Repository navigation
Conversation
- service/{system,comm,monitor,definition}、device/{motor,sensor,remote,actuator};protocol/emmv5_protocol 并进 device/motor/
- CMake 只加 code/ 包含路径、源文件 GLOB code/*.cpp;库与模板的包含语句一律写全子目录
- bsp 只包含 service/system/status_code.hpp(不再经 status.hpp 间接依赖 FreeRTOS 事件组)
- 新增 tools/check_layers.py:下层不能包含上层(status_code.hpp 例外)
- 编码规范加包含路径规则;README、docs/code 的目录描述同步
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- CMake 目标 stm32_framework → icbsp,内部变量与提示信息同步 - hardware_config.h 的全部配置宏与功能开关、board_instances.hpp 的 BSP_*_INSTANCES、 bsp_series.hpp 的 BSP_SERIES_* / BSP_CAN_MODULE_ENABLED / BSP_UART_HAS_FIFO 统一加 ICBSP_ 前缀 - README 改名并说明 ICBSP = INVC & CUBOT Board Support Package;LICENSE 版权人 INVC & CUBOT - integrate.py、模板、文档里的路径改成 third_party/icbsp - 历史记录(docs/bsp_test、对比评估、评审、F4 移植计划)保持原文 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- 烧录脚本支持 OPENOCD 环境变量指定 OpenOCD,.sh 检测到 0.11 及以下时提示 - daplink.cfg / jlink.cfg 注明不要注册外置 Flash bank;daplink.cfg 带注释掉的 cmsis-dap backend hid - templates/Flash/README.md 与接入指南常见问题补实测经验(含烧录 CRC 造成的假 HardFault) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- 新增 service/system/config_check.hpp:库读配置的唯一入口,缺宏 #error → HAL 模块没开时强制关开关 → 开关依赖 static_assert → 取值范围 static_assert;库内不再直接包含 hardware_config.h - 零散的检查(system.cpp、device_bmi088.cpp、bsp_can / bsp_fdcan / can_tx_node 的缺宏检查)并进来 - 依赖:串口巡检需要 sys_task;DjiMotor 需要 CAN 收发都开(开了 CAN 外设却关了任一路径时 #error) - 模板 hardware_config.h 只留 #define,四个功能开关写明关掉的后果 - check_layers.py 例外清单加 config_check.hpp;编码规范、接入指南同步 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- sys_task 上电即开始维护(Online 初始离线,恢复 / 巡检在无故障时不动作) - BspUartT::tx_recover() 的卡死阈值 = max(一包耗时 × 2, 10 ms):tick 只有 1 ms 分辨率, 高波特率下阈值 1~2 ms 时刚开始的传输可能被误判卡死并中止 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- 新增 service/system/state_tree:system_init() 按 ICBSP_CAN/UART/SPI_INSTANCES 给每个实例建节点挂到 sys_state, system_start() 进入运行态并记诊断计数基线;sys_task 每 10 ms state_tree_poll(),计数涨了就在总线节点记错 - Online::set_state():由在线变离线时在设备节点记 TIMEOUT(构造后从没上线过的不算) - DjiMotor 持有自己的节点(get_state()),挂在所用 CAN 的总线节点下;init 失败记在本节点 - 传播规则不变:子节点出错只置父节点错误位,不清运行位 - status.hpp 文件头的旧约定(单个设备不许引用 EventState)按 Q6 更新;docs/code/service.md 补默认树一节 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…陀螺仪 x/y/z,ICBSP_PI 常量,DjiMotorType(阶段 2,Q10 / I5 / I6 / I7) - 编码规范 2.1 写入接口命名规则与例外,按规则改名 GPIO / Key / Encoder / SPI / UART / CAN / DWT / BMI088 / DeviceMotor / R9DS / DjiMotor / CanTxNode / EventState / PID / RLS 的查询接口 - Online::is_online() 改返回 bool(原来返回 Status,if (x.is_online()) 在离线时成立) - I5:ImuData::gyro 改 x / y / z(本体系) - I6:删除两处 PI 宏(float 精度),新增 algorithm/math_constants.hpp(ICBSP_PI / ICBSP_PI_F,并入 PI_D); MotorType → enum class DjiMotorType;PID 的 _input / _output 改私有 - I7:CAN 发送槽位冲突改报 BUSY - 文档里的旧名字同步 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…默认树(阶段 2,Q12 / N33) - BspUartT 新增公开常量 TX_CAPACITY / RX_CAPACITY - DeviceEmmv5GroupT:帧缓冲跟随 Uart::TX_CAPACITY(原来写死 128);N33:take_position / take_status / take_in_position、is_in_position、get_last_multi_frame;send() 不再把 tick 当毫秒;lock_bus() 用 ms_to_ticks(); Config::checksum(FIXED_6B / XOR,XOR 未实测,CRC-8 因说明书没给参数未实现) - emmv5_protocol:Checksum、checksum_of()、Frame::apply_checksum()、解析器与 MMCL 总帧按校验方式处理 - 默认树第三层:Emm_V5 组、R9DS、BMI088 各有 EventState 节点(get_state()),挂在所用总线下 - undo:DR16 / ET08 移到待排期,新增 Emm_V5 CRC-8 待办 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- 协议按 DM-J4310-2EC V1.2 说明书;P_MAX / V_MAX / T_MAX 必填(与调试助手一致),Kp / Kd 按说明书范围限幅 - 控制帧不经过 CanTxNodeT(槽位过期清零 = MIT 满负扭矩),直接 send_latest();命令帧 send() 排队 - switch_mode() 写 CTRL_MODE;写寄存器回复按挂起的那次识别,不当反馈解 - Online、snapshot()、get_state()(默认树:掉线 TIMEOUT,故障态 IO_ERROR);需要 ICBSP_CAN_RX_ENABLE - 只编译验证(宿主编译探针显式实例化),映射 / 拼包 / 解包代码另做了主机侧往返测试 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- 编译矩阵(清单留空,关 SPI / UART / FDCAN / TIM 各一个及全关,功能开关组合)0 error / 0 warning Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…起的寄存器回复(阶段 3 前置) - float_to_uint 改成说明书给出的截断取整(原来四舍五入,差 1 LSB) - DmState 增加输出轴校准异常 / 传感器异常 / 编码器校准异常;故障判定改为“不是失能 / 使能” - 新增 read_register():读寄存器不用使能,用来确认通信、核对 PMAX / VMAX / TMAX / 控制模式;dm::RID_* 常量 - 实板扫描时发现:别人发起的读写寄存器回复也发到 master_id,会被当成一帧反馈解码(假位置);现在丢弃 实板(2026-11-06):DM-J4310P(CAN2,0x05 / 0x06)读寄存器正常(速度模式、12.5 / 30 / 10) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…xFF/0x00(实板发现) CAN2 实测:GM6020 ID1 的反馈 0x205 = CAN_ID 0x05 的 DM 电机在速度模式下的控制帧 ID, DM 每收到一帧 6020 反馈就回一帧(约 1 kHz),使能后会把 6020 的数据当成速度给定。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…驱动器同步映射范围与模式 - 三个系列 CAN 协议逐项相同,不做模板;Config::model + constexpr dm_model_info()(减速比、额定 / 峰值扭矩、空载转速,抄自说明书) - 映射范围可留 0,启动后 sync_ranges() 读 PMAX / VMAX / TMAX / CTRL_MODE;Config 与驱动器不一致时记 range_mismatch,以驱动器为准 - 映射范围未知时拒发 MIT 帧、反馈只留原始值;MIT 前馈扭矩限在型号峰值扭矩内 实板:J4340P(12.5 / 10 / 28,MIT)、J4310P(12.5 / 30 / 10,速度模式,检测出 Config 模式不一致)同步正确 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- tests/host:不依赖硬件、RTOS 和测试框架,45 条判据:PID 限幅、F4(i_max = 0 跟随 out_max,链式与 Config 一致)、 非有限输入丢弃计数;四元数 F1(零模长 / NaN 退回单位四元数)、旋转 / 欧拉 / 积分 / slerp;Matrix 乘法 / 转置 / 求逆 / 奇异判定; RLS 收敛、非有限样本拒绝、参数非法、tr(P) 上限 - .github/workflows/host-tests.yml:push / PR 时跑 check_layers.py 与主机单元测试 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…l_line),定位偶发 IO_ERROR(阶段 3) 第 A 轮 Debug 全组回归时 P04(200 次重新 init)有 48 次 IO_ERROR,之后 -O2 与两次 Debug 复现都是 0 次; init_locked() 的每个失败返回都记下源码行号,下次出现时能看到是哪一步。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
vTaskDelay(1) 只等到下一个 tick 边界,实际可能远不到 1 ms;加速度计软复位后不到 1 ms 就重读芯片 ID,偶发读错。 阶段 3 实测:P04(连续 200 次 init)两次完整回归各有 48 次 IO_ERROR,失败行都在软复位后读 ACC_CHIP_ID 处; 改后第 B 轮 Debug 0 次(单次 init 93 → 108 ms)。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…帧压力用例待补;附阶段 3 测试记录 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…套圈检测待排期 阶段 3 宿主 U16~U20 实测:回绕、多圈、IDLE 风暴、反复中止重挂都正确,TIM8 = 15 不卡死; U19 屏蔽串口 / DMA 中断 0.75 / 1.5 圈时丢帧且库计数为 0。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… 勾选 DMA 循环模式专项 / F2 短段压力 tx_recover() 原来两次巡检(相隔 10 ms)都看到“通道空闲、流缓冲区有数据”就补发并计卡死恢复; 短段连续发送时 sys 任务抢占写者恰好落在 send() 的“写进流缓冲区 → 拿 _tx_lock 启动”之间,两次都可能看到这个样子(阶段 3 U21 实测, 现场快照:通道完全空闲、上一次启动在 1 ms 前、写者一直在调 start_transmission())。数据无损,但计数误报成故障。 改为第一次看到时记下 _tx_last_activity_tick,第二次只有期间没有任何启动才补发。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- README:当前状态(阶段 1~3 完成、实板回归)、目录树(tests/、check_layers.py)、接入要求(C++20、栈溢出 / 分配失败钩子、D-Cache)、 库任务(报告回调,不再“每 2 s 打印”)、已知限制(UART 循环接收约束、F4 只编译验证)、许可证例外 - docs/code:五层;依赖矩阵按 check_layers.py;X-macro 漏写时 init() 返回 BAD_ARG;启动顺序用 ICBSP_CHECK - device.md 按 motor / sensor / remote / actuator 分节,并入 protocol.md(删除);修正 Emm_V5 帧格式与组帧示例、 BMI088 的 read_dummy(加速度计 1、陀螺仪 0)与示例、DJI ID 范围是运行期 BAD_ARG、达妙实测情况 - bsp.md:bsp_fdcan / bsp_series / bsp_dma_buffer、F4 bxCAN 入口、UART 循环接收约束与 idle_kick 诊断、非 constexpr 实例放 board_cfg.cpp - service.md / tasks.md:报告回调与统计、sys_task 每周期的六件事、优先级、心跳 5 ms / 有效期 100 ms - algorithm.md:RLS 用法、Matrix from_array、积分分离是清零、主机侧单元测试 - draw_diagrams.py:分层图 device 与 tasks 并列、去掉 protocol/、各层实际模块;启动图 ICBSP_CHECK、报告回调、优先级 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- 7 处注释引用不存在的 bsp_dwt.md / bsp_key.md / bsp_pwm.md / device_servo.md / device_emmv5_group.md / emmv5_protocol.md / device_r9ds.md, 改为指向 docs/code 对应小节或同文件里实际存在的注释(bsp_uart.md / bsp_can.md / status.md 之前已修) - 接入指南:库内部用 FreeRTOS 原生 API,不经 cmsis_os2.h;要求 V2 是因为优先级档数 - 编码规范第 1 / 5 / 6 节:去掉 api_xxx.h、protocol_ / alg_ 前缀和 Module / Protocol 分层,换成实际的五层与 extern "C" 入口 - D2 的其余条目(README 章节号、hardware_config_defaults.hpp、“8 路串口”、“pid 已测”)在当前代码里已不存在;时基优先级理由 1.4 已改 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…s_to_ticks 引用、节点数上限的说明 - templates/user/board/board_cfg.cpp:ICBSP_CHECK(不是 configASSERT)、DWT 已由 system_init() 初始化、 示例里舵机是 PWM 设备、Emm_V5 是张大头串口步进(不是达妙),补上 DmMotor 示例;设备放在所用总线之后 - monitor_task 是每 10 s 打印(app_task.hpp / app_main.cpp / demo_task.cpp 原来写“每秒”) - bsp_spi.cpp:ms_to_ticks() 在 bsp_uart.hpp 的 uart_detail 里,不在 bsp_uart.cpp - ICBSP_CAN_RX/TX_NODE_MAX:计数按 BspCanT 类型分别算(同模板参数的总线合计),类型是 uint32_t;断言提示去掉“uint8_t” - 其余几条已在之前修过:README“每 2 s”(4.1)、bsp_spi.hpp 示例段名、integrate.py 收尾提示 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…AN Message RAM / 过滤器、时基优先级、编码器 ARR、newlib、BDMA - 1:语言 C++20(inline 变量、指定初始化器按声明顺序、volatile 不能 ++) - 1.1:hardware_config.h(只经 config_check.hpp 读)与 board_instances.hpp(X-macro 清单,包含 board_cfg.hpp)的职责 - 1.2:库占用的 HAL 回调(UART 3、SPI 2、FDCAN 3 含 ErrorStatusCallback、F4 bxCAN 5),清单外转调 icbsp_unhandled_*()(N30); HAL_GPIO_EXTI_Callback 由宿主定义并转调 BMI088;弱符号 __malloc_lock - 2.3:时基优先级原来的两条理由(HAL_DMA_Abort 竞争、调度器启动前 BASEPRI 挡住 HAL tick)及现在为何不成立;宿主在 app_init / board_init 里不要 HAL_Delay - 2.4:MessageRAMOffset 不重叠的算法(例 0 / 129 / 258)、StdFiltersNbr、TX FIFO / Queue 的取舍、中断线 0 - 2.5:RX DMA 循环模式与中断屏蔽约束、BDMA 外设(LPUART1、SPI6 等)用 DMA 时 init() 返回 BAD_ARG - 2.7:编码器 Period 必须是计数器最大值(N37);2.9 BMI088(EXTI、不要启动加热电阻);2.10 newlib(锁、两个堆) - 4.2:漏写清单时 init() 返回 BAD_ARG(原来写“不会报错”) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- 接入指南 4.2:五个开关(SYS_TASK / CAN_RX / CAN_TX / UART_PATROL / UART_ENABLE_FIFO)各管什么、关掉之后失去什么 - 模板 hardware_config.h:依赖说明改成“DjiMotor 要收发都开、DmMotor 只要接收”(原来写“以后的 dm_motor”); sys_task 关掉后默认状态树总线层不再记错;CAN 开关关掉时哪些设备头文件 #error;FIFO 关着没有损失 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- 第 4 节:板级实例在宿主(外设类 constexpr → board_cfg.hpp inline;设备类不是 constexpr → 推荐 board_cfg.cpp + extern)、 X-macro 实例清单(不再有登记表)、模板只有头文件 + compile_probe、HAL 回调与 icbsp_unhandled_*、聚合体 Config + 指定初始化器 (按声明顺序;算法类 Config 的位置构造与单参数花括号二义性)、构造只赋值 + 外设类 constexpr / 平凡析构(N32)、init() 可重复调用 - 第 9 节 C++20:volatile 不能复合赋值、指定初始化器顺序、聚合体、constexpr + 平凡析构、inline 变量、不用异常 / RTTI - 第 10 节 .dma_buffer:一律 ICBSP_DMA_BUFFER(变量名)(COMDAT 同名段的问题)、可加载段、init() 的可达性核对、D-Cache - 第 2 节示例换成现在的名字;第 8 节 fault_record 路径与 board_init() - (get_ / is_ / read_ / take_ 命名与包含路径规则阶段 2 已写入,本次核对未改) - device.md:设备类构造不是 constexpr 的说明 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- docs/code/README.md 新增“实测状态”表:逐个模块写状态与依据(用例编号);F4 bxCAN、Gpio / Key / Encoder、newlib_lock、 DeviceMotor / Servo / R9DS / Emm_V5、QuaternionPID 标“只编译验证”,DJI / 达妙写明实测到哪些型号 - docs/bsp_test/README.md 改成 ICBSP 的说明,新增“记录 → 代码版本”表(phase3 = phase2 分支 68451b7 ~ d71421a;1.x 的 fork 提交; 10-17 / 10-28 的旧库 STM32_BSP 提交);五份旧记录与 service_test 标题下补一行版本说明 - README 指向实测状态表 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- README 许可证一节:VQF(MIT,Daniel Laidig,SPDX 行不要删、上游原样)、matrix(原作者许可 RoboMaster 范围内使用,不适用 MIT) - docs/sheet/README.md:手册清单与对应代码、版权归厂商、不属于 MIT、按要求可删除;DJI 官方渠道链接(达妙未找到可确认的官网链接) - 厂商 PDF 按用户选择保留 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
….py) - 外设类型(can / uart / spi / pwm / encoder):CubeMX IP 名、实例名与句柄的命名、包含的头文件、X-macro 清单宏、参数(类型 / 范围 / 默认值或来源)、 声明与 init() 片段(H7 / F4 两套)、适用的校验规则 - 设备目录:dji_motor、dm_motor、bmi088、r9ds、emmv5_group、servo、buzzer、device_motor 的依赖(外设 / GPIO / EXTI)、所需开关、参数、 定义 / extern / init() / EXTI 转调片段、实测状态;dr16 / et08 标“计划中” - 功能开关与依赖;校验规则(级别、标题、修改方法、能否自动修改)——判断逻辑在 Python 里按规则 id 实现 - manifest.py:自检每个片段的占位符都有来源、规则引用存在、开关依赖存在;CI 里跑 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…y),integrate.py 接入 - ioc.py:读写 .ioc(Java properties 转义、保持原顺序、新键按字母序插入),外设视图:FDCAN(含 Message RAM 字数)/ UART / SPI / PWM 通道 / 编码器 / 带标签的 GPIO 输出与 EXTI / FreeRTOS / 定时器时钟。缺省键按 CubeMX 数据库默认值(db/mcu/IP/*.xml) - checks.py:全局(CMSIS_V2、tick、栈溢出检查、分配失败钩子、defaultTask As weak、CMake、时基、D-Cache)与外设规则 (FDCAN 经典帧 / FIFO 不为 0 / 中断线 0 / Message RAM 不重叠 / 标准过滤器,UART 中断 / DMA / BDMA,SPI 主机全双工 / KeepIO / 中断, 编码器 Period);能自动修改的给出 .ioc 键值(同步 IPParameters) - 时基优先级不再要求 < 5(1.4 起默认 15);新增 can_fifo 规则:CubeMX 的 RxFifo0ElmtsNbr / TxFifoQueueElmtsNbr 默认 0,收不到也发不出 - selection.py:可做成库实例的候选与参数默认值(SPI1 只发送等不可用的写明原因)、默认选择(PWM / 编码器默认不选)、选择的校验 - integrate.py:前提检查之后校验 .ioc;经典接入时全局规则不满足算错误、外设规则只提醒。DM-MC02 的 .ioc 39 项全部通过 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- generate.py:board_cfg.hpp 的 includes / peripherals(每个选中外设一行 inline 实例,H7 的 DMA 实例自动套 ICBSP_DMA_BUFFER, print_uart 指向选定的调试串口)、board_instances.hpp 的三个 X-macro 清单、board_cfg.cpp 的 init(先外设后设备)、 hardware_config.h 的功能开关;片段全部来自 manifest.json,实例名 / 句柄按 .ioc 的外设编号(FDCAN1 → bsp_can1 / hfdcan1) - regions.py:生成区 `// <ICBSP-GEN 名字>` … `// </ICBSP-GEN 名字 哈希>`,哈希是区内内容的 SHA-1 前缀(手改可检测);解析、替换、盖哈希 - 模板加生成区:board_cfg.hpp(includes / peripherals / devices)、board_cfg.cpp(devices / init / callbacks)、 board_instances.hpp(instances)、hardware_config.h(switches;各开关关掉的后果挪到区前的说明里) - board_instances.hpp 模板:“忘了同步不报错”改成 init() 返回 BAD_ARG(阶段 4 漏改) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- selection.device_catalog():设备只在依赖的外设已选中、所需开关满足时可选,每个依赖给出候选(总线 / PWM / 编码器 / 带标签的 GPIO 与 EXTI); 计划中的设备(DR16、ET08)列出但不可选并写明原因 - generate.py:设备实例定义在 board_cfg.cpp 的 devices 区、board_cfg.hpp 里 extern(设备构造不是 constexpr),init() 排在外设之后; 用到 EXTI 的设备(BMI088)生成 HAL_GPIO_EXTI_Callback(与 DM-MC02 实测的写法一致);notes() 给出生成后的提醒(sync_ranges、只编译验证等) - selection.validate():PWM 通道 / 编码器 / GPIO 只能给一个设备用;GM6020 ID 1~7;设备所需开关 - 用 DM-MC02 的 .ioc 生成(CAN1/2、五个串口、SPI2、TIM12_CH2 + BMI088、蜂鸣器)替换宿主板级文件,Debug 0 error / 0 warning Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…dited / --ioc - 只改生成区、区外不动;内容一致时不算修改(可重复运行);文件不存在从模板新建再填;写盘前走 Plan(--dry-run 即 diff 预览) - 停下的情况:文件缺生成区(手写的文件,提示加标记)、生成区被手改过(哈希不符,--overwrite-edited 才覆盖)、 区外有同名实例、宿主别处已定义 HAL_GPIO_EXTI_Callback(跳过 HAL 的 __weak 与 Drivers / Middlewares) - --apply <选择.json>:按 .ioc 补齐默认值、校验选择、选中外设的 .ioc 规则按清单级别处理,经典接入步骤之后同步生成区 - 修经典接入的一个坑:已有的 app_main.cpp 没有 app_default_task()(N25 之前)时不再改 StartDefaultTask(原来会改成调用它,链接失败) - 在 DM-MC02 工程的拷贝上验证:手写文件 / 首次生成 / 重跑无改动 / 手改停下 / --overwrite-edited / 区外重名,生成结果 Debug 0 warning Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…plan - --json:stdout 只输出一个 JSON:report(ok / skip / warn / error)、ioc_checks(逐条规则)、candidates(外设候选与参数默认值、不可用原因)、 selection(--apply 给的选择补齐默认值,没给时为默认选择)、devices(可挂设备目录)、switches、peripheral_kinds(参数说明)、 gpio(带标签的输出 / EXTI 引脚)、generated(宿主现有生成区与手改情况)、plan(每个文件的 unified diff)、applied - --plan 同 --dry-run;--json 配 --apply 时按选择生成,不带 --plan 就写盘;致命错误(不是宿主根目录)也以 JSON 返回 - Plan.diffs():按文件给出 diff(新建文件给全文) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- cubemx.py:把校验里能自动修改的失败项写进 .ioc(同步 IPParameters,先备份成 .ioc.bak-时间),--plan 只给 .ioc 的 diff; --regenerate 用 CubeMX 自带 Java 跑命令行脚本(config load / project generate / exit),10 分钟超时(提示桌面 CubeMX 抢锁); 找不到 CubeMX(--cubemx、ICBSP_CUBEMX、~/STM32CubeMX)时只改 .ioc 并提示手动 Generate - integrate.py:--fix-ioc all|规则id,… / --regenerate 单独运行,--json 时输出 fixed、ioc_diff、regenerated、CubeMX 输出尾部;不能自动修改的列出修改方法 - 在 DM-MC02 工程拷贝上实测:.ioc 改坏 4 项(Message RAM 重叠、SPI2 KeepIO、栈溢出检查、USART1 中断)+ 生成代码改坏, 修复并重新生成 31 s;修好的 .ioc 与原工程一致,重新生成的 Core/ 与原工程一致 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…_selection.json - server.mjs:Node 自带 http,只监听 127.0.0.1;找 Python 3.8+(--python、ICBSP_PYTHON、python3、python、py -3),找不到时页面明确提示; /api/info、/api/scan(--json --plan)、/api/apply(--json --apply)、/api/fix-ioc(--fix-ioc [--regenerate])只把请求翻译成 integrate.py 参数 - 页面:工程、.ioc 校验(勾选自动修改、可选 CubeMX 重新生成)、外设与参数、调试串口、功能开关、设备(按目录添加、依赖与参数)、 生成区状态、报告、diff 预览与写入(确认后);改选择后自动重新预览;明暗主题 - 生成时把完整选择存进 <板级目录>/icbsp_selection.json(生成区的源,随工程提交),--json 不带 --apply 时从它开始(selection_source) - 接入指南 3.1、README:生成与 Web UI 的用法、命令行参数、生成区规则 - 验证:API 用 curl 测过;app.js 用最小 DOM 跑通全部渲染路径(本机没有浏览器,交互未实测) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- test_tool.py(CI 里跑,13 项):清单自检、模板生成区哈希、.ioc 解析(DM-MC02 与“CubeMX 默认值”夹具)、校验与自动修复往返、 选择校验(GM6020 ID、计划中设备、缺依赖、资源共用、重名、未选中总线、开关依赖)、设备目录、生成快照逐字比对、生成区幂等与手改检测 - compile_test.py(本地跑):每个用例用 STM32CubeMX 在空目录生成全新工程 → 拷库 → integrate.py --apply 从零完整接入并生成 → 编译; mc02_full(CAN1/2、五个串口、SPI2、TIM12 + BMI088、蜂鸣器)与 mc02_alt(CAN1/3、中断串口、两路 PWM + GM6020 电流模式、J8009P、 舵机、蜂鸣器、R9DS、Emm_V5 XOR、串口巡检关)都 0 error / 0 warning - 测试抓到并修掉:一次修复多项时 Message RAM 偏移没算上“标准过滤器 0 → 1”,修完仍重叠; 另加:串口波特率与 .ioc 不一致时警告 - CI 加接入引擎测试 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- cmake/icbsp_flash.cmake:缓存变量 ICBSP_FLASH_LAYOUT(INTERNAL / QSPI_RAM / QSPI_XIP)换链接脚本、加宏, ExternalProject 编译 bootloader,构建后生成 QSPI 镜像;cmake/icbsp_options.cmake:按构建类型的优化等级 - boot/:寄存器级 bootloader(W25Q 复位 / JEDEC / QE / 内存映射、镜像头与 CRC 校验、MPU 13~15 区),A / B 共用 - templates/flash_layout/:方案 A(拷进 AXI SRAM)与方案 B(XIP)的链接脚本模板 - tools/qspi_image.py:镜像头 + 载荷,方案 B 把头写回 ELF;输出 _qspi.bin / .hex - Flash/ 脚本按构建目录的存放方式烧(bootloader 不同才烧、--boot、--ram),daplink_qspi.cfg 在 reset-init / gdb-attach 时初始化 QSPI - 修:linker_sections.ld 的 __dma_buffer_load 没算段内 ALIGN(32) 的偏移(.dma_buffer 不在 RAM 区开头时实例初值错位) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- icbsp_tool/flash.py:是否建议外置 Flash(QUADSPI + 片内 ≤128 KB / 构建占用 ≥85%,链接溢出时读 .map)、引脚与复用号、 生成 icbsp_flash_config.h 与 OpenOCD 的 QSPI 初始化;OCTOSPI 标为暂不支持 - icbsp_tool/host_options.py:根 CMakeLists 的 icbsp-options 生成区(# 注释标记)、CMakePresets、quadspi.c 的方案 B 提前返回、.gitignore 合并 - selection:external_flash / optimization / gitignore 三个键;manifest:flash_chips、options、规则 qspi_params - integrate.py:--external-flash / --flash-chip / --qspi-prescaler / --opt / --vendor-os / --no-opt / --no-gitignore, launch.json 合并两个调试配置,--fix-ioc 按保存的选择检查;老宿主的 __dma_buffer_load 等价改写 - Web UI:建议横幅、外置 Flash / 编译优化 / 工程文件三节 - 测试:tests/test_flash.py(22 项),H750 夹具与快照,compile_test 支持用例 args / presets Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- docs/外置Flash.md:三种存放方式、启用 / 切换 / 烧录 / 调试、bootloader 状态码、镜像头、MPU 13~15 区、限制 - docs/接入指南.md:3.2 外置 Flash、编译优化与 .gitignore;参数表与常见问题 - docs/bsp_test/external_flash_2026-11-10.md:H750 + W25Q128 实板 H1~H10、30 min XIP 浸泡、A / B 各掉电 3 次、性能对比 - undo.md:勾选“小 Flash 型号的外置 Flash 支持”,待排期加 OCTOSPI、XIP 可选放置、EmberProbe 写 QSPI Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- H7 的 CubeMX 在 .ioc 不写 DataSize 时默认 4 位帧,BspSpi 按字节收发,HAL 的收发循环卡住;BMI088 的 SCK 上限 10 MHz - ioc.spi_instances 加 data_size / prescaler / kernel_hz;checks.run 接收设备列表,按 BMI088 所在总线算 SCK,超了就改预分频 - integrate.py 普通模式按保存的选择里的设备检查 - H750 夹具换成改好的 .ioc;test_flash 加 SpiRulesTest;compile_test h750_qspi 通过 - 文档:接入指南常见问题(4 位帧、BMI088 堆)、外置 Flash 实测记录补 SPI6 结论、软件断点偶发失败的说明 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- 选择键 flash_scripts(默认 true,--flash-scripts on|off 存回;--no-flash 只管这一次) - templates/vscode 拆出 tasks_flash / settings_flash(烧录任务与按钮),外置 Flash 再加 tasks_qspi / settings_qspi(RAM 运行、重烧 boot) - plan_vscode 按选项合并,VsCodeTaskButtons.tasks 按 task 去重、整个缺就整个加;关掉时不删宿主已有的,只提示 - Web UI:Flash/ 选项移到“工程文件”一节,显示会加哪些按钮;测试 3 项 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
You can see what changes in the undo.md
概述
把
phase2合入main,包含重构计划阶段 2~6 的全部成果(46 个提交,2026-11-06 ~ 2026-11-11):库正式改名为 ICBSP 并重排目录,补齐设备驱动与配置检查,文档整体重写,并新增一套宿主工程接入工具链(.ioc解析校验 → 生成板级代码 → 同步到宿主 → Web UI),以及外置 QSPI Flash 支持。改动规模:201 个文件,+13941 / −1722(docs/、templates/、tools/ 占一半以上)。
主要改动
阶段 2:改名、目录重排、命名统一(⚠️ 破坏性)
icbsp;配置宏、功能开关、实例清单、系列宏统一加ICBSP_前缀service/、device/拆子目录(device/motor、device/sensor、device/remote、device/actuator);包含路径只保留code/,一律写成#include "bsp/bsp_uart.hpp"这种形式get_,布尔用is_/has_;Online::is_online()返回bool;ImuData陀螺仪字段改为x/y/z;新增ICBSP_PI、DjiMotorTypeconfig_check.hpp,检查功能开关之间的依赖EventState默认树:sys_state → 总线实例 → 设备;Emm_V5、R9DS、BMI088 挂进默认树sys_task去掉开机 1 s 等待,串口卡死阈值下限取巡检周期Matrix::_data改为私有阶段 2~3:设备驱动
DmMotor:MIT、位置速度、速度三种模式;使能、失能、清错误、设零点;read_register()DmMotor支持 J4310 / J4340P / J8009P(型号参数表、峰值扭矩限幅、sync_ranges()),按 J4340P 说明书修正映射取整和故障态 3/4/5can_id要避开 0x01~0x0B 和 0xFE/0xFF/0x00(实板发现,已写进文档)DeviceBmi088:记录init()失败的位置(get_init_fail_count / get_init_fail_line);调度器启动后delay_ms()至少等满 N 毫秒阶段 3:测试与 UART 稳定性
.github/workflows/host-tests.yml)TxDiag::idle_kick_cnt和 ErrorCode 快照阶段 4:文档与规范
docs/code和代码子目录一一对应,架构图重画icbsp_unhandled_*、FDCAN Message RAM 与过滤器、时基优先级、编码器 ARR、newlib、BDMA.dma_buffer段两节;补充许可证说明(VQF SPDX、matrix 授权范围、厂商手册版权声明)阶段 5:宿主接入工具链(
tools/)tools/manifest.json:库侧清单,带读取自检.ioc解析与校验(ioc.py/checks.py/selection.py)generate.py:按.ioc和用户选择生成板级代码;模板加生成区(regions.py)init()、EXTI 转调sync.py:生成区与宿主同步;integrate.py新增--apply / --overwrite-edited / --iocintegrate.py机器接口:--json、--plan;.ioc自动修改和 CubeMX 无界面重新生成(--fix-ioc / --regenerate / --cubemx)tools/web_ui,用户选择存进宿主的icbsp_selection.jsontools/tests)阶段 6:外置 QSPI Flash 与 .ioc 规则
QSPI_RAM、QSPI_XIP;integrate.py和 Web UI 同步支持;附实测记录(含 USB CDC 复测)Flash/目录,同时在.vscode里加烧录任务和 Task Buttons.ioc新规则spi_8bit / spi_bmi088_speed(H750 上 BMI088 卡死的根因)checks.py会对未开启的.ioc报错main上的 WT102 驱动main上有一个phase2没有的提交eff9f5e 推送一个陀螺仪接收库,新增了code/device/device_wt102.{hpp,cpp}。两边改的不是同一批文件,git 合并不会冲突,但合并后会编译失败:CMakeLists.txt用GLOB_RECURSE收集源文件,WT102 会自动参与编译"bsp_series.hpp"、"bsp_uart.hpp"、"status.hpp"),而 phase2 的包含路径只有code/建议在本 PR 里一起处理:
code/device/sensor/"bsp/bsp_series.hpp"、"bsp/bsp_uart.hpp"、"service/system/status.hpp"ICBSP_前缀、是否挂进 EventState 默认树、是否登记到tools/manifest.json)对宿主工程的影响(升级须知)
#include改为相对code/的路径ICBSP_前缀,CMake 链接目标改为icbspget_*/is_*、is_online()返回值、ImuData字段tools/integrate.py --fix-ioc自动修正tools/integrate.py或tools/web_ui生成和同步板级代码测试
host-tests)通过tools/tests:快照测试 + 编译测试(mc02_full/mc02_alt/h750_qspi)通过