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


#ifndef _MODBUS_REQUEST_MODULE_H
#define _MODBUS_REQUEST_MODULE_H

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

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


/**
 * @brief           读取请求帧
 * @details
 * 
 * @param[out]      *requestFrame   接收请求数据帧结构体地址
 * @param[in]       timeOut         读取请求帧数据超时时间
 * 
 * @return          RESUIL          读取结果
 * @retval          MODBUS_TURE     成功
 * @retval          MODBUS_FALSE    失败
 */
RESUIL RequestOperateDataRead(REQUEST_FRAME *requestFrame, INT32U timeOut);

/**
 * @brief           读取异常应答帧
 * @details
 * 
 * @param[out]       *ackFrame      接收异常应答帧结构体地址
 * @param[in]       timeOut         读取异常应答帧帧数据超时时间
 * 
 * @return          RESUIL          读取结果
 * @retval          MODBUS_TURE     成功
 * @retval          MODBUS_FALSE    失败
 */
RESUIL RequestErrorAckFrameRead(ACK_FRAME *ackFrame, INT32U timeOut);

#endif // !_MODBUS_REQUEST_MODULE_H