Configuring BACnet TCP/IP

The BACnet TCP/IP protocol allows APEX to communicate with BACnet-enabled devices over an Ethernet network. Using BACnet TCP/IP, you can create a network, discover devices, add points, and monitor real-time data for building automation and control systems.

Creating a BACnet TCP/IP Network

  1. Open the Devices module from the sidebar.

  2. Click Create Network.

    A Create Network popup appears.

    layout

  3. From the Choose a Network dropdown, select BACnet TCP/IP.

    Enter the following network details:

    FieldDescription
    Network NameEnter a unique name for the BACnet TCP/IP network.
    Network DescriptionEnter a brief description to help identify the network.
    InstanceEnter the BACnet device instance number. Each device on the BACnet network must have a unique instance number.
    PortEnter the communication port used by the BACnet TCP/IP network. The default BACnet UDP port is 47808 (0xBAC0) unless otherwise configured.
    AddressEnter the IP address of the BACnet TCP/IP network interface.
    SubnetEnter the subnet mask of the network.
    GatewayEnter the gateway IP address for the network.
    APDUEnter the maximum APDU (Application Protocol Data Unit) size supported by the device.
    TimeoutSpecify the communication timeout value used while communicating with BACnet devices.
    RetryEnter the number of retry attempts if communication fails.
  4. After entering all the required details, click Create Network.

    layout

  5. Once the network is created successfully, it is displayed in the network list.


Discovering and Adding Devices

After creating the BACnet TCP/IP network, discover the BACnet devices connected to the network.

  1. Open the BACnet TCP/IP network.

  2. Click Add Device.

    layout

  3. The Device Discovery window displays all the available BACnet devices.

    Select the required device(s) and click Add.

    layout

  4. The selected devices are added to the network and displayed in the device list.

    layout


Discovering and Adding Points

After adding a BACnet device, you can add the required points for monitoring.

  1. Open the required BACnet device.

  2. Click Add Points.

    layout

  3. The Points Discovery window displays all the available BACnet points.

    Select the required points or click Select All Points to add every available point.

    Click Add Selected Points.

    layout

  4. The selected points are added to the device and displayed in the points list.

    layout


Viewing Point Details

After adding the required points, you can view their properties and live values.

  1. Click any point from the points list.

    layout

    The point details page displays the following information:

    • Live Value – Displays the current value of the selected point.
    • Point Properties – Displays the point name, object type, object instance, and other configured properties.
    • Communication Status – Indicates whether the point is communicating successfully.
    • Timestamp – Displays the date and time of the latest value update.
    • Real-Time Monitoring – Continuously updates the point value while communication is active.

Point Configuration

After selecting a point, click the Config tab to configure the point settings. The Config tab contains four sections:

  • General
  • Alarms
  • Trends
  • Tags

General Configuration

The General tab allows you to configure linear mapping, scaling, and offset values for the selected point.

General Configuration

SectionFieldDescription
Point CharacteristicsEnable Linear MappingEnables linear mapping for the selected point.
Min VoltageSpecifies the minimum input voltage.
Max VoltageSpecifies the maximum input voltage.
Min OutputSpecifies the minimum output value after mapping.
Max OutputSpecifies the maximum output value after mapping.
Scaling & Offset ConfigurationScalingEnables scaling for the point value.
Scaling ValueMultiplies the incoming value by the specified scaling factor.
OffsetEnables offset adjustment.
Offset ValueAdds or subtracts the specified offset from the calculated value.
Live ReadingsRaw ValueDisplays the value received directly from the device.
Calculated ValueDisplays the final value after applying scaling and offset.

After configuring the required settings, click Apply Changes to save the configuration.


Alarm Configuration

The Alarms tab allows you to configure warning and critical alarm thresholds for the selected point.

Alarm Configuration

The alarm configuration is divided into two stages:

  • Stage 1 – Warning Limits
  • Stage 2 – Critical Limits

Stage 1 – Warning Limits

FieldDescription
High WarningEnables or disables the high warning alarm.
PrioritySelect the alarm priority.
Warning LimitEnter the upper warning threshold value.
Alarm MessageEnter the message displayed when the warning alarm is triggered.
Low WarningEnables or disables the low warning alarm.
PrioritySelect the alarm priority.
Warning LimitEnter the lower warning threshold value.
Alarm MessageEnter the message displayed when the low warning alarm is triggered.

Stage 2 – Critical Limits

FieldDescription
High CriticalEnables or disables the high critical alarm.
PrioritySelect the alarm priority.
Critical LimitEnter the upper critical threshold value.
Alarm MessageEnter the message displayed when the critical alarm is triggered.
Low CriticalEnables or disables the low critical alarm.
PrioritySelect the alarm priority.
Critical LimitEnter the lower critical threshold value.
Alarm MessageEnter the message displayed when the low critical alarm is triggered.

After configuring the required alarm settings, click Save Alarm Configuration.


Trend Configuration

The Trends tab allows you to configure data logging and trend collection for the selected point.

Trend Configuration

Data Logging

FieldDescription
Enable Data LoggingEnables or disables trend logging.
Trend Interval (Hours)Specifies the number of hours between data samples.
Trend Interval (Minutes)Specifies the number of minutes between data samples.
Trend Interval (Seconds)Specifies the number of seconds between data samples.
Max History RecordsSpecifies the maximum number of trend records to retain. Older records are automatically removed when this limit is reached.

Active Calendar

FieldDescription
Enable Active CalendarEnables scheduled trend logging.
Days of WeekSelect the days on which trend logging should be active.
Start TimeSpecifies when trend logging begins.
End TimeSpecifies when trend logging stops.

After completing the configuration, click Save Trend Configuration.


Tags Configuration

The Tags tab allows you to assign one or more tags to the selected point for easier organization and searching.

Tags Configuration

FieldDescription
Search & Add TagsSearch for an existing tag or create a new tag by entering a name.
Added TagsDisplays all tags currently assigned to the selected point.
Remove TagClick the × icon on a tag to remove it from the point.

To assign a tag:

  1. Enter the tag name in the Search & Add Tags field.
  2. Select an existing tag or create a new one.
  3. The selected tag is automatically added to the Added Tags section.
  4. Multiple tags can be assigned to a single point.