|
|
@@ -1,253 +1,204 @@
|
|
|
-# 项目长期备忘 — 孢子仪2.x 滑台/运动控制(Application_cbd_apm32f1)
|
|
|
-
|
|
|
-## 🔴 改动代码必须同步 Readme.md(用户硬性要求)
|
|
|
-- **只要动了任何源码,就必须把本次修改内容写进 `readme.md`**;没有该文件就自动创建。
|
|
|
-- `readme.md` 是**倒序更新日志**(最新在最上)+ 顶部专题的形式。
|
|
|
- 写专题时插到**文件最顶部**,并在对应日期条目下**追加一行索引**,不要动用户原有条目。
|
|
|
-- 用户明确说过"不用改了,把修改内容写入 Readme"——即**先记录、后决策**,
|
|
|
- 待确认项在文档里单列"已知未修",不要擅自改行为。
|
|
|
-- 用户 Readme 里长期有他自己未提交的改动 → **禁止整体重写**,只做插入。
|
|
|
-
|
|
|
-## 🔴 升级机制现状(2026-09-26 第五、六轮后,以此为准)
|
|
|
-- **升级只有一条入口**: `dtu_uart2.c` 收到远程 `update` 指令后,**在本线程直接调 `ymodem_ota(1,0)`**。
|
|
|
- **不再"置标志 + 重启"**——那条路要过 EasyFlash,参数一丢标志就没了(现场升级静默失效的主因)。
|
|
|
-- 历史上的 `Upgrade_Flag_Set/Clear`、`UPG_BKP_DR3/DR4` 宏、`upgrade_set`/`upgrade_clear`
|
|
|
- msh 命令、`hmi.c` 的 `hmi_update` 分支体、开机侧 ymodem 分支 **全部已被用户删除**(2026-09-26 核实)。
|
|
|
- ⚠️ 提到这些名字时先 grep 确认,别再照着旧记忆改。
|
|
|
-- 🔴 **`ymodem_ota.c:117` 有 `rt_console_set_device("uart2")`** —— 调试口被切成 ymodem 接收口。
|
|
|
- 此后**任何线程的 rt_kprintf / LOG 都会污染 ymodem 字节流**。所以升级分支内禁止 rt_kprintf
|
|
|
- (只能用 LOG_W,且必须在调用 ymodem_ota 之前打完)。
|
|
|
-- 🔴 **`DTU_UART_NAME` 就是 `"uart2"`**(dtu_uart2.h:14)—— DTU 通信与 ymodem 接收**同一个串口**。
|
|
|
- 进入 ymodem 前必须先停 uart2 上的发送源: `rt_timer_stop(timer_uart2)` +
|
|
|
- `rt_thread_delete(dtu_send_data)`,否则传输必被打断。
|
|
|
-- 升级前统一调 **`thread_stop_all_for_ota()`**(control.c,control.h 导出)停掉全部业务线程,详见下一节。
|
|
|
-- `syswatch` 看门狗无需处理: 喂狗靠 syswatch 线程每秒执行,OTA 期间照跑;且
|
|
|
- `syswatch_thread_switch_hook`(syswatch.c:286-288) 在切到 idle 时会清零计数,
|
|
|
- ymodem 阻塞会让出 CPU → 不会误判异常线程。
|
|
|
-- ⚠️ 遗留隐患: `hmi.c` 的 `iSave != FLASH_FLAG` 分支仍会把 flash/快照里残留的
|
|
|
- `update_flag=1` 恢复到 RAM,而 Control_Clear / Control_Check / thread_485play 会靠它 break
|
|
|
- → 会被误认为"有升级请求"而一开机就退出(不清扫/不恒温)。已告知用户,未擅自改。
|
|
|
-
|
|
|
-## 🔴 线程名与线程清理(2026-09-26,重要)
|
|
|
-- **`RT_NAME_MAX = 8`**(rtconfig.h:8)→ 内核**只存前 7 个字符**。实测撞名:
|
|
|
- `Control_Clear_thread_entry` 与 `Control_Check_thread_entry` 都变成 `Control`;
|
|
|
- `DTU_Uart_thread_send` 与 `DTU_Uart_thread_recv` 都变成 `DTU_Uar`
|
|
|
- —— 后者**就是执行升级的当前线程**。
|
|
|
- → **禁止用 `rt_thread_find(全名)` 操作线程**,可能删错甚至删掉自己。
|
|
|
-- 正确做法(`list_thread` 同款): 遍历 `rt_object_get_information(RT_Object_Class_Thread)->object_list`
|
|
|
- + `rt_list_for_each` + `rt_list_entry(node, struct rt_thread, list)` + **前缀匹配**
|
|
|
- (比较长度截到 RT_NAME_MAX-1)+ **显式跳过 `rt_thread_self()`**。
|
|
|
- ⚠️ `struct rt_thread` 的 rt_object 部分是**内联展开**(name/type/flags/list 在最前面),
|
|
|
- 没有 `struct rt_object parent;` 成员,所以 member 用 `list`。
|
|
|
-- **先收集到数组再删**(遍历中删节点会把链表走坏),遍历期间 `rt_enter_critical()`。
|
|
|
-- `thread_stop_all_for_ota()` 的保留名单: **syswatch(喂狗) / tshell / tidle / main**。
|
|
|
- 注意 `syswatch` 线程名走宏 `SYSWATCH_THREAD_NAME`,不是字面量。
|
|
|
-- 需要停的 17 个业务线程及其截断名,见 `.workbuddy/tools/ota_thread_stop_check.py` 的 [C] 项输出。
|
|
|
-- 停线程顺序: ① `thread_delete_adc()` 优雅退出(它可能持 ADC 设备锁, 强删会死锁)
|
|
|
- ② RAM 内置 `device_status.update_flag = 1`(**绝不落盘**)让带 break 的线程自己退
|
|
|
- ③ mdelay(300) ④ 收集 + 强删其余。
|
|
|
-
|
|
|
-## 升级标志 update_flag(2026-09-24 第八轮 —— 机制已于 09-26 废弃,留作历史)
|
|
|
-- 当年方案: 三通道 ① EasyFlash env ② param_a/b 快照 ③ RTC BKP_DR3(魔数 0x5AA5),
|
|
|
- 置位/清位调 `Upgrade_Flag_Set()` / `Upgrade_Flag_Clear()`。
|
|
|
-- ⚠️ 这套函数**现在已不存在**(定义被删)。若还要用三通道思路,需重新实现;
|
|
|
- 当前 `update_flag` 的唯一用途是"RAM 置 1 触发线程 break 退出",全程不写 flash。
|
|
|
-- 历史经验仍有价值: ① 单通道存标志必丢 → 至少双通道; ② `iSave != FLASH_FLAG` 分支
|
|
|
- **不许无条件清零 update_flag**;③ `param_unpack()` 整包覆盖后要把已置位的 flag OR 回去;
|
|
|
- ④ `ymodem_ota()` 成功失败都会 `rt_hw_cpu_reset()`,必须有失败上限防死循环。
|
|
|
-
|
|
|
-## 版本控制
|
|
|
-- 仓库根 = `D:\RT-ThreadStudio\workspace\IOT_CBD_BZY_CTRL`(本工程是子目录)。HEAD="3.7.13"。
|
|
|
-- 本机 git 不在 PATH, 用 `C:\Users\Administrator\.workbuddy\binaries\PortableGit\versions\1.2.0\cmd\git.exe`。
|
|
|
-- 工作区长期带**用户自己未提交的改动**(control.c/h、hmi.c、dtu_uart2.c、readme.md)。
|
|
|
- **禁止 git checkout 一把梭回退**, 会冲掉用户的活; 必须按 hunk 精确回退。
|
|
|
+# 项目长期备忘 — 孢子仪2.x 控制器(Application_cbd_apm32f1)
|
|
|
+
|
|
|
+## 🔴 硬性约定
|
|
|
+- **改了源码必须同步写 `readme.md`**(倒序更新日志,最新在最上;专题插到文件最顶部并在对应日期条目加一行索引)。
|
|
|
+ 用户 readme 常有自己未提交的改动 → **禁止整体重写,只做插入**。用户说"只分析不要改"时连 readme 都不要动。
|
|
|
+- 备份/临时文件**绝不能放工程树内任何 .c/.h**(含 .workbuddy/)→ CDT 全扫会 multiple definition。
|
|
|
+ 放 `C:\Users\Administrator\.workbuddy\backups\` 或改 `.c.bak`。
|
|
|
+- 版本号 2.42→2.46(2026-09-28 四批修复)→ **2.47**(2026-09-28 第五批:OTA 前关串口4/5)。
|
|
|
+ 改 `control.h` 的 `VERSION_HK/VERSION_HK_2000W/VERSION_ZP/VERSION_GK`(注意 `VERSION_HK_2000W`
|
|
|
+ 在 `#if TG_MODULE / JINGJIKUAN / QINGSAO_YUGUAQI / MATCH_DEVICE` 分支下有多份,只改生效那份)。
|
|
|
+
|
|
|
+## 生效配置(2026-09-28 核实)
|
|
|
+- 串口驱动只有 `drivers/drv_usart_v2.c`(`RT_USING_SERIAL_V1/X` 未定义,drv_usart.c/X.c 是死代码)。
|
|
|
+ **uart1=调试console、uart2=DTU(+RX DMA)、uart4=屏幕(+RX DMA)、uart5=485**。
|
|
|
+- RT_NAME_MAX=8(内核只存前 7 字符,线程名会撞)、TICK=1000、HEAP 开、TIMER_SOFT 开、WDT 5s 开、main 栈 4096。
|
|
|
+ 编译开关:MATCH_DEVICE 0、PCB_V1 1、LAMP_EN 0、UART_TEST_EN 0、SENSOR_EN 0。
|
|
|
+- 字段尺寸(改字符串写入前必查 control.h):csq/net/sim/gps/gps_state **仅 8 字节**,alarm_tg 12,
|
|
|
+ power/heat_power/voltage **16**(第四批从 8/8/6 扩,原值必溢出),voltage_sun 16,tempture/humidity 12,
|
|
|
+ fuse_voltage 32,lat/lng/stamp/imei/iccid/link_ip/deviceId/project 32,driver/driver_4g/mqttcfg2 64,
|
|
|
+ json_w_* 与 qianming/photolink 128。**全部字符串写入一律用 rt_snprintf 限长**。
|
|
|
+- ⚠️ `Device_Status_typedef` ≈**1746 字节**(更早的 1712/1592 数值均已作废)→ 栈上更不能放。
|
|
|
+ `coll_time` 已改成 `char coll_time[10][16]`(原 `const char*[10]` 存栈地址会悬垂),
|
|
|
+ 改后结构体无指针成员,但 `cJSON_CreateStringArray()` 要 `const char *const *`,
|
|
|
+ 二维数组**不能强转**,须用局部 `const char *ptr[2]` 适配。
|
|
|
+- 🔴 **平台/RTU 下发的 JSON 一律不可信**:dtu_uart2.c 顶部已有 `cj_getstr(obj,key,def)` /
|
|
|
+ `cj_str(item,def)` / `SET_STATUS_STR(dst,src)` 三个入口,新增代码不要再直接碰 `->valuestring`
|
|
|
+ (节点非 String 时恒为 NULL)。数字型字段缺省传 **"-1"** 而不是 ""("" 会 atoi 成 0 误进正常分支)。
|
|
|
+- `device_status` 唯一定义在 main.c;`system_status` 已收敛到 sys_monitor.c(2026-09-28)。
|
|
|
+ `serial_485` 已收敛到 dtu_uart2.c:72 唯一定义(2026-09-28,原 sht30_collect.c 有一份靠 -fcommon 合并)。
|
|
|
+
|
|
|
+## 🔴 编译级硬坑:局部变量绝不能叫 `p` / `timep`
|
|
|
+- `rtdbg.h:136-137` 在**文件作用域**定义了 `time_t timep;` 和 `struct tm *p;`(LOG_* 宏用它打时间戳)。
|
|
|
+ 任何函数里声明同名局部变量 `p` 会屏蔽它 → 报 `has no member named 'tm_year'`。
|
|
|
+ **2026-09-28 实测**:`sync_u8/sync_i8/sync_u16` 形参叫 `p` → 6 个 tm_* 成员各报一次。改名 `params` 解决。
|
|
|
+- 这两个是**非 static 的 tentative definition**,靠 `-fcommon` 合并 → 又一个 `-fno-common` 雷。
|
|
|
+
|
|
|
+## 升级(OTA)机制现状(2026-09-28 第五批后,以此为准)
|
|
|
+- **唯一入口**:`dtu_uart2.c` 收到 `update` → **本线程直接 `ymodem_ota(1,0)`**。不再"置标志+重启"。
|
|
|
+- `Upgrade_Flag_Set/Clear`、`UPG_BKP_DR3/DR4`、`upgrade_set/clear` msh 命令、`hmi.c` 的 hmi_update 分支、
|
|
|
+ 开机 ymodem 分支**已被用户删除**;提这些名字先 grep。
|
|
|
+- `ymodem_ota.c:117` 会 `rt_console_set_device("uart2")` → 升级分支内**禁止 rt_kprintf**(只 LOG_W,且要在调用前打完)。
|
|
|
+- `DTU_UART_NAME == "uart2"` → 进 ymodem 前必须停 `timer_uart2` + 删 `dtu_send_data`。
|
|
|
+- 执行顺序(**不能反**):`thread_stop_all_for_ota()` → `uart_stop_for_ota()` → `ymodem_ota(1,0)`。
|
|
|
+ 先停线程(没人再发数据)再关设备;反过来关设备的瞬间还有线程在写 tx fifo。
|
|
|
+- `thread_stop_all_for_ota()`(control.c/h):遍历 `rt_object_get_information(RT_Object_Class_Thread)`
|
|
|
+ 的 `object_list` + `rt_list_for_each` + `rt_list_entry(node, struct rt_thread, list)` + **前缀匹配**(截到
|
|
|
+ RT_NAME_MAX-1)+ 显式跳过 `rt_thread_self()` + **先收集到数组再删**(遍历中删会走坏链表)。
|
|
|
+ ⚠️ `struct rt_thread` 的 rt_object 是**内联展开**,member 用 `list`。
|
|
|
+ 🔴 **禁止 `rt_thread_find(全名)`**(名字截断会删错/删自己 —— 撞名实例:
|
|
|
+ `Control_Clear_`/`Control_Check_` 都是 `Control`,`DTU_Uart_thread_send/recv` 都是 `DTU_Uar`,
|
|
|
+ 后者就是执行升级的当前线程)。保留名单:syswatch/tshell/tidle/main。
|
|
|
+ 停线程顺序:① `thread_delete_adc()` 优雅退出(可能持 ADC 设备锁,强删死锁)
|
|
|
+ ② RAM 置 `device_status.update_flag=1`(**绝不落盘**)让带 break 的线程自己退 ③ mdelay(300) ④ 强删其余。
|
|
|
+- `uart_stop_for_ota()`(control.c/h,2026-09-28 新增):**升级前关 uart4(HMI屏) 与 uart5(485)**。
|
|
|
+ 流程 = ① 置 `g_hmi_port_closed=1` ② 若 console 正是 uart4 则 `rt_console_set_device("uart1")`
|
|
|
+ + `finsh_set_device("uart1")` ③ `ota_close_uart(serial/serial_485)` ④ 两个句柄置 NULL。
|
|
|
+ **必须在 `thread_stop_all_for_ota()` 之后调。**
|
|
|
+- 🔴 串口关闭的三个硬约束(下次改这块前必读):
|
|
|
+ ① **引用计数**:`rt_device_open` 每次 +1,`rt_device_close` 只在归 0 时才真调驱动 close。
|
|
|
+ uart4 可能被 HMI 业务 + console + finsh 同时持有(`rt_console_set_device`/`finsh_set_device`
|
|
|
+ 内部都是 open 新 + close 旧)→ **必须循环 close 到 ref_count==0**,单次 close 等于没关。
|
|
|
+ ② **置 NULL 挡不住 HardFault**:`rt_serial_close()` 会 `rt_free` 掉 rx/tx ringbuffer 并置 NULL,
|
|
|
+ 但 `dev` 指针本身仍非空;再 `rt_device_write` 会解引用已释放的 `serial_tx->activated` → HardFault。
|
|
|
+ → 必须有**显式标志** `g_hmi_port_closed`(hmi.h extern),`HMI_WRITE`/`send_raw_to_hmi` 第一行就判。
|
|
|
+ ③ `rt_device_set_rx_indicate(dev, RT_NULL)` 要在 close 前先摘,否则窗口期仍有回调触发。
|
|
|
+- `syswatch` 喂狗无需处理(OTA 期间照跑;切 idle 时 `syswatch_thread_switch_hook` 会清零计数)。
|
|
|
+- ⚠️ 遗留隐患:`hmi.c` 的 `iSave != FLASH_FLAG` 分支仍会把 flash 残留 `update_flag=1` 恢复到 RAM
|
|
|
+ → Control_Clear/Control_Check/thread_485play 靠它 break → 一开机就误退出。已告知用户,未擅改。
|
|
|
|
|
|
## 硬件口径
|
|
|
-- 脉冲脚 PC6 = TIM3_CH1(pwm3/CH1); DIR=PB15(CTR_RO_LIMIT), EN=PB14(HK_IO);
|
|
|
- 轴电源: X=ctr_lamp(1), Y=ctr_Collect_Fan, Z=ctr_swz。限位: X=PC13, Y=PB8(dir0), Z=PB9(dir1), 高=触发。
|
|
|
-- **三路电源互斥, 同时只准一个轴上电运动**(共用 PC6/PB14)。切换顺序固定"先开目标轴、再关另两轴"。
|
|
|
-- **驱动器有启动时间**: 上电/EN/DIR 建立后 ≥100ms 才能发脉冲, 否则起步丢步。
|
|
|
-- 发脉冲前先 pwm_stop(), 避免上电自检期吃到杂散脉冲。
|
|
|
-- Y 轴垂直带载(弹簧平衡, 肉眼无下滑), 但点位间 X/Z 移动必然使 Y 断电 → 转子重对齐(每次数十脉冲)。
|
|
|
-- TIM3 无 RCR(重复计数器), 只有 TIM1/TIM8 有 → 本芯片做不到"一次发 N 个脉冲"。
|
|
|
-- TIM3_IRQHandler 当前**未定义**(曾实现过计数方案已回退); 若开 BSP_USING_TIM 且用 TIM3, 必须合并同名入口。
|
|
|
-
|
|
|
-## 运动接口约定(改前必读)
|
|
|
-- `ctr_move(轴,方向,dis_,pulse)` = "定时开PWM"而非脉冲计数: dis_ 单位≈tick(ms)。
|
|
|
- **dis_>=8000 时每格 10ms, <8000 每格 1ms** —— 同数值跨门槛行程差 10 倍(撞机械极限的经典坑)。
|
|
|
- 返回 dis_(非实际行程)。起停调度延迟 → 相对往返必然累积偏差。
|
|
|
-- RT_TICK_PER_SECOND=1000。对焦/预对焦用 1ms 周期使 1 单位=1 脉冲; 复位/到位用 mapSpeed(50)=125us(8kHz)。
|
|
|
-- 所有滑台动作由 `slide_thread_entry` 串行执行, 靠 `slide_para.en_slide` 派发
|
|
|
- (1/2=X/Z移动, 3=X复位, 4=Z复位, 6=Y步进, 7=Y复位, 8=录制)。stop_move() 置 stop_flag=1 且不清零。
|
|
|
-- **en_slide=6 有 4 个派发点且 ydis 口径不统一**(脉冲数 vs tick): hmi.c 的 auto_focus_move_to /
|
|
|
- calibrate_move / Ctr_Mortor 走位(y_init_dis≈9000, ≥8000 档实测约 90s) / dtu_uart2.c 远程命令。
|
|
|
- 想只改其中一个必须加显式模式位(曾经的 y_pulse_mode 即如此, 已随回退删除)。
|
|
|
-- 🔴 **派发自死锁(2026-09-22 实修)**: 在 `slide_thread_entry` 内部调用的函数里, **绝不能**
|
|
|
- `en_slide=6` 后死等清零 —— 执行 case 6 的就是本线程, 会永久卡死(现象: 收到 focus 后整机无输出)。
|
|
|
- 现已抽出底层 `slide_y_step(dir,dis,pulse)`; `pf_move()` 用 `rt_thread_self()==g_slide_thread`
|
|
|
- 判断: 在滑台线程内直接调底层, 其它线程(如 hmi.c 的 Ctr_Mortor)仍走派发以保持串行。
|
|
|
-
|
|
|
-## 预对焦(Pre-Focus)策略 [2026-09-22 实装]
|
|
|
-现状: `FOCUS_STEP_EN=0`, 爬山式自动对焦**不启用**; 实际链路是
|
|
|
-**MCU 发 `mov_init_y/takephoto_done` → 工控机开录 → 下发 `record_start` → case 8 下行+回程 →
|
|
|
-发 `record_stop` → 工控机在视频流里挑最清晰帧**。
|
|
|
-- `PF_EN`(=1, control.h) 开关: 每个点位录制前先 `slide_pre_focus()`, 以 PF_STEP 下采样清晰度
|
|
|
- 找"上升沿", 回退 PF_HEADROOM 作录制起点 → 下行 3~5 秒即罩住焦区。
|
|
|
- 实现全在 control.c "预对焦"块: pf_request_focus / pf_move / pf_scan_down / slide_pre_focus /
|
|
|
- slide_set_record_travel + `g_record_dis_1/0` + `g_record_preroll`。
|
|
|
-- 两阶段搜索: ①向下 PF_SEARCH_LIMIT; ②失败则上退 PF_PHASE2_UP 再长距离重扫(应对"起点已在焦后
|
|
|
- 下降段"); 仍失败则**先退回进入时高度**再按加长行程兜底(否则净下行叠加会撞下限)。
|
|
|
-- `g_pf_busy` 必须: dtu_uart2.c 每收到 focus 就置 autotakepic=2 并发信号, 预对焦期间靠它在
|
|
|
- hmi.c 的 ==2 分支里挡掉这些帧, 否则旧状态机同时驱动 Y 轴。
|
|
|
-- 口径陷阱: 预对焦 1ms/格 → 1 单位=1 脉冲; hmi.c ==3 分支扣 PF_APPROACH_BACKOFF 后**仍须 ≥8000**。
|
|
|
-- PF 退出时恢复 `slide_para.pulse_period`(否则污染后续 X/Z 复位速度档)。
|
|
|
-- 🔴 **历史 bug(已修)**: 老 case 8 下行预启动 1500 / 回程硬编码 800 不对称 → 每点位净往下 700
|
|
|
- 单位(≈93 脉冲), 32 点位累计约 3000 脉冲单向爬行 —— "走着走着拍不到清晰位置"的主因。
|
|
|
- 现已两向共用 `g_record_preroll`, 另留 `PF_RETURN_BIAS_MS` 补偿实测偏差。
|
|
|
-- 待现场标定: PF_STEP / PF_SEARCH_LIMIT / PF_HEADROOM / PF_APPROACH_BACKOFF / PF_RISE_RATIO /
|
|
|
- PF_RECORD_MS_OK / PF_RETURN_BIAS_MS。
|
|
|
-
|
|
|
-## 点位间漂移(结构性, 未根治)
|
|
|
-- 一轮 32 点位内 Y 不复位, 每点位以上一点位落点为原点相对移动, 只在整轮开始(autotakepic==1/3)
|
|
|
- 复位一次 → 误差逐级累加; 点位间 X/Z 移动又必然使 Y 断电再上电。
|
|
|
-- **限位开关是唯一绝对基准**(无编码器)。表现: 越往后的点位画面越往 dir=1 偏, 实测一轮偏 2~3 秒行程。
|
|
|
-- 诊断钩子: hmi.c 的 `g_y_abs`, 每点位对焦完成后 LOG_I 打印绝对位置; 超 AF_ABS_DRIFT_LIMIT(=1200)
|
|
|
- 会 LOG_E, 但 `af_drift_over` 上报被 `#if 0` 关着。
|
|
|
-- **已知未修**: 注释称 g_y_abs 在整轮复位处清零, 但代码里没有该赋值 → 跨轮持续累积。
|
|
|
-
|
|
|
-## 录制流程(case 8)
|
|
|
-- 现状: 下行 `ctr_move(Y_,1,dis_1,133Hz档)` → 发 record_stop → `rt_thread_delay(200)` → 回程
|
|
|
- `ctr_move(Y_,0,dis_0,...)`。相对往返, 两向脉冲数不可能严格相等 → 每次留净偏差。
|
|
|
-- 回程 dir=0 是限位方向, ctr_move 对 Y 有两处限位保护: ①起始前读到限位 → 3 声鸣叫 + 不动;
|
|
|
- ②循环内读到 → 截断行程。另有 `stop_flag!=0` → 3 声鸣叫 + break。
|
|
|
- **鸣叫次数是判据**: 3 声=限位或急停, 无声=脉冲/周期问题。
|
|
|
-- `stop_move()` 调用点(dtu_uart2.c): 某下行命令(1079)、`xdis==0`(1135)、`led_off`(1217)。
|
|
|
- 平台发 led_off 或 movx:0 都可能打断录制回程。
|
|
|
-
|
|
|
-## 硬件计数方案(已回退, 备查) — 2026-09-21
|
|
|
-`ctr_move_pulse()`(TIM3 更新中断计数, 返回实际脉冲数)已实现并验证, 后因"回程时间不够"整体回退,
|
|
|
-**当前源码无此实现**。复用要点: 先 pwm_stop() 再开轴电源; EN/DIR 后等 ≥100ms; 三轴电源互斥
|
|
|
-顺序; case 6 四个派发点口径不同需显式模式位。
|
|
|
-回退做法: `git diff` 逐 hunk 分组, 只反向应用"含自己新增标记"的分组, 用户改动组跳过;
|
|
|
-纯新增块反向应用要连同换行一起删。
|
|
|
-
|
|
|
-## 构建系统约定(踩过坑)
|
|
|
-- Eclipse CDT managed build(RT-Thread Studio), 产物在 `Debug/`, sources.mk/subdir.mk 自动生成。
|
|
|
-- ⚠️ **绝不把 .c/.h 备份或临时副本留在工程树内任何目录(含 .workbuddy/)** —— CDT 扫描全部 .c/.h
|
|
|
- 且不跳点开头目录 → 链接期 multiple definition。备份放 `C:\Users\Administrator\.workbuddy\backups\`
|
|
|
- 或改扩展名 .c.bak。(2026-09-21 实际踩过)
|
|
|
-- `.cproject` 的 sourceEntries 已排除 `//.workbuddy`(共 110 项)。
|
|
|
-- 排 multiple definition 顺序: ①Debug/sources.mk 的 SUBDIRS ②工程树内同名 .c 副本 ③陈旧 .o。
|
|
|
-- 改完源码需 IDE 里 Refresh(F5) + Clean + Build。
|
|
|
-
|
|
|
-## 交付/验证环境
|
|
|
-- 本机无 arm-none-eabi 工具链, 无法本地编译。
|
|
|
-- 现成工具 `.workbuddy/tools/c_syntax_check.py`: 按标记切出改动块 + 最小桩声明, 用宿主 gcc
|
|
|
- (`D:\Strawberry\c\bin\gcc.exe`) 做 `-fsyntax-only -Wall -Wextra`。参数 `--func 起 止` /
|
|
|
- `--case 标记` / `--block 起 止`。中间文件 `.workbuddy/tmp_syn.txt` + `gcc -x c`, 跑完自删。
|
|
|
- **改了 control.h 的结构体/原型要同步脚本里的 STUB**。
|
|
|
-- 备份约定: `C:\Users\Administrator\.workbuddy\backups\`(工程外)。
|
|
|
-- 专用检查脚本(都在 `.workbuddy/tools/`, 宿主 gcc + python, 跑完自删中间文件):
|
|
|
- - `param_syn_check.py` — param_backup 模块 + control.h 真实结构体桩
|
|
|
- - `ef_key_audit.py` — EasyFlash key/字段错位、default_env_set 重复/缺失审计
|
|
|
- - `verify_fix.py` — device_status `-fno-common` 对照链接实验
|
|
|
- - `sizeof_probe.py` — 实测结构体大小(往线程栈放大对象前先量)
|
|
|
- - `degraded_boot_check.py` — flash 降级启动链路
|
|
|
- - `ota_direct_check.py` — update 分支(禁 rt_kprintf、停机、进 ymodem)
|
|
|
- - **`ota_thread_stop_check.py`** — ★含**线程覆盖性验证**: 从源码提取全部线程名,
|
|
|
- 按 RT_NAME_MAX=8 模拟截断+前缀匹配, 报告"漏网"线程。加新线程后跑一次即可确认被覆盖。
|
|
|
- - `upgrade_flag_check.py` — 已改写为"升级机制现状检查", 核心是守住
|
|
|
- **"函数删了但调用点还在"** 这类链接错误([B] 项)。
|
|
|
-- **函数被删时务必全局 grep 调用点** —— 2026-09-26 就踩到 `Upgrade_Flag_Clear()`
|
|
|
- 调用点还在而定义已删, 会 undefined reference。
|
|
|
-- `Debug/rtthread.map` 是旧构建产物(含已回退的 ctr_move_pulse), 不要拿来判当前源码状态。
|
|
|
-
|
|
|
-## device_status 全局唯一定义(2026-09-24 收敛)
|
|
|
-- **唯一真实定义在 `main.c`**。`control.h` 里有 `extern Device_Status_typedef device_status;`,
|
|
|
- 其余 .c(含 packages/syswatch.c)一律靠这个 extern, **不要再写第二份定义**。
|
|
|
-- 历史包袱: 原本 10 个 .c 各写一行 tentative definition, 靠 `-fcommon` 合并成 1592B COMMON 符号。
|
|
|
- 已实测: 该写法在 `-fno-common` 下直接 `multiple definition` 链接失败。
|
|
|
-- 引用 device_status 的 11 个 .c 全都 include control.h, 已核对; **新增 .c 若要用
|
|
|
- device_status, 必须 include control.h**。
|
|
|
-
|
|
|
-## EasyFlash env key 别名表(改参数前必读)
|
|
|
-key 名与 `device_status` 字段名**故意不一致**的历史别名(读写成对, 别"顺手改成一致"):
|
|
|
-
|
|
|
-| env key | 字段 | 含义 |
|
|
|
-|---|---|---|
|
|
|
-| `reboot_time` | `rebootcnt` | 启动次数 |
|
|
|
-| `stime` | `clt_time` | 收集时间 |
|
|
|
-| `jtime` | `heattime` | 加热时间 |
|
|
|
-| `env_t` / `env_h` | `tempture` / `humidity` | 环境温湿度 |
|
|
|
-| `platform` | `mqttcfg1` | 平台地址 |
|
|
|
-
|
|
|
-- 🔴 **`heatvalue` 是双语义字段**: 测报灯(dtype!=7)写/读 `jheat`(加热温度, 0~130);
|
|
|
- **孢子仪(dtype==7)写/读 `heatvalue`(培养温度, 10~50)**。开机已按 dtype 分支读取,
|
|
|
- 老设备回退 jheat。改这块前先看 hmi.c 的 dtype==7 分支。
|
|
|
-- `default_env_set` 在 `packages/EasyFlash-v4.1.0/src/ef_fal_port.c`, 53 项。
|
|
|
- 已修: `workmode`→`work_mode`、`shake_sw`→`shake_ws`(字段名是 shake_ws)、删重复 `run_sta`。
|
|
|
-- **已知未修(会改变行为, 等用户确认)**: `wind_sw`(风机开关)、`driver_compile`(BL 编译时间)
|
|
|
- 在 default_env_set 里有默认值, 但代码**从未 ef_get/ef_set** -> 重启不保存/读不到。
|
|
|
-- 审计工具 `.workbuddy/tools/ef_key_audit.py`: 查 key/字段错位、default_env_set 重复/缺失/未使用。
|
|
|
-
|
|
|
-## flash 损坏降级启动(2026-09-24 加固, 场景 A)
|
|
|
-- 🔴 **改了 RT-Thread 公共组件** `rt-thread/components/fal/samples/porting/fal_flash_sfud_port.c`。
|
|
|
- IDE 更新/重生成 FAL 组件时**可能被覆盖**, 升级后确认 `nor_flash0_is_ready()` 还在不在。
|
|
|
-- 原链路四处返回值被丢弃(probe / fal_init / ops.init / 分区校验只查 offset 不查 offset+len),
|
|
|
- flash 整体失效时一路"假装正常", 直到 `sfud_read(NULL,...)` 空指针 hard fault。
|
|
|
-- 加固要点: `nor_flash0_is_ready()` 对外暴露; init 失败时 **`nor_flash0.len = 0`**(让分区表
|
|
|
- 越界校验失败 -> fal_partition_find 返回 NULL, 把故障顶到上层); read/write/erase 显式判空。
|
|
|
-- 🔴 **`ef_fal_port.c` 的 `EF_ASSERT(part)` 已改成返回 `EF_ENV_INIT_FAILED`** ——
|
|
|
- 原来它是 `while(1)` 且 EF_DEBUG 不打印 -> 串口全无输出, 现场只见"通电没反应"。
|
|
|
-- `hmi.c Check_ParamConfig` 开头用 `nor_flash0_is_ready()` 门控: 不 ready 就**完全不调
|
|
|
- easyflash_init()**, 32 连写用 `if (ef_ok)` 跳过, 走 RAM 出厂值 + 三声短鸣。
|
|
|
-- `nor_flash0_is_ready()` 在 **init 没被调用过时返回 1**(保守), 否则会把"从未探测"
|
|
|
- 误判成"flash 损坏" -> 整机参数凭空回出厂, 后果比原 bug 更严重。
|
|
|
-- `param_backup.c` 的 `g_disabled`: 分区都找不到时 mark_dirty/flush 直接失败, 不重试。
|
|
|
-- 判据: 串口出现 `!! SPI FLASH NOT READY` = 已损坏并降级启动。
|
|
|
-
|
|
|
-## 🔴 FAL / flash 的坑(2026-09-24 断言死循环血的教训)
|
|
|
-- **绝不能把 `nor_flash0.len` 清 0** 来"让分区表失效"。
|
|
|
- `fal_partition.c` 的 `check_and_update_part_cache()` 一见 `offset >= len` 就 return -1
|
|
|
- → `fal_partition_init()` 整体失败 → fal.c `init_ok` 永远为 0
|
|
|
- → **任何 `fal_partition_find()` 都会撞第一行 `assert(init_ok)` 死循环**(全局杀伤,
|
|
|
- 连片内 bl/app 分区一起废)。想表达"这个设备坏了", 用 `nor_flash0_ready` 标志,
|
|
|
- 而不是改 len。
|
|
|
-- **`fal_partition_find()` 之前必须先查 `fal_init_check()`**。
|
|
|
- `fal_init_check()` 定义在 fal.c 但 **fal.h 没导出**(fal_rtt.c 里是 extern 现声明的),
|
|
|
- 已在 `applications/fal_cfg.h` 补 extern。
|
|
|
-- `fal_flash_init()`(fal_flash.c:45)**丢弃** `ops.init()` 返回值 —— 移植层 init()
|
|
|
- 返回 -1 并不会让 FAL 失败, 别指望靠返回值传递故障。
|
|
|
-- 降级分支里**别忘了给 param_backup_init() 之类"顺带调用"加闸门**:
|
|
|
- 实测就是它第一个撞上断言(hmi.c 的 `Check_ParamConfig` 里它不在 ef_ok 门控内)。
|
|
|
-- 时序现状(正确, 别乱改): `rt_hw_spi_init`=INIT_BOARD(1) < sfud probe=INIT_COMPONENT(4)
|
|
|
- < `fal_init`=INIT_APP(6), 都在 main 线程 `rt_components_init()` 里跑完才进 main()。
|
|
|
-
|
|
|
-## 栈的坑(2026-09-24 hard fault 血的教训)
|
|
|
-- **`sizeof(param_persist_t) = 820` 字节。任何线程栈上都不许放它**(哪怕只放一个)。
|
|
|
- 模块内部一律用 param_backup.c 的 `static param_persist_t g_work`(配 g_lock 保护);
|
|
|
- 调用方(如 hmi.c)需要持有就必须写 `static`。
|
|
|
-- 线程栈基线: `RT_MAIN_THREAD_STACK_SIZE` 已由 2048 提到 4096; 落盘线程栈 1024→2048。
|
|
|
- **`rt_kprintf`/`vsnprintf` 本身就要好几百字节栈**, 新开线程栈别低于 2048。
|
|
|
-- RT-Thread 的 mutex **支持同线程递归 take**(`ipc.c`: `if (mutex->owner == thread) mutex->hold++`),
|
|
|
- 所以"外层持锁 → 调内部又加锁的函数"是安全的, 不会死锁。
|
|
|
-- 排查同类 hard fault 的工具: `.workbuddy/tools/sizeof_probe.py`(量结构体实际字节数)。
|
|
|
- 判据: 局部变量字节数 > 线程栈的 60% 就要警惕。
|
|
|
-- EasyFlash 相关另用 `.workbuddy/tools/param_syn_check.py`(抽真实 Device_Status_typedef + 桩)。
|
|
|
-
|
|
|
-## 参数存储(EasyFlash V4.1.0 NG) [2026-09-24 加双分区备份]
|
|
|
-- ENV 区: FAL 分区 `easyflash` @ norflash0 偏移 0, 64KB(16×4KB sector)。**分区起始必须保持 0、
|
|
|
- 不得小于 64KB**, 否则老设备升级后 ENV 读不出来 -> 整机参数回出厂。
|
|
|
-- `ef_set_env_blob` 立即落 flash(NG 的 `ef_save_env` 是空实现), 无掉电保护窗口。
|
|
|
- 写一半复位 -> 该条被判 ENV_ERR_HDR 永久丢失; GC 中断 -> 整个 sector 被 format。
|
|
|
-- **`iSave`(==FLASH_FLAG 2)是整机唯一哨兵**, 它一丢就全量刷出厂值。别再引入第二个单点哨兵。
|
|
|
-- 🔴 **绝不能 memcpy 整个 `Device_Status_typedef` 做持久化** —— 里面有 `const char *coll_time[10]`
|
|
|
- 指针数组, 存进去的是无效地址。持久化只用 `param_persist_t`(param_backup.h)。
|
|
|
- 新增需持久化字段要同步改: 结构体 + `param_pack()` + `param_unpack()` + `param_write_back_to_easyflash()`。
|
|
|
-- 双备份区: `param_a`@128K / `param_b`@132K 各 4KB, ping-pong + CRC32 + seq 递增 + 回读校验。
|
|
|
-- 写入一律走 `param_mark_dirty()`(延迟 500ms 静默 + 内容比对 + 最小间隔 10s);
|
|
|
- 只有恢复出厂用 `param_flush_force()`。**屏幕每帧刷屏也会打 dirty, 没节流几天就写穿 4KB。**
|
|
|
-- `param_mark_dirty()` 故意不加锁(只写对齐字长变量, M3 上原子), 加锁会卡住业务线程 ~100ms。
|
|
|
-- 已知未修的确定性 bug: `dtu_uart2.c` parse_param_to_mcu 里把 `startBar` 写进了 key `sunBar`;
|
|
|
- `default_env_set` 有 `workmode` 但代码用 `work_mode`, 且缺 `cold_sw`/`heatvalue` 默认值。
|
|
|
-- syswatch 看门狗 5s 已启用(rtconfig.h:262)。flash GC / 固件备份的长阻塞有触发复位风险。
|
|
|
+- 脉冲 PC6=TIM3_CH1(pwm3/CH1);DIR=PB15(CTR_RO_LIMIT);EN=PB14(HK_IO)。
|
|
|
+ 轴电源 X=ctr_lamp(1)、Y=ctr_Collect_Fan、Z=ctr_swz。限位 X=PC13、Y=PB8(dir0)、Z=PB9(dir1),高=触发。
|
|
|
+- **三路电源互斥,同时只准一个轴运动**(共用 PC6/PB14);切换顺序"先开目标轴、再关另两轴"。
|
|
|
+- 驱动器上电/EN/DIR 后需 ≥100ms 才发脉冲;发脉冲前先 pwm_stop()。
|
|
|
+- Y 轴垂直带载;点位间 X/Z 移动必然使 Y 断电 → 转子重对齐(每次数十脉冲)。
|
|
|
+- TIM3 无 RCR → 做不到"一次发 N 个脉冲";TIM1/TIM8 才有。TIM3_IRQHandler 当前未定义。
|
|
|
+- `board.h` **必须同时**声明 `BSP_USING_PWMx` 和 `BSP_USING_PWMx_CHy`。
|
|
|
+ 只声明 PWM3/PWM8 时 `pwm_get_channel()` 得到 channel=0 → `stm32_hw_pwm_init` 的 4 个 if 全不成立 →
|
|
|
+ `HAL_TIM_PWM_ConfigChannel()` 一次都不调,PWM 靠 `board.c` 残留配置撑着(隐式耦合,改 CubeMX 就静默失效)。
|
|
|
+ 现值:PWM3_CH1(PC6 蜂鸣器/步进)、CH2/CH3/CH4(PB1 清洁刷),PWM8_CH2(PC7)/CH3(PC8)。
|
|
|
+
|
|
|
+## 运动接口约定
|
|
|
+- `ctr_move(轴,方向,dis_,pulse)` 是"定时开 PWM"不是脉冲计数;**dis_≥8000 每格 10ms,<8000 每格 1ms**
|
|
|
+ → 同数值跨门槛行程差 10 倍(撞机械极限的经典坑)。返回 dis_ 而非实际行程。
|
|
|
+- 复位/到位用 mapSpeed(50)=125us(8kHz);对焦/预对焦用 1ms 使 1 单位=1 脉冲。
|
|
|
+- 所有滑台动作由 `slide_thread_entry` 串行派发:`slide_para.en_slide`
|
|
|
+ 1/2=X/Z移动、3=X复位、4=Z复位、6=Y步进、7=Y复位、8=录制。`stop_move()` 置 stop_flag=1 且不清零。
|
|
|
+- 🔴 **派发自死锁**:在 slide 线程内调用的函数里绝不能 `en_slide=6` 后死等清零。
|
|
|
+ 已抽底层 `slide_y_step(dir,dis,pulse)`;`pf_move()` 用 `rt_thread_self()==g_slide_thread` 判断。
|
|
|
+- `en_slide=6` 有 4 个派发点且 ydis 口径不统一(脉冲 vs tick):hmi.c 的 auto_focus_move_to /
|
|
|
+ calibrate_move / Ctr_Mortor(y_init_dis≈9000) / dtu_uart2.c 远程命令。改单个必须加显式模式位。
|
|
|
+
|
|
|
+## 预对焦(Pre-Focus)
|
|
|
+- `FOCUS_STEP_EN=0`,爬山对焦未启用。实际链路:MCU 发 `mov_init_y/takephoto_done` → 工控机开录 →
|
|
|
+ 下发 `record_start` → case 8 下行+回程 → 发 `record_stop` → 工控机挑最清晰帧。
|
|
|
+- `PF_EN`(=1) 每点位录制前先 `slide_pre_focus()`:PF_STEP 下采样找清晰度上升沿,回退 PF_HEADROOM 作录制起点。
|
|
|
+ 实现在 control.c "预对焦"块:pf_request_focus/pf_move/pf_scan_down/slide_pre_focus/slide_set_record_travel
|
|
|
+ + `g_record_dis_1/0` + `g_record_preroll`。两阶段:①向下 PF_SEARCH_LIMIT;②失败上退 PF_PHASE2_UP 重扫;
|
|
|
+ 仍失败先退回进入高度再兜底(否则净下行叠加会撞下限)。
|
|
|
+- `g_pf_busy` 在 hmi.c 的 `autotakepic==2` 分支挡掉预对焦期间收到的 focus 帧。
|
|
|
+- hmi.c ==3 分支扣 PF_APPROACH_BACKOFF 后**仍须 ≥8000**;PF 退出要恢复 `slide_para.pulse_period`。
|
|
|
+- 🔴 历史 bug(已修):老 case 8 下行 1500 / 回程硬编码 800 不对称 → 每点位净下移 700 单位,
|
|
|
+ 32 点位累计约 3000 脉冲单向爬行。现两向共用 `g_record_preroll`,留 `PF_RETURN_BIAS_MS` 补偿。
|
|
|
+- 待现场标定:PF_STEP/SEARCH_LIMIT/HEADROOM/APPROACH_BACKOFF/RISE_RATIO/RECORD_MS_OK/RETURN_BIAS_MS。
|
|
|
+
|
|
|
+## 点位漂移 / 录制 case 8 / stop_move
|
|
|
+- 一轮 32 点位内 Y 不复位,只在整轮开始复位一次 → 误差累加;**限位开关是唯一绝对基准**(无编码器)。
|
|
|
+ 越靠后的点位画面越往 dir=1 偏,实测一轮偏 2~3 秒行程。
|
|
|
+ 诊断钩子 hmi.c 的 `g_y_abs`,超 AF_ABS_DRIFT_LIMIT(1200) LOG_E,上报被 `#if 0` 关着。
|
|
|
+ **已知未修**:注释称整轮复位处清零 `g_y_abs`,代码里没这行 → 跨轮累积。
|
|
|
+- case 8:下行 → record_stop → delay(200) → 回程。相对往返必然留净偏差,两向现共用 `g_record_preroll`。
|
|
|
+ 回程 dir=0 是限位方向,`ctr_move` 对 Y 有起始前/循环内两处限位保护。
|
|
|
+ **鸣叫次数是判据:3 声=限位或急停,无声=脉冲/周期问题**。
|
|
|
+- `stop_move()` 调用点:dtu_uart2.c 某下行命令、`xdis==0`、`led_off` → 平台指令可打断录制回程。
|
|
|
+
|
|
|
+## 参数存储(EasyFlash NG) + 双分区备份
|
|
|
+- ENV 区 `easyflash`@norflash0 偏移 0、128KB(**起始必须 0 且 ≥64KB**,否则老设备升级后参数回出厂)。
|
|
|
+- `ef_set_env_blob` 立即落 flash(NG 的 ef_save_env 是空实现),无掉电保护窗口。
|
|
|
+- **`iSave`(==FLASH_FLAG 2) 是整机唯一哨兵**,别引入第二个单点哨兵。
|
|
|
+- 持久化只用 `param_persist_t`(820B,**任何线程栈上都不许放**,模块内用 `static g_work` + g_lock);
|
|
|
+ 新增字段要同步改 结构体 + param_pack + param_unpack + param_write_back_to_easyflash。
|
|
|
+- 双备份 `param_a`@128K / `param_b`@132K 各 4KB,ping-pong + CRC32 + seq 递增 + 回读校验。
|
|
|
+ 写入一律 `param_mark_dirty()`(延迟 500ms + 比对 + 最小间隔 10s);只有恢复出厂用 `param_flush_force()`。
|
|
|
+- `param_mark_dirty()` 故意不加锁(只写对齐字长,M3 上原子)。
|
|
|
+- key↔字段历史别名(成对,别"顺手改成一致"):`reboot_time`↔rebootcnt、`stime`↔clt_time、
|
|
|
+ `jtime`↔heattime、`env_t`/`env_h`↔tempture/humidity、`platform`↔mqttcfg1。
|
|
|
+- 🔴 `heatvalue` 双语义:dtype!=7 读写 `jheat`(0~130),dtype==7 读写 `heatvalue`(10~50)。
|
|
|
+- 已知未修:`wind_sw`/`driver_compile` 在 default_env_set 有默认值但代码从不 ef_get/ef_set。
|
|
|
+
|
|
|
+## FAL / flash 降级启动
|
|
|
+- 🔴 **绝不能把 `nor_flash0.len` 清 0** 让分区表失效 → `fal_partition_find()` 撞 `assert(init_ok)`
|
|
|
+ 死循环(全局杀伤)。要表达"坏了"用 `nor_flash0_ready` 标志。
|
|
|
+- `fal_partition_find()` 前**必须先查 `fal_init_check()`**(fal.h 未导出,已在 applications/fal_cfg.h 补 extern)。
|
|
|
+- `fal_flash_init()` 丢弃 `ops.init()` 返回值,别指望靠返回值传故障。
|
|
|
+- 改过 `rt-thread/components/fal/samples/porting/fal_flash_sfud_port.c`(`nor_flash0_is_ready()`);
|
|
|
+ `ef_fal_port.c` 的 `EF_ASSERT(part)` 已改成返回 `EF_ENV_INIT_FAILED`。
|
|
|
+ **IDE 更新 FAL 组件可能被覆盖,升级后要确认还在**。
|
|
|
+- `nor_flash0_is_ready()` 在 init 没被调用过时返回 1(保守,否则会把"从未探测"误判成损坏)。
|
|
|
+- 判据:串口出现 `!! SPI FLASH NOT READY` = 已降级启动。
|
|
|
+- 时序:spi_init(INIT_BOARD) < sfud probe(INIT_COMPONENT) < fal_init(INIT_APP)。
|
|
|
+
|
|
|
+## 栈 / 并发 / 发送
|
|
|
+- `sizeof(param_persist_t)=820`,`Device_Status_typedef`≈1746 → 都不许上栈。
|
|
|
+- 线程栈基线:main 4096、DTU 4096、work_loop 2048、Control_Clear 2048、net_wait 2048、
|
|
|
+ sht30 两线程 **2048**(第四批从 1024 提上来,因 `sprintf("%.2f")` dtoa 峰值 500~800B 且 `TempCalculate()` 含 `log()`)、
|
|
|
+ **Control_Check / work_status_check / thread_485play 仍只有 1024**(待扩容)。
|
|
|
+- `HAL_Delay()` 在 drv_common.c 实现为 `HAL_GetTick()` 差值忙等。
|
|
|
+ ⚠️ **不能**改成 `rt_thread_mdelay()`:`hw_board_init()` 在调度器启动**之前**就调 `HAL_Init()`,那时永久挂起。
|
|
|
+- `dtu_write_json(char *json)`:发送**堆上** JSON 并自动 free(内部固定 `"%s"`)。
|
|
|
+ 栈/静态缓冲**不能**传进去。栈上缓冲用 `DTU_Write("%s", buf)`。
|
|
|
+- 🔴 **`DTU_Write()` 的锁覆盖全过程**(格式化→写串口→485 转发→日志)。`dtu_str` 是 static 共享缓冲,
|
|
|
+ 第四批已把锁提到 `va_start` 之前;原来只在 `rt_device_write` 前后加锁 → 并发时发出半截/混合 JSON。
|
|
|
+- 🔴 `DTU_Write`/`Uart5_Write` 都是变参函数,**绝不能把内容当格式串传**(平台下发含 `%s/%n` 会被当格式指令)。
|
|
|
+- `Uart5_Write` 有自己的 `uart5_write_mutex`(**不能**复用 `dtu_write_mutex`,会自死锁)。
|
|
|
+- `dtu_stop_send_thread()`:替代裸 `rt_thread_delete(dtu_send_data)`。
|
|
|
+ **`rt_thread_delete()` 不释放被删线程持有的 mutex** → owner 指向已销毁线程 → 之后所有 `DTU_Write()` 永久挂起。
|
|
|
+- 🔴 **本工程 `rt_mutex_control()` 是空实现**(ipc.c:1216 直接 return -RT_ERROR),
|
|
|
+ **`RT_IPC_CMD_RESET` 对 mutex 无效**。要"清锁"只能 `rt_mutex_detach` + `rt_mutex_init`。
|
|
|
+- `HMI_WRITE()` 已加 `hmi_write_mutex`(第三批);内部仍有 `rt_thread_mdelay` → **ISR/HARD_TIMER 禁止调用**。
|
|
|
+- RT-Thread mutex **支持同线程递归 take**;惰性 init mutex 必须包在 `rt_enter_critical()` 里。
|
|
|
+
|
|
|
+## 🔴 uart2 / uart5 接收链路(2026-09-28 第四批改为批量读)
|
|
|
+- **绝不能**再写 `rt_device_read(dev,-1,&ch,1)` 逐字节:115200bps = 11520 字节/秒 = 每秒上万次系统调用。
|
|
|
+- 现状:`rx_indicate`(`dtu_input`/`uart5_input`)只把 size 累加进 `dtu_rx_pending`/`uart5_rx_pending`
|
|
|
+ 并 release 信号量;接收线程 `rt_device_read(dev, 0, rx_blk, DTU_RX_BLK_SIZE=128)` 一次读 128 字节,
|
|
|
+ 再调公共 `dtu_feed_block()` 逐字节喂 lwjson。`dtu_rx_pending` **只作参考**,read 返回 0 就退回等信号量。
|
|
|
+- `lwjson_stream_parse()` 本身是单字节 API,这步省不掉;省的是系统调用。
|
|
|
+- uart2 用 `lwparser`,uart5 用**独立的 `lwparser_485`** —— 共用会互相破坏 parse_state/stack_pos。
|
|
|
+ (`MATCH_DEVICE=0` 时 uart5 线程不建,属休眠缺陷;一旦打开就是必现故障。)
|
|
|
+
|
|
|
+## 版本控制 / 构建 / 工具
|
|
|
+- 仓库根 = `D:\RT-ThreadStudio\workspace\IOT_CBD_BZY_CTRL`(本工程是子目录),HEAD 曾为 "3.7.13"。
|
|
|
+ git 不在 PATH,用 `C:\Users\Administrator\.workbuddy\binaries\PortableGit\versions\1.2.0\cmd\git.exe`。
|
|
|
+- 工作区长期带用户未提交改动(control.c/h、hmi.c、dtu_uart2.c、readme.md)→ **禁止 git checkout 一把梭**,
|
|
|
+ 必须 `git diff` 逐 hunk 精确回退。
|
|
|
+- Eclipse CDT managed build,`Debug/` 产物,sources.mk/subdir.mk 自动生成;改完需 IDE Refresh+Clean+Build。
|
|
|
+- `.cproject` 的 `sourceEntries/excluding` 已排除 `//applications/lwjson.c`、`//lwjson_debug.c` 与 `//.workbuddy`。
|
|
|
+ ⚠️ 改这里**必须 Refresh+Clean+Build**才生效。
|
|
|
+- 排 multiple definition:①Debug/sources.mk 的 SUBDIRS ②工程树内同名 .c 副本 ③陈旧 .o。
|
|
|
+- **本机无 arm-none-eabi,不能本地编译**。工具在 `.workbuddy/tools/`(宿主 gcc `D:\Strawberry\c\bin\gcc.exe` + python):
|
|
|
+ `c_syntax_check.py`(按标记切块 -fsyntax-only)、`verify_fix.py`、`param_syn_check.py`、`ef_key_audit.py`、
|
|
|
+ `sizeof_probe.py`、`degraded_boot_check.py`、**`ota_uart_close_check.py`(★第五批新增:A语法/B括号/C符号/D调用顺序)**、
|
|
|
+ `upgrade_flag_check.py`。改了 control.h 结构体/原型要同步脚本里的 STUB。
|
|
|
+ ⚠️ 新写这类脚本时:桩里要 `typedef struct rt_device *rt_device_t;`(只 typedef struct 不给别名会报 unknown type name)。
|
|
|
+- `Debug/rtthread.map` 是旧产物(含已回退的 ctr_move_pulse),别拿来判当前源码状态。
|
|
|
+- 函数被删时务必全局 grep 调用点(踩过 `Upgrade_Flag_Clear()` 定义删了调用还在 → undefined reference)。
|
|
|
+- 🔧 Bash 工具 PATH 有时坏(`dirname/ls: command not found`);PowerShell **不回传 stdout**。
|
|
|
+ 变通:让脚本自己把结果写文件,再用 Read 读(`ota_uart_close_check.py` 就是这么用的)。
|
|
|
+
|
|
|
+## 已回退/废弃备查
|
|
|
+- `ctr_move_pulse()`(TIM3 更新中断计数)曾实现并验证,因"回程时间不够"整体回退,**当前源码无此实现**。
|
|
|
+- 升级三通道标志机制(EasyFlash + 快照 + RTC BKP_DR3 魔数 0x5AA5)已废弃;
|
|
|
+ 当前 `update_flag` 唯一用途是"RAM 置 1 触发线程 break 退出",全程不写 flash。
|
|
|
+
|
|
|
+## 审计报告与修复进度
|
|
|
+- 2026-09-28 产出 `固件代码审计与优化报告_2026-09-28.md`(P0×4 / P1×18 / P2×15 / P3×8 / 待确认×6)。
|
|
|
+ 最高危:`UpLoad_Data()` 的 `DTU_Write(updata)` 格式串、平台 JSON 字段大面积未判空、`LOG_W("...%s...",ch)`、
|
|
|
+ HARD_TIMER 里调 HMI_WRITE、多处定长数组越界、DTU_Write 未配对 free。
|
|
|
+- 修复进度(2.42 → 2.46):一批 P0-1/2/3/4 + P1-2/4/15/16;二批 P1-1/3/5/8/18;
|
|
|
+ 三批 P1-6~14/17 + P2-1~5/10/13/15;四批 P2-6~9/11/12/14 + P3 全部
|
|
|
+ + 报告外的 DTU_Write 锁位置、Uart5_Write 格式串注入、board.h 补 CH 宏、接收批量读。第五批(2.47)= OTA 前关串口4/5。
|
|
|
+- **遗留未动**:`ymodem_ota`/`itoa` 隐式声明 warning、报告第六节 6 项待上机确认、
|
|
|
+ `hmi.c` 的 `iSave != FLASH_FLAG` 恢复 `update_flag`、`g_y_abs` 跨轮不清零、
|
|
|
+ Control_Check/work_status_check/thread_485play 线程栈仍 1024。
|