# transmit **Repository Path**: wumingshi271/transmit ## Basic Information - **Project Name**: transmit - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-04-02 - **Last Updated**: 2026-04-02 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # RoboMaster 2026 机甲大师通信协议解析库 ## 概述 本项目实现了RoboMaster 2026机甲大师高校系列赛裁判系统串口通信协议的解析库,支持**GCC (arm-none-eabi-gcc)** 和 **ARM Keil MDK** 两个编译器平台。 **协议版本**: V1.3.0 (20260327) ## 兼容性 | 编译器 | 平台 | 定义宏 | |--------|------|--------| | GCC | Linux/Windows | `__GNUC__` | | ARM Keil MDK | ARM | `__ARMCC_VERSION` | ## 目录结构 ``` transmit/ ├── transmit.c # 协议解析库实现 ├── transmit.h # 头文件(可扩展) ├── main.c # 示例主程序 ├── CMakeLists.txt # CMake构建配置 └── README.md # 本文档 ``` ## 构建方法 ### GCC (arm-none-eabi-gcc) ```bash # 创建构建目录 mkdir build && cd build # 配置项目(指定ARM交叉编译器) cmake -DCMAKE_C_COMPILER=arm-none-eabi-gcc .. # 编译 make ``` ### ARM Keil MDK 在Keil uVision中导入`CMakeLists.txt`,或使用RTE组件导入。 ### Windows (本地测试) ```bash mkdir build && cd build cmake -G "MinGW Makefiles" .. mingw32-make ``` ## 协议帧格式 ``` +--------+----------+-------+-------+-------------+-------+-------+ | SOF | data_len | seq | crc8 | cmd_id | data | crc16 | +--------+----------+-------+-------+-------------+-------+-------+ | 1 Byte | 2 Bytes |1 Byte|1 Byte | 2 Bytes | N Bytes|2 Bytes| +--------+----------+-------+-------+-------------+-------+-------+ ``` | 字段 | 长度 | 说明 | |------|------|------| | SOF | 1字节 | 帧起始标志,固定为0xA5 | | data_len | 2字节 | 数据段长度(小端序) | | seq | 1字节 | 包序号,用于去重 | | crc8 | 1字节 | 帧头CRC8校验(本版本占位) | | cmd_id | 2字节 | 命令字ID(小端序) | | data | N字节 | 数据段 | | crc16 | 2字节 | 帧尾CRC16校验 | ## 命令字列表 ### 比赛信息 (0x00xx) | 命令字 | 名称 | 说明 | |--------|------|------| | 0x0001 | 比赛状态数据 | 比赛类型、阶段、剩余时间 | | 0x0002 | 比赛结果数据 | 获胜方信息 | | 0x0003 | 机器人血量数据 | 所有己方机器人血量 | ### 场地事件 (0x01xx) | 命令字 | 名称 | 说明 | |--------|------|------| | 0x0101 | 场地事件数据 | 补给站、机关激活状态 | | 0x0104 | 裁判警告数据 | 黄/红牌判罚信息 | | 0x0105 | 飞镖发射数据 | 飞镖站倒计时 | ### 机器人状态 (0x02xx) | 命令字 | 名称 | 说明 | |--------|------|------| | 0x0201 | 机器人性能体系数据 | ID、等级、血量、功率上限 | | 0x0202 | 实时底盘缓冲能量和射击热量 | 能量和热量状态 | | 0x0203 | 机器人位置数据 | x、y坐标和朝向 | | 0x0204 | 机器人增益数据 | 回血、冷却、攻防增益 | | 0x0206 | 伤害状态数据 | 装甲ID和伤害类型 | | 0x0207 | 实时射击数据 | 弹丸类型、射速、初速 | | 0x0208 | 允许发弹量数据 | 17mm/42mm弹丸余量和金币 | | 0x0209 | RFID模块状态 | 场地交互触发状态 | | 0x020A | 飞镖选手端指令 | 飞镖发射站控制状态 | | 0x020B | 地面机器人位置 | 所有己方机器人坐标 | | 0x020C | 雷达标记进度 | 目标标记状态 | | 0x020D | 哨兵自主决策信息 | 哨兵决策状态 | | 0x020E | 雷达自主决策信息 | 雷达决策状态 | ### 机器人交互 (0x03xx) | 命令字 | 名称 | 说明 | |--------|------|------| | 0x0301 | 机器人交互数据 | 自定义数据通信 | #### 子命令字 | 子命令字 | 名称 | 说明 | |----------|------|------| | 0x0100 | 删除图层 | 删除客户端界面图形 | | 0x0101 | 绘制一个图形 | 直线/矩形/圆/椭圆/弧/数字/字符 | | 0x0102 | 绘制两个图形 | 批量绘制 | | 0x0103 | 绘制五个图形 | 批量绘制 | | 0x0104 | 绘制七个图形 | 批量绘制 | | 0x0120 | 哨兵自主决策指令 | 哨兵控制指令 | | 0x0121 | 雷达自主决策指令 | 雷达控制指令(含密钥) | ## API参考 ### 核心解析函数 ```c /** * 解析裁判系统数据帧(无CRC校验) * @param buffer 接收到的原始字节流 * @param length 缓冲区长度 * @return 0-成功, -1-长度不足, -2-未知命令, -3-SOF错误 */ int parse_referee_packet_no_crc(const uint8_t *buffer, uint32_t length); /** * 解析裁判系统数据帧(带完整CRC校验) * @param buffer 接收到的原始字节流 * @param length 缓冲区长度 * @return 0-成功, -1-长度不足, -2-未知命令, -3-SOF错误, -4-CRC8错误, -5-CRC16错误 */ int parse_referee_packet_with_crc(const uint8_t *buffer, uint32_t length); ``` ### 辅助函数 ```c /** 重置全局数据 */ void reset_referee_data(void); /** 检查数据是否更新 */ int is_referee_data_updated(uint16_t flag); /** 获取并清除更新标志 */ uint16_t get_and_clear_referee_flags(void); /** 获取错误描述 */ const char *get_parse_error_string(int result); ``` ### 全局数据 ```c /** 全局裁判系统数据 */ extern referee_global_t g_referee_data; /** 数据有效标志位 */ #define FLAG_GAME_STATUS (1 << 0) #define FLAG_GAME_RESULT (1 << 1) #define FLAG_GAME_ROBOT_HP (1 << 2) #define FLAG_EVENT_DATA (1 << 3) #define FLAG_REFEREE_WARNING (1 << 4) #define FLAG_DART_INFO (1 << 5) #define FLAG_ROBOT_STATUS (1 << 6) #define FLAG_POWER_HEAT_DATA (1 << 7) #define FLAG_ROBOT_POS (1 << 8) #define FLAG_BUFF_DATA (1 << 9) #define FLAG_HURT_DATA (1 << 10) #define FLAG_SHOOT_DATA (1 << 11) #define FLAG_PROJECTILE_ALLOWANCE (1 << 12) #define FLAG_RFID_STATUS (1 << 13) #define FLAG_DART_CLIENT_CMD (1 << 14) #define FLAG_GROUND_ROBOT_POS (1 << 15) ``` ## 使用示例 ```c #include "transmit.c" uint8_t rx_buffer[256]; void uart_rx_callback(uint8_t *data, uint32_t len) { int result = parse_referee_packet_with_crc(data, len); if (result == 0) { /* 解析成功,检查更新标志 */ if (is_referee_data_updated(FLAG_ROBOT_STATUS)) { /* 机器人状态已更新 */ uint8_t robot_id = g_referee_data.robot_status.robot_id; uint16_t hp = g_referee_data.robot_status.current_hp; printf("Robot %d HP: %d\n", robot_id, hp); } if (is_referee_data_updated(FLAG_SHOOT_DATA)) { /* 射击数据已更新 */ float speed = g_referee_data.shoot_data.initial_speed; printf("Shot speed: %.1f m/s\n", speed); } } else { printf("Parse error: %s\n", get_parse_error_string(result)); } } ``` ## CRC校验说明 - **CRC8**: 多项式 `x^8 + x^7 + x^6 + x^4 + x^2 + 1` (0xD5),用于帧头校验 - **CRC16**: 多项式 `x^16 + x^12 + x^5 + 1` (0x1021),用于帧尾校验 ## 注意事项 1. 所有多字节数据采用**小端序** (Little Endian) 2. 结构体使用`PACKED`属性确保字节对齐与协议一致 3. 建议使用`parse_referee_packet_with_crc`进行生产环境验证 4. 开发调试阶段可使用`parse_referee_packet_no_crc`跳过CRC校验 ### 变量命名避免与函数名冲突 **问题描述**:在C语言中,如果局部变量名与函数名相同,会发生**变量遮蔽(Shadowing)**。部分静态分析工具(如Clion的代码分析)会将其报告为"局部变量在未被初始化的情况下使用"。 **示例**: ```c // 错误示例:变量名 calc_crc16 与函数名 calc_crc16 冲突 uint16_t calc_crc16 = calc_crc16(cmd_data_ptr, cmd_data_len); // 静态分析可能报错 // 正确示例:使用不同的变量名 uint16_t crc16_value = calc_crc16(cmd_data_ptr, cmd_data_len); // 正常 ``` **建议**:在定义局部变量存储函数返回值时,使用与函数名不同的命名,如: - `crc16_value` - `crc16_checksum` - `result_crc16` - `calculated_crc` ## 许可证 本项目仅供学习交流使用,版权归RoboMaster组委会所有。