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 根钩子全通过。
218 lines
6.1 KiB
C
218 lines
6.1 KiB
C
/*
|
||
* 模块名称:开入(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;
|
||
}
|
||
}
|