QKnxNetIpDeviceConfigurationAcknowledgeProxy Class

The QKnxNetIpDeviceConfigurationAcknowledgeProxy class provides the means to read a device configuration acknowledgment from the generic QKnxNetIpFrame class and to create a KNXnet/IP frame based on the information. 更多...

头：	#include <QKnxNetIpDeviceConfigurationAcknowledgeProxy>
qmake:	QT += knx

所有成员列表，包括继承成员

公共类型

class

Builder

公共函数

	QKnxNetIpDeviceConfigurationAcknowledgeProxy (const QKnxNetIpFrame & frame )
quint8	channelId () const
bool	isValid () const
quint8	sequenceNumber () const
QKnxNetIp::Error	status () const

静态公共成员

QKnxNetIpDeviceConfigurationAcknowledgeProxy::Builder

builder ()

详细描述

A KNXnet/IP client connects to a configuration and management data endpoint of a KNXnet/IP server to send device configuration request frames and to receive device configuration acknowledgment frames. A device configuration request is used to read and write KNXnet/IP device configuration data. When a server receives a configuration request, it responds with a device configuration acknowledgment to confirm the reception of the request.

A device configuration acknowledgment frame contains the ID and status of the communication channel between a KNXnet/IP client and server, as well as the sequence number of the device configuration request frame.

The KNXnet/IP server discards device configuration request frames with unexpected sequence numbers and does not send a device configuration acknowledgment upon receiving them.

In most programs, this class will not be used directly. Instead, the QKnxNetIpTunnel or QKnxNetIpDeviceManagement class is used to establish a functional connection to a KNXnet/IP server.

注意： When using QKnxNetIpDeviceConfigurationAcknowledgeProxy, care must be taken to ensure that the referenced KNXnet/IP frame outlives the proxy on all code paths, lest the proxy ends up referencing deleted data.

The following code sample illustrates how to read the device configuration acknowledgment information sent by a KNXnet/IP client:

auto frame = QKnxNetIpFrame::fromBytes(...);
const QKnxNetIpDeviceConfigurationAcknowledgeProxy proxy(netIpFrame);
if (!proxy.isValid())
    return;
quint8 chanId = proxy.channelId();
quint8 seqNum = proxy.sequenceNumber();
QKnx::NetIp::Error error = proxy.status();

另请参阅 builder (), QKnxNetIpDeviceConfigurationRequestProxy , Qt KNX Device Management Classes ，和 Qt KNXnet/IP Connection Classes .

成员函数文档编制

QKnxNetIpDeviceConfigurationAcknowledgeProxy:: QKnxNetIpDeviceConfigurationAcknowledgeProxy (const QKnxNetIpFrame & frame )

Constructs a proxy object to read the device configuration acknowledgment information carried by the specified KNXnet/IP frame frame .

`[static]` QKnxNetIpDeviceConfigurationAcknowledgeProxy::Builder QKnxNetIpDeviceConfigurationAcknowledgeProxy:: builder ()

Returns a builder object to create a KNXnet/IP device configuration acknowledgment frame.

quint8 QKnxNetIpDeviceConfigurationAcknowledgeProxy:: channelId () const

Returns the ID of the communication channel between a KNXnet/IP client and server.

bool QKnxNetIpDeviceConfigurationAcknowledgeProxy:: isValid () const

返回 true if the frame contains initialized values and is in itself valid, otherwise returns false . A valid KNXnet/IP frame consists of at least a valid header and a size in bytes corresponding to the total size of the KNXnet/IP frame header.

另请参阅 QKnxNetIpFrameHeader::totalSize ().

quint8 QKnxNetIpDeviceConfigurationAcknowledgeProxy:: sequenceNumber () const

Returns the sequence number of a device configuration request frame.

QKnxNetIp::Error QKnxNetIpDeviceConfigurationAcknowledgeProxy:: status () const

Returns the status of the communication channel between a KNXnet/IP client and server.