Click to download this document.
Version History
Updated | Document Version | Description |
2026-08-18 | V1.1 | Optimize image description |
2026-06-18 | V1.0 | Initial version |
Gateways & Firmware Requirement
Software | E2C Factory | E2C Field | E2C Facility |
Gateways supporting | EG3120; EG5120; EG5200 | LG3120 | LG5120 |
Firmware Requirement (RobustOS Pro Version) | EG3120 (≥ROS Pro:2.4.103); EG5120 (≥ROS Pro:2.4.105); EG5200 (≥ROS Pro:2.3.108) | LG3120 (=ROS Pro:2.4.111) | TBD |
1. Manual Description
1.1 Manual Purpose
This manual guides technicians to quickly configure the Robustel edge computing gateway to collect data from Southbound BACnet devices (BACnet/IP or BACnet MS/TP). It also covers how to forward the collected data to Northbound systems using MQTT or an OPC UA Server.
1.2 Scope of Application
This manual is written for field implementation engineers and technicians. You do not need deep theoretical knowledge of the BACnet protocol. By following these step-by-step instructions, you can easily connect devices, read data points, and forward data.
2. Basic Concepts & Network Topology
2.1 Gateway Role in the Network
In the BACnet network, the Robustel Gateway acts as the data forwarding machine. Its job is to actively initiate requests, read data from the underlying BACnet devices (such as HVAC controllers, chillers, or smart meters), and then translate this data into IIoT protocols (like MQTT/OPC UA).
2.2 Connection Topology
- BACnet/IP: Devices are connected via standard Ethernet cables. The gateway and the BACnet devices are typically in the same local network subnet. However, if they are not in the same subnet (e.g., cross-network segment via a router), the BBMD (BACnet Broadcast Management Device) protocol can be used to discover and connect the devices.
Figure 2-1 BACnet IP connection architecture
- BACnet MS/TP: Devices are daisy-chained via an RS485 serial cable. You must connect the "A" and "B" wires correctly and ensure all devices share the same Baud Rate.
Figure 2-2 BACnet MS/TP connection architecture
3. Preparations
3.1 Hardware Device Requirements
Device Type | Specific Requirements |
Gateway | Robustel Gateway with E2C Field / E2C Factory / E2C Facility software installed. In this document, we use LG3120 with E2C Field for an example. |
BACnet Device | BACnet/IP device or BACnet MS/TP device (must know its IP or Serial settings). |
Wiring | Standard Ethernet cable (for IP) or 2-wire RS485 cable (for MS/TP). |
PC | A laptop connected to the gateway's LAN port for web configuration. |
3.2 Environment and Network Requirements
- The PC and the Gateway must be in the same network segment. (Default Gateway IP: 192.168.0.1)
- It is highly recommended that you have the Point List (Register Map) provided by the BACnet device manufacturer. This list tells you the specific meanings of the data points. If you do not have it, you can still use the gateway's Auto Search function to discover the points, but you may need the list to interpret the data.
4. Southbound Configuration: BACnet/IP
If your field device uses a network cable (Ethernet), follow this chapter. If it uses an RS485 serial port, skip to Chapter 5.
4.1 Physical Layer: Configuring LAN IP
Purpose of this step: To establish basic network communication. The gateway's LAN IP must be configured so it can successfully "ping" and communicate with the target BACnet/IP device over the Ethernet network.
(Note: If crossing subnets, ensure routers are configured correctly and BBMD is properly handled for device discovery).
- Log in to the gateway's Web GUI (Default IP: 192.168.0.1, User: admin, Password: admin).
- Go to Network > LAN.
- Edit the LAN1 interface and fill in the parameters according to the table below:
Parameter Name | Configuration Description | Recommended / Example Value |
IPv4 Address and Subnet Mask | Set the gateway's IP to be in the same subnet as the end BACnet device. | e.g., 192.168.1.1/24 (if device is 192.168.1.100) |
Click Submit and Save & Apply to apply the network changes.
Figure 4-1 Configuring LAN IP
4.2 Adding a BACnet/IP Device
Purpose of this step: To define the target device in the Data Collection engine so the gateway knows exactly which IP address and port to send data requests to, and how to identify itself on the BACnet network.
First, click Edge Computing in the gateway's Web GUI to enter the E2C Field software. Then follow these steps to add a BACnet IP Device.
Method 1: Manual Configuration
- Go to Data Collection > Wired Device.
- Click the + button to add a new device.
- Configure the following parameters in the popup window:
Parameter Name | Configuration Description | Recommended / Example Value |
Device Name | Create a custom name for easy identification on the platform. | e.g., Chiller_01 |
Driver (Protocol) | Select the protocol type for the Southbound device. | BACnet IP |
Local Network | Select the LAN port that connects to the BACnet IP device. | e.g., br_lan(192.168.1.1) |
Port Number | The communication port for BACnet/IP services. | Keep default 47808 unless specified otherwise. |
Device ID | The ID of the BACnet IP device. | e.g., 1111 |
Click Save to create the device profile.
Figure 4-2 Manual add device configuration
Method 2: Auto Search (Recommended)
If you are unsure of the device's specific parameters, you can use the Auto Search feature to discover BACnet/IP devices on the network.
- Click the Auto Search button, and select the LAN port.
- The system will scan the network for available BACnet devices. Select the desired device from the search results and click to add it. This will automatically populate the necessary parameters.
Figure 4-3 Auto search devices
4.3 Adding Data Points
Purpose of this step: To define which specific sensor values or registers (data points) need to be read from the added BACnet device.
Method 1: Auto Search (Highly Recommended) BACnet protocol supports network discovery. This is the fastest way to add points.
- In the Data Collection list, click on the device name you just created to enter its tag list.
- Click the Auto Search button at the top.
- The gateway will automatically query the device and display all available data points (tags).
- Select the checkboxes next to the points you need and click Save.
- Check the Latest Value column. If live numbers appear and update periodically, the configuration is fully successful.
Figure 4-4 Auto Search BACnet/IP data points
Method 2: Manually Add If Auto Search fails or is not supported by the end device, you can add points manually based on the manufacturer's Point List. Click Manually Add and configure:
Parameter Name | Configuration Description | Recommended / Example Value |
Collection Mode | Select Polling or Subscription Mode | e.g., Polling |
Name | Tag name, a readable name for the data point. | e.g., DO1 |
Tag Type | Select Device Tag or Virtual Tag. For reading data from device, select Device Tag. | e.g., Device Tag |
Object Type | The type of the BACnet object. Refer strictly to your device's Point List. | e.g., Analog Input (AI), Binary Output (BO) |
Instance Number | The unique register/instance number for this specific object. | e.g., 17 |
Data Type | The data format of the point value. | Select according to the Point List. |
R/W Permission | Select Read Only or Read & Write. | e.g., Read & Write |
Figure 4-5 Manually add a BACnet/IP data point
5. Southbound Configuration: BACnet MS/TP
If your field device uses a 2-wire RS485 serial connection, follow this chapter.
First, click Edge Computing in the gateway's Web GUI to enter the E2C Field software. Then follow these steps to add a BACnet MS/TP Device.
5.1 Physical Layer: Configuring the Serial Port
Purpose of this step: To align the gateway's serial port hardware settings with the field device. In RS485 communications, all devices on the daisy-chain must speak at the exact same speed and format, otherwise, no data can be read.
Warning: Ensure the RS485 wiring is correct (A to A, B to B). If communication fails later, try swapping the A and B wires.
- Log in to the gateway's Web GUI.
- Go to Interface > Serial Port, set the Serial Port Type to RS485.
Figure 5-1 Configure the RS485 serial port
- Go to Edge Computing > System Settings > Serial Ports.
- Find the serial port connected to your device (e.g., COM1) and configure:
Parameter Name | Configuration Description | Recommended / Example Value |
Baud Rate | The communication speed. Must exactly match the end device. | Usually 38400 or 9600 |
Data Bit | The length of the data payload. | 8 |
Check Bit | No Parity / Even Parity / Odd Parity | No Parity |
Stop Bits | The end-of-byte signal length. | 1 |
Parity | Error checking method. | None |
- Click Submit to apply the serial settings.
Figure 5-2 Serial port settings
5.2 Adding a BACnet MS/TP Device
Purpose of this step: To tell the Data Collection engine which serial port to listen on and what the MS/TP MAC address (Station ID) of the target device is.
Method 1: Manual Configuration
- Go to Data Collection > Wired Device.
- Click the + button to add a new device.
- Configure the following parameters in the popup window:
Parameter Name | Configuration Description | Recommended / Example Value |
Device Name | Create a custom name for easy identification on the platform. | e.g., Chiller_01 |
Driver (Protocol) | Select the protocol type for the serial device. | BACnet MSTP |
Communication method | Select the serial port that connects to the device. | e.g., /dev/ttyCOM1 |
Local Node Address | Set an address of the Edge Gateway itself. | e.g., 0 |
Maximum number of frames per message | Set the maximum number of frames per message. | e.g., 5 |
Maximum number of primary devices | Set the maximum number of primary devices. | e.g., 10 |
Device ID | Set the ID of the BACnet MS/TP device. You can get this value from the specification document of the device usually. | e.g., 1 |
Polling Cycle | Set the polling cycle time. | e.g., 1 |
- Click Save to create the device.
Figure 5-3 Manually add a BACnet MS/TP device
Method 2: Auto Search (Recommended)
If you are unsure of the device's specific parameters on the serial network, you can use the Auto Search feature to discover BACnet MS/TP devices.
- Click the Auto Search button.
- Configure the following parameters in the popup window:
Parameter Name | Configuration Description | Recommended / Example Value |
Device Name | Create a custom name for easy identification on the platform. | e.g., Chiller_01 |
Driver (Protocol) | Select the protocol type for the serial device. | BACnet MSTP |
Communication method | Select the serial port that connects to the device. | e.g., /dev/ttyCOM1 |
Local Node Address | Set an address of the Edge Gateway itself. | e.g., 1 |
Maximum number of frames per message | Set the maximum number of frames per message. | e.g., 5 |
Maximum number of primary devices | Set the maximum number of primary devices. | e.g., 10 |
Polling Cycle | Set the polling cycle time. | e.g., 1 |
- The system will scan the selected serial port for available BACnet devices. Select the desired device from the search results and click to add it. This will automatically populate the necessary parameters like MAC Address.
Figure 5-4 Auto Search BACnet MS/TP devices
5.3 Adding Data Points
Purpose of this step: Let the software know which point data to read.
Method 1: Auto Search (Highly Recommended) BACnet protocol supports network discovery. This is the fastest way to add points.
- In the Data Collection list, click on the device name you just created to enter its tag list.
- Click the Auto Search button at the top.
- The gateway will automatically query the device over the RS485 serial network and display all available data points (tags).
- Select the checkboxes next to the points you need and click Save.
Figure 5-5 Auto Search BACnet MS/TP data points
- Check the Latest Value column. If live numbers appear and update periodically, the configuration is fully successful.
Figure 5-6 Verify BACnet MS/TP data point values
Method 2: Manually Add If Auto Search fails or is not supported by the end device, you must add points manually based on the manufacturer's Point List. Click Manually Add and configure:
Parameter Name | Configuration Description | Recommended / Example Value |
Collection Mode | Select Polling or Subscription Mode | e.g., Polling |
Name | Tag name, a readable name for the data point. | e.g., DO1 |
Tag Type | Select Device Tag or Virtual Tag. For reading data from device, select Device Tag. | e.g., Device Tag |
Object Type | The type of the BACnet object. Refer strictly to your device's Point List. | e.g., Analog Input (AI), Binary Output (BO) |
Instance Number | The unique register/instance number for this specific object. | e.g., 17 |
Data Type | The data format of the point value. | Select according to the Point List. |
R/W Permission | Select Read Only or Read & Write. | e.g., Read & Write |
6. Device Status and Data Verification
Once the configuration is complete, it is crucial to verify that the gateway is successfully communicating with the field devices and collecting accurate data.
6.1 Checking Device Connection Status
Purpose of this step: To confirm if the gateway has successfully established a connection with the Southbound BACnet device.
- Go to Edge Computing > Data Collection > Wired Devices.
- Locate the configured device card in the list.
- Check the indicator on the top left corner of the device card:
- Green: The device connection is normal.
- Red: The device connection failed.
Figure 6-1 Check device connection status
6.2 Viewing Data Collection Status and Latest Values
Purpose of this step: To verify that the configured data points are successfully returning valid readings from the field device.
- Observe the Status, Latest Value, and Update Time columns:
- Status: This column shows the collection status of each data point. A green icon indicates the data point is collected normally, while a red icon indicates collection failure.
- Latest Value: This column displays the real-time data collected from the field device (e.g., a temperature reading of 25.5 ).
Figure 6-2 View data collection status and latest values
6.3 Modifying Data Values (Write Operation)
Purpose of this step: To send control commands back to the field device (e.g., turning on a relay or setting a new temperature setpoint).
- Ensure the data point has Read/Write permissions (e.g., Analog Output - AO, or Binary Output - BO). Points with Read Only permission (like AI or BI) cannot be modified.
- In the tag list, click the Edit icon (usually a pencil symbol) next to the point you want to modify.
- A Modify Tag Value dialog box will appear. Enter the new desired value and click Save or Confirm.
- Observe the Latest Value column. It should update to reflect the new value if the write operation was successful.
Figure 6-3 Modify a data point value
7. Northbound Configuration: Two Core Scenarios
Once the gateway successfully reads data from Southbound BACnet devices, you can forward this data to the Northbound platform.
7.1 Creating Data Groups (Preparation for Data to Cloud)
Purpose of this step: To organize the collected BACnet data points into logical groups before sending them to the cloud or application systems. Grouping allows you to control exactly which data points are packed and uploaded together in a single payload.
- Go to the Data to Cloud - Groups tab.
- Click the + button to add a new group, and set the report type (Period, Change or Change & Period).
- In the tag selection area, select the BACnet devices and the specific data points (tags) you want to include in this group.
- Click Save to create the group.
(Note: You will use this created Group in the following MQTT transmission settings to define the upload payload).
Figure 7-1 Create a data group
7.2 Scenario A: Forwarding to MQTT Broker (Data to Cloud)
This scenario is used to push data to cloud platforms (like AWS, Azure, or private IoT platforms).
- Go to Data to Cloud, Create Cloud Service, and choose MQTT.
- Configure the MQTT connection:
- Server Address / Port: Enter your cloud server IP and Port (usually 1883).
- Client ID: Set a unique ID for the gateway.
- Username / Password: Fill in if required by your broker.
- Go to the Message Management section and add a publish topic.
- Topic: Define the topic where data will be published (e.g., gateway/bacnet/data).
- Data Group: Select the group you created before.
- Click Save and ensure the connection status turns to "Connected".
- Use a MQTT client to check subscribe the message.
Figure 7-2 Configure the MQTT cloud service
Figure 7-3 Configure MQTT message management
Figure 7-4 Verify MQTT data publication
7.3 Scenario B: Forwarding to OPC UA Server (Data to SCADA)
This scenario is used to provide data to local factory SCADA or BMS systems. The gateway acts as an OPC UA Server, waiting for the SCADA to connect to it.
- Go to Data Forwarding.
- Add a OPC UA Server.
- Enable the OPCUA Server Configuration and set the Port Number.
- Set Maximum Connections, and choose Authentication Mode (Anonymous or User)。If User Mode is selected, you need to set a username and a password.
- Submit and Publish.
- In your SCADA software, use the URL opc.tcp://[Gateway_LAN_IP]:4840 to discover the gateway and browse the BACnet data points.
Figure 7-5 Configure the OPC UA server
Figure 7-6 Browse BACnet data points through OPC UA
8. Troubleshooting / FAQ
Symptom | Possible Cause | Solution |
BACnet/IP: Cannot search any devices or points | 1. Gateway and device are in different subnets without BBMD; 2. Target IP or Port is incorrect. | 1. Ensure the gateway IP is in the same subnet as the target, or properly configure BBMD for cross-subnet discovery; 2. Verify the Target IP and Port (default 47808). |
BACnet MS/TP: No data | RS485 wiring is reversed or Baud Rate does not match. | 1. Swap the A and B wires physically; 2. Check Serial Ports Configuration to ensure the Baud Rate matches the device. |
Both: Status show red (Read Failed) | The device does not support the requested Object Type or Instance Number. | Check the manufacturer's manual. Manually add the point and ensure the Instance Number is exactly correct. |
MQTT: Fails to connect | Gateway has no internet access or wrong broker info. | Check if the gateway's WAN/4G interface is online. Verify Broker IP and Port. |
9. Core Parameter Quick Reference
For quick on-site configuration, refer to these industry-standard default values. Unless explicitly required by the site, do not change them:
Parameter Name | Protocol | Default/Recommended Value | Description |
Port | BACnet/IP | 47808 (UDP) | Standard BACnet/IP Port. |
Device ID | BACnet/IP | Unique number (e.g., 200) | Must not duplicate other devices on the LAN. |
Baud Rate | BACnet MS/TP | 38400 or 9600 | Must match the end device perfectly. |
MAC Address | BACnet MS/TP | 1 to 127 | The Slave ID of the end device. |
AI (Analog Input) | Point Object | Sensor values | Temperature, Pressure, Level (Read Only). |
AO (Analog Output) | Point Object | Control values | Valve position, Fan speed (Read/Write). |
BI (Binary Input) | Point Object | Digital status | Switch ON/OFF, Fault Alarm (Read Only). |
BO (Binary Output) | Point Object | Digital control | Relay ON/OFF command (Read/Write). |