90cc9a7d99
把 IEC104 从模拟器端整体搬到板端:协议栈原先由独立 iec104Task 驱动, 现在改为 netTask 单 owner 的 threadless 驱动,退役独立任务。 驱动与后端: - 新增 iec104_net_mcu.c/.h,实现 IEC104_Net.h 的 11 个 ABI 函数, 用槽表加单调句柄映射 net_socket 的单 fd 模型;CLIENT 拆除只走 net_drop_conn_locked,绝不 net_close 监听 fd。 - net_socket 增 5 个 owner-only 接口(net_accept_locked、 net_drop_conn_locked、net_pending_bytes、net_send_try、 net_mono_now_ms)。 - iec104_serv.c 重写为 iec104_serv_net_tick(),在 netTask 1ms 主循环 里驱动 core;无 osDelay/阻塞调用,喂狗是第一句。 - Src/freertos.c 删除 iec104Task 三件套,对应栈水位探针表项同步删除。 内存:目标板 192KB SRAM 装不下 vendor 默认容量档,按实测裁剪到 skeleton 档(TCP 缓冲、业务池、SOE 256->128、值槽密集化), RW_IRAM1 118,408 B / 90.3%,留 2,178 B 余量。 台架修复(只在真硬件暴露): - SNTP s_ctx.fd 零初始化后为 0,而 net fd 0 是合法槽位下标, 首次代次变化时误 net_close(0) 关掉 ftpTask 的监听槽,导致 104 连接被 FTP 的 220 banner 抢走;改为显式 .fd = -1。 - Accept 幂等:单 fd 模型下 vendor 每轮重试 Accept 会拿到同一 fd, 后端改为会话在役时返 WOULD_BLOCK,Close 不再清槽。 验证: - Keil 全量重建 0 error 0 warning,uvprojx 零抖动。 - 模拟器真实 TCP 13/13、transport 10/10。 - netmcu 后端单测 13/13(新增 N12)。 - 台架 serial-boot-test required 全中;板端 2404 总召 129 帧收到 59 遥信(53 有源、全 IV)+ 16 双点 + 30 遥测(PT1 三相非零、 UN/频率/温度按未标定置 IV)、遥控选择执行全否定、校时 COT 7。 - 期间顺带修正 UI 漂移自检文案、.serialtest required 陈旧项、 coding-standard 对 vendor 与外部 ABI 名字的排除口径。
119 lines
10 KiB
Markdown
119 lines
10 KiB
Markdown
# App/log/ — 日志子系统
|
||
|
||
> 两类日志:**持久化运行日志**(`sys_log`,落 NAND)与**控制台日志**(`console_log`,走串口)。
|
||
> 两者都遵循**单写者**模型,避免多任务交错输出。
|
||
|
||
## 文件一览
|
||
|
||
| 文件 | 作用 |
|
||
|---|---|
|
||
| `sys_log.h` | **日志接口(平台无关)**:定长 64B 记录,七类各一个 `/log` 文件(run / selftest / accid / alarm / start / oper / yk)|
|
||
| `sys_log_mcu.c` | `sys_log` 的 MCU 端后端实现(NAND + FatFs) |
|
||
| `console_log.c/h` | **控制台单写者日志**:多任务日志经队列汇入唯一写者,避免串口输出交错 |
|
||
| `soe_rec.c/h` | **SOE 记录纯编解码**:64B 定长记录(CP56Time2a 时标 + 类型 + 元件号 + 单调序号 + 值 + sum8 撕裂校验),零 I/O 零 OS 依赖,主机单测覆盖 |
|
||
| `soe_store.c/h` | **SOE 落盘胶水**:`/log/soe.log`,protectTask 投递(零文件系统)→ defaultTask 排空落盘 |
|
||
|
||
## 关键机制
|
||
|
||
### syslog(运行/自检记录)
|
||
|
||
- **唯一写者 = defaultTask**;其它任务只投递,不直接写盘
|
||
- **单记录定长 64 B**,循环写;待机页可显示记录
|
||
- **内核启动前的日志**走**无锁静态缓冲** `s_preboot[8]` 暂存(因为内核启动前不能建队列),
|
||
内核启动后由 `syslog_drain` 惰性创建真队列并排空
|
||
- ⚠️ 写盘必须校验 `f_write` 返回的**字节数**(该 FatFs 移植在簇分配失败时返回 `FR_OK` + 短写,
|
||
不报错误码);追加写必须 `FA_WRITE|FA_OPEN_APPEND`(`FA_OPEN_APPEND` 单独用**不含写位**)
|
||
- **清除记录 = 请求 / 落地分离**:非写者上下文(uiTask 等)只能 `syslog_request_clear(id)`
|
||
置一个标志(零盘触点、零卷锁),真正的 `f_unlink` 在 **defaultTask** 的 `syslog_drain()`
|
||
**尾部**执行——顺序也是判据的一部分:排在条目排空之后,否则本轮刚排空的旧记录会被
|
||
写回去、`syslog_count()` 不归零。结果读 `syslog_clear_state(id)`
|
||
(`NONE/OK/WAIT/FAIL`),事实复核读 `syslog_count()`。
|
||
落地函数 `syslog_clear_apply(id)` 是 MCU 后端专属(模拟器不实现 → 共享代码误调在
|
||
链接期就报错):卷锁一律 try,卷占用返 -1 且**不动原文件**;幂等只认 `FR_NO_FILE`,
|
||
`FR_NO_PATH` 如实返 -1 且**不做任何卷级动作**(不补目录、不重格式化)
|
||
- 删除的作用域 = 上表七个记录文件(`syslog_request_clear(id)` 逐 id 独立请求);取证文件
|
||
`wdev.log` 与 `soe.log` 各有各的属主与通道,不在本 API 作用域,想清它们要另开 API。
|
||
清除成功会往**操作记录**里落一条 `clear <文件>`——但清 `oper.log` 自己时**刻意不投**,
|
||
否则"我清除了记录"这条会把刚删空的文件又写成 1 条,直接砸掉「删除后 `syslog_count()`
|
||
归零」这条判据(`TC-SYSLOG-133b` 钉住)
|
||
- ⚠ 宿主后端(`simulator/sim/sim_syslog.c`)与 MCU 端**判据相同、时序不同**:模拟器单线程,
|
||
七类对应工作目录下七份宿主文件(`sim_accid.log` 等),`syslog_post_quiet()` 在本端
|
||
等价于 `syslog_post()`(宿主进程没有那条栈硬线,也没有队列与丢弃);
|
||
`syslog_request_clear()` 调用内就删完了,因此 `WAIT` 态在模拟器上永不出现
|
||
(同 `syslog_post` 在两端"有队列 / 直写无队列"的差异)
|
||
|
||
### 五类记录与「记录类型 = 日志 ID」(道F task-10,2026-10-26;task-11 记录 5 页按此做,2026-10-28 五页已落地)
|
||
|
||
**决策一:记录类型就是 `syslog_id_t` 本身,一类记录 = `/log` 下一个严格 8.3 短名的文件。**
|
||
64B 定长记录体里**没有类型字段位**:`[0..18]` 时标 / `[19]` 空格 / `[20..29]` epoch /
|
||
`[30]` 空格 / `[31..58]` 描述 / 尾部补零,这个布局被 UI 记录页与主机解码工具按**固定偏移**
|
||
读了了很久(run.log / selftest.log 是既有文件,既有读者)。塞类型字节要么挪走 epoch
|
||
(上电/重启分类就断),要么挪走描述(屏上少字),且两端读者同批改——所以
|
||
"这条记录是什么类型"由**它在哪个文件里**回答。`TC-SYSLOG-136` 把这条钉成机器断言:
|
||
同一条内容在七类之间逐字节相同,记录体不编码类型。
|
||
|
||
**决策二:不动 `soe_type_t`(二进制 SOE 通道保持现有 8 型)。** 加 SOE 类型必须同步 UI 侧
|
||
`ui_w_soe.c` 的类型名表(那是另一位队友的写域),而 SOE 页与这五页本就是两套读者
|
||
(二进制解码器 vs 文本列表)。**别把新类型顺手加进 SOE**:那会同时造出
|
||
"同一个事件两个真源"。
|
||
|
||
| 记录 | 日志 ID / 文件 | 容量上限 | 写入点 | 触发判据 |
|
||
|---|---|---|---|---|
|
||
| 事故 | `SYSLOG_ACCIDENT` / `accid.log` | 512 | `App/task/protect_task.c:188` | `asserted` 上升沿**且**该元件跳闸投退项 = 1 |
|
||
| 保护告警 | `SYSLOG_ALARM` / `alarm.log` | 1024 | 同文件 `191` | `asserted` 上升沿**且**跳闸投退项 = 0 或该元件无此项 |
|
||
| 保护启动 | `SYSLOG_START` / `start.log` | 1024 | 同文件 `183` | `picked` 上升沿(越限电平,早于/等于动作) |
|
||
| 操作 | `SYSLOG_OPER` / `oper.log` | 512 | `App/task/default_task.c`(`default_task_func()`,`settings saved`)、`App/log/sys_log_mcu.c`(`s_clear_service()`,清除记录成功)、`App/task/ui_task.c`(`ui_task_maint_oper_note()`,面板操作)、`App/sync/time_sntp.c`(`clock set by SNTP`);宿主侧 `simulator/main.c` 与 `simulator/sim/sim_syslog.c` | 定值**真落盘成功** / 清除记录成功 / 面板运维动作 / SNTP 对时。⚠ 104 侧不再投递:原 `App/protocol/iec104/iec104_pts.c` 写 `force reset` 与 `plate in/out`,该实现已于 2026-11-17 割接删除,骨架阶段不驱动物理出口故无记录(见 `docs/子系统设计/IEC104上行设计说明.md` §0.5) |
|
||
| 遥控 | `SYSLOG_YK` / `yk.log` | 256 | **当前无生产者**——原写入点 `App/protocol/iec104/iec104_pts.c`(`s_src_yk_exec()`:选择段、执行段、非法 DPC、未知 IOA)已随 2026-11-17 割接删除 | ⚠ 骨架阶段**有意不记**:模拟动作绝不驱动物理出口,照旧写"选择/执行"即为伪造记录(判据与后果见 `docs/子系统设计/IEC104上行设计说明.md` §0.5)。恢复记录需新增观测接缝,待另行立项 |
|
||
|
||
- **"哪些元件算跳闸"只有一个真源**:定值表 `g_prot_set_meta` 里的 `PS_*_TRIP`(枚举注释
|
||
即"0 告警 / 1 跳闸")+ 实例表 `k_pe[]` 的 `trip_ctl` 列。分类入口
|
||
`prot_elm_record_kind()`(`App/algo/prot_elm.c`)里**没有第二份元件名单**,
|
||
没有该投退项的五项(OV/UV/3U0/OF/UF)填 `PROT_ELM_NO_TRIP=0xFF` → 恒告警;
|
||
`TC-PROTELEM-015` 逐元钉住"逐项独立 / 改定值即改类别 / 无此项者不受别人定值影响"。
|
||
- **描述只用 ROM 常量或 `prot_elm_name()` 直传**:所有写入点零 `snprintf`、零拼接。
|
||
最长一条 20 字节 < `SYSLOG_DESC_MAX`(28);`TC-IEC104-030` 逐条量长度(超 28 会被
|
||
投递侧静默截断,屏上少几个字,没人会去数)。
|
||
- ⚠️ **两个投递口,按调用者的栈预算选**:`syslog_post()` 的两个"满态丢弃留痕"分支
|
||
内联着日志行缓冲(每处约 216 B 栈),因此 `syslog_post_quiet()` 给静态最坏链吃紧的
|
||
任务用(**protectTask、iec104Task 必须用它**),丢弃只累加 `syslog_post_dropped()`、
|
||
由唯一写者 defaultTask 在 `syslog_drain()` 里按差值补一条留痕——同 `soe_store_post`
|
||
当年那条 `872 → 1192 B FAIL` 的实证纪律。收/丢判据两个口完全一致。
|
||
- **读侧契约(给 task-11;2026-10-28 五页已按此接上)**:`syslog_count(id)` + `syslog_get_record(id, idx, ts, ts_len,
|
||
desc, desc_len)` 与运行/自检记录**同一枚 reader**,"最近 20 条"= 从 `count-20` 起读;
|
||
`count()==0` 就是空态,页面显示"无记录"。**不要**在共享代码里调 MCU 专属的
|
||
`syslog_clear_apply()`(模拟器不实现 → 链接期报错是故意的);清除一律走
|
||
`syslog_request_clear()` + `syslog_clear_state()`,并把 `WAIT` 当正常态看(模拟器端
|
||
永不出现 `WAIT`,见下条)。
|
||
|
||
### console_log(控制台单写者)
|
||
|
||
- 多任务的生产者 → **单写者消费者**,消除任务间日志行交错
|
||
- 设计详见 `docs/子系统设计/控制台单写者日志设计.md`
|
||
|
||
### soe(SOE 事件顺序记录,SOE 记录)
|
||
|
||
- **记录 = 64 B 定长二进制**(`soe_rec.h` 布局),落 `/log/soe.log`;
|
||
与 run.log 分文件——run.log 是文本记录、有 UI/主机读取方,二进制 SOE
|
||
混入会破坏读取器;分文件保持"定长 64B + 条数=fsize/64 + 满删重建 +
|
||
FTP 下载 + 主机解码"同一套先例
|
||
- **生产者 = protectTask**(元件动作/返回、软压板投退、采样闭锁/恢复六类
|
||
边沿):`soe_store_post()` 纯 RAM(取时标 + 组记录 + 队列/待发环),
|
||
**零 NAND I/O**;⚠️ **post 内禁 `DBG_*`**——会把 protectTask 静态最坏链
|
||
垫高一帧(实证 872→1192 B FAIL),丢弃留痕由 drain(defaultTask)差值上报
|
||
- **唯一写者 = defaultTask**:挂 `syslog_drain()` 尾部(继承其卷就绪门),
|
||
50 ms 节拍 → SOE 落盘延迟 ≤50 ms;写盘纪律全套照 syslog(卷锁 try /
|
||
`FA_WRITE|FA_OPEN_APPEND` / 校验字节数 / 满删重建 / 失败留痕去重),
|
||
**绝不把名字/参数类错误码归入卷损坏触发集**
|
||
- **时标口径**:sys_clock 秒域时基 → CP56 ms 域 = 秒×1000(亚秒恒 0,
|
||
不造假);墙钟未建 → IV 位如实置位;seq 仅上电生命周期内单调
|
||
(容量重建不重置,仅复位重置——主机解码按 boot 段分段断言)
|
||
- 主机侧:`test/host/soe/decode_soe.py` 解码 + 断言(校验和/seq 单调/
|
||
CP56↔epoch UTC 交叉);⚠️ 交叉校验用 `calendar.timegm`,不是本地时区的
|
||
`dt.timestamp()`(+08 机差 28800 s,首跑实证坑)
|
||
|
||
## 相关文档
|
||
|
||
- `docs/子系统设计/控制台单写者日志设计.md`
|
||
- `docs/子系统设计/运行与自检记录设计.md`
|
||
- FatFs 陷阱(`FA_WRITE|FA_OPEN_APPEND` 缺一即 `FR_DENIED`、短写须校验字节数、严格 8.3):`docs/架构设计/STM32F4-Base存储架构说明.md` §10 第 10/11 项
|