BACnet

This document explains how to connect BACnet devices to Aqara Studio.

Prerequisites

Before you start, please make sure your network meets these conditions based on your device type:

• For BACnet/IP devices: The BACnet/IP device, Aqara gateway, and your computer must be on the same local area network (LAN).
• For BACnet MS/TP devices: The BACnet MS/TP device is already connected to a BACRouter, and the BACRouter, Aqara gateway, and your computer are all on the same LAN.

Add A BACnet Device

1. In the left sidebar, click to enter the Devices page.

2. In the device tree on the left, click the “+” button. In the popup, choose BACnet IP.

3. Select BACnet IP to open the management page.

4. Go to the Protocol Configuration tab and set the following parameters for this protocol:

   Category	Parameter	Required	Description	Example
   Basic Configuration	Network Number	✔	It identifies the logical subnet, and must be unique. Range: [0, 65535]. 0: Local network 65535: Broadcast network	1
   	UDP Port	✔	The UDP port for BACnet/IP communication. Default is 47808 (0xBAC0).	47808
   	Local IP Address	✘	The IP address of the device on which Aqara Studio is deployed. Format: xxx.xxx.xxx.xxx (for example, 192.168.1.100). Default is 0.0.0.0, which allows the system to assign it automatically.	1
   	Device Object Instance Number	✔	A unique identifier for the BACnet device on the BACnet network. Range: [0, 4194303].	1
   Worker Mode Configuration	BACnet/IP Device Type	✘	The following options are supported: Standard Device: General BACnet devices (such as controllers, servers, clients) that use UDP port 47808 (default). Foreign Device: Not on the local subnet, must be registered with BBMD to enable cross-subnet communication. Broadcast Management Device (BBMD): Manages foreign device registration, forwards broadcast messages, and maintains the broadcast table.	Standard Device
   	BBMD UDP Port	✘	The listening port for BBMD services, default is 47808. Required if the BACnet/IP device mode is Foreign Device or Broadcast Management Device.	47808
   	BBMD IP Address	✘	The IP address of the BBMD. This is the target for foreign device registration and is used for cross-subnet broadcasts. Required if device mode is Foreign Device or Broadcast Management Device.	null
   Advanced Configuration	Max APDU Length Accepted (bytes)	✘	The maximum supported APDU (Application Protocol Data Unit) length in bytes. It is recommended to set no larger than 1476.	1076
   	Segmentation Supported	✘	Options: Segmented Both (default): The device supports segmented APDU messages both for sending and receiving. Segmented Transmit: Only supports sending segmented messages. Segmented Receive: Only supports receiving segmented messages. No Segmentation: Does not support segmented messages. Only messages within the max APDU length are supported.	Segmented Both
   	APDU Segment Timeout	✘	The timeout for waiting for a segment acknowledgment when transmitting segmented APDU. Default is 2000ms.	2s
   	APDU Timeout	✘	Applies only for non-segmented APDU transfers. Defines how long to wait for a response (such as ACK or Error). Default is 30000ms.	30s
   	Character Set	✘	The character set used, to ensure text information can be correctly encoded and decoded between devices. Supported options: ISO_10646_UTF8, IBM_MICROSOFT_DBCS, JIS_X0208, ISO_10646_UCS4, ISO_10646_UCS2, ISO_8859_1, UNKNOWN.	ISO_10646_UTF8
   	Enable/Disable Network	✘	Note: If disabled, devices on this network will not work.	-

5. (Optional) Go to the "Add Device" tab, and click the ⚙ button to set up device discovery rules.

   The following discovery rule fields can be set:

   Field Name	Description
   Device objectId ≥	Search for devices with instance numbers greater than or equal to this value. Minimum is 0.
   Device objectId ≤	Search for devices with instance numbers less than or equal to this value. Maximum is 4194302.
   Network Instance Filter	Control which network numbers to discover, such as 1,2,3,4. Default is all.
   Wait Response Time	The time for the discovery process, in seconds. Note: If device discovery fails or some devices are not found, adjust this field based on network conditions.

6. Click the “Discover Devices” button. Aqara Studio will then scan the network to find devices.

   tip

   If Aqara Studio does not find your BACnet device, you can also add the device manually.

7. Select the device(s) you want to add, and click the "+" button in the center. The newly added device(s) will appear in the Added Device List on the right, and will also be displayed under BACnet IP in the device tree on the left.

Add Points

1. In the device tree, select the newly added device to enter its configuration page.

2. Go to the Point tab and click the Add point button.

3. In the "Add point" page, click Discover Points button, Aqara Studio will begin scanning to discover function points for this device.

   tip

   If the system does not discover the function points you need, you can also add them manually.

4. Select the required points and click the blue "+" button. The newly added points will appear in the Added Points list on the right, and will also be displayed under the related device in the device tree on the left.

   Aqara Studio will automatically map the points of BACnet devices to the feature points in the Aqara Spec protocol accordingly, enabling standardized control and management.

   tip

   If Aqara Studio mapped a point type incorrectly, you can select the point in the device tree, go to the Point detail page, and click Point Type to adjust it.

   

Next Steps

Now, you can view details and control the device, or use the device in automation.

FAQ

How to Handle BACnet Devices Not Discovered by Aqara Studio

If Aqara Studio does not find your BACnet device, click "Manually Add." In the "Add Device" popup, enter the required parameters to finish adding the device.

Details for each parameter are as follows:

Parameter	Required	Description	Example
Device Name	✔	Your custom name for the BACnet device.
Device Object Instance Number	✔	Unique ID for the BACnet device on the BACnet network. Range: [0, 4194303].	1
Network Number	✔	Identifies the logical subnet, must be unique. Range: [0,65535]. 0: Local, 65535: Broadcast	1
MAC Address	✘	MAC address of the device.	-
Address Type	✘	Specify the format and protocol type of MAC address: UNKNOWN: Unknown type ETHERNET: 6-byte Ethernet MAC, format AA:BB:CC:DD:EE:FF IP: 4-6 byte IP address, format 192.168.1.1:47808 MSTP: 1 byte, Master-Slave/Token-Passing SC: 6-byte Secure Connection, WebSocket	-
Max APDU Length Accepted (bytes)	✘	The maximum APDU (Application Protocol Data Unit) length in bytes. Recommended no larger than 1476.	1076
Segmentation Supported	✘	Options: Send and Receive Segmentation (default): Supports both sending and receiving segmented APDUs. Send Only: Only supports sending segmented messages. Receive Only: Can only receive segmented messages. No Segmentation: Only unsegmented messages within the length limit are supported.	Send and Receive Segmentation
Encoding	✘	Character encoding used. Supported: ISO_10646_UTF8 IBM_MICROSOFT_DBCS JIS_X0208 ISO_10646_UCS4 ISO_10646_UCS2 ISO_8859_1 UNKNOWN	ISO_10646_UTF8
Vendor Name	✘	Name of the device manufacturer.	-
Model Name	✘	Model name of the device.	-
Protocol Revision	✘	Enter the Protocol_Revision property from BACnet.	-
Firmware Version	✘	Enter the Firmware_Revision property from BACnet.	-
Application Software Version	✘	Enter the Application_Software_Version property from BACnet.	-

How to Handle BACnet Points Not Discovered by Aqara Studio

If Aqara Studio does not find the points you need, click "Manually Add" on the Point Add page, and enter the point parameters in the popup.

Details for each parameter are as follows:

Parameter	Required	Description
Point Name	✔	You can set a custom name for this point.
Aqara Object Type	✘	Object type defined by Aqara.
Object Type	✔	Object type as defined by BACnet.
Object Instance identifier	✘	The instance number for this point. Range: [0, 4194303].