Update a Controller from FW 0.8.X to FW 0.9.X

Note

This guide is for cases where your Controller is still running FW 0.8.X and needs to be migrated to FW 0.9.X.

The key limitation is that Network OTA Update does not work on FW 0.8.X. The update therefore has to be performed one Controller at a time through studio.spectoda.com.

What changes during this migration

Moving from FW 0.8.X to FW 0.9.X has two main steps:

1. perform a Controller OTA Update on each Controller individually
2. upload the correct 0.9 Config to each Controller, prepared by Spectoda support

Unlike newer migrations, it is not enough to only move the Controller to a newer firmware version. After the firmware update, the matching 0.9 config also has to be written into the Controller.

Important limitation: Network OTA Update does not work on FW 0.8

For Controllers running FW 0.8.X, keep this operational limitation in mind:

• Network OTA Update does not work on FW 0.8
• you need to connect to each Controller individually
• the update must be started as a Controller OTA Update

In practice, this means that if you are migrating multiple Controllers in one installation, you need to update them one by one.

1. Connect to each Controller individually

1. Open studio.spectoda.com.
2. Connect to one specific Controller.
3. Do not use Network OTA Update.
4. Work with only one Controller at a time until its update is completed.

If your installation contains multiple Controllers, repeat this process for each unit separately.

2. Run a Controller OTA Update to FW 0.9.X

1. In studio.spectoda.com, start Controller OTA Update.
2. Wait until the Controller moves from FW 0.8.X to FW 0.9.X.
3. After the update is complete, verify that the Controller boots correctly again.

The purpose of this step is to move the Controller to the 0.9.X firmware line, which is the baseline required for the matching 0.9 config.

3. Apply the correct 0.9 Config from Spectoda support

Once the Controller is on FW 0.9.X, the correct 0.9 Config must be uploaded into it.

This is the important operational rule:

• 0.9 Configs are not available as presets
• the correct config must be prepared with Spectoda support
• without the correct 0.9 config, the Controller may not behave as expected after migration

Recommended process:

1. contact Spectoda support
2. have them prepare the correct 0.9 Config for the specific Controller or project
3. apply that config to the Controller after the firmware update is complete

What to do if OTA update from studio.spectoda.com fails

If the OTA update does not work through studio.spectoda.com, use the fallback path through the older Studio version:

• blockly.spectoda.com

Access to this older Studio environment must be provided by Spectoda support.

Practical fallback process:

1. contact Spectoda support
2. ask them to enable access to blockly.spectoda.com
3. perform the OTA update through that older Studio version
4. after a successful update, continue by applying the correct 0.9 config

Migration checklist

The migration from FW 0.8.X to FW 0.9.X is complete only when all of the following are true:

• each Controller was updated individually
• the Controller is no longer on FW 0.8.X and is now running FW 0.9.X
• the update was done through Controller OTA Update, not Network OTA
• the correct 0.9 Config from Spectoda support has been uploaded into the Controller
• the Controller’s basic functionality has been verified after the update

Most common practical mistake

The most common misunderstanding is assuming that:

• Network OTA Update can be used
• or the correct 0.9 Config can be selected from presets

Neither is true for this migration:

• FW 0.8.X must be migrated one Controller at a time
• the 0.9 Config must be handled individually with Spectoda support

Related pages

• Update a Controller from FW 0.9.X to FW 0.12.X
• Firmware Release Notes