103 lines
2.7 KiB
C
103 lines
2.7 KiB
C
/**
|
||
******************************************************************************
|
||
* @file io_monitor.h
|
||
* @brief IO状态监控模块头文件
|
||
* @author Application Layer
|
||
* @version 1.1
|
||
******************************************************************************
|
||
* @attention
|
||
* 本模块实现四路数字输入(DI1-DI4)的状态监控
|
||
* 采用定时扫描+软件去抖方式检测IO状态变化
|
||
* 状态变化时通过回调函数上报，支持多端口路由
|
||
*
|
||
* 修订历史：
|
||
* v1.1 - 增加事件回调机制，支持多端口路由
|
||
******************************************************************************
|
||
*/
|
||
|
||
#ifndef __IO_MONITOR_H
|
||
#define __IO_MONITOR_H
|
||
|
||
#ifdef __cplusplus
|
||
extern "C" {
|
||
#endif
|
||
|
||
#include <stdint.h>
|
||
#include <stdbool.h>
|
||
|
||
#define IO_CHANNEL_COUNT 4
|
||
#define IO_SCAN_PERIOD_MS 10
|
||
#define IO_DEBOUNCE_COUNT 3
|
||
|
||
/**
|
||
* @brief IO事件回调函数类型
|
||
* @note 当IO状态变化时调用，用于事件路由
|
||
* @param channel: 通道号(0-3对应DI1-DI4)
|
||
* @param state: 当前状态(0=LOW, 1=HIGH)
|
||
* @param event_msg: 事件消息字符串
|
||
*/
|
||
typedef void (*io_event_callback_t)(uint8_t channel, uint8_t state, const char *event_msg);
|
||
|
||
/**
|
||
* @brief 初始化IO监控模块
|
||
* @note 初始化各通道状态，读取初始IO电平
|
||
* @param 无
|
||
* @retval 无
|
||
*/
|
||
void IO_Monitor_Init(void);
|
||
|
||
/**
|
||
* @brief IO监控任务处理函数
|
||
* @note 在主循环中调用，每10ms扫描一次IO状态
|
||
* 检测到状态变化时自动上报
|
||
* @param 无
|
||
* @retval 无
|
||
*/
|
||
void IO_Monitor_Task(void);
|
||
|
||
/**
|
||
* @brief 获取指定通道的IO状态
|
||
* @note 返回经过去抖处理后的稳定状态
|
||
* @param channel: 通道号(0-3对应DI1-DI4)
|
||
* @retval 0: LOW, 1: HIGH
|
||
*/
|
||
uint8_t IO_Monitor_GetState(uint8_t channel);
|
||
|
||
/**
|
||
* @brief 获取所有IO通道状态
|
||
* @note 返回4位状态值，每位对应一个通道
|
||
* @param 无
|
||
* @retval 状态值 (bit0=DI1, bit1=DI2, bit2=DI3, bit3=DI4)
|
||
*/
|
||
uint8_t IO_Monitor_GetAllStates(void);
|
||
|
||
/**
|
||
* @brief 启用/禁用IO状态变化上报
|
||
* @note 禁用后状态变化不会触发上报，但状态仍会更新
|
||
* @param enable: true=启用, false=禁用
|
||
* @retval 无
|
||
*/
|
||
void IO_Monitor_EnableReport(bool enable);
|
||
|
||
/**
|
||
* @brief 获取IO状态变化次数统计
|
||
* @note 用于调试和诊断
|
||
* @param channel: 通道号(0-3)
|
||
* @retval 该通道的状态变化次数
|
||
*/
|
||
uint32_t IO_Monitor_GetChangeCount(uint8_t channel);
|
||
|
||
/**
|
||
* @brief 设置IO事件回调函数
|
||
* @note 设置后，IO状态变化将通过回调函数上报
|
||
* @param callback: 回调函数指针，NULL则使用默认UART2输出
|
||
* @retval 无
|
||
*/
|
||
void IO_Monitor_SetEventCallback(io_event_callback_t callback);
|
||
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
|
||
#endif
|