Builder Class

Class Builder is declared in class QKnxNetIpSessionResponseProxy.

The QKnxNetIpSessionResponseProxy::Builder class provides the means to create a KNXnet/IP session response frame. More...

Public Functions

Builder(const Builder &other)
Builder()
Builder &operator=(const Builder &other)
~Builder()
QKnxNetIpFrame create() const
Builder &setMessageAuthenticationCode(const QKnxByteArray &data)
Builder &setPublicKey(const QKnxByteArray &serverPublicKey)
Builder &setSecureSessionId(quint16 sessionId)

Detailed Description

This class is part of the Qt KNX module and currently available as a Technology Preview, and therefore the API and functionality provided by the class may be subject to change at any time without prior notice.

This frame will be sent by the KNXnet/IP secure server to the KNXnet/IP secure client control endpoint in response to a received secure session request frame.

The common way to create a session response frame is:

auto serverPublicKey = ... // create the public key
auto auth = ... // create the full 128 bit CCM-MAC

auto netIpFrame = QKnxNetIpSessionResponseProxy::builder()
    .setSecureSessionId(0x1976)
    .setPublicKey(serverPublicKey)
    .setMessageAuthenticationCode(auth)
    .create();

See also QKnxCryptographicEngine.

Member Function Documentation

Builder::Builder(const Builder &other)

Constructs a copy of other.

Builder::Builder()

Creates a new empty session response builder object.

Builder &Builder::operator=(const Builder &other)

Assigns the specified other to this object.

Builder::~Builder()

Destroys the object and frees any allocated resources.

QKnxNetIpFrame Builder::create() const

Creates and returns a KNXnet/IP session response frame.

Note: The returned frame may be invalid depending on the values used during setup.

See also isValid().

Builder &Builder::setMessageAuthenticationCode(const QKnxByteArray &data)

Sets the AES128 CCM message authentication code (MAC) of the generic KNXnet/IP session response frame to data and returns a reference to the builder. The MAC has a fixed size of 16 bytes.

Builder &Builder::setPublicKey(const QKnxByteArray &serverPublicKey)

Sets the public key of the KNXnet/IP session response frame to serverPublicKey and returns a reference to the builder. The public key needs to be generated using the Curve25519 algorithm and has a fixed size of 32 bytes.

Builder &Builder::setSecureSessionId(quint16 sessionId)

Sets the secure session ID of the KNXnet/IP session response frame to sessionId and returns a reference to the builder.

© 2019 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.