112 lines
3.7 KiB
C
112 lines
3.7 KiB
C
/**
|
||
**********************************************************************************************************************
|
||
* @file menu_port.h
|
||
* @brief 菜单组件硬件端口层定义
|
||
* @author menu_component
|
||
* @date 2025-12-19
|
||
**********************************************************************************************************************
|
||
*/
|
||
|
||
#ifndef MENU_PORT_H
|
||
#define MENU_PORT_H
|
||
|
||
/* Includes ----------------------------------------------------------------------------------------------------------*/
|
||
#include "../src/core/menu_config.h"
|
||
#include <stdarg.h>
|
||
|
||
/* 类型定义 ---------------------------------------------------------------------------------------------------------*/
|
||
|
||
/**
|
||
* @brief Modbus寄存器类型
|
||
*/
|
||
typedef enum {
|
||
MODBUS_REG_TYPE_COIL, /*!< 线圈寄存器 */
|
||
MODBUS_REG_TYPE_DISCRETE_INPUT, /*!< 离散输入寄存器 */
|
||
MODBUS_REG_TYPE_HOLDING_REG, /*!< 保持寄存器 */
|
||
MODBUS_REG_TYPE_INPUT_REG, /*!< 输入寄存器 */
|
||
} ModbusRegType;
|
||
|
||
/**
|
||
* @brief 持久化操作回调函数类型定义
|
||
*/
|
||
typedef MenuErrCode (*MenuPersistenceSaveCallback)(const uint8_t* data, uint16_t size); ///< 保存持久化数据回调
|
||
typedef MenuErrCode (*MenuPersistenceRestoreCallback)(uint8_t* data, uint16_t* size); ///< 恢复持久化数据回调
|
||
|
||
/**
|
||
* @brief 硬件驱动结构体
|
||
*/
|
||
typedef struct {
|
||
void (*printf)(const char* fmt, va_list args); ///< 硬件打印接口
|
||
uint32_t (*get_tick)(void); ///< 获取系统滴答时间
|
||
void (*delay_ms)(uint32_t ms); ///< 硬件延迟函数
|
||
void (*display)(const char* menu_name, uint16_t menu_id); ///< 菜单显示接口
|
||
MenuEventType (*key_scan)(void); ///< 按键扫描接口（可选）
|
||
void (*irq_ctrl)(bool enable); ///< 中断管理接口（可选）
|
||
void (*error_handler)(MenuErrCode err_code); ///< 错误处理接口（可选）
|
||
MenuErrCode (*modbus_send)(ModbusRegType reg_type, uint16_t reg_addr, const uint8_t* reg_buf, uint8_t buf_len); ///< Modbus发送接口（可选）
|
||
MenuErrCode (*modbus_receive)(ModbusRegType reg_type, uint16_t reg_addr, uint8_t* reg_buf, uint8_t buf_len); ///< Modbus接收接口（可选）
|
||
MenuPersistenceSaveCallback persistence_save; ///< 持久化数据保存接口（可选）
|
||
MenuPersistenceRestoreCallback persistence_restore; ///< 持久化数据恢复接口（可选）
|
||
} MenuPortDriver;
|
||
|
||
/* 函数声明 ---------------------------------------------------------------------------------------------------------*/
|
||
|
||
/**
|
||
* @brief 初始化硬件端口层
|
||
* @param driver 硬件驱动结构体指针
|
||
* @return 错误码
|
||
*/
|
||
MenuErrCode menu_port_init(const MenuPortDriver* driver);
|
||
|
||
/**
|
||
* @brief 反初始化硬件端口层
|
||
* @return 错误码
|
||
*/
|
||
MenuErrCode menu_port_deinit(void);
|
||
|
||
/**
|
||
* @brief 获取当前系统时间（ms）
|
||
* @return 系统时间（ms）
|
||
*/
|
||
uint32_t menu_port_get_tick(void);
|
||
|
||
/**
|
||
* @brief 硬件延迟函数
|
||
* @param ms 延迟时间（ms）
|
||
*/
|
||
void menu_port_delay_ms(uint32_t ms);
|
||
|
||
/**
|
||
* @brief 打印函数
|
||
* @param fmt 格式化字符串
|
||
* @param ... 可变参数
|
||
*/
|
||
void menu_port_printf(const char* fmt, ...);
|
||
|
||
/**
|
||
* @brief 菜单显示函数
|
||
* @param menu_name 菜单名称
|
||
* @param menu_id 菜单ID
|
||
*/
|
||
void menu_port_display(const char* menu_name, uint16_t menu_id);
|
||
|
||
/**
|
||
* @brief 按键扫描函数
|
||
* @return 按键事件类型
|
||
*/
|
||
MenuEventType menu_port_key_scan(void);
|
||
|
||
/**
|
||
* @brief 中断管理函数
|
||
* @param enable 是否启用中断
|
||
*/
|
||
void menu_port_irq_ctrl(bool enable);
|
||
|
||
/**
|
||
* @brief 错误处理函数
|
||
* @param err_code 错误码
|
||
*/
|
||
void menu_port_error_handler(MenuErrCode err_code);
|
||
|
||
#endif /* MENU_PORT_H */
|