If you are connected to the O3's internal MQTT broker, you can directly modify the O3's configuration file.
Modify a setting using the format setting/TOPIC/SUBTOPIC and write to the data JSON key. The change is then applied to config/TOPIC/SUBTOPIC.
For example, to change the unit for temperature from the default Celsius (°C) to Fahrenheit (°F), publish {"data": "F"} to setting/units/temp. To change it back to Celsius, publish {"data": "C"}. (Do not include the degree symbol °)
MQTT topics are case sensitive. Make sure you write the topic exactly as is written in the table below to ensure your settings are properly applied.
Setting Topics
| Topic | Description | Example |
| setting/bacnet/eth/Enable | Enables BACnet/Ethernet when set to true. Default value is true. | |
| setting/bacnet/bnip/Enable | Enables BACnet/IP when set to true. Default value is false. | |
| setting/bacnet/bnip/IpMode | Not currently supported. The topic config/bacnet/bnip/IpMode is read-only. To set up the O3 as a foreign device, you must use a BACnet front-end application. For more details, see the BACnet Application Guide on support.o3hub.com. | N/A |
| setting/bacnet/bnip/udpPort | Sets the BACnet/IP UDP port. Default value is 47808. | |
| setting/bacnet/device_name | Sets the BACnet device name. | |
| setting/bacnet/id | Sets the BACnet device ID. Must be a unique value between 1 and 4194302. Default value is based on Ethernet MAC address. | |
| setting/ble/enable | Enables the Bluetooth LE communication when set to true. Default value is true. | |
| setting/ble/pin | Sets the 6-digit authentication code for read/write access via Bluetooth. Default value is 000000. Reboot the device after changing the PIN. | |
| setting/ble/txPower | Sets the Bluetooth maximum transmit power. Must be a value between 1 and 8, corresponding to the following states: ‑40, ‑20, ‑16, ‑12, ‑8, ‑4, 0, 4 dBm. | |
| setting/fw/urlFw | Sets the location of the server where firmware upgrades are stored. | |
| setting/io/1/setup | Sets the xP1 universal point type (analog‑input, analog‑output, binary‑input, binary‑output) and configuration (0‑5‑volt, 0‑10‑volt, 10kohm‑thermistor). |
{ "data": {"type": "analog-input", "option": "0‑5‑volt"} } |
| setting/io/2/setup | Sets the xP2 universal point type (analog‑input, analog‑output, binary‑input, binary‑output) and configuration (0‑5‑volt, 0‑10‑volt, 10kohm‑thermistor). |
{ "data": {"type": "analog-output", "option": "0‑10‑volt"} } |
| setting/mqttPassword | Sets the password to access the internal MQTT broker. Default value is admin. This password must be changed after initial login to prevent unauthorized use of the broker. The password is case-sensitive and must be 5 to 31 characters in length. Special characters are allowed. Reboot the device after changing the password. | |
| setting/mqttPort | Sets the port used by the internal MQTT broker. Default value is 1883 (TCP). | |
| setting/ntpEnable | Enables Network Time Protocol service when set to true, causing the O3 to display UTC time. Default value is true. |
{ "data": 0 } |
| setting/ntp | Enables Network Time Protocol service when set to true, causing the O3 to display UTC time. Default value is true. |
{ "data": { "product-support-ntp":true, "ntp-enable":true, "ntp-server-primary":"", "ntp-server-secondary":"", "ntp-server-port":123, "ntp-timeout":10, "ntp-poll-interval":60, "ntp-version":3 } } |
| setting/units/light | Sets the illuminance unit of measurement: lx (lux) or ft-c (foot-candle). Default value is lx. | |
| setting/units/temp | Sets the temperature unit of measurement: C (Celsius) or F (Fahrenheit). Default value is C. | |
| setting/timedate | Sets the UTC offset. | { "data": { "iso_utc_time_date" : "2022-07-21T18:57:54.009243+0000" } } |
| setting/timeZoneDst | Sets the UTC offset and daylight savings. | { "data": { "utc-enable": true, "utc-offset": 60, "dst-enable": true, "dst-start": { "month": "november", "week-of-month": "second", "day-of-week": "sunday" }, "dst-start-on-after": 0, "dst-end": { "month": "march", "week-of-month": "first", "day-of-week": "sunday" }, "dst-end-on-after": 0, "dst-transition-time": "2:00:00.00", "dst-offset": 60 } } |
Comments
0 comments
Please sign in to leave a comment.