Skip to content
This repository was archived by the owner on May 22, 2026. It is now read-only.

Commit 6d6d66b

Browse files
samson0vashvayka
authored andcommitted
Updated BACnet connector advanced configuration section
1 parent 4291fc8 commit 6d6d66b

2 files changed

Lines changed: 28 additions & 0 deletions

File tree

_includes/templates/iot-gateway/bacnet-connector/examples/time-series-and-attributes/dynamic-device-name-and-profile.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,3 +17,6 @@ You can use the following variables to extract specific device information:
1717
- "**Device ID: ${objectId} at ${address}**" If the objectId variable exists and contains **"vendorId": 999** and
1818
address variable exists and contains **"address": "192.168.1.1"**, the device on platform will have the following
1919
name: **Device ID: 999 at 192.168.1.1**.
20+
21+
You can find full list of available variables in
22+
the [Advanced configuration](/docs/iot-gateway/config/bacnet/#available-variables-for-device-nameprofile-expressions) section.

docs/iot-gateway/config/bacnet.md

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -284,6 +284,17 @@ Example of the application configuration:
284284
}
285285
```
286286

287+
### Foreign device (v.3.7.6+)
288+
289+
The foreign device configuration parameters are used to configure the gateway as a foreign device in the BACnet network.
290+
It is useful when the gateway is behind a NAT and needs to register with a BACnet Broadcast Management Device (BBMD).
291+
292+
| **Parameter** | **Default value** | **Description** |
293+
|:---------------------------|-------------------|---------------------------------------------------|
294+
| foreignDevice.ttl (in sec) | **900** | Time to live for the foreign device registration. |
295+
| foreignDevice.address | **0.0.0.0** | The address of the BBMD to register with. |
296+
| --- | | |
297+
287298
### Devices
288299

289300
The device list contains an array of BACnet devices that can be connected to the connector and interact with them.
@@ -329,6 +340,20 @@ Example of the device mapping configuration:
329340
}
330341
```
331342

343+
#### Available variables for device name/profile expressions
344+
345+
You can use the following parameters for forming device name and profile:
346+
- `${objectName}` - the device object name of the BACnet device.
347+
- `${objectId}` - the device object identifier of the BACnet device.
348+
- `${vendorId}` - the device vendor identifier of the BACnet device.
349+
- `${address}` - the device host address.
350+
- `${routerId}` - the device router identifier.
351+
- `${routerName}` - the device router name.
352+
- `${routerAddress}` - the device router address.
353+
- `${routerVendorId}` - the device router vendor identifier.
354+
355+
You can find detail examples [here](/docs/iot-gateway/config/bacnet/#usage-examples).
356+
332357
#### Device attributes and time series
333358

334359
| **Parameter** | **Description** |

0 commit comments

Comments
 (0)