Updating firmware

This page describes three methods for upgrading firmware on O3 Sense and O3 Edge multisensor devices:

• Using the Proviso™ app
• Using BACnet (enteliWEB^®)
• Using an MQTT client

Note: As of firmware version 4.16 or later, enteliWEB firmware loader support has been added for upgrading with .fls files. For more information, see Managing Firmware Tasks.

O3 Sense and O3 Edge devices update their firmware using the internet instead of a local firmware upgrade utility. The O3 must be able to access the internet on port 443 to download new firmware files over a secure HTTPS connection, when locally commanded to perform an upgrade via BACnet, MQTT, or the Proviso app.

This means that the O3 must have correct time/date settings in order to establish the secure HTTPS connection. Prior to initiating the firmware upgrade, you must set the correct time and UTC offset in the O3 device.

Upgrade Using the Proviso App

1. Connect your O3 device over BLE using the Proviso app.

2. In the kebab menu on the top right, select Update firmware.
(Optional) You can toggle the Use Default URL to select the default URL location, or manually change the firmware download location in the URL field. 

3. Review the firmware details, then select Update to latest to update to the latest available firmware or Select firmware to specify a firmware version. 

Additionally, you can tap Previous update status to view details about the most recent firmware upgrade attempt. 

If you've selected a specific firmware to specify, a list of available firmware downloads display. Tap a firmware version to view more details. Additionally, you can tap Manual to view the detailed release notes. 

 

The download screen displays your upgrade progress. Do NOT power off or reset while the upgrade is underway.

The light ring turns orange when the upgrade procedure begins. This will continue for 2-3 minutes, then the device will start the reboot process after which the light ring will turn off for 1-2 minutes. Once the device is fully rebooted, the blue swirl light ring pattern will display, followed by the blue-red-yellow light ring. 
Note: In some cases, the device may reboot a couple times, and the ling ring patterns may display more than once.
If there is an error, the light ring will flash red 3 times. Check your file location, name, and connection. The device will attempt the upgrade a maximum of 3 times.

For iOS devices: You will be prompted to unpair your device from Bluetooth to complete the upgrade.

Notes:

• Do not turn off or reboot your device during an upgrade.
• Status messages will display indicating if upgrade was successful. If the upgrade was not successful, a status message displays describing the reason for failure. 

Once upgrade is complete, a green banner displays on the bottom of the screen. 

Upgrade Using BACnet

The following procedures describe how to upgrade the firmware over BACnet using Delta Controls’ enteliWEB facility management software.

To upgrade a single O3 device

1. In the enteliWEB Navigator pane, select the device that you want to update.
2. Open the CSV43 object, set it to Manual, then enter the firmware version as a JSON string to initiate the firmware upgrade. For example: {"version":"1.6.13"}
3. The upgrade status displays in the description property field and is updated with each stage of the upgrade. Should any upgrade disruptions occur and the upgrade fails, you can refer to this description field to source the issue.

For up-to-date firmware version details, go to the Release Notes page Release Notes – Delta Controls

To batch upgrade multiple O3 devices

1. In enteliWEB, in the left pane, hold down the Shift key and select up to 8 devices to update.
2. Filter on CSV43.
3. Select the checkbox at the top left to select all the objects.
4. Select Command > Manual Value, then enter the firmware version as a JSON string to initiate the firmware upgrade. For example: {"version":"1.6.13"}
5. Select Save.
6. Verify that all the selected devices have been updated.
7. The upgrade status displays in the property field. Should any upgrade disruptions occur, you can refer to this description to source the issue. 

Upgrade Using MQTT

Publish the desired firmware version to the topic commands/fw/updateFw.

In the example below, MQTT Explorer is used to upgrade to version 1.6.13 from the default location, e.g., {"data":{"version":"1.6.13"}}

Note: You must have MQTT broker login credentials to publish to the O3.