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

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 HTTPS, when locally commanded to perform an upgrade via BACnet, MQTT, or the Proviso app.

Upgrade Using the Proviso App

1. 1. Connect your O3 device over BLE using the Proviso app.
   2. In the kebab menu on the top right, select Upgrade firmware.

3. Set Current Firmware URL.

The Firmware location URL must be set to Default. Custom firmware locations are not currently supported. If you make changes to the firmware location, ensure that the URL is set back to Default and that the settings are applied to the device.

4. Select Select version from list. Prior to upgrading, your screen should not display any warnings.

Note: Select Enter version manually if your mobile device does not have access to the internet and you know the version.

5. Available firmware versions are listed. Select the version you want to upgrade to.

Verify that the correct version you want to upgrade to is listed, then select Apply firmware upgrade.

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.

7. 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. 

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 O3 product page: O3Sense < Products < Delta Controls Support

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.