fd767d1dcd
74HC165 开入 + 光耦继电器开出的完整硬件抽象层,接进 defaultTask 的 50ms 节拍。开入 8 路(第二块 165 数据线板上未接,故只有 8 位), 开出 4 路(高电平吸合)。 驱动 BSP drivers: - IOBOARD/ioboard.c 装载与移位时序,每步注明数据手册依据; SH/LD 拉高前先拉低 CLK,否则装载瞬间多移一位; 单次读取上界 26us(延时按最慢列 VCC 2V 全温区取值)。 - IOBOARD/ioboard_bits.c 位序组装纯函数,只依赖 stdint.h, 主机侧可直接 include 做单测:读 8 次为 H,G,F,E,D,C,B,A, A 放 bit0(bit(7-i) = reads[i])。 - 极性集中在 IOBOARD_DO_LEVEL_ACTIVE 一处,接口语义统一为 mask 的 1 = 吸合。 业务接线: - App/util/ioboard_di.c 通道去抖与双区快照,纯逻辑; 刻意不 include ioboard.h(其引脚宏会牵入 main.h), 两处路数常量由测试的编译期静态断言钉住。 - default_task.c 的 default_task_di_poll():读失败不喂去抖、 不写发布值,只把上一有效值加 valid=0 发布出去, 避免"全 0"被现场读成开入全部复归。 - 去抖实际粒度 50ms(每个轮询周期喂一拍),最坏上报约 100ms; 想要真 20ms 需另建定时器,本次不做。 - Src/main.c 在 app_main_init 之前调 ioboard_init(), 上电即把 4 路出口钉在全释放并确认 165 静止态。 测试: - test/host/ioboard/ 100 条断言。位序主判据为单比特两端 (只有 A 得 0x01、只有 H 得 0x80)加八点双射穷举; 混合图样降级为辅助,因该图样曾先后被算成 0xA5、0x5A、0xAA。 - 去抖覆盖 20ms 边界、抖动不翻、跨 49.7 天回绕。 - 失败语义覆盖"失败保留上次有效值"与"失败窗口内的真实变位不丢"。 文档: - 新增 docs/硬件平台/开入开出实施说明.md。 - 硬件规格与能力边界 §5 的能力边界现状改写:出口继电器与 开入回路已具备、业务层未接入;4 路开出只可台架验证, 不得用于真实跳闸。 - 修正 docs/文档规范.md §3.1:原文要求所有互链用仓库根相对, 与 check_doc_links.py 的实际解析基准矛盾(markdown 链接按 当前文档目录解析,反引号路径才按仓库根)。改为区分两类, 并补 §3.1b 写明对应校验器。 - 清理 docs/任务规划/登记簿.md 改名为硬件改版登记.md 后 遗留的 9 处旧名引用。 门禁: keil-build 0 Error 0 Warning;主机侧单测 ioboard 100/100、 sb_proto 45/45;pre-commit 48 根钩子全通过。
143 lines
7.5 KiB
C
143 lines
7.5 KiB
C
/*
|
||
* 模块名称:Task Profiler(任务耗时最坏值探针)
|
||
* 模块功能:用内核 DWT 周期计数器(CYCCNT,168 MHz 主频下 168 周期 = 1 us)为
|
||
* 各任务主循环的**最坏耗时 / 执行次数 / "此刻是否仍在某段内"** 提供
|
||
* 常开、低开销的观测面,经控制台单写者输出 `[PROF]` 行。
|
||
* 用途:把"某任务心跳缺席"这一结果拆成三种互斥机理,供归因定位。
|
||
* 适用平台:STM32F407ZGTx(仅 MCU 端:依赖 DWT 与 HAL 时基;模拟器/主机单测
|
||
* 不编译本模块)
|
||
* 作者:王建锋
|
||
* 创建日期:2026-10-10
|
||
* 修改记录:
|
||
* v1.0 2026-10-10 王建锋 创建:常开任务耗时探针
|
||
*
|
||
* 设计背景(docs/子系统设计/看门狗设计说明.md §11.4):
|
||
* uiTask 偶发心跳缺席导致 IWDG 复位,但"占用者"无法从既有日志判定。
|
||
* 同一现象至少对应三种互斥机理,观测上必须能区分:
|
||
* ① 被调度饿死 → 循环周期长,而段内耗时短;
|
||
* ② 阻塞在网络往返 → `ui_net_sink_poll()` 段内耗时长;若永久阻塞,
|
||
* 该段样本**永不结算**,只有"此刻仍在段内已 X us"能证明;
|
||
* ③ 自身渲染拖长 → 单轮工作耗时长。
|
||
* 故每个探针记录 max / count / last,并对可疑段记录 enter/exit。
|
||
*
|
||
* ⚠ 开销:一次采样 = 1 次 DWT 读 + 数次比较/存储(< 20 周期);对 1 ms 节拍
|
||
* (168000 周期)可忽略。无动态分配、无内核对象、无临界区、无阻塞。
|
||
* ⚠ 单写者假设:同一探针 ID 只由**一个任务**写入(见下表),报告由
|
||
* defaultTask 读取。32 位对齐读写在 Cortex-M4 上原子,读侧不会撕裂。
|
||
*
|
||
* 探针 ID 写入者 含义(enter/exit = 可读出"此刻仍在段内已多久")
|
||
* UI_PERIOD uiTask 上轮循环起点 → 本轮循环起点(enter/exit)
|
||
* UI_WORK uiTask 本轮起点 → 心跳前(含 LVGL 渲染 + 推流轮询)
|
||
* UI_SINK uiTask ui_net_sink_poll() 单次往返(enter/exit)
|
||
* ADC_BEAT adcTask 单拍起点 → 心跳后(含取数 + 压环 + 相量 + 心跳日志)
|
||
* ADC_POLL adcTask adc_input_poll() 单次(enter/exit)——隔离 ADC 超时成本
|
||
* DEF_DRAIN defaultTask dbg_console_drain()(enter/exit)——控制台忙等发送
|
||
* DEF_SYSLOG defaultTask syslog_drain()(enter/exit)——NAND/FTL 写
|
||
* DEF_DI defaultTask 开入采样一拍(默认Task,任务级 max)——开入读+去抖+发布
|
||
* NET_POLL netTask net_poll()(enter/exit)——CH395F 驱动轮询
|
||
*
|
||
* 后四个探针用于**指认占用者**:UI 心跳缺席时,谁的最坏耗时在同一窗口抬起来,
|
||
* 谁就是挤占 CPU 的 Normal 任务(见 docs/子系统设计/看门狗设计说明.md §11.2 第 4 步)。
|
||
*/
|
||
|
||
#ifndef TASK_PROF_H
|
||
#define TASK_PROF_H
|
||
|
||
#include <stdint.h>
|
||
|
||
#ifdef __cplusplus
|
||
extern "C" {
|
||
#endif
|
||
|
||
/* 探针 ID(顺序即内部槽位下标,新增只能追加) */
|
||
typedef enum {
|
||
TASK_PROF_UI_PERIOD = 0, /* uiTask 循环周期 */
|
||
TASK_PROF_UI_WORK = 1, /* uiTask 单轮工作耗时(不含 osDelay) */
|
||
TASK_PROF_UI_SINK = 2, /* ui_net_sink_poll() 往返耗时 */
|
||
TASK_PROF_ADC_BEAT = 3, /* adcTask 单拍耗时 */
|
||
TASK_PROF_ADC_POLL = 4, /* adc_input_poll() 耗时(隔离 ADC 超时成本) */
|
||
TASK_PROF_DEF_DRAIN = 5, /* defaultTask 控制台排空耗时 */
|
||
TASK_PROF_DEF_SYSLOG = 6, /* defaultTask syslog 落盘耗时 */
|
||
TASK_PROF_NET_POLL = 7, /* netTask net_poll() 耗时(CH395F 驱动) */
|
||
TASK_PROF_DEF_DI = 8, /* defaultTask 开入采样一拍(读 + 去抖 + 发布) */
|
||
TASK_PROF_ID_COUNT
|
||
} task_prof_id_t;
|
||
|
||
/*
|
||
* 函数功能:读 DWT 周期计数器(懒使能;基准为"任意",仅供取差值)
|
||
* 入口参数:无
|
||
* 返回值:当前 CYCCNT 值(周期数)
|
||
* 限定条件:任意上下文可调(幂等;纯寄存器读,不创建任何内核对象)
|
||
* 函数说明:首次调用置 CoreDebug->DEMCR.TRCENA 与 DWT->CTRL.CYCCNTENA。
|
||
* 刻意**不清零** CYCCNT:本模块只用差值,清零无意义,且会与
|
||
* console_log.c 的同名惰性使能互相干扰。DWT 使能失败时恒返回 0,
|
||
* 采样侧把 0 判为"不可用"(见 task_prof_sample)。
|
||
*/
|
||
uint32_t task_prof_cyc(void);
|
||
|
||
/*
|
||
* 函数功能:记录一次耗时样本(周期数)
|
||
* 入口参数:id - 探针 ID
|
||
* cyc - 耗时(周期数;0 或超出合理上界视为不可用/计数器被重置)
|
||
* 返回值:无
|
||
* 限定条件:单写者(每个 ID 只由一个任务调用)
|
||
* 函数说明:更新 count / last / max。`cyc == 0`(DWT 未使能)或
|
||
* `cyc >= TASK_PROF_GLITCH_CYC`(计数器中途被重置造成的无符号回绕)
|
||
* 只累加 glitch 计数、不污染 max——否则一次计数器重置就会把
|
||
* 最坏值抬到 ~2^32 周期,掩盖真实数据。
|
||
*/
|
||
void task_prof_sample(task_prof_id_t id, uint32_t cyc);
|
||
|
||
/*
|
||
* 函数功能:标记"进入某段"(用于观测"此刻仍在段内已多久")
|
||
* 入口参数:id - 探针 ID
|
||
* 返回值:无
|
||
* 限定条件:单写者;须与 task_prof_exit 成对
|
||
* 函数说明:记录进入时刻并置"在段内"标志。若该任务此后永久阻塞在该段,
|
||
* 样本永不结算,只有报告侧的"仍在段内"字段能证明它卡在哪里。
|
||
*/
|
||
void task_prof_enter(task_prof_id_t id);
|
||
|
||
/*
|
||
* 函数功能:结算一段耗时(与 task_prof_enter 成对)
|
||
* 入口参数:id - 探针 ID
|
||
* 返回值:无
|
||
* 限定条件:单写者;须与 task_prof_enter 成对
|
||
* 函数说明:清"在段内"标志 → 以 enter 时刻为起点记一次样本。
|
||
* **未 enter 过(in_seg == 0)时直接返回**——这使"先 exit 再 enter"的
|
||
* 周期测量写法(如 uiTask 的循环周期)在首轮不会拿 0 当起点,
|
||
* 从而不产生一次虚假的超大样本。
|
||
*/
|
||
void task_prof_exit(task_prof_id_t id);
|
||
|
||
/*
|
||
* 函数功能:周期性打印 `[PROF]` / `[PROF2]` 行(内部节流:首次 5 s 后,此后每 2 s)
|
||
* 入口参数:无
|
||
* 返回值:无
|
||
* 限定条件:仅 defaultTask 主循环调用(唯一串口写者;静态行缓冲复用)
|
||
* 函数说明:整行一次 `dbg_console_write_line` 入环形缓冲(行级原子)。
|
||
* `[PROF]` = uiTask/adcTask 任务级(周期 / 工作 / 往返 / 单拍);
|
||
* `[PROF2]` = 占用者段级(defaultTask 排空与落盘、netTask 驱动轮询、
|
||
* adcTask ADC 单次),用于指认"谁把 CPU 占住了"。
|
||
* 用**静态**行缓冲而非栈缓冲:本函数挂在 defaultTask 的最坏调用链上,
|
||
* 栈上再放一个 192 B 行缓冲会挤占该任务的栈预算。
|
||
*/
|
||
void task_prof_report(void);
|
||
|
||
/*
|
||
* 函数功能:停摆现场快照——同 `[PROF]` + `[PROF2]` 两行,走**裸 UART 直发**
|
||
* 入口参数:无
|
||
* 返回值:无
|
||
* 限定条件:仅 defaultTask 调用(此时它就是唯一串口写者,无并发)
|
||
* 函数说明:用于"某任务心跳刚由'到过'变为'缺席'"的瞬间。缺席窗口内环形缓冲
|
||
* 可能积压,裸直发保证这两行能出去(与 task_wd_poll 的 `MISS start`
|
||
* 标记同款理由)。
|
||
*/
|
||
void task_prof_report_raw(void);
|
||
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
|
||
#endif /* TASK_PROF_H */
|