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

Commit 254a105

Browse files
samson0vashvayka
authored andcommitted
Small fixes
1 parent 5c1a7ec commit 254a105

7 files changed

Lines changed: 52 additions & 13 deletions

File tree

Lines changed: 21 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
To add a new device, click the "plus" icon:
1+
To add a new device, click the "**plus**" icon:
22

33
![image](/images/gateway/bacnet-connector/bacnet-gateway-configuring-1-ce.png)
44

@@ -8,11 +8,28 @@ Provide the following fields in the opened model window:
88
- **Device name source** - the source of the device name, can be:
99
- **Constant** - the device name is static;
1010
- **Expression** - the device name is an expression;
11-
- **Device name value / expression** - the device name (you can find detail examples [here](/docs/iot-gateway/config/bacnet#examples-device-name-expression-and-device-profile-expression));
11+
- **Device name value / expression** - the device name (you can find detail examples [here](/docs/iot-gateway/config/bacnet/#usage-examples));
1212
- **Device profile source** - the source of the device profile, can be the same as the device name source;
13-
- **Device profile value / expression** - the device profile name (you can find detail examples [here](/docs/iot-gateway/config/bacnet#examples-device-name-expression-and-device-profile-expression));
13+
- **Device profile value / expression** - the device profile name (you can find detail examples [here](/docs/iot-gateway/config/bacnet/#usage-examples));
1414
- **Poll period** - the period of time when the connector will try to poll BACnet device;
1515
- **Advanced configuration settings**:
16-
- **Alternative responses addresses** - the alternative address for responses from the device (you can find detail examples [here](/docs/iot-gateway/config/bacnet#examples-alternative-responses-addresses)).
16+
- **Alternative responses addresses** - the alternative address for responses from the device (you can find detail examples [here](/docs/iot-gateway/config/bacnet/#usage-examples)).
17+
- **Report strategy** - strategy for sending data to ThingsBoard:
18+
- **Report period** - period for sending data to ThingsBoard in milliseconds;
19+
- **Type** - type of the report strategy:
20+
- **On report period** - sends data to ThingsBoard after the report period;
21+
- **On value change** - sends data to ThingsBoard when the value changes;
22+
- **On value change or report period** - sends data to ThingsBoard when the value changes or after the report period;
23+
- **On received** - sends data to ThingsBoard after receiving data from the device (default strategy).
24+
25+
{% capture difference %}
26+
All configuration parameters list, and their detailed description can be found in the
27+
[Advanced configuration](/docs/iot-gateway/config/bacnet/#devices) section.
28+
29+
More usage examples can be found in the [Example usage](/docs/iot-gateway/config/bacnet/#usage-examples) section.
30+
31+
Additional information about the report strategy can be found [here](/docs/iot-gateway/features-overview/report-strategy){:target="_blank"}.
32+
{% endcapture %}
33+
{% include templates/info-banner.md content=difference %}
1734

1835
![image](/images/gateway/bacnet-connector/bacnet-gateway-configuring-2-ce.png)

_includes/templates/iot-gateway/bacnet-connector/device-time-series-and-attributes-basic-section.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@ data will be sent to the ThingsBoard server. The following strategies are availa
4040

4141
- **On report period** - sends data to ThingsBoard after the report period;
4242
- **On value change** - sends data to ThingsBoard when the value changes;
43-
- **On value change and report period** - sends data to ThingsBoard when the value changes or after the report period;
43+
- **On value change or report period** - sends data to ThingsBoard when the value changes or after the report period;
4444
- **On received** - sends data to ThingsBoard after receiving data from the device (default strategy).
4545

4646
![image](/images/gateway/bacnet-connector/bacnet-gateway-configuring-10-ce.png)

_includes/templates/iot-gateway/bacnet-connector/examples/shared-attributes-and-rpc/attribute-updates.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ Let’s add an attribute update to our configuration. For this purpose, follow t
2727
title: Click on the “**Add attribute update**” button. In our case, we will add `relay` attribute update, so the “**Key**” field, enter `relay`, select the “**Object ID**” as **Analog Input** and "**1**", "**Property ID**" as "**Present Value**".
2828
===
2929
image: /images/gateway/bacnet-connector/examples/connector-configuration-attribute-updates-3.png,
30-
title: Remember to save your changes by clicking the “**Apply**” button.
30+
title: Remember to save your changes by clicking the “**Apply**” button and click save connector configuration button.
3131
'
3232
%}
3333

_includes/templates/iot-gateway/bacnet-connector/examples/shared-attributes-and-rpc/rpc-to-device.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ we need to configure the BACnet connector to support RPC calls. For this purpose
2323
title: Click on the "**Add method**" button. Fill in the "**Method**" field with `getTemperature`, select the "**Request Type**" as "**Read Property**", "**Object ID**" as "**Analog Value**" and "**1**", and "**Property ID**" as "**Present Value**".
2424
===
2525
image: /images/gateway/bacnet-connector/examples/rpc-to-device-3.png,
26-
title: Remember to save your changes by clicking the "**Apply**" button.
26+
title: Remember to save your changes by clicking the "**Apply**" button and click save connector configuration button.
2727
'
2828
%}
2929

_includes/templates/iot-gateway/bacnet-connector/examples/time-series-and-attributes/reading-all-device-objects.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ In our case, we will store all objects in time series, so the device configurati
3939
"attributeUpdates": [],
4040
"serverSideRpc": []
4141
}
42-
],
42+
]
4343
}
4444
```
4545

docs/iot-gateway/config/bacnet.md

Lines changed: 27 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ backward compatibility.
3030

3131
## Configuration modes
3232

33-
The Modbus connector can be configured in two modes: **Basic** and **Advanced**.
33+
The BACnet connector can be configured in two modes: **Basic** and **Advanced**.
3434

3535
- **Basic** mode is designed for users who are new to ThingsBoard IoT Gateway and want to quickly set up the connector
3636
with minimal configuration. It provides a simplified interface with essential settings.
@@ -74,8 +74,8 @@ You can configure additional application settings like: APDU length, segmentatio
7474
|:-----------------------------|:------------------|------------------------------------------------------------------------------------------------------------------|
7575
| APDU Length (in bytes) | **1476** | Maximal length of the APDU. |
7676
| Segmentation | **Both** | Segmentation type for transmitting large BACnet messages. Can be: **Both**, **Transmit**, **Receive**, **None**. |
77-
| Network number | | Identifier of the network segment. |
78-
| Discovering timeout (in sec) | **3** | Period of time when the connector will try to discover BACnet devices. |
77+
| Network number | **3** | Identifier of the network segment. |
78+
| Discovering timeout (in sec) | **5** | Period of time when the connector will try to discover BACnet devices. |
7979
| --- | | |
8080

8181
{% capture difference %}
@@ -390,7 +390,8 @@ Example of the device attribute updates configuration:
390390
"key": "setpoint",
391391
"objectType": "analogValue",
392392
"objectId": 3,
393-
"propertyId": "presentValue"
393+
"propertyId": "presentValue",
394+
"timeout": 5000
394395
}
395396
]
396397
}
@@ -420,7 +421,8 @@ Example of the device RPC methods configuration:
420421
"requestType": "writeProperty",
421422
"objectType": "analogValue",
422423
"objectId": 3,
423-
"propertyId": "presentValue"
424+
"propertyId": "presentValue",
425+
"timeout": 5000
424426
}
425427
]
426428
}
@@ -473,6 +475,26 @@ Property identifiers depend on type of the BACnet object, provided in camelCase,
473475
**objectDescription**
474476
etc.
475477

478+
## Troubleshooting
479+
480+
### Device discovery issues on Linux with Docker Compose
481+
482+
If you are running Gateway via docker compose on Linux, and you have issues with device discovery, make sure that you
483+
have set the correct network mode in the docker compose file. So you should add the following line to `tb-gateway`
484+
service in your docker compose file:
485+
486+
```yaml
487+
network_mode: "host"
488+
extra_hosts:
489+
- "host.docker.internal:host-gateway"
490+
```
491+
{: .copy-code}
492+
493+
### Device discovery issues on Windows with Docker Compose
494+
495+
BACnet connector doesn't support device discovery on Windows OS due to the limitations of the Docker networking stack
496+
on Windows. Please use installation from source or other installation methods to run Gateway on Windows OS.
497+
476498
## Next steps
477499
478500
Explore guides related to main ThingsBoard features:
376 KB
Loading

0 commit comments

Comments
 (0)