ChameleonMini命令行操作完全指南
项目地址: https://gitcode.com/gh_mirrors/ch/ChameleonMini 项目概述
ChameleonMini是一款功能强大的RFID/NFC模拟设备，能够模拟多种类型的智能卡，并支持RFID/NFC读写功能。通过其命令行界面，用户可以完全控制设备的各种功能，包括配置模拟卡片、读取卡片数据、设置设备参数等。
命令行基础
连接方式
ChameleonMini通过USB接口枚举为虚拟串行设备，用户可以使用任何终端软件（如TeraTerm、PuTTY等）连接设备。需要注意的是：
- 串口设置（波特率、停止位、校验位等）对ChameleonMini无效
- 命令不区分大小写
- 每个命令必须以回车(CR, 0x0D)结束
- 设备不会回显输入字符，建议在终端软件中开启"本地回显"功能
命令语法
ChameleonMini支持四种基本命令格式：
-
设置参数：
<命令>=<值>- 示例：
CONFIG=MF_CLASSIC_1K设置当前槽位模拟Mifare Classic 1K卡
- 示例：
-
获取参数值：
<命令>?- 示例：
CONFIG?返回当前槽位的配置
- 示例：
-
获取参数可选值：
<命令>=?- 示例：
CONFIG=?列出所有支持的卡片类型
- 示例：
-
执行功能：
<命令>- 示例：
RESET重启设备
- 示例：
响应代码详解
ChameleonMini对每个命令都会返回状态码和状态信息，格式为状态码:状态信息，以CR+LF结束。状态码分为两类：
-
1xx：成功响应
100:OK命令执行成功101:OK WITH TEXT命令成功执行并附加信息110:WAITING FOR XMODEM等待XMODEM连接120:FALSE请求返回false121:TRUE请求返回true
-
2xx：错误响应
200:UNKNOWN COMMAND未知命令201:INVALID COMMAND USAGE命令使用方式错误202:INVALID PARAMETER参数值无效203:TIMEOUT操作超时
核心命令详解
全局命令
-
设备信息：
VERSION?获取固件版本信息SYSTICK?获取系统时间(ms)RSSI?获取天线电压值，可用于检测RF场强
-
设备控制：
RESET重启设备UPGRADE进入固件升级模式(DFU)
-
电池状态：
CHARGING?检查是否正在充电
槽位管理
ChameleonMini提供8个槽位，每个槽位可以存储不同的卡片配置和数据：
SETTING=<1-8>选择活动槽位SETTING?获取当前活动槽位
槽位配置命令
-
卡片配置：
CONFIG=?列出所有支持的卡片类型CONFIG=<类型>设置当前槽位的卡片类型CONFIG?获取当前槽位的卡片类型
-
UID操作：
UIDSIZE?获取当前卡片类型的UID长度UID?获取当前UIDUID=<十六进制UID>设置新UID
-
内存操作：
MEMSIZE?获取当前配置占用的内存大小CLEAR清除当前槽位内容STORE将当前槽位内容从FRAM存储到FlashRECALL从Flash恢复槽位内容到FRAM
-
数据传输：
UPLOAD通过XMODEM上传卡片数据DOWNLOAD通过XMODEM下载卡片数据
读写器功能命令
当槽位配置为读写器模式时可用：
-
基本通信：
SEND <字节值>发送带校验位的命令SEND_RAW <字节值>发送原始命令
-
卡片操作：
GETUID获取卡片UIDDUMP_MFU读取Mifare Ultralight卡片全部内容COPY_MFU复制Mifare Ultralight卡片数据IDENTIFY识别卡片类型
-
场强控制：
FIELD?检查读写器场是否激活FIELD=[0|1]启用/禁用读写器场
-
阈值设置：
THRESHOLD?获取当前阈值THRESHOLD=<值>设置阈值(默认400)AUTOCALIBRATE自动校准阈值
超时控制
某些命令执行时间不确定，可通过超时设置控制等待时间：
TIMEOUT?获取当前超时设置TIMEOUT=<值>设置超时(单位：128ms)TIMEOUT=?获取超时值范围
注意：设置为0表示无超时，可能导致无限等待。
实用操作示例
读取卡片示例
CONFIG=ISO14443A_READER # 设置为读写器模式
AUTOCALIBRATE # 自动校准阈值
IDENTIFY # 识别卡片类型
复制Mifare Ultralight卡片数据
CONFIG=ISO14443A_READER # 设置为读写器模式
AUTOCALIBRATE # 自动校准阈值
COPY_MFU # 复制卡片数据
上传卡片数据
- 在终端输入
UPLOAD - 等待
110:WAITING FOR XMODEM响应 - 使用终端软件的XMODEM发送功能上传二进制文件
终端使用建议
推荐使用TeraTerm等支持XMODEM协议的终端软件：
-
连接设置：
- 选择正确的虚拟串口
- 启用"本地回显"功能(Setup -> Terminal -> Local Echo)
-
文件传输：
- 上传：使用XMODEM Send功能
- 下载：使用XMODEM Receive功能
注意：XMODEM传输有10秒超时限制，超时后需重新发送命令。
总结
ChameleonMini的命令行界面提供了对设备的全面控制能力，通过掌握这些命令，用户可以充分发挥设备的RFID/NFC模拟和读写功能。建议新用户从基本配置命令开始，逐步熟悉设备的各种功能。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
