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:
+33
-16
@@ -46,16 +46,22 @@ void MX_GPIO_Init(void)
|
||||
|
||||
/* GPIO Ports Clock Enable */
|
||||
__HAL_RCC_GPIOE_CLK_ENABLE();
|
||||
__HAL_RCC_GPIOC_CLK_ENABLE();
|
||||
__HAL_RCC_GPIOF_CLK_ENABLE();
|
||||
__HAL_RCC_GPIOH_CLK_ENABLE();
|
||||
__HAL_RCC_GPIOA_CLK_ENABLE();
|
||||
__HAL_RCC_GPIOC_CLK_ENABLE();
|
||||
__HAL_RCC_GPIOB_CLK_ENABLE();
|
||||
__HAL_RCC_GPIOF_CLK_ENABLE();
|
||||
__HAL_RCC_GPIOG_CLK_ENABLE();
|
||||
__HAL_RCC_GPIOD_CLK_ENABLE();
|
||||
|
||||
/*Configure GPIO pin Output Level */
|
||||
HAL_GPIO_WritePin(GPIOC, LED1_Pin|TP_RD_Pin, GPIO_PIN_SET);
|
||||
HAL_GPIO_WritePin(GPIOC, KO6_Pin|HC165_CLK_Pin|TP_CONVST_Pin, GPIO_PIN_RESET);
|
||||
|
||||
/*Configure GPIO pin Output Level */
|
||||
HAL_GPIO_WritePin(GPIOF, TRIP_LED_Pin|ERT_LED_Pin|CLZ_LED_Pin, GPIO_PIN_RESET);
|
||||
|
||||
/*Configure GPIO pin Output Level */
|
||||
HAL_GPIO_WritePin(GPIOC, HC165_LD_Pin|LED1_Pin|TP_RD_Pin, GPIO_PIN_SET);
|
||||
|
||||
/*Configure GPIO pin Output Level */
|
||||
HAL_GPIO_WritePin(GPIOB, LED2_Pin|LED3_Pin|LED4_Pin|CH395_SCS_Pin
|
||||
@@ -64,20 +70,38 @@ void MX_GPIO_Init(void)
|
||||
/*Configure GPIO pin Output Level */
|
||||
HAL_GPIO_WritePin(GPIOF, LED5_Pin|LED6_Pin, GPIO_PIN_SET);
|
||||
|
||||
/*Configure GPIO pin Output Level */
|
||||
HAL_GPIO_WritePin(TP_CONVST_GPIO_Port, TP_CONVST_Pin, GPIO_PIN_RESET);
|
||||
|
||||
/*Configure GPIO pin Output Level */
|
||||
HAL_GPIO_WritePin(GPIOA, TP_OS2_Pin|TP_OS1_Pin|TP_OS0_Pin|ST_DIR4_Pin, GPIO_PIN_RESET);
|
||||
|
||||
/*Configure GPIO pin Output Level */
|
||||
HAL_GPIO_WritePin(GPIOE, GD_CS_Pin|GD_HOLD_Pin, GPIO_PIN_SET);
|
||||
|
||||
/*Configure GPIO pin : CH395_INT_Pin */
|
||||
GPIO_InitStruct.Pin = CH395_INT_Pin;
|
||||
/*Configure GPIO pins : IN_D4_Pin HC165_IN2_Pin IN_E4_Pin CH395_INT_Pin */
|
||||
GPIO_InitStruct.Pin = IN_D4_Pin|HC165_IN2_Pin|IN_E4_Pin|CH395_INT_Pin;
|
||||
GPIO_InitStruct.Mode = GPIO_MODE_INPUT;
|
||||
GPIO_InitStruct.Pull = GPIO_NOPULL;
|
||||
HAL_GPIO_Init(CH395_INT_GPIO_Port, &GPIO_InitStruct);
|
||||
HAL_GPIO_Init(GPIOE, &GPIO_InitStruct);
|
||||
|
||||
/*Configure GPIO pins : KO6_Pin HC165_CLK_Pin */
|
||||
GPIO_InitStruct.Pin = KO6_Pin|HC165_CLK_Pin;
|
||||
GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;
|
||||
GPIO_InitStruct.Pull = GPIO_NOPULL;
|
||||
GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW;
|
||||
HAL_GPIO_Init(GPIOC, &GPIO_InitStruct);
|
||||
|
||||
/*Configure GPIO pins : TRIP_LED_Pin ERT_LED_Pin CLZ_LED_Pin */
|
||||
GPIO_InitStruct.Pin = TRIP_LED_Pin|ERT_LED_Pin|CLZ_LED_Pin;
|
||||
GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;
|
||||
GPIO_InitStruct.Pull = GPIO_NOPULL;
|
||||
GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW;
|
||||
HAL_GPIO_Init(GPIOF, &GPIO_InitStruct);
|
||||
|
||||
/*Configure GPIO pins : HC165_LD_Pin TP_RD_Pin TP_CONVST_Pin */
|
||||
GPIO_InitStruct.Pin = HC165_LD_Pin|TP_RD_Pin|TP_CONVST_Pin;
|
||||
GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;
|
||||
GPIO_InitStruct.Pull = GPIO_NOPULL;
|
||||
GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_VERY_HIGH;
|
||||
HAL_GPIO_Init(GPIOC, &GPIO_InitStruct);
|
||||
|
||||
/*Configure GPIO pin : LED1_Pin */
|
||||
GPIO_InitStruct.Pin = LED1_Pin;
|
||||
@@ -131,13 +155,6 @@ void MX_GPIO_Init(void)
|
||||
GPIO_InitStruct.Pull = GPIO_NOPULL;
|
||||
HAL_GPIO_Init(TP_BUSY_GPIO_Port, &GPIO_InitStruct);
|
||||
|
||||
/*Configure GPIO pins : TP_RD_Pin TP_CONVST_Pin */
|
||||
GPIO_InitStruct.Pin = TP_RD_Pin|TP_CONVST_Pin;
|
||||
GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;
|
||||
GPIO_InitStruct.Pull = GPIO_NOPULL;
|
||||
GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_VERY_HIGH;
|
||||
HAL_GPIO_Init(GPIOC, &GPIO_InitStruct);
|
||||
|
||||
/*Configure GPIO pins : TP_OS2_Pin TP_OS0_Pin */
|
||||
GPIO_InitStruct.Pin = TP_OS2_Pin|TP_OS0_Pin;
|
||||
GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;
|
||||
|
||||
+26
@@ -44,6 +44,7 @@
|
||||
#include "task_watchdog.h" /* task_wd_tick_probe():第 8b 轮时间源存活性取证 */
|
||||
#include "adc_task.h" /* adc_tick_irq_notify():TIM3 采样节拍 → 唤醒 adcTask */
|
||||
#include "sb_link.h" /* sb_link_ms_tick():TIM3 1 kHz 顺手做按键召唤延迟应答的毫秒时钟 */
|
||||
#include "ioboard.h" /* ioboard_init():开入开出板上电确认(全释放 + 静止态) */
|
||||
/* USER CODE END Includes */
|
||||
|
||||
/* Private typedef -----------------------------------------------------------*/
|
||||
@@ -71,6 +72,13 @@
|
||||
|
||||
/* USER CODE BEGIN PV */
|
||||
/* RS-485 实例与接收缓冲已收归 rs485.c(见 rs485.h 的 extern 导出) */
|
||||
|
||||
/*
|
||||
* 开入开出板上电确认结果:0 = ioboard_init() 成功,1 = 失败。
|
||||
* 只做取证用途,不参与任何控制决策——失败不阻断启动,理由见 main() 里
|
||||
* 调用点的注释。放在 .noinit 之外(普通 .bss),每次上电由启动代码清零。
|
||||
*/
|
||||
uint8_t g_ioboard_init_rc;
|
||||
/* USER CODE END PV */
|
||||
|
||||
/* Private function prototypes -----------------------------------------------*/
|
||||
@@ -142,6 +150,24 @@ int main(void)
|
||||
/* USER CODE BEGIN 2 */
|
||||
HAL_Delay(100);
|
||||
|
||||
/*
|
||||
* 开入开出板:在 app_main_init 之前把 4 路出口继电器钉在「全释放」。
|
||||
*
|
||||
* 为什么必须排在这里而不放进 app_main_init:
|
||||
* 出口继电器由光耦驱动,一旦吸合就是一次真实的开关量输出。上电后到
|
||||
* 应用层建立起自己状态之间的这段时间里,继电器不该处于任何「未定义」
|
||||
* 位置。MX_GPIO_Init 给的初值已经是释放电平,本调用是把它**确认并锁存**
|
||||
* 到影子寄存器,顺带把 74HC165 拉回静止态(SH/LD 高 + CLK 低),
|
||||
* 让第一次 ioboard_di_read 不需要额外的补救动作。
|
||||
*
|
||||
* 为什么失败只记不拦:本函数返回错误说明引脚状态不符合预期(多半是
|
||||
* 硬件问题),但这不该让整机停在上电阶段——网络、存储、采集仍要起来。
|
||||
* 错误码留给开机自检与后续 ioboard_di_read 的失败计数去体现。
|
||||
*/
|
||||
if (ioboard_init() != BSP_OK) {
|
||||
g_ioboard_init_rc = 1u; /* 供开机日志取证;不阻断启动 */
|
||||
}
|
||||
|
||||
/* 应用层初始化(时间子系统优先,详见 app_main_init) */
|
||||
app_main_init();
|
||||
/* USER CODE END 2 */
|
||||
|
||||
Reference in New Issue
Block a user