BACnetWhoIs (FUN)

FUNCTION BACnetWhoIs : IEC_BACNET_STATUS

Sends a who-Is request.

Sends a BACnet Who-Is request to a local or remote device or network. This routine allows an application to discover BACnet Devices for which the Address isn’t known previously. In a simple network with only one LAN using ARCNET or Ethernet, a minimum delay of 1 second is adequate, but higher values may be appropriate in some situations.

InOut:

Scope

Name

Type

Comment

Return

BACnetWhoIs

IEC_BACNET_STATUS

A status indicating whether the operation worked.

Input

pSourceAddress

POINTER TO IEC_BACNET_ADDRESS

If the BACnet application has only one device constructed and installed, this can be 0. In this case the MAC address of this device will be used. Otherwise this shall be the MAC address returned on device object construction.

pDestinationAddress

POINTER TO IEC_BACNET_ADDRESS

This is the MAC address of the device to which the request should be sent.

filterMin

IEC_BACNET_DWORD

Optional argument for the Who-Is request, which limit the lower range of Device instance numbers expected to respond to the Who-Is request. This argument is omitted from the request if both parameters have the value “BACNET_NO_FILTER” (use -1).

filterMax

IEC_BACNET_DWORD

Optional argument for the Who-Is request, which limit the upper range of Device instance numbers expected to respond to the Who-Is request. This argument is omitted from the request if both parameters have the value “BACNET_NO_FILTER” (use -1).