cc7f17f231
Three of the six DWT CYCCNT users wrote the counter to zero on init: console_log, net_latency_test and ch395f_reuse_bench. Every one of them only ever takes the difference (CYCCNT - t0) against a local snapshot, so the reset bought nothing and instead caused a bogus ~2^32 delta for anyone who sampled across it. That delta trips the task_prof glitch guard (TASK_PROF_GLITCH_CYC = 10 s worth of cycles), which discards the sample, so a whole worst-case measurement could vanish silently. All three call sites now leave the counter alone; the shared contract is "enable only, never reset", documented at each of the six users. The documented behaviour in the link latency test guide (section 4.3) is updated to match. Net source change is three deleted lines, no new executable code. Verification: - grep for a zero assignment to CYCCNT across the tree: no hits left. - Keil build: Code=257932 RO-data=32108 RW-data=2104 ZI-data=152688, 0 errors 0 warnings. - Host unit tests: console_log 153/153, task_prof 27/27, ioboard 100/100, sb_link 164/164. - Four console_log assertions pinned the absolute number of DWT register touches; dropping the reset write lowers it by one, so their expected counts move from 3 to 2 (and 4 to 3 for TC-CONLOG-093). The test text now says why the third write disappeared. - check_doc_links: 6 known issues, unchanged from baseline.
145 lines
7.7 KiB
C
145 lines
7.7 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:本模块只用差值,清零无意义。CYCCNT 是全内核
|
||
* 共享的单一计数器,本仓 console_log.c、IOBOARD 驱动与 ScreenLink 驱动
|
||
* 也在用它取差值;任何一处清零都会让其余使用者"在途"的基准失效。
|
||
* 该口径已于 2026-11-16 在四处统一(此前 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 */
|