QModbusServer Class

成员函数文档

[explicit] QModbusServer::QModbusServer(QObject *parent = nullptr)

使用指定的parent 构建 Modbus 服务器。

bool QModbusServer::data(QModbusDataUnit *newData) const

返回newData 给定的寄存器范围内的值。

newData 必须提供有效的寄存器类型、起始地址和值计数。返回的 将包含与给定范围相关的寄存器值。newData

如果newData 包含有效的寄存器类型，但起始地址为负数，则将返回整个寄存器映射，并适当调整newData 的大小。

另请参见 setData().

bool QModbusServer::data(QModbusDataUnit::RegisterType table, quint16 address, quint16 *data) const

读取存储在 Modbus 服务器中的数据。Modbus 服务器有四个表 (table)，每个表都有一个唯一的address 字段，用于从所需字段读取data 。有关不同表的更多信息，请参阅QModbusDataUnit::RegisterType 。如果地址超出映射范围或寄存器类型未定义，则返回false 。

另请参见 QModbusDataUnit::RegisterType 和setData()。

[signal] void QModbusServer::dataWritten(QModbusDataUnit::RegisterType table, int address, int size)

当 Modbus 客户端向 Modbus 服务器写入一个或多个数据字段时，就会发出该信号。该信号包含已写入字段的相关信息：

• 写入的寄存器类型 (table)、
• address 写入的第一个字段、
• 以及从address 开始写入的连续字段的size 。

如果待写字段的值没有变化，则不会发出该信号。

[virtual protected] QModbusResponse QModbusServer::processPrivateRequest(const QModbusPdu &request)

自定义 Modbus 服务器应执行此函数。如果给定的request 不是标准 Modbus 请求，processRequest() 将调用该函数。

重写此函数可处理《Modbus 应用协议规范 1.1b 》中未指定的附加功能代码和子功能代码。重新实现时应再次调用此函数，以确保对自定义 Modbus 实现未处理的所有未知功能代码返回异常响应。

此默认实现返回一个QModbusExceptionResponse ，其中包含request 功能代码和设置为非法功能的错误代码。

另请参见 processRequest()。

[virtual protected] QModbusResponse QModbusServer::processRequest(const QModbusPdu &request)

处理 Modbus 客户端request 并返回 Modbus 响应。该函数根据请求的性质返回QModbusResponse 或QModbusExceptionResponse 。

该函数的默认执行方式是处理 Modbus 应用协议规范 1.1b 中定义的所有标准 Modbus 功能代码。规范中未包含的所有其他 Modbus 功能代码都将转发到processPrivateRequest() 。

标准 Modbus 功能代码请求的默认处理方式可通过重新实现此函数来覆盖。覆盖必须处理相关的请求类型，并返回相应的QModbusResponse 。一个常见的原因可能是过滤掉数据值的功能代码请求，以限制读/写访问，以及在以太网或 Modbus Plus 传输层上的串行线路诊断等特定实现中不需要的功能代码。其他所有请求类型均应转发至该默认实现。

另请参阅 processPrivateRequest().

[virtual] bool QModbusServer::processesBroadcast() const

如果传输层应处理广播，子类应实现该函数。如果当前处理的请求是广播请求，则该实现应返回true ；否则返回false 。默认实现总是返回false 。

[virtual protected] bool QModbusServer::readData(QModbusDataUnit *newData) const

读取newData 给出的寄存器范围内的值，并将数据写回newData 。成功时返回true ，如果newData 是0 、newData 范围超出映射范围或 registerType() 不存在，则返回false 。

另请参见 setMap() 和writeData()。

int QModbusServer::serverAddress() const

返回此 Modbus 服务器实例的地址。

另请参阅 setServerAddress()。

bool QModbusServer::setData(const QModbusDataUnit &newData)

将newData 写入 Modbus 服务器映射。如果newData 范围超出映射范围，则返回false 。

如果调用成功，则发出dataWritten() 信号。请注意，当寻址寄存器未发生变化时，信号不会发出。当newData 包含的值与寄存器已包含的值完全相同时，可能会出现这种情况。不过，在这种情况下，该函数将返回true 。

另请参阅 data() 。

bool QModbusServer::setData(QModbusDataUnit::RegisterType table, quint16 address, quint16 data)

向 Modbus 服务器写入数据。一个 Modbus 服务器有四个表 (table)，每个表都有一个唯一的address 字段，使用该字段可将data 写入所需字段。如果地址超出映射范围，则返回false 。

如果调用成功，则发出dataWritten() 信号。请注意，当data 未发生变化时，信号不会发出。不过，在这种情况下，该函数会返回true 。

另请参见 QModbusDataUnit::RegisterType,data() 和dataWritten()。

[virtual] bool QModbusServer::setMap(const QModbusDataUnitMap &map)

将其他 ModBus 客户端请求的注册映射结构设置为map 。寄存器值初始化为 0。成功时返回true ，否则返回false 。

如果在连接前未调用此函数，则会设置一个条目为零的默认寄存器。

void QModbusServer::setServerAddress(int serverAddress)

将此 Modbus 服务器实例的地址设置为serverAddress 。

另请参阅 serverAddress() 。

[virtual] bool QModbusServer::setValue(int option, const QVariant &newValue)

为option 设置newValue ，成功时返回true ，否则返回false 。

另请参阅 value() 。

[virtual] QVariant QModbusServer::value(int option) const

返回option 的值，如果未设置该选项，则返回无效的QVariant 。

另请参阅 setValue()。

[virtual protected] bool QModbusServer::writeData(const QModbusDataUnit &newData)

将newData 写入 Modbus 服务器映射。成功时返回true ，如果newData 范围超出映射范围或 registerType() 不存在，则返回false 。

另请参见 setMap()、readData() 和dataWritten()。