7 Commits

5 changed files with 493 additions and 133 deletions

View File

@@ -793,7 +793,7 @@ func (mc *ModbusClient) WriteRegisterWithRes(addr uint16, value uint16) (bytes [
req.payload = append(req.payload, uint16ToBytes(mc.endianness, value)...) req.payload = append(req.payload, uint16ToBytes(mc.endianness, value)...)
// run the request across the transport and wait for a response // run the request across the transport and wait for a response
res, err = mc.executeRequest(req) res, err = mc.executeRequestWithRes(req)
if err != nil { if err != nil {
return return
} }
@@ -801,17 +801,27 @@ func (mc *ModbusClient) WriteRegisterWithRes(addr uint16, value uint16) (bytes [
// validate the response code // validate the response code
switch { switch {
case res.functionCode == req.functionCode: case res.functionCode == req.functionCode:
// expect 4 bytes (2 byte of address + 2 bytes of value) // expect at least 4 bytes (2 byte of address + 2 bytes of value)
if len(res.payload) != 4 || // 后面可能还有自定义数据
if len(res.payload) < 4 {
err = ErrProtocolError
return
}
// bytes 1-2 should be the register address // bytes 1-2 should be the register address
bytesToUint16(BIG_ENDIAN, res.payload[0:2]) != addr || if bytesToUint16(BIG_ENDIAN, res.payload[0:2]) != addr ||
// bytes 3-4 should be the value // bytes 3-4 should be the value
bytesToUint16(mc.endianness, res.payload[2:4]) != value { bytesToUint16(mc.endianness, res.payload[2:4]) != value {
err = ErrProtocolError err = ErrProtocolError
return return
} }
bytes = req.payload[1:] // 返回自定义数据第4字节之后的数据
if len(res.payload) > 4 {
bytes = res.payload[4:]
} else {
bytes = []byte{} // 没有自定义数据,返回空切片
}
case res.functionCode == (req.functionCode | 0x80): case res.functionCode == (req.functionCode | 0x80):
if len(res.payload) != 1 { if len(res.payload) != 1 {
@@ -1188,15 +1198,9 @@ func (mc *ModbusClient) readRegistersWithFunctionCode(addr uint16, quantity uint
unitId: mc.unitId, unitId: mc.unitId,
} }
// if functionCode != fcCustomize { if functionCode != fcCustomize {
// err = ErrUnexpectedParameters
// mc.logger.Errorf("unexpected function code (%d)", functionCode)
// return
// }
if functionCode == 0 {
err = ErrUnexpectedParameters err = ErrUnexpectedParameters
mc.logger.Errorf("unexpected register type (%v)", functionCode) mc.logger.Errorf("unexpected function code (%d)", functionCode)
return return
} }
@@ -1208,9 +1212,10 @@ func (mc *ModbusClient) readRegistersWithFunctionCode(addr uint16, quantity uint
return return
} }
if quantity > 1024 { // 16 * 16 * 40
if quantity > 10240 {
err = ErrUnexpectedParameters err = ErrUnexpectedParameters
mc.logger.Error("quantity of registers exceeds 1024") mc.logger.Error("quantity of registers exceeds 10240")
return return
} }
@@ -1266,6 +1271,38 @@ func (mc *ModbusClient) readRegistersWithFunctionCode(addr uint16, quantity uint
switch { switch {
case res.functionCode == req.functionCode: case res.functionCode == req.functionCode:
// For custom function code 0x41, the payload format is:
// [起始地址(2字节)] [字节数(2字节)] [数据...]
if functionCode == fcCustomize {
// validate minimum payload length (start address 2 bytes + byte count 2 bytes)
if len(res.payload) < 4 {
err = ErrProtocolError
mc.logger.Errorf("payload too short for custom function code: %d bytes", len(res.payload))
return
}
// extract byte count from payload (bytes 2-3, big endian)
byteCount := bytesToUint16(BIG_ENDIAN, res.payload[2:4])
// validate payload length matches expected data length
expectedLength := 4 + int(byteCount) // start address (2) + byte count (2) + data
if len(res.payload) != expectedLength {
err = ErrProtocolError
mc.logger.Errorf("payload length mismatch: expected %d, got %d", expectedLength, len(res.payload))
return
}
// validate byte count matches requested quantity
if byteCount != 2*quantity {
err = ErrProtocolError
mc.logger.Errorf("byte count mismatch: expected %d, got %d", 2*quantity, byteCount)
return
}
// extract only the data part (skip start address and byte count)
bytes = res.payload[4:]
} else {
// standard modbus protocol handling
// make sure the payload length is what we expect // make sure the payload length is what we expect
// (1 byte of length + 2 bytes per register) // (1 byte of length + 2 bytes per register)
// if len(res.payload) != 1+2*int(quantity) { // if len(res.payload) != 1+2*int(quantity) {
@@ -1282,6 +1319,7 @@ func (mc *ModbusClient) readRegistersWithFunctionCode(addr uint16, quantity uint
// remove the byte count field from the returned slice // remove the byte count field from the returned slice
bytes = res.payload[1:] bytes = res.payload[1:]
}
case res.functionCode == (req.functionCode | 0x80): case res.functionCode == (req.functionCode | 0x80):
if len(res.payload) != 1 { if len(res.payload) != 1 {
@@ -1406,3 +1444,29 @@ func (mc *ModbusClient) executeRequest(req *pdu) (res *pdu, err error) {
return return
} }
func (mc *ModbusClient) executeRequestWithRes(req *pdu) (res *pdu, err error) {
// send the request over the wire, wait for and decode the response
res, err = mc.transport.ExecuteRequestWithRes(req)
if err != nil {
// map i/o timeouts to ErrRequestTimedOut
if os.IsTimeout(err) {
err = ErrRequestTimedOut
}
return
}
// make sure the source unit id matches that of the request
if (res.functionCode&0x80) == 0x00 && res.unitId != req.unitId {
err = ErrBadUnitId
return
}
// accept errors from gateway devices (using special unit id #255)
if (res.functionCode&0x80) == 0x80 &&
(res.unitId != req.unitId && res.unitId != 0xff) {
err = ErrBadUnitId
return
}
return
}

View File

@@ -41,7 +41,7 @@ const (
fcWriteFileRecord uint8 = 0x15 fcWriteFileRecord uint8 = 0x15
// customize // customize
fcCustomize uint8 = 0x29 fcCustomize uint8 = 0x41
// exception codes // exception codes
exIllegalFunction uint8 = 0x01 exIllegalFunction uint8 = 0x01

View File

@@ -4,6 +4,7 @@ import (
"fmt" "fmt"
"io" "io"
"log" "log"
"os"
"time" "time"
) )
@@ -21,10 +22,10 @@ type rtuTransport struct {
} }
type rtuLink interface { type rtuLink interface {
Close() (error) Close() error
Read([]byte) (int, error) Read([]byte) (int, error)
Write([]byte) (int, error) Write([]byte) (int, error)
SetDeadline(time.Time) (error) SetDeadline(time.Time) error
} }
// Returns a new RTU transport. // Returns a new RTU transport.
@@ -79,7 +80,9 @@ func (rt *rtuTransport) ExecuteRequest(req *pdu) (res *pdu, err error) {
// build an RTU ADU out of the request object and // build an RTU ADU out of the request object and
// send the final ADU+CRC on the wire // send the final ADU+CRC on the wire
n, err = rt.link.Write(rt.assembleRTUFrame(req)) n, err = rt.link.Write(rt.assembleRTUFrame(req))
fmt.Printf("send: %X\n", rt.assembleRTUFrame(req))
if err != nil { if err != nil {
fmt.Printf("write error: %s", err.Error())
return return
} }
@@ -109,6 +112,59 @@ func (rt *rtuTransport) ExecuteRequest(req *pdu) (res *pdu, err error) {
return return
} }
func (rt *rtuTransport) ExecuteRequestWithRes(req *pdu) (res *pdu, err error) {
var ts time.Time
var t time.Duration
var n int
// set an i/o deadline on the link
err = rt.link.SetDeadline(time.Now().Add(rt.timeout))
if err != nil {
return
}
// if the line was active less than 3.5 char times ago,
// let t3.5 expire before transmitting
t = time.Since(rt.lastActivity.Add(rt.t35))
if t < 0 {
time.Sleep(t * (-1))
}
ts = time.Now()
// build an RTU ADU out of the request object and
// send the final ADU+CRC on the wire
n, err = rt.link.Write(rt.assembleRTUFrame(req))
if err != nil {
return
}
// estimate how long the serial line was busy for.
// note that on most platforms, Write() will be buffered and return
// immediately rather than block until the buffer is drained
rt.lastActivity = ts.Add(time.Duration(n) * rt.t1)
// observe inter-frame delays
time.Sleep(rt.lastActivity.Add(rt.t35).Sub(time.Now()))
// read the response back from the wire
res, err = rt.readRTUFrameWithRes()
if err == ErrBadCRC || err == ErrProtocolError || err == ErrShortFrame {
// wait for and flush any data coming off the link to allow
// devices to re-sync
time.Sleep(time.Duration(maxRTUFrameLength) * rt.t1)
discard(rt.link)
}
// mark the time if we heard anything back
if err != ErrRequestTimedOut {
rt.lastActivity = time.Now()
}
return
}
// Reads a request from the rtu link. // Reads a request from the rtu link.
func (rt *rtuTransport) ReadRequest() (req *pdu, err error) { func (rt *rtuTransport) ReadRequest() (req *pdu, err error) {
// reading requests from RTU links is currently unsupported // reading requests from RTU links is currently unsupported
@@ -139,9 +195,170 @@ func (rt *rtuTransport) readRTUFrame() (res *pdu, err error) {
var byteCount int var byteCount int
var bytesNeeded int var bytesNeeded int
var crc crc var crc crc
// var dataLength uint16
rxbuf = make([]byte, maxRTUFrameLength) rxbuf = make([]byte, maxRTUFrameLength)
// read the serial ADU header: unit id (1 byte), function code (1 byte) and
// PDU length/exception code (1 byte)
byteCount, err = io.ReadFull(rt.link, rxbuf[0:3])
if (byteCount > 0 || err == nil) && byteCount != 3 {
err = ErrShortFrame
return
}
if uint8(rxbuf[1]) == fcCustomize {
fmt.Printf("receive: %v\n", rxbuf[0:3])
}
if err != nil && err != io.ErrUnexpectedEOF {
return
}
// handle custom function code 0x41 with special format:
// [单元ID] [功能码] [起始地址(2字节)] [字节数(2字节)] [数据...] [CRC]
if uint8(rxbuf[1]) == fcCustomize {
// 1. 读取剩余的自定义头部 (4 字节: rxbuf[2] 到 rxbuf[5])
// 覆盖 rxbuf[2](上一次读取的第三个字节)以及 rxbuf[3], rxbuf[4], rxbuf[5]
byteCount, err = io.ReadFull(rt.link, rxbuf[3:6]) // <-- 关键修正:从索引 2 开始读取 4 字节
// 修正短帧检查逻辑
if err != nil {
if err == io.EOF || err == io.ErrUnexpectedEOF {
err = ErrShortFrame
}
return
}
// 此时 byteCount 应该总是 4。
// 2. 提取数据长度 (关键修正点)
// 数据长度位于 rxbuf[4] 和 rxbuf[5]
dataLength := bytesToUint16(BIG_ENDIAN, rxbuf[4:6])
bytesNeeded = int(dataLength)
fmt.Println(bytesNeeded)
// 3. 计算总共需要读取的字节数
// 数据域长度 + 2 字节 CRC
bytesToRead := bytesNeeded + 2
// 4. 计算总帧大小: 6 (Header) + DataLength + 2 (CRC)
totalFrameSize := 6 + bytesToRead
TotalHeaderLength := 6
// 5. 动态分配或调整缓冲区
if totalFrameSize > maxRTUFrameLength {
// save already read data
header := make([]byte, 6)
copy(header, rxbuf[0:TotalHeaderLength]) // 复制 rxbuf[0] 到 rxbuf[5]
// resize buffer to accommodate larger frame
rxbuf = make([]byte, totalFrameSize)
// copy back the header
copy(rxbuf[0:TotalHeaderLength], header)
}
// 6. 读取数据域和 CRC
// 从 rxbuf[6] (TotalHeaderLength) 开始读取 DataLength + CRC (2 字节)
readStartIdx := TotalHeaderLength // 6
byteCount, err = io.ReadFull(rt.link, rxbuf[readStartIdx:totalFrameSize])
if err != nil {
if err == io.EOF || err == io.ErrUnexpectedEOF {
err = ErrShortFrame
}
return
}
if byteCount != bytesToRead {
rt.logger.Warningf("expected %v bytes, received %v", bytesToRead, byteCount)
err = ErrShortFrame
return
}
// 7. CRC 校验
crcEndIndex := totalFrameSize - 2 // CRC 校验范围的结束索引 (不包含)
fmt.Println("crc end index", crcEndIndex)
crc.init()
crc.add(rxbuf[0:crcEndIndex]) // 校验范围从 rxbuf[0] 到数据域结束
// 比较接收到的 CRC
// recvCRCLow := rxbuf[crcEndIndex]
// recvCRCHigh := rxbuf[crcEndIndex+1]
// fmt.Println("len: ", len(rxbuf[6:crcEndIndex]))
// if !crc.isEqual(recvCRCLow, recvCRCHigh) {
// err = ErrBadCRC
// fmt.Println("crc: ", recvCRCLow, recvCRCHigh, "byte needed: ", bytesNeeded)
// return
// }
// 8. 构造 PDU
// Payload 包含:自定义数据 (4 bytes) + Data (N bytes)
// 切片范围:从 rxbuf[2] (自定义数据开始) 到数据域结束 (crcEndIndex)
res = &pdu{
unitId: rxbuf[0],
functionCode: rxbuf[1],
payload: rxbuf[2:crcEndIndex],
}
return
}
// standard modbus protocol handling
// figure out how many further bytes to read
bytesNeeded, err = expectedResponseLenth(uint8(rxbuf[1]), uint8(rxbuf[2]))
if err != nil {
return
}
// we need to read 2 additional bytes of CRC after the payload
bytesNeeded += 2
// never read more than the max allowed frame length
if byteCount+bytesNeeded > maxRTUFrameLength {
err = ErrProtocolError
return
}
byteCount, err = io.ReadFull(rt.link, rxbuf[3:3+bytesNeeded])
if err != nil && err != io.ErrUnexpectedEOF {
return
}
if byteCount != bytesNeeded {
rt.logger.Warningf("expected %v bytes, received %v", bytesNeeded, byteCount)
err = ErrShortFrame
return
}
// compute the CRC on the entire frame, excluding the CRC
crc.init()
crc.add(rxbuf[0 : 3+bytesNeeded-2])
// compare CRC values
if !crc.isEqual(rxbuf[3+bytesNeeded-2], rxbuf[3+bytesNeeded-1]) {
err = ErrBadCRC
return
}
res = &pdu{
unitId: rxbuf[0],
functionCode: rxbuf[1],
// pass the byte count + trailing data as payload, withtout the CRC
payload: rxbuf[2 : 3+bytesNeeded-2],
}
return
}
func (rt *rtuTransport) readRTUFrameWithRes() (res *pdu, err error) {
var rxbuf []byte
var byteCount int
var bytesNeeded int
var crc crc
rxbuf = make([]byte, 4096)
// read the serial ADU header: unit id (1 byte), function code (1 byte) and // read the serial ADU header: unit id (1 byte), function code (1 byte) and
// PDU length/exception code (1 byte) // PDU length/exception code (1 byte)
byteCount, err = io.ReadFull(rt.link, rxbuf[0:3]) byteCount, err = io.ReadFull(rt.link, rxbuf[0:3])
@@ -188,11 +405,77 @@ func (rt *rtuTransport) readRTUFrame() (res *pdu, err error) {
return return
} }
// 标准modbus响应已读取完成现在读取自定义数据
// 设置5秒超时来读取自定义数据
customDataTimeout := 5 * time.Second
err = rt.link.SetDeadline(time.Now().Add(customDataTimeout))
if err != nil {
return
}
// 使用临时缓冲区循环读取自定义数据
tempBuf := make([]byte, 256) // 每次读取最多256字节
totalRead := 0
startPos := 3 + bytesNeeded
for {
// 检查缓冲区是否还有空间
if startPos+totalRead+len(tempBuf) > len(rxbuf) {
// 如果缓冲区不够,扩展它
newBuf := make([]byte, len(rxbuf)*2)
copy(newBuf, rxbuf)
rxbuf = newBuf
}
// 尝试读取数据
n, readErr := rt.link.Read(tempBuf)
if n > 0 {
// 将读取的数据复制到rxbuf
copy(rxbuf[startPos+totalRead:startPos+totalRead+n], tempBuf[:n])
totalRead += n
}
// 如果遇到超时错误,说明没有更多数据了
if readErr != nil {
if os.IsTimeout(readErr) {
// 超时是正常的,说明自定义数据读取完成
break
}
// 其他错误需要检查是否是EOF数据读取完成
if readErr == io.EOF {
break
}
// 对于其他错误,如果已经读取了一些数据,继续处理
if totalRead == 0 {
err = readErr
return
}
break
}
// 如果读取的字节数少于请求的,说明没有更多数据了
if n < len(tempBuf) {
break
}
}
// 返回标准响应的payload地址+值4字节+ 自定义数据
// 标准响应的payload在 rxbuf[2:3+bytesNeeded-2] 位置
standardPayloadStart := 2
standardPayloadEnd := 3 + bytesNeeded - 2
// 构建完整的payload标准响应payload + 自定义数据
completePayload := make([]byte, 0, standardPayloadEnd-standardPayloadStart+totalRead)
completePayload = append(completePayload, rxbuf[standardPayloadStart:standardPayloadEnd]...)
if totalRead > 0 {
completePayload = append(completePayload, rxbuf[startPos:startPos+totalRead]...)
}
res = &pdu{ res = &pdu{
unitId: rxbuf[0], unitId: rxbuf[0],
functionCode: rxbuf[1], functionCode: rxbuf[1],
// pass the byte count + trailing data as payload, withtout the CRC // payload包含标准响应的payload + 自定义数据
payload: rxbuf[2:3 + bytesNeeded - 2], payload: completePayload,
} }
return return
@@ -222,12 +505,16 @@ func expectedResponseLenth(responseCode uint8, responseLength uint8) (byteCount
case fcReadHoldingRegisters, case fcReadHoldingRegisters,
fcReadInputRegisters, fcReadInputRegisters,
fcReadCoils, fcReadCoils,
fcReadDiscreteInputs: byteCount = int(responseLength) fcReadDiscreteInputs,
0x41:
byteCount = int(responseLength)
case fcWriteSingleRegister, case fcWriteSingleRegister,
fcWriteMultipleRegisters, fcWriteMultipleRegisters,
fcWriteSingleCoil, fcWriteSingleCoil,
fcWriteMultipleCoils: byteCount = 3 fcWriteMultipleCoils:
case fcMaskWriteRegister: byteCount = 5 byteCount = 3
case fcMaskWriteRegister:
byteCount = 5
case fcReadHoldingRegisters | 0x80, case fcReadHoldingRegisters | 0x80,
fcReadInputRegisters | 0x80, fcReadInputRegisters | 0x80,
fcReadCoils | 0x80, fcReadCoils | 0x80,
@@ -236,8 +523,11 @@ func expectedResponseLenth(responseCode uint8, responseLength uint8) (byteCount
fcWriteMultipleRegisters | 0x80, fcWriteMultipleRegisters | 0x80,
fcWriteSingleCoil | 0x80, fcWriteSingleCoil | 0x80,
fcWriteMultipleCoils | 0x80, fcWriteMultipleCoils | 0x80,
fcMaskWriteRegister | 0x80: byteCount = 0 fcMaskWriteRegister | 0x80,
default: err = ErrProtocolError 0x41 | 0x80:
byteCount = 0
default:
err = ErrProtocolError
} }
return return

View File

@@ -59,6 +59,10 @@ func (tt *tcpTransport) ExecuteRequest(req *pdu) (res *pdu, err error) {
return return
} }
func (tt *tcpTransport) ExecuteRequestWithRes(req *pdu) (res *pdu, err error) {
return nil, nil
}
// Reads a request from the socket. // Reads a request from the socket.
func (tt *tcpTransport) ReadRequest() (req *pdu, err error) { func (tt *tcpTransport) ReadRequest() (req *pdu, err error) {
var txnId uint16 var txnId uint16

View File

@@ -1,6 +1,7 @@
package modbus package modbus
type transportType uint type transportType uint
const ( const (
modbusRTU transportType = 1 modbusRTU transportType = 1
modbusRTUOverTCP transportType = 2 modbusRTUOverTCP transportType = 2
@@ -11,8 +12,9 @@ const (
) )
type transport interface { type transport interface {
Close() (error) Close() error
ExecuteRequest(*pdu) (*pdu, error) ExecuteRequest(*pdu) (*pdu, error)
ExecuteRequestWithRes(*pdu) (*pdu, error)
ReadRequest() (*pdu, error) ReadRequest() (*pdu, error)
WriteResponse(*pdu) (error) WriteResponse(*pdu) error
} }