Files
STM32F4-Base/App/util/task_prof.c
T
wandering1 fd767d1dcd feat(ioboard): 开入开出板驱动、去抖快照与主机侧单测接入
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 根钩子全通过。
2026-11-16 18:30:31 +08:00

303 lines
12 KiB
C
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
/*
* 模块名称:Task Profiler(任务耗时最坏值探针)实现
* 模块功能:接口见 task_prof.h。本文件只做三件事:
* ① 惰性使能 DWT CYCCNT 并读值;② 维护每探针的 count/max/last/glitch
* 与"在段内"标志;③ 把全部字段格式化成一整行 `[PROF]` 交给控制台单写者。
* 适用平台:STM32F407ZGTx(仅 MCU 端)
* 作者:王建锋
* 创建日期:2026-10-10
* 修改记录:
* v1.0 2026-10-10 王建锋 创建:常开任务耗时探针
*
* 设计依据:docs/子系统设计/看门狗设计说明.md §11.4(探针字段语义与实测基线)
*/
#include "task_prof.h"
#include <stdio.h>
#include "main.h" /* DWT / CoreDebug / SystemCoreClock / HAL_GetTick() */
#include "console_log.h" /* dbg_console_write_line / dbg_console_write_raw */
/* Private defines -----------------------------------------------------------*/
/* 报告节奏:首次延后(bring-up 深链期间不占串口),此后周期一行。
* 2 s 与 defaultTask 的 [STACK] 报告同节奏,便于两条序列交叉比对。 */
#define TASK_PROF_FIRST_MS 5000u
#define TASK_PROF_PERIOD_MS 2000u
/* 合理耗时上界(周期数)。超过即判为"CYCCNT 中途被重置"造成的无符号回绕
* (差值 ~2^32),丢弃而不污染 max。取 10 s 对应周期数:远高于真实最坏段
* 耗时(停摆窗口 < 2.5 s 即复位),又远低于 2^32,不会误杀真实数据。
* 168 MHz 下 10 s = 1.68e9 < 2^32,本身不溢出。 */
#define TASK_PROF_GLITCH_CYC (SystemCoreClock * 10u)
/* Private types -------------------------------------------------------------*/
typedef struct {
volatile uint32_t count; /* 已结算样本数 */
volatile uint32_t max; /* 最坏耗时(周期数) */
volatile uint32_t last; /* 最近一次耗时(周期数) */
volatile uint32_t glitch; /* 丢弃的样本数(DWT 不可用 / 计数器被重置) */
volatile uint32_t t_start; /* 进段时刻(周期数;仅 enter/exit 类探针使用) */
volatile uint32_t in_seg; /* 1 = 此刻仍在段内(读侧据此算"已停留多久") */
} task_prof_slot_t;
/* Private variables ---------------------------------------------------------*/
static task_prof_slot_t s_prof[TASK_PROF_ID_COUNT];
static uint8_t s_dwt_ok; /* 1 = DWT CYCCNT 已使能 */
static uint8_t s_prof_reported; /* 1 = 已首次报告(节流状态) */
static uint32_t s_prof_last; /* 上次报告时刻(ms) */
static char s_prof_line[DBG_CON_LINE_MAX]; /* 报告行缓冲(仅 defaultTask 用) */
/* Private function prototypes -----------------------------------------------*/
static uint32_t prof_cyc_to_us(uint32_t cyc);
static void prof_send(int n, uint32_t raw);
static void prof_emit(uint32_t raw);
/*
* 函数功能:周期数 → 微秒
* 入口参数:cyc - 周期数
* 返回值:微秒数(SystemCoreClock 低于 1 MHz 时返回 0)
* 限定条件:任意上下文可调(纯算术)
* 函数说明:MicroLIB 的 snprintf 不支持 %f → 一律以整数微秒上报。
*/
static uint32_t prof_cyc_to_us(uint32_t cyc) {
uint32_t per_us = SystemCoreClock / 1000000u;
if (per_us == 0u) {
return 0u;
}
return cyc / per_us;
}
/*
* 函数功能:把已格式化在静态行缓冲里的行按指定通道发出
* 入口参数:n - snprintf 返回的长度(<= 0 = 格式化失败,丢弃)
* raw - 0 = 入环形缓冲;非 0 = 裸 UART 直发
* 返回值:无
* 限定条件:仅 defaultTask 调用(唯一串口写者)
* 函数说明:长度按静态缓冲容量夹取,防 snprintf 截断后越界。
*/
static void prof_send(int n, uint32_t raw) {
const unsigned cap = (unsigned)sizeof(s_prof_line);
unsigned len;
if (n <= 0) {
return;
}
len = ((unsigned)n >= cap) ? (cap - 1u) : (unsigned)n;
if (raw != 0u) {
dbg_console_write_raw(s_prof_line, len);
} else {
(void)dbg_console_write_line(s_prof_line, len);
}
}
/*
* 函数功能:格式化并输出 `[PROF]` + `[PROF2]` 两行(静态行缓冲,零栈开销)
* 入口参数:raw - 0 = 入环形缓冲(周期报告);非 0 = 裸 UART 直发(停摆现场)
* 返回值:无
* 限定条件:仅 defaultTask 调用(唯一串口写者,无并发;故可复用静态缓冲)
* 函数说明:字段含义(括号内为打印单位):
* [PROF] t HAL tick(ms)
* uic/uip/uipn/uil uiTask 循环次数 / 周期最坏 / 本轮已进行 / 周期最近(us)
* uiw/uis/uisn uiTask 单轮工作最坏 / 推流往返最坏 / 仍在推流段内(us)
* adc/adcm/adcn adcTask 单拍次数 / 单拍最坏 / 仍在拍内(us)
* [PROF2] defd/defs defaultTask 控制台排空最坏 / syslog 落盘最坏(us)
* defi defaultTask 开入采样一拍最坏(读 + 去抖 + 发布,us)
* netp/netn netTask 驱动轮询最坏 / 仍在轮询内(us)
* adcp/adcq adcTask ADC 单次最坏 / 仍在 ADC 内(us)
* 两行的 gl 丢弃样本数(DWT 不可用或计数器被重置)
* "仍在段内"为 0 表示不在该段内——某任务若永久阻塞在某段,该段的
* count 不再增长,只有这个字段能证明它卡在哪里。
*/
static void prof_emit(uint32_t raw) {
const uint32_t t = HAL_GetTick();
const uint32_t now = task_prof_cyc();
uint32_t uipn = 0u;
uint32_t uisn = 0u;
uint32_t adcn = 0u;
uint32_t netn = 0u;
uint32_t adcq = 0u;
uint32_t gl = 0u;
uint32_t i;
int n;
if (s_prof[TASK_PROF_UI_PERIOD].in_seg != 0u) {
uipn = now - s_prof[TASK_PROF_UI_PERIOD].t_start;
}
if (s_prof[TASK_PROF_UI_SINK].in_seg != 0u) {
uisn = now - s_prof[TASK_PROF_UI_SINK].t_start;
}
if (s_prof[TASK_PROF_ADC_BEAT].in_seg != 0u) {
adcn = now - s_prof[TASK_PROF_ADC_BEAT].t_start;
}
if (s_prof[TASK_PROF_NET_POLL].in_seg != 0u) {
netn = now - s_prof[TASK_PROF_NET_POLL].t_start;
}
if (s_prof[TASK_PROF_ADC_POLL].in_seg != 0u) {
adcq = now - s_prof[TASK_PROF_ADC_POLL].t_start;
}
for (i = 0u; i < (uint32_t)TASK_PROF_ID_COUNT; i++) {
gl += s_prof[i].glitch;
}
/* 行 1:任务级(uiTask / adcTask) */
n = snprintf(s_prof_line, sizeof(s_prof_line),
"[PROF] t=%lu uic=%lu uip=%lu uipn=%lu uil=%lu uiw=%lu uis=%lu "
"uisn=%lu adc=%lu adcm=%lu adcn=%lu gl=%lu\r\n",
(unsigned long)t,
(unsigned long)s_prof[TASK_PROF_UI_PERIOD].count,
(unsigned long)prof_cyc_to_us(s_prof[TASK_PROF_UI_PERIOD].max),
(unsigned long)prof_cyc_to_us(uipn),
(unsigned long)prof_cyc_to_us(s_prof[TASK_PROF_UI_PERIOD].last),
(unsigned long)prof_cyc_to_us(s_prof[TASK_PROF_UI_WORK].max),
(unsigned long)prof_cyc_to_us(s_prof[TASK_PROF_UI_SINK].max),
(unsigned long)prof_cyc_to_us(uisn),
(unsigned long)s_prof[TASK_PROF_ADC_BEAT].count,
(unsigned long)prof_cyc_to_us(s_prof[TASK_PROF_ADC_BEAT].max),
(unsigned long)prof_cyc_to_us(adcn),
(unsigned long)gl);
prof_send(n, raw);
/* 行 2:段级(占用者指认:defaultTask 排空/落盘/开入、netTask 驱动、adcTask ADC) */
n = snprintf(s_prof_line, sizeof(s_prof_line),
"[PROF2] t=%lu defd=%lu defs=%lu defi=%lu netp=%lu netn=%lu adcp=%lu "
"adcq=%lu gl=%lu\r\n",
(unsigned long)t,
(unsigned long)prof_cyc_to_us(s_prof[TASK_PROF_DEF_DRAIN].max),
(unsigned long)prof_cyc_to_us(s_prof[TASK_PROF_DEF_SYSLOG].max),
(unsigned long)prof_cyc_to_us(s_prof[TASK_PROF_DEF_DI].max),
(unsigned long)prof_cyc_to_us(s_prof[TASK_PROF_NET_POLL].max),
(unsigned long)prof_cyc_to_us(netn),
(unsigned long)prof_cyc_to_us(s_prof[TASK_PROF_ADC_POLL].max),
(unsigned long)prof_cyc_to_us(adcq),
(unsigned long)gl);
prof_send(n, raw);
}
/*
* 函数功能:读 DWT 周期计数器(懒使能;见 task_prof.h 的契约说明)
* 入口参数:无
* 返回值:当前 CYCCNT 值(周期数)
* 限定条件:任意上下文可调(幂等;纯寄存器读写)
* 函数说明:只置使能位、**不清零** CYCCNT——本模块只用差值,清零无意义,
* 且会与 console_log.c 的同名惰性使能互相干扰(该模块对 CYCCNT
* 清零后,在途的差值会变成一次无符号回绕,由 glitch 守卫丢弃)。
*/
uint32_t task_prof_cyc(void) {
if (s_dwt_ok == 0u) {
CoreDebug->DEMCR |= CoreDebug_DEMCR_TRCENA_Msk;
DWT->CTRL |= DWT_CTRL_CYCCNTENA_Msk;
if ((DWT->CTRL & DWT_CTRL_CYCCNTENA_Msk) != 0u) {
s_dwt_ok = 1u;
}
}
return DWT->CYCCNT;
}
/*
* 函数功能:记录一次耗时样本(周期数)
* 入口参数:id - 探针 ID;cyc - 耗时(周期数)
* 返回值:无
* 限定条件:单写者(每个 ID 只由一个任务调用)
* 函数说明:不可用样本(cyc 为 0 或超出合理上界)只累加 glitch,不更新
* max/last/count——否则一次计数器重置就会把最坏值抬到 ~2^32 周期。
*/
void task_prof_sample(task_prof_id_t id, uint32_t cyc) {
task_prof_slot_t *p;
if ((uint32_t)id >= (uint32_t)TASK_PROF_ID_COUNT) {
return;
}
p = &s_prof[id];
if ((cyc == 0u) || (cyc >= TASK_PROF_GLITCH_CYC)) {
p->glitch++;
return;
}
p->count++;
p->last = cyc;
if (cyc > p->max) {
p->max = cyc;
}
}
/*
* 函数功能:标记"进入某段"(观测"此刻仍在段内已多久")
* 入口参数:id - 探针 ID
* 返回值:无
* 限定条件:单写者;须与 task_prof_exit 成对
* 函数说明:写序为先 t_start 后 in_seg——读侧见 in_seg 为 1 时 t_start 必已有效。
*/
void task_prof_enter(task_prof_id_t id) {
task_prof_slot_t *p;
if ((uint32_t)id >= (uint32_t)TASK_PROF_ID_COUNT) {
return;
}
p = &s_prof[id];
p->t_start = task_prof_cyc();
p->in_seg = 1u;
}
/*
* 函数功能:结算一段耗时(与 task_prof_enter 成对)
* 入口参数:id - 探针 ID
* 返回值:无
* 限定条件:单写者;须与 task_prof_enter 成对
* 函数说明:先清"在段内"标志再结算,避免读侧把已结算的段误报为"仍在段内"。
* **未 enter 过则直接返回**:让"先 exit 再 enter"的周期测量写法
* 在首轮不把 0 当作起点(否则会记下一次虚假的超大样本)。
*/
void task_prof_exit(task_prof_id_t id) {
uint32_t t0;
if ((uint32_t)id >= (uint32_t)TASK_PROF_ID_COUNT) {
return;
}
if (s_prof[id].in_seg == 0u) {
return;
}
t0 = s_prof[id].t_start;
s_prof[id].in_seg = 0u;
task_prof_sample(id, task_prof_cyc() - t0);
}
/*
* 函数功能:周期性打印 [PROF] 行(内部节流)
* 入口参数:无
* 返回值:无
* 限定条件:仅 defaultTask 主循环调用
* 函数说明:首次 5 s 后报告(bring-up 深链已跑过),此后每 2 s 一行。
*/
void task_prof_report(void) {
const uint32_t now = HAL_GetTick();
if (s_prof_reported == 0u) {
if (now < TASK_PROF_FIRST_MS) {
return;
}
s_prof_reported = 1u;
} else if ((uint32_t)(now - s_prof_last) < TASK_PROF_PERIOD_MS) {
return;
}
s_prof_last = now;
prof_emit(0u);
}
/*
* 函数功能:停摆现场快照(同一 [PROF] 行,走裸 UART 直发)
* 入口参数:无
* 返回值:无
* 限定条件:仅 defaultTask 调用(此时它就是唯一串口写者,无并发)
* 函数说明:用于"首次心跳缺席"瞬间;缺席窗口内环形缓冲可能积压,
* 裸直发保证这一行能出去。
*/
void task_prof_report_raw(void) {
prof_emit(1u);
}