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 根钩子全通过。
This commit is contained in:
@@ -69,6 +69,8 @@
|
||||
#include "wave_ring.h" /* 录波环消费侧:sealed/sealed_meta/read_cb/write_done(task-2) */
|
||||
#include "wave_store.h" /* 段打包游标 + 段号轮转纯函数(落盘道本体,task-2) */
|
||||
#include "task_handles.h" /* 任务句柄与属性块的引用契约(定义处仍是 Src/freertos.c) */
|
||||
#include "ioboard.h" /* 开入开出板 BSP(硬件动起来并如实汇报) */
|
||||
#include "ioboard_di.h" /* 开入去抖 + 双区快照(纯逻辑,主机侧同一份源码被单测覆盖) */
|
||||
|
||||
/* Private defines -----------------------------------------------------------*/
|
||||
/* 栈水位观测节奏:首次报告须晚于 bring-up 深链(mount/mkfs/探针/cfg/syslog),
|
||||
@@ -119,6 +121,29 @@ static const stack_probe_task_t s_stack_probe[] = {
|
||||
static void stack_probe_poll(void);
|
||||
#if !defined(TEST_SUITE_STORAGE)
|
||||
static void default_task_net_cfg_save_notify(void);
|
||||
static uint8_t default_task_di_poll(void);
|
||||
|
||||
/* 周期性发布者的编译期开关:两个测试套件构建都禁用本任务的发布(见 poll 函数的说明四) */
|
||||
#if defined(TEST_SUITE_CH395F) || defined(TEST_SUITE_GDRAM)
|
||||
#define DEFAULT_TASK_DI_PUBLISH_EN 0
|
||||
#else
|
||||
#define DEFAULT_TASK_DI_PUBLISH_EN 1
|
||||
#endif
|
||||
|
||||
/*
|
||||
* 开入(DI)采集状态,**文件作用域静态零初始化**(不占任务栈、不走堆):
|
||||
* s_di_ch - 8 个通道的去抖状态机(App/util/ioboard_di.c)
|
||||
* s_di_snap - 双区快照(消费者无锁读,见 ioboard_di.h)
|
||||
* s_di_pub_mask - 最近一次**成功**读到的去抖后 mask;读失败时原样再发布,
|
||||
* 这就是"失败不得当全 0 上报"在本任务侧的落点
|
||||
* s_di_fail_edges_seen - 已写入日志的故障下降沿计数("每个 episode 只记一条")
|
||||
* 为什么是文件作用域而不是任务内 static:poll 函数在任务函数之外定义,
|
||||
* C99 里函数内 static 无法被别处看见;放文件作用域还让"唯一写者"更显眼。
|
||||
*/
|
||||
static ioboard_di_ch_t s_di_ch[IOBOARD_DI_CH_NUM];
|
||||
static ioboard_di_snapshot_t s_di_snap;
|
||||
static uint8_t s_di_pub_mask;
|
||||
static uint32_t s_di_fail_edges_seen;
|
||||
static FRESULT storage_bring_up(FATFS *fs);
|
||||
static void wave_store_drain(void);
|
||||
#endif
|
||||
@@ -189,6 +214,16 @@ void default_task_func(void *argument) {
|
||||
uint32_t cfg_poll_cnt = 0u;
|
||||
uint32_t led_tick = HAL_GetTick();
|
||||
|
||||
/* 周期性发布者的编译期开关:两个套件都禁用本任务的发布(见下方 poll 函数的说明) */
|
||||
#if defined(TEST_SUITE_CH395F) || defined(TEST_SUITE_GDRAM)
|
||||
#define DEFAULT_TASK_DI_PUBLISH_EN 0
|
||||
#else
|
||||
#define DEFAULT_TASK_DI_PUBLISH_EN 1
|
||||
#endif
|
||||
/* 开入第一次读取放在 bring-up 之后:此刻 MX_GPIO_Init 早已配好引脚(模块初始化期),
|
||||
* 且看门狗尚未启动,几十微秒的移位读不会影响任何节拍。 */
|
||||
(void)default_task_di_poll();
|
||||
|
||||
/* 注册控制台写者:本任务此后是串口唯一发送者(其余任务只写环形缓冲)。
|
||||
* 见 App/log/console_log.c "控制台单写者日志"——消除并发写造成的日志逐字符交错,
|
||||
* 并让脏指针无法再进入 HAL_UART_Transmit 的缓冲遍历。 */
|
||||
@@ -305,6 +340,11 @@ void default_task_func(void *argument) {
|
||||
cfg_file_poll();
|
||||
#endif
|
||||
}
|
||||
/* 开入采集(8 路 74HC165):读、去抖、发布快照。**不单独占喂狗段**
|
||||
* (见函数说明:单次裸读上界见 IOBOARD_DI_READ_MAX_US,去抖是纯比较,无需新增段号)。 */
|
||||
task_prof_enter(TASK_PROF_DEF_DI);
|
||||
(void)default_task_di_poll();
|
||||
task_prof_exit(TASK_PROF_DEF_DI);
|
||||
/* LED 心跳:500ms 翻转一次(与旧 500ms 循环节奏等效;循环基准改 50ms 后
|
||||
* 不能再每轮翻转,否则变成 10Hz 闪烁) */
|
||||
task_wd_seg(TASK_WD_SEG_LED);
|
||||
@@ -887,3 +927,95 @@ static void default_task_net_cfg_save_notify(void) {
|
||||
}
|
||||
}
|
||||
#endif
|
||||
|
||||
/*
|
||||
* 函数功能:开入(8 路 74HC165)采样一拍——读、逐通道去抖、发布快照
|
||||
* 入口参数:无
|
||||
* 返回值:1 = 本拍成功并发布了有效快照;0 = 本拍读失败
|
||||
* 限定条件:仅 defaultTask 调用(启动期一次 + 主循环每轮一次;**唯一写者**)
|
||||
* 函数说明:
|
||||
*
|
||||
* 一、【节拍与去抖粒度 —— 必须讲清楚,别让人误以为真能 20 ms】
|
||||
* 本函数挂在 defaultTask 的 50 ms 基准拍上(osEventFlagsWait(..., 50u) 的兜底,
|
||||
* 无事件时一轮 = 50 ms;有事件时一轮更短)。因此**一个轮询周期只喂一拍**,
|
||||
* 20 ms 去抖窗口的实际粒度是 **50 ms 而不是 20 ms**。
|
||||
* 这与设计目标一致(开关量与继电器辅助触点的变位时标以"秒"计,50 ms 远够),
|
||||
* 代价是单次变位的上报时延最坏约"一拍轮询 + 一个窗口"≈ 100 ms。
|
||||
* 想要真 20 ms 需另建硬件定时器中断,那要动 RAM/任务预算,本次**不做**。
|
||||
* 有事件唤醒时一轮会更短(>= 若干 ms),此时去抖精度随之细化 —— 只会更准,不会更差。
|
||||
*
|
||||
* 二、【耗时与喂狗段】
|
||||
* 单次 ioboard_di_read() 上界见 ioboard.h 的 IOBOARD_DI_READ_MAX_US
|
||||
* (装载 + 8 拍,每拍两相各 1 us;全程在临界区内关中断)。
|
||||
* **不要在这个函数里硬写数字**:该宏是驱动的时序规格唯一出处,驱动改时序时
|
||||
* 这里必须跟着改就说明注释写错了——用宏名。
|
||||
* 以当前值(26 us)计:对 50 ms 一拍是 0.05%,且远小于任何中断的响应预算,故:
|
||||
* · **不新增 task_wd_seg 段号**(段号是复位取证用的契约,为几十 µs 加一个段
|
||||
* 只会稀释 PREVRUN 的信息量,且 enum 是新契约、要对齐文档);
|
||||
* · 只加一个 task_prof 探针,把"它到底多久"变成可观测值(见 task_prof.h)。
|
||||
* 临界区长度已由驱动负责(其注释写明"时序内不含任何可能阻塞的调用")。
|
||||
*
|
||||
* 三、【失败语义:读失败绝不当全 0 上报】
|
||||
* 读失败时:不更新 s_di_ch(不喂去抖 → 候选值与计时全长不动),
|
||||
* **用上一有效值 s_di_pub_mask 再次发布**,valid 置 0,并累加失败拍数。
|
||||
* 于是消费者看到的是"mask 还是旧的 + valid = 0",而不是一个新鲜的全 0 ——
|
||||
* 后者在现场会被读成"开入全部复归",是最危险的假信息。
|
||||
* 恢复:第一拍成功读即整组重新确立去抖基准(ioboard_di_ch_reset + 喂一拍),
|
||||
* 避免把"故障期间积累的旧计时"当成合法窗口。
|
||||
*
|
||||
* 四、【故障留痕】
|
||||
* 有效性下降沿(有效 → 失效)各落一条 run.log。判据用 fail_edges 的**边沿**
|
||||
* 而不是失败计数,保证一个故障 episode 只记一条(与 task_wd_poll 的位图边沿同款)。
|
||||
* 写日志点放在本函数内而非 ioboard_di.c:纯逻辑层不碰文件系统。
|
||||
* 且只在 !TEST_SUITE_CH395F && !TEST_SUITE_GDRAM 时发布 —— 那两个套件构建下
|
||||
* 卷由 testTask 独占(与 TEST_SUITE_STORAGE 同款理由),defaultTask 侧只读不算不写盘。
|
||||
*/
|
||||
static uint8_t default_task_di_poll(void) {
|
||||
uint8_t mask = 0u;
|
||||
uint8_t rc = 0u;
|
||||
uint8_t i;
|
||||
uint32_t now = HAL_GetTick();
|
||||
uint32_t edges = 0u;
|
||||
int32_t fails = 0;
|
||||
|
||||
#if (DEFAULT_TASK_DI_PUBLISH_EN == 0)
|
||||
/* 测试套件构建:卷上写者不是本任务,本函数不发布也不写日志(见函数说明四) */
|
||||
(void)mask; (void)rc; (void)i; (void)now; (void)edges; (void)fails;
|
||||
return 0u;
|
||||
#else
|
||||
if (ioboard_di_read(&mask) == BSP_OK) {
|
||||
/* 成功:第一拍(或刚从故障恢复)先整组重新确立基准,再喂本拍 */
|
||||
if (s_di_snap.valid == 0u) {
|
||||
ioboard_di_ch_reset(s_di_ch, (uint8_t)IOBOARD_DI_CH_NUM, now);
|
||||
}
|
||||
for (i = 0u; i < (uint8_t)IOBOARD_DI_CH_NUM; i++) {
|
||||
uint8_t lvl = (uint8_t)((mask >> i) & 1u);
|
||||
|
||||
(void)ioboard_di_ch_feed(&s_di_ch[i], lvl, now, IOBOARD_DI_DEBOUNCE_MS);
|
||||
}
|
||||
/* 用**去抖后**的稳定值重新组合发布值(原始 mask 只用一次,不等抖就上报) */
|
||||
mask = 0u;
|
||||
for (i = 0u; i < (uint8_t)IOBOARD_DI_CH_NUM; i++) {
|
||||
if (s_di_ch[i].stable != 0u) {
|
||||
mask = (uint8_t)(mask | (uint8_t)(1u << i));
|
||||
}
|
||||
}
|
||||
s_di_pub_mask = mask;
|
||||
(void)ioboard_di_snap_publish(&s_di_snap, mask, 1u, 1u);
|
||||
rc = 1u;
|
||||
} else {
|
||||
/* 失败:不喂去抖、不写 mask,只把"旧值 + 无效"发布出去 */
|
||||
(void)ioboard_di_snap_publish(&s_di_snap, s_di_pub_mask, 0u, 0u);
|
||||
rc = 0u;
|
||||
}
|
||||
|
||||
/* 故障下降沿留痕(每个 episode 一条;recovers 由下一拍的有效发布体现) */
|
||||
ioboard_di_snap_faults(&s_di_snap, &edges, &fails);
|
||||
if (edges != s_di_fail_edges_seen) {
|
||||
s_di_fail_edges_seen = edges;
|
||||
syslog_post(SYSLOG_SELFTEST, "di read fault");
|
||||
}
|
||||
|
||||
return rc;
|
||||
#endif
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user