ExtendedBuilder Class

Detailed Description

To discover KNXnet/IP servers, a KNXnet/IP client sends a extended search request data packet via multicast using its discovery endpoint. The request contains the host address protocol information (HPAI) of the discovery endpoint. The HPAI may also contain a unicast IP address to receive the answers from the different servers directly in a point-to-point manner. Typically, it should contain the KNXnet/IP system setup multicast address to ensure reception from KNXnet/IP servers that are on a different subnetwork. Additionally, the client may include 0 or more search request parameter blocks.

The common way to create a search request is:

auto hpai = ... // create HPAI;
auto macAddress = ... // fetch and set the MAC address;

auto macSrp = QKnxNetIpSrpProxy::macAddressBuilder()
    .setMac(macAddress)
    .create();
auto modeSrp = QKnxNetIpSrpProxy::programmingModeBuilder()
               .setMandatory(true)
               .create();

auto netIpFrame = QKnxNetIpSearchRequestProxy::extendedBuilder()
    .setDiscoveryEndpoint(hpai)
    .setExtendedParameter({ macSrp, modeSrp })
    .create();

After sending the search request, the KNXnet/IP client waits until timeout for the response frame from the KNXnet/IP server, QKnxNetIpSearchResponseProxy. After the timeout, received response frames are ignored by the client until it sends another search request. Search requests received from other clients are always ignored.