Files
STM32F4-Base/App/util/ioboard_di.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

218 lines
6.1 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.
/*
* 模块名称:开入(DI)去抖与快照——纯逻辑实现(本模块可主机侧测试的那一半)
* 模块功能:ioboard_di.h 全部纯函数。零 HAL、零 FreeRTOS、零全局可变状态,
* MCU(ARMCC C99)与主机侧 MSVC 编译**同一份源码**。
* 适用平台:任何 C99
* 作者:王建锋
* 创建日期:2026-11-16
* 修改记录:
* 2026-11-16 王建锋 创建
*/
#include "ioboard_di.h"
/* 空指针统一按 "0" 处理:本层是纯逻辑,不为防御性检查引入错误码;
* 调用方(defaultTask)传的都是静态对象地址,NULL 只可能出现在测试里 */
static uint8_t di_is_null(const void *p)
{
return (p == 0) ? 1U : 0U;
}
/* ======================== 通道去抖 ======================== */
void ioboard_di_ch_reset(ioboard_di_ch_t *ch, uint8_t n, uint32_t now_ms)
{
uint8_t i;
if (di_is_null(ch) != 0U) {
return;
}
for (i = 0U; i < n; i++) {
ch[i].t_ms = now_ms;
ch[i].raw = 0U;
ch[i].stable = 0U;
ch[i].started = 0U;
}
}
uint8_t ioboard_di_ch_feed(ioboard_di_ch_t *c, uint8_t level, uint32_t now_ms,
uint32_t window_ms)
{
uint8_t lvl;
if (di_is_null(c) != 0U) {
return 0U;
}
lvl = (level != 0U) ? 1U : 0U;
/* 一、首个样本直接确立:上电后不必空等一个窗口才有开入值 */
if (c->started == 0U) {
c->started = 1U;
c->raw = lvl;
c->stable = lvl;
c->t_ms = now_ms;
return 0U; /* 首拍不算"稳定电平翻转":此前没有稳定值可翻 */
}
/* 二、原始电平变了:重新开始计时。抖动只会不断推迟翻转,这就是去抖 */
if (lvl != c->raw) {
c->raw = lvl;
c->t_ms = now_ms;
return 0U;
}
/* 三、原始电平持续满窗口 → 稳定电平跟随。
* 用无符号减法而不是 now >= t + window:tick 在 49.7 天处回绕时前者依然正确,
* 后者会在回绕附近出现一次长达 49 天的"永不翻转"(或者反过来瞬间误翻)。
* 边界取 >=:恰好满 20 ms 就应翻转。 */
if ((c->stable != lvl) && ((uint32_t)(now_ms - c->t_ms) >= window_ms)) {
c->stable = lvl;
return 1U;
}
return 0U;
}
/* ======================== 双区快照 ======================== */
uint8_t ioboard_di_snap_publish(ioboard_di_snapshot_t *s, uint8_t mask, uint8_t valid,
uint8_t is_fail)
{
uint8_t changed;
uint8_t was_valid;
if (di_is_null(s) != 0U) {
return 0U;
}
/* 先递增成奇数 = "正在写";数据写完再递增成偶数 = "可读" */
s->seq++;
was_valid = s->valid;
changed = 0U;
if (s->change_seq == 0U) {
/* 第一次发布:视为一次变化(让上位机区分"还没有值"与"已建立基线") */
changed = 1U;
} else if (s->mask != mask) {
changed = 1U;
}
/* 读失败**不自行写 0**:mask 就是调用方传进来的值(失败拍传的是上一有效值) */
s->mask = mask;
s->valid = (valid != 0U) ? 1U : 0U;
if (is_fail == 0U) {
if (s->fail_count < (int32_t)IOBOARD_DI_FAIL_COUNT_CAP) {
s->fail_count++;
}
} else {
/* 任何一次成功读都说明"当前这一拍读到了":计数从 0 重新累计,
* 表示**连续**失败拍数。不归零的话,一次偶发失败会让计数永久停在上界,
* 之后真正的断线再也看不出来(饱和计数只拦"长时间连续断线")。 */
s->fail_count = 0;
}
/* 有效 → 失效 的下降沿记一次故障次数(恢复沿不改 fail_edges,靠 valid 回落体现) */
if ((was_valid != 0U) && (s->valid == 0U)) {
s->fail_edges++;
}
if (changed != 0U) {
s->change_seq++;
}
s->seq++;
return changed;
}
uint8_t ioboard_di_snap_read(const ioboard_di_snapshot_t *s, uint8_t *out_mask,
uint32_t *out_seq)
{
uint32_t s1;
uint32_t s2;
uint8_t n;
if (di_is_null(s) != 0U) {
if (out_mask != 0) {
*out_mask = 0U;
}
if (out_seq != 0) {
*out_seq = 0U;
}
return 0U;
}
/* 一次读取两遍并校验序号:读期间若被写者打断,序号会变化或为奇数 → 作废重来 */
for (n = 0U; n < (uint8_t)IOBOARD_DI_SNAP_RETRY; n++) {
s1 = s->seq;
if ((s1 & 1U) != 0U) {
continue; /* 写者正在写 */
}
if (out_mask != 0) {
*out_mask = s->mask;
}
if (out_seq != 0) {
*out_seq = s->change_seq;
}
s2 = s->seq;
if ((s1 == s2) && ((s2 & 1U) == 0U)) {
return (s->valid != 0U) ? 1U : 0U;
}
}
/* 连续被打断 20 次:本次不给值(调用方按"无新数据"处理,绝不拿半新半旧的东西) */
return 0U;
}
void ioboard_di_snap_reset(ioboard_di_snapshot_t *s)
{
if (di_is_null(s) != 0U) {
return;
}
s->seq = 0U;
s->mask = 0U;
s->valid = 0U;
s->fail_count = 0;
s->fail_edges = 0U;
s->change_seq = 0U;
}
void ioboard_di_snap_copy(const ioboard_di_snapshot_t *s, ioboard_di_snapshot_t *out)
{
if ((di_is_null(s) != 0U) || (di_is_null(out) != 0U)) {
return;
}
out->seq = s->seq;
out->mask = s->mask;
out->valid = s->valid;
out->fail_count = s->fail_count;
out->fail_edges = s->fail_edges;
out->change_seq = s->change_seq;
}
void ioboard_di_snap_faults(const ioboard_di_snapshot_t *s, uint32_t *out_edges,
int32_t *out_fails)
{
if (di_is_null(s) != 0U) {
if (out_edges != 0) {
*out_edges = 0U;
}
if (out_fails != 0) {
*out_fails = 0;
}
return;
}
if (out_edges != 0) {
*out_edges = s->fail_edges;
}
if (out_fails != 0) {
*out_fails = s->fail_count;
}
}