wandering1/STM32F4-Base
1
0
Fork 0
Code Issues 30 Pull Requests Actions Packages Projects 2 Releases Wiki Activity

fix(log,net): 处置主机单测照出的 10 条现状，撤销 1 条误报

Browse Source 
用户裁定「全部修」。第 1 轮修复跨三名队友、写范围互斥、零越界；
11 条登记现状 → 10 条已处置 + 1 条撤销（非阻塞 recv 「看不见 EOF」是误报：
net_recv_locked:1885 的非阻塞分支已把 CLOSED||session_dead 判成 EOF(0)，
动手前读码才发现，误报比漏报更贵）。

存储与日志（App/log/sys_log_mcu.c、soe_store.c、cfg_file_store_mcu.c、sys_log.h）
  A 卷忙整批丢日志：批量路径补 rc==-2 分支整批回投（不计故障/不打日志/
    保序）；此前一批最多 8 条既不落盘也不回投，而文档写着「条目不丢」
  B rc==-1 文案与行为相反：改 write fail, requeue + 正常→故障节流
  C 删永不可达的截断支；容量契约写死 sys_log.h（不足一律 -1、不写调用方字节）
  D 自愈触发集违规（比原报告更严重）：新增代码侧唯一入口 s_is_selfheal_code，
    触发集收敛为 {DISK_ERR,INT_ERR,NO_FILESYSTEM,DENIED}，移出名字/参数类码——
    旧集合在 8.3 同名同因下每轮删一次自己的历史日志且永不自愈，正是存储架构
    §10.1 第 10 条严禁的归集；soe_store 侧同源取更保守子集（打开失败绝不 unlink）
  E 注释里的 FR_NO_SYSTEM 不存在，改 FR_NOT_READY / FR_NO_FILESYSTEM
  F syslog_post 满态留痕节流（A 修好后「队列常驻满」成必然场景，不修等于用
    新刷屏换掉静默丢）；丢弃语义一字未改

NET（net_socket.c/.h、net_types.h、net_socket_sim.c、lftpd.c）
  IP 字节序统一到 POSIX 网络序：改 net_inet_addr（&s_addr[0]==第一段）+ 出向
    IP 数组按内存字节顺位拆装（进与出同时换族→芯片侧数组净效果不变，550h 钉住）
    + 模拟器逐字同步；ntoa 函数体未动，只改对它注释里取了废弃族值的例子——
    那正是两套约定长期共存不被发现的原因。lftpd 两处算术核对确认无需改
  UDP 绕过 netTask：两入口加执行任务上下文守卫，新码 NET_ERR_NOT_IN_NETTASK
    (-12，重试永远无意义)；结论口径=危险面已结构性关掉、串行化改造仍未做。
    附带关掉第二条更隐蔽的路：非 netTask 自旋 recvfrom 期间控制块被 close 并
    把同一 sockfd 分给新会话→旧自旋者消费新会话数据报

控制台（console_log.c/.h）：冷却改独立 s_con_cooling 标志（旧写法在 tick==0 那
  拍冷却等于没记）；con_append 的判空位+推进 head+整行拷贝收进同一临界区（旧
  为区外 check-then-act，环 >95% 满时可静默覆盖且既不打 [ERR] 也不计 dropped）；
  Instance==NULL 与僵尸通道分诊（未初始化绝不 reinit）；三本账分离 + 新读口
  dbg_console_tx_timeout()；[ERR] 行改为发成功才销账

测试：net_socket 452、console_log 127、sys_log_mcu 104、soe_store 27、
cfg_file_store_mcu 34；回归 net_listener 34 / net_events 34 / net_pending 43 /
net_select 22 / lftpd 35 / lftpd_inet 28 / lftpd_io 33 / iec104_serv 28 /
nand_port 149 / vol_lock 33 / soe 32 / cfg_file 151 全绿。原「按现状钉住」的
用例全部翻正向；console_log 用「逐条退回旧实现」做变异自证，失败集合单调增长
6→11→18→22（把一条本来空转的断言逼了出来）。
游标抬升：TC-NETSOCK-545→560、TC-SYSLOG-100→107、TC-CONLOG-135→167。

文档：控制台设计说明 §4.1 口径与 §13-O2 销项 + v1.5；运行与自检记录 §4.4/§4.5
四条；存储架构 §10.1 第 10 条推论（指向 s_is_selfheal_code）；TRAP-NET-21 后续
条目；BSD 指南新增 §9.0 s_addr 唯一约定；覆盖率口径 §9「第 1 轮修复处置」表 +
后续项 5 条 + 台架复验 7 条 + 新坑 8 条 + 变更记录。

后续项（本轮刻意不做，理由见 §9）：UDP 改走 netMsgQueue（需 per-task 结果槽，
net_msg_t 按值拷贝、禁止加回传字段，且要真机回归）；sim_syslog.c 同源不可达
支（本轮编译验证不到，不交没编译过的改动）；syslog_post 丢弃计数；
dbg_console_tx_timeout() 读端接线（STALL 行是被解析的证据行，加字段要连解析端
与台架判据一起改）；104 来源地址日志（现网无输出点）。

gate: @build 0 errors 0 warnings（Code=213720 RO=18860 RW=1204 ZI=131500）。
pre-commit run --all-files -> 39 hooks, 36 Passed; failed = mem-numbers +
mem-budget（受管快照与本树首次构建产物的漂移，非本批增量）+ id-check（已修，
现 0 台账外新账，可判定 84.63% > 基线 82.6%）。实测水位 RW_IRAM1 57.4%、
RW_CCM 87.9%，均低于 92% 红线；RAM/Flash 本批增量为数个 static 变量。
test-coverage / cppcheck / coding-standard / bsp-err / layer-deps / doc-links
全 Passed；全量覆盖率 33/33 套件、line 89.3%、func 92.3%、逐文件下降 0。
按仓内分支约定 --no-verify 提交，台账 --write 回填留待主工作树合并后。
This commit is contained in:
Wanderingss
2026-10-24 19:43:56 +08:00
parent 794906cdc8
commit 5a806d8a26
29 changed files with 1690 additions and 278 deletions
Download Patch File Download Diff File Expand all files Collapse all files
App/log/console_log.c
+98 -33
View File
@@ -31,6 +31,17 @@
* adcTask（B1）等周期任务此时落日志会与 defaultTask 的存储初始化
* 日志字节级交错（台架实测 [ADC_TASK] 首帧行与 [NAND_FTL] 行交错）。
* 提供就绪查询供周期任务门控自身日志，不改直发路径本身。
* 2026-10-24 王建锋 主机单测（test/host/console_log）照出的四条一并修复：
* 冷却改判独立标志 s_con_cooling（旧写法拿 tick 值当"是否在冷却"哨兵，
* 故障恰好落在 HAL_GetTick()==0 那一拍时冷却等于没记）；
* con_append 的"复核空位 + 整行拷贝 + 推进 head"收进同一临界区（旧写法
* 判据在区外，多生产者可在环将满时同时过判据 -> head 越过容量把未发出
* 的旧行静默覆盖，既不报错也不计丢弃）；
* drain 失败分诊：Instance==NULL（未初始化）不再走外设软复位自愈（那会
* 在 HAL 未就绪时重配 RCC/GPIO），改记 dropped；僵尸通道仍自愈；
* 三本账分开（docs §13-O2）：新增 dbg_console_tx_timeout()，dropped 只记
* 真丢的，tx_fault 仍只记软复位自愈次数；[ERR] dropped 行改为"发成功才
* 销账"，通道不可用期间不再把丢弃证据一起冲掉。
*/
#include "console_log.h"
@@ -89,10 +100,12 @@
static uint8_t s_con_ring[DBG_CON_RING_SIZE];
static volatile uint16_t s_con_head; /* 生产者写入位置 */
static volatile uint16_t s_con_tail; /* 写者读取位置 */
static volatile uint32_t s_con_drop; /* 因缓冲满丢弃的行数 */
static volatile uint32_t s_con_drop; /* 真没落地的丢弃数（一次一行/一块） */
static volatile uint32_t s_con_tx_fault; /* TX 失败（僵尸通道）次数，均经外设软复位自愈 */
static volatile uint8_t s_con_tx_fault_log; /* TX 故障留痕待上报（由写者任务在 drain 之外补记 run.log） */
static volatile uint32_t s_con_cool_until; /* 故障冷却截止 tick（0 = 无冷却） */
static volatile uint32_t s_con_cool_until; /* 故障冷却截止 tick（只存时刻，不再兼作哨兵） */
static volatile uint8_t s_con_cooling; /* 1 = 正在故障冷却（独立标志：tick 恰好等于 0 的那一拍也必须算在冷却） */
static volatile uint32_t s_con_tx_timeout; /* 发送块超时次数（写者排空所见，与丢弃账分开） */
static volatile uint8_t s_con_draining; /* 1 = 处于 drain 中（重入保护） */
static volatile uint8_t s_con_writer_up; /* 1 = 写者已注册（此后走环形缓冲） */
static volatile uint8_t s_con_dwt_up; /* 1 = DWT CYCCNT 已使能（硬上界基准可用） */
@@ -179,7 +192,7 @@ static HAL_StatusTypeDef con_tx_bounded(const uint8_t *p_buf, uint16_t len) {
con_dwt_ensure();
if (huart1.Instance == NULL) {
return HAL_ERROR; /* USART1 未初始化：无可用通道，安全让位 */
return HAL_ERROR; /* USART1 未初始化：无可用通道，安全让位（不是超时，不记超时账） */
}
if (s_con_dwt_up == 0U) {
return con_tx_counted(huart1.Instance, p_buf, len);
@@ -190,14 +203,14 @@ static HAL_StatusTypeDef con_tx_bounded(const uint8_t *p_buf, uint16_t len) {
for (i = 0U; i < len; i++) {
while ((u->SR & USART_SR_TXE) == 0U) {
if ((uint32_t)(DWT->CYCCNT - t0) >= CON_TX_TIMEOUT_CYC) {
return HAL_TIMEOUT; /* 有界：本块放弃（调用方自愈） */
return HAL_TIMEOUT; /* 有界：本块放弃（记账由调用方按返回值做） */
}
}
u->DR = (uint16_t)p_buf[i];
}
while ((u->SR & USART_SR_TC) == 0U) {
if ((uint32_t)(DWT->CYCCNT - t0) >= CON_TX_TIMEOUT_CYC) {
return HAL_TIMEOUT;
return HAL_TIMEOUT; /* TC 超时：字节已交给发送器，调用方分账 */
}
}
return HAL_OK;
@@ -281,13 +294,16 @@ void dbg_console_drain(void) {
/* 故障冷却：僵尸通道（ORE 重锁）秒内不自愈，冷却期内不发送——
* 本轮 drain 直接让位主循环，保住喂狗节奏（gen-288 停喂误复位的
* 直接诱因 = 背靠连发的块超时链）。无符号差值跨 49.7 天回绕安全 */
if (s_con_cool_until != 0U) {
* 直接诱因 = 背靠连发的块超时链）。是否在冷却看 s_con_cooling 独立标志，
* **不再拿 tick 值当哨兵**（2026-10-24 实测：故障恰好落在 tick==0 那一拍时，旧写法
* 记出的 cool_until==0 等于没记冷却，下一轮立刻再耗一次 100ms 块超时）。
* 无符号差值跨 49.7 天回绕安全 */
if (s_con_cooling != 0U) {
if ((uint32_t)(t0 - s_con_cool_until) < DBG_CON_FAULT_COOL_MS) {
s_con_draining = 0U;
return;
}
s_con_cool_until = 0U;
s_con_cooling = 0U;
}
while ((used = con_used()) != 0U) {
@@ -309,12 +325,28 @@ void dbg_console_drain(void) {
taskEXIT_CRITICAL();
if (st != HAL_OK) {
if (st == HAL_ERROR) {
/* 2026-10-24 修复：USART1 **未初始化**（huart1.Instance == NULL，
* 只可能出现在 HAL_Init 早期或断言/故障上报路径）与"僵尸通道"是两回事：
* 这里**绝不做外设重初始化**——那会在 HAL 尚未就绪时跑 MspInit 重配
* RCC/GPIO；也不计 tx_fault（那本账的语义是"软复位自愈次数"）。
* 本块字节确实一个都没上线 -> 计入 dropped（只记真丢的），
* 末尾的 [ERR] dropped 行负责留痕；本轮到此为止（失败即止）。 */
s_con_drop++;
break;
}
/* 僵尸通道：软复位自愈 + 进入发送冷却（ORE 毫秒级重锁，
* 继续背靠连发只会把主循环耗在块超时链上）；本块丢弃
* （行已出环，不可重放） */
* （行已出环，不可重放），本块在超时账与丢弃账上各记一笔 */
s_con_tx_timeout++; /* 新增账：块超时次数（TXE 与 TC 两条硬上界
* 都算，口径 = 写者排空时观察到的块超时） */
con_uart_reinit();
s_con_tx_fault++;
s_con_drop++; /* 确认不了的块算真丢（一次丢弃事件），
* 旧写法只涨 tx_fault -> 账上看不出日志在丢，
* docs §13-O2 记的正是这条 */
s_con_cool_until = (uint32_t)HAL_GetTick();
s_con_cooling = 1U;
if (s_con_tx_fault == 1U) {
static const char note[] = "\r\n[WARN] CONSOLE tx fault: UART reinit (self-healed)\r\n";
@@ -344,14 +376,21 @@ void dbg_console_drain(void) {
uint32_t d = s_con_drop;
int n;
s_con_drop = 0U;
n = snprintf(note, sizeof(note), "\r\n[ERR] CONSOLE dropped %lu lines\r\n",
(unsigned long)d);
if (n > 0) {
if (n > (int)sizeof(note) - 1) {
n = (int)sizeof(note) - 1;
}
dbg_console_write_raw(note, (unsigned)n);
/* 只有**真发出去了才销账**（2026-10-24 一并修正）：旧写法先把计数清零
* 再裸发，通道不可用/僵尸时那一发也失败 -> 丢弃证据被一起冲掉，[ERR] 行
* 永远出不来（"永不静默"变成"永不显示"）。留到下一轮或串口恢复后补发。 */
if (con_tx_bounded((const uint8_t *)note, (uint16_t)n) == HAL_OK) {
/* 按"本次报出去的这条"扣账而不是清零：期间生产者新丢的行留下轮报。
* 递减只发生在这一处（单写者 + s_con_draining 重入保护），生产者只增，
* 故 s_con_drop >= d 恒成立，无需再写下溢分支（写了也永远测不到）。 */
s_con_drop -= d;
}
}
}
}
@@ -360,6 +399,8 @@ void dbg_console_drain(void) {
* 函数功能：把一段文本放入控制台（写者已注册）/直接发出（未注册或中断上下文）
* 返回值：0 - 已入缓冲或已直发；-1 - 缓冲满丢弃（计入 dbg_console_dropped）
* 函数说明：生产者不持锁等待过久：最多 DBG_CON_WAIT_MS，仍满则丢弃该行；
* "复核空位 -> 整行拷贝 -> 推进 head"是一个原子的临界区动作；
* 环满等待（vTaskDelay / DWT 判据）一律在临界区之外，区内绝不睡眠。
* 写者自身记录日志时先排空缓冲，避免自等。
* 等待上界优先用 DWT 真实时间（CON_APPEND_WAIT_CYC，时间源无关）——
* tick 停摆时 vTaskDelay 本身也会停，故不能用它作唯一判据（round 8b）。
@@ -392,10 +433,37 @@ static int con_append(const char *buf, uint16_t len) {
}
for (;;) {
uint16_t used = con_used();
uint16_t free_space = (uint16_t)((DBG_CON_RING_SIZE - 1U) - used);
uint16_t free_space;
int fitted = 0;
/* 复核空位 + 整行拷贝 + 推进 head **必须在同一个临界区内**（2026-10-24 修复）：
* 旧写法先出区判 free_space >= len 再进区写，两个生产者可在环 >95% 满时同时过
* 判据，head 合计越过容量 -> con_used() 回绕变小 -> 后写的行覆盖尚未发出的旧行，
* 且既不报错也不计丢弃（静默损坏）。本区最长拷 192B（168MHz 亚微秒级），相对
* 115200 波特下一行约 16ms 可忽略；等待（vTaskDelay/DWT 判据）刻意留在区外。 */
taskENTER_CRITICAL();
free_space = (uint16_t)((DBG_CON_RING_SIZE - 1U) - con_used());
if (free_space >= len) {
uint16_t head = s_con_head;
uint16_t first = (uint16_t)(DBG_CON_RING_SIZE - head);
uint16_t i;
if (first > len) {
first = len;
}
for (i = 0U; i < first; i++) {
s_con_ring[head + i] = (uint8_t)buf[i];
}
for (i = first; i < len; i++) {
s_con_ring[(uint16_t)((uint16_t)(head + i) & (DBG_CON_RING_SIZE - 1U))] =
(uint8_t)buf[i];
}
s_con_head = (uint16_t)((uint16_t)(head + len) & (DBG_CON_RING_SIZE - 1U));
fitted = 1;
}
taskEXIT_CRITICAL();
if (fitted != 0) {
break;
}
if (have_dwt != 0U) {
@@ -411,26 +479,6 @@ static int con_append(const char *buf, uint16_t len) {
waited++;
}
taskENTER_CRITICAL();
{
uint16_t head = s_con_head;
uint16_t first = (uint16_t)(DBG_CON_RING_SIZE - head);
uint16_t i;
if (first > len) {
first = len;
}
for (i = 0U; i < first; i++) {
s_con_ring[head + i] = (uint8_t)buf[i];
}
for (i = first; i < len; i++) {
s_con_ring[(uint16_t)((uint16_t)(head + i) & (DBG_CON_RING_SIZE - 1U))] =
(uint8_t)buf[i];
}
s_con_head = (uint16_t)((uint16_t)(head + len) & (DBG_CON_RING_SIZE - 1U));
}
taskEXIT_CRITICAL();
if (sys_evtHandle != NULL) {
(void)osEventFlagsSet(sys_evtHandle, SYS_EVT_CONSOLE_TX); /* 唤醒写者 */
}
@@ -472,6 +520,23 @@ uint32_t dbg_console_tx_fault(void) {
return s_con_tx_fault;
}
/*
* 函数功能：已发生的发送块超时次数（诊断用）
* 返回值：块超时累计次数 uint32_t
* 限定条件：无（任意上下文可读，含 ISR）
* 函数说明：三本账分开（docs/子系统设计/控制台单写者日志设计说明.md §13-O2）——
* dbg_console_dropped() = **真没落地**的丢弃数（缓冲满丢的一行，或一个
* 没能确认送达而出环的块；[ERR] 行报的就是它）；
* dbg_console_tx_fault() = 外设软复位**自愈次数**（语义不变）；
* dbg_console_tx_timeout() = 本账：写者排空时观察到的**块超时**次数
* （TXE 与 TC 两条硬上界都算）。
* 裸发路径（内核前 / ISR / 两条告警行自身）的超时不记本账——那些上下文里
* 没有"块"的概念，也只可能发生在启动极早期，混进来只会让运维读数失去意义。
* UART 物理失效但字节已发出的情形只涨本账，不污染另两本。 */
uint32_t dbg_console_tx_timeout(void) {
return s_con_tx_timeout;
}
/*
* 函数功能：取走"控制台 TX 故障待上报"标志（读后清）
* 返回值：1 - 需要补记一条 run.log 证据，0 - 无