Chameleon Ultra GUI完全指南：从安装到精通的5个关键步骤

Chameleon Ultra GUI是一款基于Flutter框架（跨平台应用开发工具包）构建的跨平台GUI设备管理工具，专为Chameleon Ultra/Chameleon Lite设备设计。该Flutter应用提供直观的图形界面，帮助用户轻松完成设备连接、卡片读写、槽位管理等核心操作，实现跨Windows、macOS、Linux和移动平台的无缝体验。

🔍 功能速览：5分钟了解核心操作

1. 设备连接界面

显示已识别的Chameleon Ultra设备，点击即可建立连接，支持USB和蓝牙两种连接方式

2. 主控制中心

展示设备基本信息，包括已用槽位(3/8)、固件版本(2.0 dev-2-g7efe23e)，提供快速导航至各功能模块的入口

3. 槽位管理系统

可视化管理8个设备槽位，支持查看各槽位状态（如Mifare Classic 1K、EM410X等类型）和快速配置

4. 高频/低频卡片读取

同时显示HF（高频）和LF（低频）标签信息，包括UID、SAK、ATQA等参数，支持一键读取和保存UID

5. Mifare Classic密钥分析

针对Mifare Classic 1K卡片的密钥状态检测，通过颜色标识（红叉/绿勾）直观展示各扇区密钥获取情况

🛠️ 零门槛部署指南：新手必看安装流程

环境准备（3分钟搞定）

1. 安装Flutter SDK（跨平台应用开发工具包）
2. 配置Git环境（版本控制工具）
3. 安装JDK（Java开发工具包）

源码获取与依赖安装

# 克隆项目仓库
git clone https://gitcode.com/gh_mirrors/ch/ChameleonUltraGUI
# 进入项目目录
cd ChameleonUltraGUI/chameleonultragui
# 获取项目依赖
flutter pub get

执行成功后会显示"Process finished with exit code 0"

运行应用程序

# 查看连接设备
flutter devices
# 运行应用（默认设备）
flutter run

首次运行可能需要下载平台相关依赖，耐心等待即可

Linux用户特别配置

# 添加用户到uucp组（解决权限问题）
sudo usermod -aG uucp $USER
# 禁用ModemManager（避免设备冲突）
sudo systemctl disable --now modemmanager

配置完成后需重启电脑使设置生效

💡 快速上手：3步完成首次卡片操作

步骤1：设备连接

1. 启动应用后自动扫描设备
2. 在连接界面选择显示的"/dev/ttyACM2 Chameleon Ultra"设备
3. 点击设备图标完成连接，自动跳转至主界面

步骤2：读取卡片信息

1. 点击左侧导航栏的无线图标进入"Read Card"页面
2. 将NFC卡片贴近设备感应区
3. 点击"Read"按钮获取卡片UID和技术参数
   • HF标签：显示UID、SAK、ATQA等高频卡信息
   • LF标签：显示UID和技术类型（如EM4100/EM4102）

步骤3：管理设备槽位

1. 点击左侧导航栏的网格图标进入"Slot Manager"
2. 选择任意绿色可用槽位（如Slot 1）
3. 点击齿轮图标配置槽位参数，支持选择卡片类型和导入数据

⚡ 效率技巧：专家级操作指南

批量槽位配置

长按任意槽位卡片进入多选模式，可同时对多个槽位执行：

• 批量清空操作
• 复制槽位配置
• 导出多个槽位数据

密钥恢复加速

在Mifare Classic读取页面：

1. 点击"Recover keys"启动密钥恢复
2. 配合字典文件可大幅提高密钥破解效率
3. 使用"Dump partial data"获取部分扇区数据

快捷键操作

• Ctrl+D：快速断开设备连接
• Ctrl+R：刷新设备状态
• Ctrl+S：保存当前配置
• F5：重新扫描设备

❗ 避坑指南：常见问题解决方案

设备连接失败

• 症状：连接界面不显示设备
• 解决：
  1. 检查USB线缆是否接触良好
  2. 确认用户已加入uucp组
  3. 执行sudo chmod 666 /dev/ttyACM*临时赋予权限

卡片读取无响应

• 症状：点击"Read"后无数据显示
• 解决：
  1. 确保卡片放置在正确感应区域
  2. 检查设备固件是否为最新版本
  3. 尝试切换HF/LF模式重新读取

应用启动崩溃

• 症状：运行flutter run后闪退
• 解决：
  1. 执行flutter clean清理项目
  2. 删除pubspec.lock后重新flutter pub get
  3. 检查Flutter版本兼容性（推荐3.0+）

延伸学习

• 官方文档：docs/README.md
• 开发指南：CONTRIBUTING.md

本指南涵盖从环境搭建到高级操作的核心流程，通过直观的界面截图和详细的命令说明，帮助新手快速掌握Chameleon Ultra GUI的使用技巧。所有操作均经过实际设备测试，确保在主流操作系统上的兼容性和稳定性。