docs(screenlink): 屏板链路档去「说明」并瘦身,控制台档收编台架日志口

屏板链路设计说明.md -> 屏板链路设计.md(去档名「说明」,与 ADC 节拍 /
运行与自检记录两篇口径一致);控制台单写者日志设计说明.md 同改。
两档并存期间旧名引用 0 残留。

- 屏板链路 §3.2 台架日志口(RS232#1 / CN1 端子 / COM3)移入控制台档
  §3.4:日志口的接线属 UART5 控制台通道,不属屏板链路;屏板档只留
  「别去 CN1 找 USART1 端子」这句接线防错提示。
- 屏板链路 §7.1 由「根因账本 + 修复前后对比」改写为现状描述:延迟
  应答机制表 + 耗时分解表 + 两个计数口径 + 已知边界,40 行压到 24 行。
  顺带修正 §8 的错引:原指 `网络自愈架构设计.md` §8(实为「延后项」,
  不含 uiTask 内容)改为 §4.1 `net_reconcile_tick`。
- §9.1 增补长稳行(串口日志 2026-11-13 18:31 -> 2026-11-15 21:43,
  单次上电 51.2 h:rx=658262 ok=658262、crc/len/fmt/err 全 0、
  drop=7 仅启动期、kerr/abor/bad=0、全程 off=0);§9.2 销项三条
  (仪器项、2 h 长稳、len=7 观察项),新增「按键通路」一条——51.2 h
  日志 keys=0 kq=0 dfok=0 dfold=0,延迟应答在真机上从未执行过。
- 删除 sb_frame_b_build_logo() 及 SB_LOGO_MAGIC_* / SB_SCREEN_W/H
  与对应单测(TC-SBPROTO-022/023 全组、024c/024d),组帧入口只剩
  sb_frame_b_build_image()。sb_proto 单测 59 -> 45 条,45/45 通过。
- cfg_file.c 出厂模板三条中文字面量改 \uXXXX 转义:消除全量重编时的
  4 条 #870-D invalid multibyte character sequence,运行期字节不变,
  源码回到纯 ASCII(符合「字符串字面量必须纯 ASCII」)。

验证:keil-build 0 Error 0 Warning;sb_proto 45/45、sb_link 164/164;
pre-commit 48 钩子全 Passed;check_doc_links --sections-strict 通过。
This commit is contained in:
2026-11-15 21:51:24 +08:00
parent f5902bcc21
commit 1634088bd7
42 changed files with 131 additions and 259 deletions
+1 -1
View File
@@ -34,4 +34,4 @@ FreeRTOS/CMSIS-RTOS API**(见 `AGENTS.md`「平台约束」)。
- 架构全景:`docs/架构设计/项目架构总览.md`
- 启动顺序:`docs/架构设计/项目启动顺序管理.md`
- 配置引擎:`docs/子系统设计/配置文件设计.md`
- 日志:`docs/子系统设计/控制台单写者日志设计说明.md`、`docs/子系统设计/运行与自检记录设计.md`
- 日志:`docs/子系统设计/控制台单写者日志设计.md`、`docs/子系统设计/运行与自检记录设计.md`
+1 -1
View File
@@ -9,7 +9,7 @@
* 作者:王建锋
* 创建日期:2026-10-29
* 修改记录:
* 2026-10-29 王建锋 创建初始版本(映射表口径见 docs/子系统设计/屏板链路设计说明.md §6)
* 2026-10-29 王建锋 创建初始版本(映射表口径见 docs/子系统设计/屏板链路设计.md §6)
*
* 这张表为什么必须"自定":屏板源码(DTU-LCD LED_Printf)只规定了"位 → 灯号"的
* 物理口径(bit1~bit19 → ID 1~19,ID 0 电源灯硬件常亮、不看位,bit20~31 未使用),
+3 -3
View File
@@ -83,9 +83,9 @@ static const char s_doc_header[] =
"; ============================================================\r\n"
"; STM32F4-Base 通用配置文件\r\n"
"; 格式: INI (UTF-8 / CRLF),本文件为配置唯一来源\r\n"
"; - 以 ';' 或 '#' 开头的行为注释,保存时保留\r\n"
"; - 未知段/键保存时保留;缺失段/键保存时写回\r\n"
"; - 编辑后经 FTP 上传或设备端保存,设备 4s 沉降后自动重载\r\n"
"; - \u4ee5 ';' \u6216 '#' \u5f00\u5934\u7684\u884c\u4e3a\u6ce8\u91ca\uff0c\u4fdd\u5b58\u65f6\u4fdd\u7559\r\n"
"; - \u672a\u77e5\u6bb5/\u952e\u4fdd\u5b58\u65f6\u4fdd\u7559\uff1b\u7f3a\u5931\u6bb5/\u952e\u4fdd\u5b58\u65f6\u5199\u56de\r\n"
"; - \u7f16\u8f91\u540e\u7ecf FTP \u4e0a\u4f20\u6216\u8bbe\u5907\u7aef\u4fdd\u5b58\uff0c\u8bbe\u5907 4s \u6c89\u964d\u540e\u81ea\u52a8\u91cd\u8f7d\r\n"
"; ============================================================\r\n";
#define CFG_OUT_MAX 5120u /* 保存输出缓冲上限(经 cfg_store_alloc 取,见下方堆峰值预算) */
+2 -2
View File
@@ -88,7 +88,7 @@
### console_log(控制台单写者)
- 多任务的生产者 → **单写者消费者**,消除任务间日志行交错
- 设计详见 `docs/子系统设计/控制台单写者日志设计说明.md`
- 设计详见 `docs/子系统设计/控制台单写者日志设计.md`
### soe(SOE 事件顺序记录,SOE 记录)
@@ -113,6 +113,6 @@
## 相关文档
- `docs/子系统设计/控制台单写者日志设计说明.md`
- `docs/子系统设计/控制台单写者日志设计.md`
- `docs/子系统设计/运行与自检记录设计.md`
- FatFs 陷阱:`AGENTS.md`「平台约束」
+7 -7
View File
@@ -16,7 +16,7 @@
* 无 stall 日志,纯节奏性饥饿)。修复:发送故障后立即结束本轮
* drain 并进入 300ms 发送冷却(冷却期内 drain 直接让位主循环),
* 保证喂狗节奏 ≤ ~300ms。根治(把 USART1 改成只发不收)已于 2026-10-26
* 由用户裁定不做,本缓解即长期方案;机制详述 docs/子系统设计/控制台单写者日志设计说明.md §12。
* 由用户裁定不做,本缓解即长期方案;机制详述 docs/子系统设计/控制台单写者日志设计.md §12。
* 2026-10-02 王建锋 第 8b 轮加固:发送超时判据改用 DWT CYCCNT(时间源无关)。
* 台架第 8a 轮取证(见 docs/子系统设计/看门狗设计说明.md 2026-10-02 变更记录)定位到:defaultTask
* 冻结在 console 突发行内、无 STALL、复位为 IWDGRSTF。唯一自洽机理 =
@@ -40,7 +40,7 @@
* 故只可能是另一个写者在同一行内插入。机理 = 写者注册前(内核启动 ->
* default_task.c 的 dbg_console_writer_attach,中间隔着整段 storage_bring_up)
* 所有任务的整行都走 dbg_console_write_raw 逐字节轮询 USART1->DR,**零互斥**
* (docs/子系统设计/控制台单写者日志设计说明.md 在册 O1;20261012_B6 那次
* (docs/子系统设计/控制台单写者日志设计.md 在册 O1;20261012_B6 那次
* "st[art:" 同一形态)。修法 = con_tx_try_claim()/con_tx_release() 一对
* **非阻塞**所有权(只在几条指令的临界区里做 test-and-set,绝不把 7.8 ms
* 的发送包进临界区、绝不关中断、绝不等待);抢不到所有权的那条行**不丢**,
@@ -68,7 +68,7 @@
* 噪声沿使 RXNE 置位后无人读,下一个事件即锁存 ORE(ORE 只能靠"先读 SR
* 再读 DR"清除 ⇒ 永不自愈);引脚悬空只影响发生率,不是必要条件。
* 缓解措施与结论不变,仅改注释;机制详见
* docs/子系统设计/控制台单写者日志设计说明.md §12。
* docs/子系统设计/控制台单写者日志设计.md §12。
*/
#include "console_log.h"
@@ -104,7 +104,7 @@
* 换口只改这一段:句柄 / IRQn / 初始化函数。时钟宏随句柄走——UART5 在 APB1、
* USART1 在 APB2,别照抄;串口模式与波特率在 Src/usart.c 的 MX_*_Init 里,本模块不管。
* 控制台在 RS232#1/UART5(USART1 专用给屏板链路——700 kbaud 只有它 MCU 引脚直出)。
* 端口排布、台架端子与判据见 docs/子系统设计/屏板链路设计说明.md 的 §2 与 §3.2。 */
* 端口排布、台架端子与判据见 docs/子系统设计/屏板链路设计.md 的 §2 与 §3.2。 */
#define CON_UART huart5
#define CON_UART_IRQN UART5_IRQn
#define CON_UART_CLK_DISABLE() __HAL_RCC_UART5_CLK_DISABLE()
@@ -315,7 +315,7 @@ static HAL_StatusTypeDef con_tx_bounded(const uint8_t *p_buf, uint16_t len) {
* 返回值:CON_TX_HELD 已持有(发完必须 con_tx_release)/ CON_TX_BYPASS 放行且不记账
* / CON_TX_NO 别人正持有整行,调用方须让路
* 限定条件:任意上下文(内部只有一次几条指令的临界区,绝不睡眠、绝不长期关中断)
* 函数说明:三条规则各有硬理由,改动前请连读 docs/子系统设计/控制台单写者日志设计说明.md
* 函数说明:三条规则各有硬理由,改动前请连读 docs/子系统设计/控制台单写者日志设计.md
* 的「行级单一所有者」一节:
* ① IPSR != 0(异常/中断,含四个 Fault 的崩溃上报)-> **放行**:这些上下文不许阻塞,
* 且一发生就要复位,日志是唯一遗言,绝不允许在这里"让路"掉。已知残余(登记在同一
@@ -493,7 +493,7 @@ uint8_t dbg_console_writer_ready(void) {
* 重新初始化,故障时间被单块超时限定。
* ⚠ 2026-10-28 更正:原注释把根因写成"PA10 未接线 / 悬空",用户确认 PA10 一直是接线的;
* 充分条件是"RX 使能却不消费 DR",与引脚是否悬空无关
* (详见 docs/子系统设计/控制台单写者日志设计说明.md §12)。
* (详见 docs/子系统设计/控制台单写者日志设计.md §12)。
*/
static void con_uart_reinit(void) {
__NVIC_ClearPendingIRQ(CON_UART_IRQN);
@@ -798,7 +798,7 @@ uint32_t dbg_console_tx_fault(void) {
* 函数功能:已发生的发送块超时次数(诊断用)
* 返回值:块超时累计次数 uint32_t
* 限定条件:无(任意上下文可读,含 ISR)
* 函数说明:三本账分开(docs/子系统设计/控制台单写者日志设计说明.md §13-O2)——
* 函数说明:三本账分开(docs/子系统设计/控制台单写者日志设计.md §13-O2)——
* dbg_console_dropped() = **真没落地**的丢弃数(缓冲满丢的一行,或一个
* 没能确认送达而出环的块;[ERR] 行报的就是它);
* dbg_console_tx_fault() = 外设软复位**自愈次数**(语义不变);
+1 -1
View File
@@ -234,7 +234,7 @@ void protect_task(void *argument) {
/* 启动锚点行:控制台写者注册后首拍补打(2026-10-10 门控纪律,adcTask
* 首帧同款)。写者注册前 con_append 走无锁裸发,与 defaultTask 启动日志
* 逐字节交错——B6 台架实证:本行曾损坏为 "st[art: cycle=220ms elm=70"
* 致 /serial-boot-test 锚点 MISS(控制台单写者日志设计说明.md §3.4)。 */
* 致 /serial-boot-test 锚点 MISS(控制台单写者日志设计.md §3.4)。 */
if ((start_logged == 0u) && (dbg_console_writer_ready() != 0u)) {
DBG_INFO("protect task start: cycle=%ums elm=%u",
(unsigned)PROTECT_TASK_CYCLE_MS, (unsigned)PE_COUNT);
+2 -2
View File
@@ -1035,7 +1035,7 @@ static void ui_task_wait_net_ready(void) {
/*
* 函数功能:把屏板键号映射为 UI 键码
* 入口参数:board_key - 屏板帧 A 的 key 字节(1~10,语义见 docs/子系统设计/屏板链路设计说明.md §5)
* 入口参数:board_key - 屏板帧 A 的 key 字节(1~10,语义见 docs/子系统设计/屏板链路设计.md §5)
* 返回值:UI_KEY_* 之一;0 = 不映射(无键 / RESET / FACTORY / 屏板无物理入口的 5、6)
* 限定条件:只在 uiTask 上下文调用(ui_port_queue_key 的契约是输入子系统已初始化)
* 函数说明:1. 屏板 key_configs[] 只有 **7 项**,可达值仅 1/2/3/4/7/8/9——别按屏板 readme
@@ -1171,7 +1171,7 @@ void ui_task_func(void *argument) {
* "出键→即派即绘→组帧",sb_link_ms_tick() 在 ≤1 ms 内放行的那一答带的才是
* **按键之后**的新内容;旧顺序下按键召唤答的必然是按键前的旧帧,新内容
* 要等下一次召唤才带得出(平均 ~140 ms、最坏 280 ms,账本见
* docs/子系统设计/屏板链路设计说明.md §7.1)。
* docs/子系统设计/屏板链路设计.md §7.1)。
* "本轮画出来的就是本轮组进去的那一帧"的承诺因此覆盖到按键。
* 排在推流往返**之前**不变:那个往返最坏能等 ≈4 s(LCDMEM 应答 3204 B),
* 排在它后面会让屏板画面跟着网络一起卡(同一份显存、两个出口,出口不能互相拖)。