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方法是读取数据的主方法。

1. getReadRequestPdu： 根据ModbusHoldingRegisters实体类，转为对应请求ModbusPDUReadHoldingRegistersRequest实体类。
2. toPlcValue： 判断请求request与response响应是否对应，如果对应将参数解析后，封装成PlcValue返回。

后记

本文只是记录本人学习过程中的理解，可能有部分内容有纰漏，望各位不吝赐教。
下篇Apache-Plc4x-Modbus指令发送/接收配合源码学习（2）