This section consists of the following:
BACnet Channel Overview
You can use the SmartServer to integrate devices that support the BACnet protocol. The SmartServer can be a client that interacts with BACnet devices, or a server that maps datapoints on LON and Modbus devices for representation as BACnet objects. You can also use the SmartServer as a BACnet router to enable external BACnet clients on an IP LAN or WAN to monitor and control BACnet FT devices.
You can interface with BACnet MSTP devices using an external BACnet IP to BACnet MSTP router. The Starter Kit uses a Contemporary Controls BASRT-B, MSTP BACnet Router. This setup requires power for the Ethernet switch (5 VDC universal power supply provided with the Starter Kit) as well as an Ethernet connection for your computer configured with a fixed address on the 192.168.92.x subnet.
Note: IP addresses 192.168.92.3 and 192.168.92.68 are used for the SmartServer and the BASRT devices in the Starter Kit. Do not use these addresses when configuring your computer.
For a description of the SmartServer WAN/LAN network port settings required to support the Starter Kit and access through the BASRT-B router, see Configuring the Network.
Refer to the figure below for an overview of the network connections required to support access to the BASRT-B router on the 192.168.92.x subnet and to complete the necessary steps to setup the BACnet channel as described in this section.
Get started setting up the BACnet channel following the steps in the section below: Getting Started with BACnet Channel Setup.
Getting Started with BACnet Channel Setup
Preparing the Viconics Thermostat
The Viconics Thermostat, located on the lower right corner of the Starter Kit, is a BACnet MSTP device that is connected to the Contemporary Controls BASRT-B router. The following setup is necessary to add this device to the BACnet MSTP network segment:
- The BACnet device address must be set
- The binary input 1 must be configured with remote NSB timer clock input
Complete information on how to configure this device can be found in the Starter Kit archive → BACnet Channel → Viconics folder → VT7200 Series User Interface Guide (PDF). The quick-start steps are as follows:
- Remove the front bezel of the Viconics Thermostat by grasping the lower sides and simultaneously pulling out and up. The figure below identifies buttons that will be used in the steps that follow.
- Observe the BACnet communication Status LED located on the far left, middle portion of the thermostat. If you observe a pattern of two short, one long flashing lights, then the module has likely been configured with a BACnet device address. If you only see two short flashes, then the BACnet device address needs to be configured as described in this procedure.
Press and hold the Program menu select button for 8 seconds.
Note: The steps that follow must be done without pause because the programming mode times out if no button action is detected for 10 seconds.
The password set (PswrdSet) menu appears on the LCD display.
- Do not change this setting. The 0 value indicates that a password is not used. If you set a password, you will need to use the password from that point forward. If the password is forgotten, you will be locked out from making changes. Therefore, this step leaves the setting at 0 so you can operate the thermostat without a password.
- Press the Program menu select button one time.
The Com Addr menu appears on the LCD display.
- Press the Value up / down button until it reads a low value (8 in this example).
Verify that you set unique device addresses for all BACnet devices on a segment.
- Press the Program menu select button one more time.
- Press the Value up button on the right until you observe BI1 Rem NSB on the LCD display (which indicates Binary input no. 1, remote NSB timer clock input):
- Wait 10 seconds without pressing any buttons to allow your thermostat to return to operating mode.
At this point, the Status LED will begin a pattern of two short, one long flashing lights indicating that the module is connected to the BACnet MSTP segment of the Contemporary Controls BASRT-B router. If you do not see this LED pattern, verify the network connections and the BASRT-B, and the thermostat (Yellow - , Blue , Black (C)), and the power to the BASRT-B device.
Continue setting up the BACnet channel following the steps in the section below: Verifying the BACnet MSTP Communication Path.
Verifying the BACnet MSTP Communication Path
Your computer must be connected with the Ethernet port configured to a 192.168.92.x address.
- Refer to Configuring the Network for a description of the SmartServer WAN/LAN network port settings needed to support the Starter Kit and access through the BASRT-B router
- Refer to the figure above for an overview of the network connections required to support access to the BASRT-B router on the 192.168.92.x subnet
To configure the Ethernet port on your computer, follow these steps:
- In the Windows search box, type control panel and expand it in order to select Network and Sharing Center applet.
- Click Change adapter settings in the upper left portion of the window.
- Right-click your Ethernet adapter from the list of interfaces, and select Properties.
- Select Internet Protocol Version 4 (TCP/IPv4) and click Properties.
Define a static address for your adapter as shown in the figure below.
Note: Do not use the IP address 192.168.92.68 because this address is occupied by the Contemporary Controls BASRT-B router.
- Click OK.
- Close the nested dialogs associated with the Network and Sharing Center applet.
- Open a Windows command prompt by typing cmd in the Windows search field.
- Enter the following command to verify that you can reach the Contemporary Controls BASRT-B router:
A successful ping reply indicates that your computer and the Contemporary Controls BASRT-B router can communicate on the 192.168.92.x subnet.
Continue following the steps in the section below: Configuring the Contemporary Controls BASRT-B Router from a Browser.
Configuring the Contemporary Controls BASRT-B Router
- Open a browser session and type 192.168.92.68 in the browser address field.
A Sign In window appears.
- Enter the username and password (admin / admin). New versions of the BASRT-B Router will force you to change the password to secure this device before you can continue.
- Click Sign in.
The Contemporary Controls BASRT-B Configuration page appears.
- Confirm or set the configurations as shown in the figure below, making any necessary changes.
- Click Save Changes to store any changes you have made.
- Click Status.
The Contemporary Controls BASRT-B Status page appears.
On the Status page, you should see a green square to mark the device address you configured for the Viconics thermostat as shown in the figure below.
At this point, the infrastructure to the BACnet MSTP device is working and ready for use with the SmartServer.
Continue setting up the BACnet channel following the steps in the next section.
Configuring the BACnet Channel
You have setup the network configuration shown in this diagram. The wired connection from the computer to the 192.168.92.x subnet is no longer needed since you have established the thermostat is communicating on the MSTP segment using the BASRT-B Web configuration interface.
The steps performed in this section set up the BACnet channel on your SmartServer IoT.
The network addressing details are shown in the table below. The IP address listed for the computer is an example DHCP-assigned address — yours may be different. Review the information in the table below and confirm that your LAN network is not using the 192.168.92.x subnet. Doing so will cause problems with the static IP address configuration used for the LAN/eth0 connection.
WiFi connection to a home or corporate network. This is a DHCP-assigned IP address.
This is a wired Ethernet, statically managed IP address that uses the default subnet of the Contemporary Controls BASRT-B BACnet MSTP router.
Contemporary Controls BASRT-B
This is the factory default static IP address configured for the BASRT-B device.
The BACnet device address is set (to 8) as described in the Preparing the Viconics Thermostat section.
The BASRT-B router determines the network number of 112 from the Contemporary Controls BASRT-B configuration.
For unique device addresses used with BACnet Whois discovery, the actual UID used for communication by the BACnet driver is 72008. The 7200 prefix to the BACnet device ID is a Viconics convention.
To work with the BACnet client and server services of the SmartServer IoT, you need to enable the feature in the BACnet Configuration page. Doing so configures the BACnet communication ports and network IDs to allow BACnet communication. The steps to enable this feature are described below. With the Contemporary Controls BASRT-B configuration, it is important to note the network number (112) and the IP UDP port 1 (BAC0).
The steps that follow in this section show how the Contemporary Controls BASRT-B configuration is related to the SmartServer IoT BACnet configuration. To monitor and control devices on the MSTP-side of the Contemporary Controls BASRT-B router, your SmartServer must be on the same IP subnet (192.168.92.x) which is how we have setup the SmartServer LAN (eth0) port. This interface uses UDP port BAC0 and network 112.
Note: In some cases, you may need to isolate the interfaces to limit discovery by other BACnet client devices; these cases are where the Isolate option comes into play.
- Log into the SmartServer configuration UI using the username and password that appears on the SmartServer.
- The Network Configuration page appears.
- Click the BACnet tab.
The BACnet Configuration page appears.
Configure your BACnet settings to match those shown in the figure below as they relate to the Contemporary Controls BASRT-B Configuration settings, making sure to enable the BACnet options (checkboxes) on the SmartServer BACnet Configuration page.
- Click Update.
Continue setting up the BACnet channel following the steps in the section below: Creating BACnet Devices.
Creating BACnet Devices
The Viconics Thermostat communicates using BACnet MSTP and depends on the Contemporary Controls BASRT-B device being connected and configured as described in the previous sections.
Before creating BACnet devices in the SmartServer IoT CMS, confirm the following:
- The 5-port Ethernet switch on the back of the Starter Kit panel is powered-up.
- The SmartServer LAN (eth0) port is connected to the Ethernet switch. (Verify the link LED is active.)
- The LAN (eth0) port of the SmartServer IoT is configured with a static IP address: 192.168.92.3. (The SmartServer IoT requires a reboot after modifying the IP address.)
- The Contemporary Controls BASRT-B device is connected to the switch. (Verify the link LED is active.)
- With the Viconics thermostat cover removed, the Status LED is flashing two short, one long pattern indicating MSTP connectivity.
- Your SmartServer BACnet Router and Server is configured as shown in the BACnet Configuration page.
Perform the following steps to add the Viconics thermostat to your SmartServer IoT:
- Access the SmartServer IoT CMS by using the CMS tab on the Configuration UI, or by entering the URL https://[SmartServer IP address]/cms/#/login.
- Go to the Devices Types widget and click the Import button ().
- Select the Viconics7200-V20.dtp from the Starter Kit archive → BACnet Channel → Viconics folder in the DROP FILE HERE area.
- Click IMPORT FILE.
Notification messages will appear indicating that files are being uploaded and the CPU usage on the main CMS page will show increased activity. Once the files are finished loading, you will see the VT7200-1H1C-3 device type added to the Device Types widget. (Click to close All information messages.)
- Click BACK on the Device Types widget.
- Go to the Devices widget, which will be used to add a BACnet device to the system. Take note of the device name and character cases that will be used in creating the device.
- Click the Create button () on the Devices widget and add a device as shown in the figure below (leave the Context field empty):
- Name: Tstat-01
- Device category: Edge Device
- Click NEXT.
- Set the following fields as shown in the figure below:
- Click SAVE.
- To provision the device, click the Action button () on the Devices widget for Tstat-01 device.
Select the Provisioning and Deprovisioning a Device action.
Within a few seconds, the Tstat-01 device fill changes from blue to green indicating that the device has be successfully provisioned.
Note: With SmartServer 2.8, the Devices widget Test feature is not supported for BACnet devices.
Continue following the steps in the section below to verify and interact with the Tsat-01 device: Interacting with the BACnet Device.
Interacting with the BACnet Device
In the steps that follow, you will use the SmartServer IoT Datapoint Browser widget to verify and interact with the Tstat-01 device.
- On the Devices widget, click the Action button () for Tstat-01 device and select the View datapoints action.
The Datapoint Browser widget appears.
On the Datapoint Browser widget, you will see the current value for the datapoints that are defined in the 140_VT7200C5x00B.bac. This .bac file is contained in the Viconics7200-V20.dtp archive that was imported in the process of Creating BACnet Devices.
- The bottom switch, to the left of the Viconics thermostat, is connected to the BI:29 input.
In the OFF position, the thermostat reports an Occupied state on the LCD display and the Datapoint Browser widget reports the value as false or 0 (as shown above when the Datapoint Browser widget appears).
In the ON position, the thermostat reports an Unoccupied state on the LCD display, and the Datapoint Browser widget will report the value as true or 1 (as shown below).
To learn about exposing additional datapoints, review the section below: Defining Additional Datapoints.
Defining Additional Datapoints
The 140_VT7200C5x00B.bac file used with the Starter Kit setup defines the driver-level interface that only exposes two datapoints. This BACnet XIF file is contained in the Viconics7200-V20.dtp archive that was imported in the process of Creating BACnet Devices.
You can use the provided Viconics integrators documentation to add more datapoints. This documentation can be found in the Starter Kit archive → BACnet Channel → Viconics folder → VT7200 Series User Interface Guide (PDF).
Before taking these next steps, verify the following:
- If you have a defined device that references a type based on the existing BACnet XIF file, which calls out the Program_ID of 9B008C011E00FC04, should change the PID and rename the BACnet XIF file when you add, remove, or change datapoints.
- To retain the Program_ID, first remove devices that use the device type referencing the Program_ID, and next, remove the device type that use the BACnet XIF file.
- BACnet datapoint monitoring requires you to enable monitoring in the Datapoint Properties widget. If you add datapoints to the BACnet XIF file, define monitoring definitions in the Viconics7200-v20-dla.csv file. This DLA file is contained in the Viconics7200-V20.dtp archive that was imported in the process of Creating BACnet Devices.