/**
 * @file modbus_operate_module.h
 * @author zhangcheng
 * @brief modbus请求操作处理模块接口文件
 * @version v0.1
 * @date 2025-07-25
 * 
 * @copyright Copyright (c) 2025
 */


#ifndef _MODBUS_OPERATE_MODULE_H
#define _MODBUS_OPERATE_MODULE_H

#include "../inc/modbus.h"

/**
 * @brief           请求操作处理模块初始化
 * @details
 * 
 * @param[in]       无
 * 
 * @return          RESUIL          初始化结果
 * @retval          MODBUS_TURE     成功
 * @retval          MODBUS_FALSE    失败
 */
RESUIL OperateProcModuleInit(void);


/**
 * @brief           读取操作执行结果
 * @details
 * 
 * @param[out]       *ackFrame      接收应答帧结构体地址
 * 
 * @return          RESUIL          发送结果
 * @retval          MODBUS_TURE     成功
 * @retval          MODBUS_FALSE    失败
 */
RESUIL OperateAckFrameRead(ACK_FRAME *ackFrame, INT32U timeOut);


/**
 * @brief           写历史记录
 * @details
 * 
 * @param[in]      *data            数据缓冲区
 * @param[in]       dataLenght      数据长度
 * @param[in]       type            帧类型
 *                                  0 ：请求帧
 *                                  1 ：应答帧
 * 
 * @return          RESUIL          写入结果
 * @retval          MODBUS_TURE     成功
 * @retval          MODBUS_FALSE    失败
 */
RESUIL OperateWriteHistory(uint8_t *data, uint16_t dataLenght, uint8_t type);


/**
 * @brief           读历史记录
 * @details
 * 
 * @param[int]      无
 * 
 * @return          CORRESPONDENCE_HISTORY*          通信记录数据地址
 */
CORRESPONDENCE_HISTORY *OperateReadHistory(void);

#endif // !_MODBUS_OPERATE_MODULE_H