FreeModbus保持寄存器

保持寄存器的访问属性为读写

对保持寄存器的操作包括：读保持寄存器（0x03）、写单个保持寄存器（0x06）、写多个保持寄存器（0x10）、读写多个保持寄存器（0x17）

读保持寄存器（0x03）

在一个远程设备中，使用该功能码读取保持寄存器连续块的内容。请求PDU说明了起始寄存器地址和寄存器数量。从零开始寻址寄存器。因此，寻址寄存器1-16 为0-15。

将响应报文中的寄存器数据分成每个寄存器有两字节，在每个字节中直接地调整二进制内容。对于每个寄存器，第一个字节包括高位比特，并且第二个字节包括低位比特。

读保持寄存器状态图

/* 读保持寄存器 */
eMBException eMBFuncReadHoldingRegister(UCHAR *pucFrame, USHORT *usLen)
{USHORT usRegAddress;USHORT usRegCount;UCHAR *pucFrameCur;eMBException eStatus = MB_EX_NONE;eMBErrorCode eRegStatus;/* 校验PDU长度是否合理 */if(*usLen == (MB_PDU_FUNC_READ_SIZE + MB_PDU_SIZE_MIN)){/* 寄存器地址 */usRegAddress = (USHORT)(pucFrame[MB_PDU_FUNC_READ_ADDR_OFF] << 8);usRegAddress |= (USHORT)(pucFrame[MB_PDU_FUNC_READ_ADDR_OFF + 1]);/* 第1个寄存器寻址为0，所以地址加一 */usRegAddress++;/* 寄存器数量 */usRegCount = (USHORT)(pucFrame[MB_PDU_FUNC_READ_REGCNT_OFF] << 8);usRegCount = (USHORT)(pucFrame[MB_PDU_FUNC_READ_REGCNT_OFF + 1]);/* 检查寄存器数量是否合理 */if((usRegCount >= 1) && (usRegCount <= MB_PDU_FUNC_READ_REGCNT_MAX)){/* 构建响应 *//* PDU指针 */pucFrameCur = &pucFrame[MB_PDU_FUNC_OFF];/* PDU长度初始化为0 */*usLen = MB_PDU_FUNC_OFF;/* 功能码 */*pucFrameCur++ = MB_FUNC_READ_HOLDING_REGISTER;*usLen += 1;/* 字节数 */*pucFrameCur++ = (UCHAR)(usRegCount * 2);*usLen += 1;/* 读取保持寄存器数据 */eRegStatus = eMBRegHoldingCB(pucFrameCur, usRegAddress, usRegCount, MB_REG_READ);/* 产生异常 */if(eRegStatus != MB_ENOERR){/* 错误转化为异常码 */eStatus = prveMBError2Exception(eRegStatus);}/* 未产生异常 */else{/* 数据长度 */*usLen += usRegCount * 2;}}/* 寄存器数量不合理 */else{/* 非法数据值 */eStatus = MB_EX_ILLEGAL_DATA_VALUE;}}/* PDU长度不对 */else{/* 非法数据值 */eStatus = MB_EX_ILLEGAL_DATA_VALUE;}return eStatus;
}

写单个保持寄存器（0x06）

在一个远程设备中，使用该功能码写单个保持寄存器。请求PDU 说明了被写入寄存器的地址。从零开始寻址寄存器。因此，寻址寄存器1 为0。

正常响应是请求的应答，在写入寄存器内容之后返回这个正常响应。

写单个保持寄存器状态图

/* 写单个保持寄存器 */
eMBException eMBFuncWriteHoldingRegister(UCHAR *pucFrame, USHORT *usLen)
{USHORT usRegAddress;eMBException eStatus = MB_EX_NONE;eMBErrorCode eRegStatus;/* 校验PDU长度是否合理 */if(*usLen == (MB_PDU_FUNC_WRITE_SIZE + MB_PDU_SIZE_MIN)){/* 寄存器地址 */usRegAddress = (USHORT)(pucFrame[MB_PDU_FUNC_WRITE_ADDR_OFF] << 8);usRegAddress |= (USHORT)(pucFrame[MB_PDU_FUNC_WRITE_ADDR_OFF + 1]);/* 第1个寄存器寻址为0，所以地址加一 */usRegAddress++;/* 读写保持寄存器数据 */eRegStatus = eMBRegHoldingCB(&pucFrame[MB_PDU_FUNC_WRITE_VALUE_OFF],usRegAddress, 1, MB_REG_WRITE);/* 产生异常 */if(eRegStatus != MB_ENOERR){/* 错误转化为异常码 */eStatus = prveMBError2Exception(eRegStatus);}}/* PDU长度不对 */else{/* 非法数据值 */eStatus = MB_EX_ILLEGAL_DATA_VALUE;}return eStatus;
}

写多个保持寄存器（0x10）

在一个远程设备中，使用该功能码写连续寄存器块(1 至约120 个寄存器)。在请求数据域中说明了请求写入的值。每个寄存器将数据分成两字节。

正常响应返回功能码、起始地址和被写入寄存器的数量。

写多个保持寄存器状态图

/* 写多个保持寄存器 */
eMBException eMBFuncWriteMultipleHoldingRegister(UCHAR *pucFrame, USHORT *usLen)
{USHORT usRegAddress;USHORT usRegCount;UCHAR ucRegByteCount;eMBException eStatus = MB_EX_NONE;eMBErrorCode eRegStatus;/* 校验PDU长度是否合理 */if(*usLen >= (MB_PDU_FUNC_WRITE_MUL_SIZE_MIN + MB_PDU_SIZE_MIN)){/* 寄存器地址 */usRegAddress = (USHORT)(pucFrame[MB_PDU_FUNC_WRITE_MUL_ADDR_OFF] << 8);usRegAddress |= (USHORT)(pucFrame[MB_PDU_FUNC_WRITE_MUL_ADDR_OFF + 1]);/* 第1个寄存器寻址为0，所以地址加一 */usRegAddress++;/* 寄存器数量 */usRegCount = (USHORT)(pucFrame[MB_PDU_FUNC_WRITE_MUL_REGCNT_OFF] << 8);usRegCount |= (USHORT)(pucFrame[MB_PDU_FUNC_WRITE_MUL_REGCNT_OFF + 1]);/* 字节数 */ucRegByteCount = pucFrame[MB_PDU_FUNC_WRITE_MUL_BYTECNT_OFF];/* 检查寄存器数量和字节数是否合理 */if((usRegCount >= 1) &&(usRegCount <= MB_PDU_FUNC_WRITE_MUL_REGCNT_MAX) &&(ucRegByteCount == (UCHAR)(2 * usRegCount))){/* 写保持寄存器数据 */eRegStatus = eMBRegHoldingCB(&pucFrame[MB_PDU_FUNC_WRITE_MUL_VALUES_OFF], usRegAddress, usRegCount, MB_REG_WRITE);/* 产生异常 */if(eRegStatus != MB_ENOERR){/* 错误转化为异常码 */eStatus = prveMBError2Exception(eRegStatus);}else{/* 数据长度 */*usLen = MB_PDU_FUNC_WRITE_MUL_BYTECNT_OFF;}}/* 寄存器数量或字节数不合理 */else{/* 非法数据值 */eStatus = MB_EX_ILLEGAL_DATA_VALUE;}}/* PDU长度不对 */else{/* 非法数据值 */eStatus = MB_EX_ILLEGAL_DATA_VALUE;}return eStatus;
}

读写多个保持寄存器（0x17）

在一个单独MODBUS 事务中，这个功能码实现了一个读操作和一个写操作的组合。从零开始寻址保持寄存器。因此，寻址保持寄存器1-16 为0-15。请求说明了起始地址、被读取的保持寄存器号和起始地址、保持寄存器号以及被写入的数据。在写数据域中，字节数说明随后的字节号。

正常响应包括被读出的寄存器组的数据。在读数据域中，字节数域说明随后的字节数量。

读写多个保持寄存器状态图

/* 读写多个保持寄存器 */
eMBException eMBFuncReadWriteMultipleHoldingRegister(UCHAR *pucFrame, USHORT *usLen)
{USHORT usRegReadAddress;USHORT usRegReadCount;USHORT usRegWriteAddress;USHORT usRegWriteCount;UCHAR ucRegWriteByteCount;UCHAR *pucFrameCur;eMBException eStatus = MB_EX_NONE;eMBErrorCode eRegStatus;/* 校验PDU长度是否合理 */if(*usLen >= (MB_PDU_FUNC_READWRITE_SIZE_MIN + MB_PDU_SIZE_MIN)){/* 读寄存器地址 */usRegReadAddress = (USHORT)(pucFrame[MB_PDU_FUNC_READWRITE_READ_ADDR_OFF] << 8U);usRegReadAddress |= (USHORT)(pucFrame[MB_PDU_FUNC_READWRITE_READ_ADDR_OFF + 1]);/* 第1个寄存器寻址为0，所以地址加一 */usRegReadAddress++;/* 读寄存器数量 */usRegReadCount = (USHORT)(pucFrame[MB_PDU_FUNC_READWRITE_READ_REGCNT_OFF] << 8U);usRegReadCount |= (USHORT)(pucFrame[MB_PDU_FUNC_READWRITE_READ_REGCNT_OFF + 1]);/* 写寄存器地址 */usRegWriteAddress = (USHORT)(pucFrame[MB_PDU_FUNC_READWRITE_WRITE_ADDR_OFF] << 8U);usRegWriteAddress |= (USHORT)(pucFrame[MB_PDU_FUNC_READWRITE_WRITE_ADDR_OFF + 1]);/* 第1个寄存器寻址为0，所以地址加一 */usRegWriteAddress++;/* 写寄存器数量 */usRegWriteCount = (USHORT)(pucFrame[MB_PDU_FUNC_READWRITE_WRITE_REGCNT_OFF] << 8U);usRegWriteCount |= (USHORT)(pucFrame[MB_PDU_FUNC_READWRITE_WRITE_REGCNT_OFF + 1]);/* 写字节数 */ucRegWriteByteCount = pucFrame[MB_PDU_FUNC_READWRITE_BYTECNT_OFF];/* 检查读、写寄存器数量和写字节数是否合理 */if((usRegReadCount >= 1) && (usRegReadCount <= 0x7D) &&(usRegWriteCount >= 1) && (usRegWriteCount <= 0x79) &&((2 * usRegWriteCount) == ucRegWriteByteCount)){/* 写保持寄存器数据 */eRegStatus = eMBRegHoldingCB(&pucFrame[MB_PDU_FUNC_READWRITE_WRITE_VALUES_OFF],usRegWriteAddress, usRegWriteCount, MB_REG_WRITE);if(eRegStatus == MB_ENOERR){/* 构建响应 *//* PDU指针 */pucFrameCur = &pucFrame[MB_PDU_FUNC_OFF];/* PDU长度初始化为0 */*usLen = MB_PDU_FUNC_OFF;/* 功能码 */*pucFrameCur++ = MB_FUNC_READWRITE_MULTIPLE_REGISTERS;*usLen += 1;/* 字节数 */*pucFrameCur++ = (UCHAR) (usRegReadCount * 2);*usLen += 1;/* 读取保持寄存器数据 */eRegStatus = eMBRegHoldingCB(pucFrameCur, usRegReadAddress, usRegReadCount, MB_REG_READ);/* 未产生异常 */if(eRegStatus == MB_ENOERR){/* 数据长度 */*usLen += 2 * usRegReadCount;}}/* 产生异常 */if(eRegStatus != MB_ENOERR){/* 错误转化为异常码 */eStatus = prveMBError2Exception(eRegStatus);}}/* 寄存器数量或字节数不合理 */else{/* 非法数据值 */eStatus = MB_EX_ILLEGAL_DATA_VALUE;}}return eStatus;
}