Apache-Plc4x-Modbus-Tcp学习记录(二)
Apache-Plc4x-Modbus指令发送/接收配合源码学习(1)
本文承接上文Apache-Plc4x-Modbus基础信息配合源码学习,对Apache-Plc4x-Modbus的指令发送前数据准备、接收结合源码学习(以read读取数据为例,memory-Area以HoldingRegisters为例)。
Modbus协议-通用格式效验
从上文我们已经知道传入参数的格式为=={memory-Area}{start-address}:{data-type}[{array-size}]==,以及对应的含义,这些就是我们封包和解包时需要的参数。
参数的需要经过:格式效验、内容效验、封装成实体类,这些工作主要在field包内进行。
ModbusFieldHandler
是格式效验的控制器,首先进入这里判断符合哪种格式(正则表达式效验),进入对应的解析方法。
ModbusField
是格式效验的实现,也是ModbusHoldingRegisters的父类。
规定了通用的三个参数:address(start-address)寄存器起始地址、quantity(array-size)寄存器长度、dataType(data-type)数据类型。上文提到的(发送指令时为0,因为设置了为1的偏移量)中的偏移量也在这里配置。
ModbusHoldingRegisters
主要功能:正则表达式格式效验、参数数据效验(数据效验中进行address - PROTOCOL_ADDRESS_OFFSET)。
Modbus协议-请求/响应实体
在发送指令前,需要将参数转为请求实体,再将请求实体转为二进制流发送给设备。
在接收指令后,将从设备接收二进制流转为响应实体,再解析数据。
分别要用到请求实体和响应实体,主要在readwrite包内。
每种memory-Area类型在readwrite包内最少对应2个请求实体(读/写),2个响应实体(读/写)。
ModbusPDU
是ModbusPDUReadHoldingRegistersRequest、ModbusPDUReadHoldingRegistersResponse等的父类。实现了三个抽象访问器:获取错误标识、获取功能码标识、得到响应(true表示为响应,false表示为请求)。
getLengthInBytes:限制了指令byte数组的长度。
getLengthInBits:限制了指令二进制流的长度。
ModbusTcpADU
ModbusTcpADU类可以理解成发送/响应指令参数汇总包括:协议标识符、事务标识符(可以理解成第几条指令)、单位标识符(可以理解为设备地址)以及ModbusPDU。
和ModbusPDU实现了getLengthInBytes、getLengthInBits(影响发送/接收指令二进制流长度)。
Modbus协议-逻辑
modbus协议逻辑部分,主要进行:发送前参数整理封装,接收后解析数据内容。这些工作主要在protocol包内的ModbusProtocolLogic进行。
setConfiguration
setConfiguration方法继承了ModbusConfiguration中的参数值、初始化了请求事务管理器。
ModbusConfiguration在config包中配置了两个参数分别是:requestTimeout请求响应超时时间、unitIdentifier单位标识符(可以理解成设备地址)。
read
read方法是读取数据的主方法。
- getReadRequestPdu: 根据ModbusHoldingRegisters实体类,转为对应请求ModbusPDUReadHoldingRegistersRequest实体类。
- toPlcValue: 判断请求request与response响应是否对应,如果对应将参数解析后,封装成PlcValue返回。
后记
本文只是记录本人学习过程中的理解,可能有部分内容有纰漏,望各位不吝赐教。
下篇Apache-Plc4x-Modbus指令发送/接收配合源码学习(2)