evanliu/mothercup
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
mothercup/mcm-ddc-ble/docs/开发日志.md

7.5 KiB
Raw Blame History

mcm-ddc-ble 开发日志

独立 BLE 工程：从 0x01000000 直接起跑（无 bootloader、无 OTA），用于在单镜像环境下 验证 BLE 功能与后续功能开发。

日期：2026-09-02

1. 工程创建（基于 SDK rdtss 例程）

1.1 选型

以 nations-tec/N32WB03x_SDK_V2.0.0/projects/n32wb03x_EVAL/ble/rdtss 为蓝本： BLE 原始数据透传服务（128-bit UUID，下行写 + 上行 notify），与 mcm-ddc-04 的自定义 GATT 透传服务（CLS）形态最接近，适合作为手机 APP 通信协议的载体。heart_rate 是标准 profile，不适合做数据通道。

1.2 移植方式

  • 整目录复制 src/、inc/、MDK-ARM/ 到 mcm-ddc-ble/，工程改名 mcm-ddc-ble， 输出 bin/mcm-ddc-ble.bin。
  • uvprojx/uvoptx 中 268+11 处 SDK 相对路径由 ..\..\..\..\..\ 重定向为 ..\..\nations-tec\N32WB03x_SDK_V2.0.0\（新工程深度不同）； 另有 11+3 处 ..\..\..\dfu\common 指向 SDK 的 projects/n32wb03x_EVAL/dfu/common。 nations-tec/ 只读，未做任何修改。
  • 只使用第一个 target N32WB03x（IROM 0x01000000/0x40000）；OTA_IMG_1/OTA_IMG_2 两个 target 未适配（其 after-build 脚本会写 SDK 目录），不要构建。

1.3 引脚核对（重点：避开 SWD）

  • SWD 调试管脚：SWCLK=PA4 / SWDIO=PA5，全工程无任何占用。
  • LED1=PB0、LED2=PA6（与 mcm-ddc-04、STB 板一致）。
  • USART1 透传通道：TX=PB6 / RX=PB7（AF4，115200 8N1），与我们板子一致。
  • 日志 LPUART：TX=PB1（NS_LOG）。
  • app_usart.h 里的 PIN_4/PIN_5 是被注释掉的 USART2 备选（PB4/PB5），无影响。

1.4 保 SWD：禁止睡眠

例程主循环会进 deep sleep，SWD 随之断开（readme 也提示需 RESET 时机烧录）。 在 main.c 主循环前调用 ns_sleep_lock_acquire() 永久锁睡眠，SWD 全程可调试； 代价是功耗偏高（仅调试阶段，后续做低功耗时再评估）。

1.5 构建

UV4 -b mcm-ddc-ble.uvprojx -t "N32WB03x"：0 Error / 0 Warning， Code=23340 RO-data=3352 RW-data=1876 ZI-data=6052，bin 28224B。

日期：2026-09-02

2. 接入 FreeRTOS + 点灯任务

2.1 内容

  • 内核：SDK 自带 FreeRTOS V9（middlewares/Third_Party/FreeRTOS），工程新增 FREERTOS 组： tasks/queue/list/timers.c + heap_4.c + port.c（RVDS/ARM_CM0），只加进 N32WB03x target。
  • inc/FreeRTOSConfig.h：从 mcm-ddc-04 移植，heap 缩为 8KB（本工程仅 3 个任务）； SVC/PendSV/SysTick 由 port 接管（宏映射），本工程无 n32wb03x_it.c，无重复定义问题。
  • main.c 任务化：
    • ble_schedule_task（512 字栈，优先级 2）：rwip_schedule() + 1ms 延时， 替代裸机 while 循环（rwip 只允许单上下文运行）。
    • led_task（128 字栈，优先级 1）：LED1(PB0) 每 500ms 翻转做运行指示； LED2(PA6) 仍由 app_ble.c 驱动作连接状态指示。
    • 睡眠保持锁定（deep sleep 与 RTOS tick 冲突，且保 SWD）。
  • 串口透传路径为事件驱动（usart_forward_to_ble_loop 由 profile 回调触发、 app_usart_tx_process 由 BLE 消息处理触发），rwip_schedule 进任务后行为不变。

2.2 踩坑记录

脚本往 uvprojx 写路径时 \t 被 Python 解释成制表符（Source\tasks.c → Source<TAB>asks.c）， Keil 报 cannot create command input file 'source tasks.__i'；另外 <FileName> 必须写纯文件名 （带路径会被 Keil 当成对象名，同样报此错）。修正后全量重建通过。

2.3 构建

0 Error / 0 Warning，Code=24736 RO-data=3352 RW-data=1964 ZI-data=14484； bin ≈ 27.4KB，RAM（RW+ZI）≈ 16.1KB / 48KB（含 8KB FreeRTOS heap）。

2.4 上板预期

LED1 每 500ms 闪烁；手机可搜到并连接 NS_RDTSS，连接后 LED2 亮； 串口（PB6/PB7，115200）与手机 BLE 互发透传。

日期：2026-09-02

3. 重链接到 APP1（0x01008000）+ Boot 联合整包

  • 为验证产线形态（Boot 跳转 → APP1），工程 IROM 从 0x01000000/0x40000 改为 0x01008000/0x38000（APP1 bank）。RAM 布局本来就是 SDK 的 0x20004000 起，无需动。
  • 构建 target N32WB03x 0E0W（map：Load Region Base 0x01008000，Max 0x38000）。
  • 打包：python tools/merge_image.py mcm-ddc-ble/MDK-ARM/bin/mcm-ddc-ble.bin caiic_ble_full → tools/out/caiic_ble_full.{hex,bin}（Boot 0x01000000 + 缺省 bootsetting 0x01004000
    • 本工程 0x01008000）。烧录：tools\flash_package.bat tools\out\caiic_ble_full.hex。
  • 若要恢复单跑（无 Boot）：Keil Target 里 IROM1 改回 0x01000000, 0x40000 即可。

日期：2026-09-02

4. 从 mcm-ddc-04 搬迁 CLI 框架 + UART 驱动

mcm-ddc-04 在 Boot 跳转路径下仍有问题，以本工程为基座并入其成熟组件。

4.1 搬入文件

  • bsp_usart.c/h：USART1（PB6/PB7，115200 8N1）printf 重定向（polling TX）+ DMA TX （CH1）+ RXDNE 中断字节队列 + TX 互斥锁；新增 bsp_usart_rx_inject()（任务上下文注入 RX 队列，供 BLE 下行喂 CLI）。
  • cli_core.c/h：命令表/分词/执行原样搬入；默认输出为双通道（UART DMA + BLE notify）。 命令集适配为 help/version/sysinfo/led；log（04 的主动打印系统）、bankinfo （依赖 OTA/dfu_layout）与 Ctrl+Z 未搬。
  • app_cli.c/h：独立 CLI 任务（栈 1024 字，优先级 3），提示符 caiic->，Tab 补全、 上下键历史（8 条）、四种行结束符全保留；新增 AppCli_InputBytes() 接 BLE 下行。
  • ble_up.c/h（新写）：CLI 应答的 BLE notify 上行。ke_msg 只允许在 BLE 调度任务上下文 运行，因此 CLI 任务只入队（512B 环形缓冲，满则丢），ble_up_poll() 挂在 ble_schedule_task 里按 20B/包发送，rdtss ntf cfm 回调 ble_up_on_cfm() 节流续发。
  • n32wb03x_it.c：USART1_IRQHandler 转发 + HardFault 异常栈帧打印（ARMv6-M 无 CFSR）。
  • app_version.h：V1.00.01。

4.2 拆除与改接

  • 移除 app_usart.c（原透传 FIFO 方案）与 ns_log_lpuart.c（占用 fputc，与 bsp_usart 的 printf 重定向冲突；NS_LOG_LPUART_ENABLE 置 0，NS_LOG 变空操作）。
  • rdtss 下行写特征 → AppCli_InputBytes()（原 app_usart_tx_fifo_enter）； ntf cfm → ble_up_on_cfm()（原 usart_forward_to_ble_loop）； rdtss_send_notify 的 ble_sending 引用随 app_usart 一并清除。
  • app_ble.c：连接/断开不再开关 usart DMA（CLI 常开）；APP_CUSTS_TEST_EVT 不再触发 usart 发送。
  • main.c：新增 VTOR 预置（0x80000000|0x01008000，BLE init 前 USART1 RX 中断需要； BLE init 后 VTOR 归 0 不动）、启动 banner（版本/时钟/广播名）、AppCli_Init()。
  • FreeRTOS heap 用 20KB（用户设定，保留）：RW+ZI≈27.4KB / 48KB 窗口。

4.3 踩坑：Keil 跨 target 同名组合并

从 target N32WB03x 的 USER 组删除 app_usart.c 后，构建仍把它编进链接——µVision 在 uvoptx 缺失/不同步时会把三个 target 的同名组文件清单合并。解决办法：三个 target 的 条目全部删除（OTA_IMG_1/2 反正不用）。验证方式：看 Objects/*.lnp 链接清单无残留。

4.4 构建与产物

0E/0W：Code=30536 RO-data=3504 RW-data=1960 ZI-data=26088。 整包：tools\out\caiic_ble_full.{hex,bin}（68344B，APP1 35576B）。

4.5 上板预期

串口（PB6/PB7，115200）：banner + caiic->，help/sysinfo/led 1 toggle 可用。 BLE：手机连 CAIIC-MCM-20260902，使能 notify 后向写特征发 help\r\n 应收到底层应答。