add more comments

This commit is contained in:
wmano
2025-11-18 00:40:02 +08:00
parent 9b3e035b75
commit 7e463e56ad
48 changed files with 2334 additions and 497 deletions
+88 -1
View File
@@ -1,3 +1,11 @@
/****************************************************************************
文件名称 : chrg_comm.c
完成日期 :
当前版本号 : V1.0
主要功能 : 实现对外通讯协议 MODBUS 服务端,以独立线程等待处理响应请求数据。
版本历史 : 创建原始版本
说明 :
******************************************************************************/
#include <string.h>
#include <rtthread.h>
@@ -327,6 +335,14 @@ eMBErrorCode mb_reg_discrete_cb (rt_uint8_t *pucRegBuffer, rt_uint16_t usAddress
return eStatus;
}
/*****************************************************************
函数名称: funcReadCoils
函数描述: 读多个继电器
输入参数: reqFrame: 请求数据 reqLen: 请求长度 resFrame:响应数据 resLen:响应长度
输出参数: -
返回说明: -
其它说明: -
*****************************************************************/
eMBException funcReadCoils (rt_uint8_t *reqFrame, rt_uint16_t reqLen,
rt_uint8_t *resFrame, rt_uint16_t *resLen)
{
@@ -360,6 +376,14 @@ eMBException funcReadCoils (rt_uint8_t *reqFrame, rt_uint16_t reqLen,
return eStatus;
}
/*****************************************************************
函数名称: funcReadDiscreteInputs
函数描述: 读离散输入
输入参数: reqFrame: 请求数据 reqLen: 请求长度 resFrame:响应数据 resLen:响应长度
输出参数: -
返回说明: -
其它说明: -
*****************************************************************/
eMBException funcReadDiscreteInputs (rt_uint8_t *reqFrame, rt_uint16_t reqLen,
rt_uint8_t *resFrame, rt_uint16_t *resLen)
{
@@ -393,6 +417,14 @@ eMBException funcReadDiscreteInputs (rt_uint8_t *reqFrame, rt_uint16_t reqLen,
return eStatus;
}
/*****************************************************************
函数名称: funcReadHoldingRegister
函数描述: 读保持寄存器
输入参数: reqFrame: 请求数据 reqLen: 请求长度 resFrame:响应数据 resLen:响应长度
输出参数: -
返回说明: -
其它说明: -
*****************************************************************/
eMBException funcReadHoldingRegister (rt_uint8_t *reqFrame, rt_uint16_t reqLen,
rt_uint8_t *resFrame, rt_uint16_t *resLen)
{
@@ -425,6 +457,14 @@ eMBException funcReadHoldingRegister (rt_uint8_t *reqFrame, rt_uint16_t reqLen,
return eStatus;
}
/*****************************************************************
函数名称: funcReadInputRegister
函数描述: 读输入寄存器
输入参数: reqFrame: 请求数据 reqLen: 请求长度 resFrame:响应数据 resLen:响应长度
输出参数: -
返回说明: -
其它说明: -
*****************************************************************/
eMBException funcReadInputRegister (rt_uint8_t *reqFrame, rt_uint16_t reqLen,
rt_uint8_t *resFrame, rt_uint16_t *resLen)
{
@@ -457,6 +497,14 @@ eMBException funcReadInputRegister (rt_uint8_t *reqFrame, rt_uint16_t reqLen,
return eStatus;
}
/*****************************************************************
函数名称: funcWriteCoil
函数描述: 写单个保持继电器
输入参数: reqFrame: 请求数据 reqLen: 请求长度 resFrame:响应数据 resLen:响应长度
输出参数: -
返回说明: -
其它说明: -
*****************************************************************/
eMBException funcWriteCoil (rt_uint8_t *reqFrame, rt_uint16_t reqLen,
rt_uint8_t *resFrame, rt_uint16_t *resLen)
{
@@ -494,6 +542,14 @@ eMBException funcWriteCoil (rt_uint8_t *reqFrame, rt_uint16_t reqLen,
return eStatus;
}
/*****************************************************************
函数名称: funcWriteHoldingRegister
函数描述: 写多个保持继电器
输入参数: reqFrame: 请求数据 reqLen: 请求长度 resFrame:响应数据 resLen:响应长度
输出参数: -
返回说明: -
其它说明: -
*****************************************************************/
eMBException funcWriteHoldingRegister (rt_uint8_t *reqFrame, rt_uint16_t reqLen,
rt_uint8_t *resFrame, rt_uint16_t *resLen)
{
@@ -519,6 +575,14 @@ eMBException funcWriteHoldingRegister (rt_uint8_t *reqFrame, rt_uint16_t reqLen,
return eStatus;
}
/*****************************************************************
函数名称: funcWriteMultipleCoils
函数描述: 写多个继电器
输入参数: reqFrame: 请求数据 reqLen: 请求长度 resFrame:响应数据 resLen:响应长度
输出参数: -
返回说明: -
其它说明: -
*****************************************************************/
eMBException funcWriteMultipleCoils (rt_uint8_t *reqFrame, rt_uint16_t reqLen,
rt_uint8_t *resFrame, rt_uint16_t *resLen)
{
@@ -555,6 +619,14 @@ eMBException funcWriteMultipleCoils (rt_uint8_t *reqFrame, rt_uint16_t reqLen,
return eStatus;
}
/*****************************************************************
函数名称: funcWriteMultipleHoldingRegister
函数描述: 写多个寄存器
输入参数: reqFrame: 请求数据 reqLen: 请求长度 resFrame:响应数据 resLen:响应长度
输出参数: -
返回说明: -
其它说明: -
*****************************************************************/
eMBException funcWriteMultipleHoldingRegister (rt_uint8_t *reqFrame, rt_uint16_t reqLen,
rt_uint8_t *resFrame, rt_uint16_t *resLen)
{
@@ -602,7 +674,14 @@ static struct code_func_t funcHandlers[MB_HANDLERS_MAX] = {
{MB_WRITE_MULTIPLE_REGISTERS, funcWriteMultipleHoldingRegister},
};
/*****************************************************************
函数名称: chrg_comm_parse_msg
函数描述: 解析请求的消息
输入参数: pCOMM: 消息结构
输出参数: -
返回说明: -
其它说明: 分命令处理对应消息。地址为广播时不应答
*****************************************************************/
static int chrg_comm_parse_msg (struct chrg_comm_t *pCOMM)
{
if (RT_NULL == pCOMM) {
@@ -661,6 +740,14 @@ static int chrg_comm_parse_msg (struct chrg_comm_t *pCOMM)
return ret;
}
/*****************************************************************
函数名称: chrg_comm_thread_entry
函数描述: 对外RS485通信线程体
输入参数: *data: 本线程信息
输出参数: -
返回说明: -
其它说明: -
*****************************************************************/
void chrg_comm_thread_entry (void *data)
{
struct chrg_thread_t *pTHR = (struct chrg_thread_t *)data;