Builder Class

class QKnxNetIpRoutingBusyProxy ::Builder

The QKnxNetIpRoutingBusyProxy::Builder class provides the means to create a router busy message frame. 更多...

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

公共函数

QKnxNetIpFrame	create () const
Builder &	setDeviceState (QKnxNetIp::DeviceState state )
Builder &	setRoutingBusyControl (quint16 busyControl )
Builder &	setRoutingBusyWaitTime (quint16 waitTime )

详细描述

A router busy message is sent by a KNXnet/IP router or device to notify all other devices that its incoming queue is filling up and it may loose datagrams if they do not stop sending. The message contains the state of the router or device ( QKnx::NetIp::DeviceState ), the timeout used to empty the incoming queue of the router or device, and the routing busy control field. The control field is set to 0000h , which requires all routers and devices to act upon receiving the router busy message.

The common way to create a routing-busy message is:

auto frame = QKnxNetIpRoutingBusyProxy::builder()
    .setDeviceState(QKnx::NetIp::DeviceState::IpFault)
    .setRoutingBusyWaitTime(99)
    .setRoutingBusyControl(0xffff)
    .create();

If a KNXnet/IP router or device receives a router busy message from another router or device, it immediately stops sending routing indication frames and waits until the time specified in the router busy message has elapsed to resume sending frames.

成员函数文档编制

QKnxNetIpFrame Builder:: create () const

Creates and returns a KNXnet/IP router busy message frame.

注意： The returned frame may be invalid depending on the values used during setup.

另请参阅 isValid ().

Builder &Builder:: setDeviceState ( QKnxNetIp::DeviceState state )

Sets the state of a KNXnet/IP router or device to state and returns a reference to the builder.

Builder &Builder:: setRoutingBusyControl ( quint16 busyControl )

Sets the router busy control field to busyControl and returns a reference to the builder.

By default, the control field is set to 0000h , which requires all routers and devices to act upon receiving the router busy message.

Builder &Builder:: setRoutingBusyWaitTime ( quint16 waitTime )

Sets the timeout after which a KNXnet/IP router or device empties its incoming datagram queue to waitTime and returns a reference to the builder.

The timeout can be from 20 to 100 milliseconds.