BACnetSendNetworkManagementMessage (FUN)

FUNCTION BACnetSendNetworkManagementMessage : IEC_BACNET_STATUS

Gives the user application the ability to send network management messages.

The purpose of the BACnet network layer is to provide the means by which messages can be relayed from one BACnet network to another, regardless of the BACnet data link technology in use on that network. Whereas the data link layer provides the capability to address messages to a single device or broadcast them to all devices on the local network, the network layer allows messages to be directed to a single remote device, broadcast on a remote network, or broadcast globally to all devices on all networks. A BACnet Device is uniquely located by a network number and a MAC address.nn For detailed descritions of usage of this function look under ::BACNET_NETWORK_MANAGEMENT_MESSAGE and consult chapter 6 “THE NETWORK LAYER” from ANSI/ASHRAE Standard 135-2012.

Return: IEC_BACNET_STATUS

InOut:

Scope

Name

Type

Comment

Return

BACnetSendNetworkManagementMessage

IEC_BACNET_STATUS

Input

pSourceAddress

POINTER TO IEC_BACNET_ADDRESS

If the BACnet application has only one device constructed and installed, this can be NULL. 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.

pMessage

POINTER TO IEC_BACNET_NETWORK_MANAGEMENT_MESSAGE

The network management message to send to an specified device or as broadcast.