Distech Controls

The Distech Controls integrated system provides monitoring and control of thermostat devices. Distech Controls is integrated into IPFusion by design. For further information about this integration, please contact support.

Note: BACnet integrated systems support cross subdomain communication via BBMD (BACnet Broadcast Management Device) without the need for additional configuration in Designer.

Setup

See the Data Servers page for information on configuring driver communication.

Prerequisites


Software	Minimum Version
IPFusion — Distech Controls	1.0
.NET Framework	4.7.2

When completing your setup, be sure to have the Distech Controls documentation available for reference.

Ports

These ports must be open in your network firewall for the integration to work.


Purpose	Default Value	Configurable
Communication Settings	47808	Yes
Dataserver	9520	Yes
Debug Tools	9566	No

Communication Configuration

You will find the Communication Settings in the integrated system configuration panel. The following information is required:


IP Address	The IP Address of the Distech BACnet gateway.
Port	The Port for the Distech BACnet gateway connection.
Device ID	The Device ID of the Distech BACnet gateway.

Note: Red X indicates an invalid or out of range value given for field.

Assets

Thermostat

This asset represents a thermostat in the Distech system.

Required Property Grid Fields


Minimum Set Point	The minimum temperature to be allowed for the thermostat. This limit is not enforced by Runtime. It can be used in Workflows to determine custom behavior when the temperature is below this threshold.
Maximum Set Point	The maximum temperature to be allowed for the thermostat. This limit is not enforced by Runtime. It can be used in Workflows to determine custom behavior when the temperature is above this threshold.
Setpoint BACnet Object ID	the BACnet ID for the object used to track the set temperature for the thermostat.
Temperature BACnet Object ID	The BACnet ID for the object used to track the current temperature for the thermostat.

View all properties

Supported States


Above Setpoint (Cooling)	The temperature is currently above the configured setpoint and the system is cooling the area.
Acknowledged	An asset alarm has been acknowledged.
At Setpoint	The temperature currently matches the configured setpoint, so no heating or cooling is required.
Below Setpoint (Heating)	The temperature is currently below the configured setpoint and the system is heating the area.
Fault	An issue has been detected in a connected asset.
Masked	The asset has been masked over its true state.
No Communication	Communication has been lost with the driver or asset. This status can also occur if the communication configuration for the system or asset is invalid. Note: This status is required in all status tables.

See the Configure a Status Table page for more information on configuring status tables.

Supported Commands


Adjust Setpoint	Adjusts the current setpoint value by the configured number of degrees. Set the Offset parameter to a positive value to increase the setpoint temperature, or to a negative value to lower the setpoint.
Mask	Mask the asset's true state.
Acknowledge	Acknowledge an asset alarm.
Reset	Resets the asset to its true hardware state.
Cancel	Deselects all selected assets.

See the Command Tables page for more information on configuring command tables.

System

This asset represents the connection from Runtime to the Distech Controls system.

View all properties

Supported States


Normal	The asset is online and in its default state.
Fault	An issue has been detected in a connected asset.
Masked	The asset has been masked over its true state.
Acknowledged	An asset alarm has been acknowledged.
No Communication	Communication has been lost with the driver or asset. This status can also occur if the communication configuration for the system or asset is invalid. Note: This status is required in all status tables.

See the Configure a Status Table page for more information on configuring status tables.

Supported Commands


Mask	Mask the asset's true state.
Acknowledge	Acknowledge an asset alarm.
Reset	Resets the asset to its true hardware state.
Cancel	Deselects all selected assets.

See the Command Tables page for more information on configuring command tables.

Workflow Integration

Asset Events

Asset events are events used to trigger Workflow actions at the asset level. For more information about Workflows, see the Workflows section.

Setpoint Changed

This event is triggered when the setpoint on the thermostat is successfully changed.

Table 1. Properties
Current Setpoint	The current setpoint value for the thermostat.
Min Setpoint	The minimum allowed setpoint for this thermostat.
Max Setpoint	The maximum allowed setpoint for this thermostat.
Current Temperature	The current temperature of the area for this thermostat.

Troubleshooting

Logs from the driver and Runtime can be viewed in the Debug Tools client. These messages contain information which can provide further context for issues during initialization, or while actively running. This can help diagnose problems.