ChameleonMini 开源项目使用教程
1. 项目的目录结构及介绍
ChameleonMini 项目的目录结构如下:
ChameleonMini/
├── Doc/
│ └── Doxygen/
│ └── html/
│ └── _page__getting_started.html
├── Drivers/
├── Dumps/
├── Firmware/
├── Hardware/
├── RevE/
├── RevE-light/
├── Software/
├── LICENSE.txt
└── README.md
目录结构介绍:
- Doc/: 包含项目的文档,特别是 Doxygen 生成的文档,其中
_page__getting_started.html
是入门指南。 - Drivers/: 包含 ChameleonMini 的驱动程序,支持 Windows 和 Linux 系统。
- Dumps/: 包含不同智能卡的转储数据。
- Firmware/: 包含完整的固件,包括修改后的 Atmel DFU 引导加载程序和 LUFA。
- Hardware/: 包含 PCB 的布局和原理图。
- RevE/: 包含已停止支持的 RevE 版本的所有内容。
- RevE-light/: 包含 RevE-light 的开发文件,但目前不支持或功能不完整。
- Software/: 包含用于配置 ChameleonMini 的 Python 工具。
- LICENSE.txt: 项目的许可证文件。
- README.md: 项目的自述文件,包含项目的基本信息和使用说明。
2. 项目的启动文件介绍
ChameleonMini 项目的启动文件主要集中在 Firmware/
目录下。以下是一些关键的启动文件:
- Firmware/Bootloader/: 包含 DFU 引导加载程序的源代码。
- Firmware/LUFA/: 包含 LUFA 库的源代码,用于 USB 通信。
- Firmware/Chameleon-Mini/: 包含 ChameleonMini 固件的主要源代码。
启动流程:
- DFU 引导加载程序: 设备上电后,首先运行 DFU 引导加载程序,用于更新固件。
- LUFA 库: 用于处理 USB 通信,确保设备与主机之间的数据传输。
- Chameleon-Mini 固件: 主固件负责设备的各项功能,包括智能卡模拟、RFID 读取和数据记录。
3. 项目的配置文件介绍
ChameleonMini 的配置文件主要位于 Software/
目录下,特别是 Software/Chameleon-Tool/
目录中。以下是一些关键的配置文件:
- Software/Chameleon-Tool/config.py: 包含设备的配置选项,如通信端口、波特率等。
- Software/Chameleon-Tool/settings.py: 包含设备的默认设置和用户自定义设置。
配置文件说明:
-
config.py:
PORT
: 指定设备的通信端口。BAUDRATE
: 指定通信波特率。TIMEOUT
: 指定通信超时时间。
-
settings.py:
DEFAULT_SETTINGS
: 包含设备的默认设置。USER_SETTINGS
: 允许用户自定义设置,覆盖默认设置。
通过这些配置文件,用户可以轻松地配置 ChameleonMini 设备,以满足不同的使用需求。