FreeModbus线圈
线圈的访问属性为读写
对线圈的操作包括:读线圈(0x01)、写单个线圈(0x05)、写多个线圈(0x0F)
读线圈(0x01)
在一个远程设备中,使用该功能码读取线圈的1 至2000 连续状态。请求PDU 详细说明了起始地址,即指定的第一个线圈地址和线圈编号。从零开始寻址线圈。因此寻址线圈1-16 为0-15。根据数据域的每个比特将响应报文中的线圈分成为一个线圈。指示状态为1= ON 和0= OFF。第一个数据字节的LSB(最低有效位)包括在询问中寻址的输出。其它线圈依次类推,一直到这个字节的高位端为止,并在后续字节中从低位到高位的顺序。
如果返回的输出数量不是八的倍数,将用零填充最后数据字节中的剩余比特(一直到字节的高位端)。字节数量域说明了数据的完整字节数。
读线圈状态图
/* 读线圈 */
eMBException eMBFuncReadCoils(UCHAR *pucFrame, USHORT *usLen)
{
USHORT usRegAddress;
USHORT usCoilCount;
UCHAR ucNBytes;
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++;
/* 线圈数量 */
usCoilCount = (USHORT)(pucFrame[MB_PDU_FUNC_READ_COILCNT_OFF] << 8);
usCoilCount |= (USHORT)(pucFrame[MB_PDU_FUNC_READ_COILCNT_OFF + 1]);
/* 检查线圈数量是否合理 */
if((usCoilCount >= 1) &&
(usCoilCount < MB_PDU_FUNC_READ_COILCNT_MAX))
{
/* 构建响应 */
/* PDU指针 */
pucFrameCur = &pucFrame[MB_PDU_FUNC_OFF];
/* PDU长度初始化为0 */
*usLen = MB_PDU_FUNC_OFF;
/* 功能码 */
*pucFrameCur++ = MB_FUNC_READ_COILS;
*usLen += 1;
/* 字节数 */
if((usCoilCount & 0x0007) != 0)
{
ucNBytes = (UCHAR)(usCoilCount / 8 + 1);
}
else
{
ucNBytes = (UCHAR)(usCoilCount / 8);
}
*pucFrameCur++ = ucNBytes;
*usLen += 1;
/* 读取线圈值 */
eRegStatus = eMBRegCoilsCB(pucFrameCur, usRegAddress, usCoilCount, MB_REG_READ);
/* 产生异常 */
if(eRegStatus != MB_ENOERR)
{
/* 错误转化为异常码 */
eStatus = prveMBError2Exception(eRegStatus);
}
/* 未产生异常 */
else
{
/* 数据长度 */
*usLen += ucNBytes;;
}
}
/* 线圈数量不合理 */
else
{
/* 非法数据值 */
eStatus = MB_EX_ILLEGAL_DATA_VALUE;
}
}
/* PDU长度不对 */
else
{
/* 非法数据值 */
eStatus = MB_EX_ILLEGAL_DATA_VALUE;
}
return eStatus;
}
写单个线圈(0x05)
在一个远程设备上,使用该功能码写单个输出为ON 或OFF。请求数据域中的常量说明请求的ON/OFF状态。十六进制值FF 00请求输出为ON。十六进制值00 00 请求输出为OFF。其它所有值均是非法的,并且对输出不起作用。请求PDU说明了强制的线圈地址。从零开始寻址线圈。因此,寻址线圈1 为0。线圈值域的常量说明请求的ON/OFF 状态。十六进制值0XFF00请求线圈为ON。十六进制值0X0000请求线圈为OFF。其它所有值均为非法的,并且对线圈不起作用。
正常响应是请求的应答,在写入线圈状态之后返回这个正常响应。
写单个线圈状态图
/* 写单个线圈 */
eMBException eMBFuncWriteCoil(UCHAR *pucFrame, USHORT *usLen)
{
USHORT usRegAddress;
UCHAR ucBuf[2];
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++;
/* 判断值是否合法,ON:0xFF00 OFF:0x0000 */
if((pucFrame[MB_PDU_FUNC_WRITE_VALUE_OFF + 1] == 0x00) &&
((pucFrame[MB_PDU_FUNC_WRITE_VALUE_OFF] == 0xFF) ||
(pucFrame[MB_PDU_FUNC_WRITE_VALUE_OFF] == 0x00)))
{
/* 将ON/OFF转换为位1/0 */
ucBuf[1] = 0;
if(pucFrame[MB_PDU_FUNC_WRITE_VALUE_OFF] == 0xFF)
{
ucBuf[0] = 1;
}
else
{
ucBuf[0] = 0;
}
/* 写入线圈值 */
eRegStatus = eMBRegCoilsCB(&ucBuf[0], usRegAddress, 1, MB_REG_WRITE);
/* 产生异常 */
if(eRegStatus != MB_ENOERR)
{
/* 错误转化为异常码 */
eStatus = prveMBError2Exception(eRegStatus);
}
}
/* 状态值错误 */
else
{
/* 非法数据值 */
eStatus = MB_EX_ILLEGAL_DATA_VALUE;
}
}
/* PDU长度不对 */
else
{
/* 非法数据值 */
eStatus = MB_EX_ILLEGAL_DATA_VALUE;
}
return eStatus;
}
写多个线圈(0x0F)
在一个远程设备中,使用该功能码强制线圈序列中的每个线圈为ON 或OFF。请求PDU说明了强制的线圈参考。从零开始寻址线圈。因此,寻址线圈1 为0。请求数据域的内容说明了被请求的ON/OFF 状态。域比特位置中的逻辑“1”请求相应输出为ON。域比特位置中的逻辑“0”请求相应输出为OFF。
正常响应返回功能码、起始地址和强制的线圈数量。
写多个线圈状态图
/* 写多个线圈 */
eMBException eMBFuncWriteMultipleCoils(UCHAR *pucFrame, USHORT *usLen)
{
USHORT usRegAddress;
USHORT usCoilCnt;
UCHAR ucByteCount;
UCHAR ucByteCountVerify;
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_MUL_ADDR_OFF] << 8);
usRegAddress |= (USHORT)(pucFrame[MB_PDU_FUNC_WRITE_MUL_ADDR_OFF + 1]);
/* 第1个线圈寻址为0,所以地址加一 */
usRegAddress++;
/* 线圈数量 */
usCoilCnt = (USHORT)(pucFrame[MB_PDU_FUNC_WRITE_MUL_COILCNT_OFF] << 8);
usCoilCnt |= (USHORT)(pucFrame[MB_PDU_FUNC_WRITE_MUL_COILCNT_OFF + 1]);
/* 字节数 */
ucByteCount = pucFrame[MB_PDU_FUNC_WRITE_MUL_BYTECNT_OFF];
/* 计算字节数 */
if((usCoilCnt & 0x0007) != 0)
{
ucByteCountVerify = (UCHAR)(usCoilCnt / 8 + 1);
}
else
{
ucByteCountVerify = (UCHAR)(usCoilCnt / 8);
}
/* 检查线圈数量和字节数是否合理 */
if((usCoilCnt >= 1) &&
(usCoilCnt <= MB_PDU_FUNC_WRITE_MUL_COILCNT_MAX) &&
(ucByteCountVerify == ucByteCount))
{
/* 写入线圈值 */
eRegStatus = eMBRegCoilsCB(&pucFrame[MB_PDU_FUNC_WRITE_MUL_VALUES_OFF],
usRegAddress, usCoilCnt, 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;
}