Legacy iMX28 Recovery OS Upgrade Procedure
From Zenitel Wiki
Summary
Firmware version 10.x introduces a Recovery OS compatibility issue affecting Legacy iMX28 devices manufactured up to the end of 2018 and using the original 6-partition flash layout.
Devices that have already been upgraded to firmware 10.x remain fully operational. However, future software upgrades and downgrades are not possible until the Recovery OS has been updated.
If an affected device has already been upgraded to version 10.x, follow the recovery procedure described in this article to restore normal upgrade functionality.
| In this article, Legacy iMX28 refers to iMX28-based devices manufactured up to the end of 2018 that use the original 6-partition flash layout. |
Affected Devices: Zenitel Devices based on iMX28 manufactured up to the end of 2018.
Recommendation
Do not upgrade affected devices directly to firmware 10.x. Continue using VS-IS 9.4.3.x until support for these legacy devices is introduced in a future release.
Symptom
If an affected device has already been upgraded to firmware 10.x:
- The device remains fully operational.
- Existing configuration and functionality are retained.
- Further software upgrades are not possible.
- Software downgrades are not possible.
When attempting a Standard Upgrade from DeviceWeb, the following error is displayed:
| Failure - Recovery OS cannot start |
Recovery Procedure
If an affected device has already been upgraded to firmware 10.x, install Recovery OS version 1.2.0.1 to restore upgrade functionality.
- Go to Download. From the Zenitel Connect section download the Recovery OS image vsft-1.2.0.1_recovery.zip.
- Log into the Device.
- Navigate to Station Administration > Upgrade and select Recovery OS Upgrade.
- Drag and Drop, or Browse to the vsft-1.2.0.1_recovery.zip file.
- When the new Recovery OS is installed the station will reboot.
- When the station is back online, normal software upgrade functionality is restored. The device can now be upgraded or downgraded using the standard software upgrade procedure.
- The device may continue running firmware version 10.x. No downgrade is required after the Recovery OS has been installed.
| Installing a new Recovery OS |
Cause and Technical Background
Legacy iMX28 devices manufactured up to the end of 2018 use an earlier flash-memory layout consisting of six MTD partitions. Unlike newer devices, these units do not have a dedicated Recovery MTD partition. Instead, the Recovery OS is stored in a UBIFS volume with limited available space.
Firmware version 10.x introduces a newer Recovery OS with a larger footprint than the Recovery OS used in previous releases. On affected devices, the available space is insufficient to accommodate the new Recovery OS, causing the installation to fail.
The station firmware itself is installed successfully and the device remains fully operational. However, because the Recovery OS is no longer functional, any subsequent software upgrade or downgrade attempt fails with the message:
Recovery OS version 1.2.0.1 fits within the constraints of the legacy flash layout. Installing this Recovery OS restores normal software upgrade and downgrade functionality.
Frequently Asked Questions
Can I continue using the device after it has been upgraded to 10.x?
Yes. The device remains operational and can continue to be used.
Will the device stop working?
No. The issue affects future software upgradeability, not normal operation.
Can I upgrade directly from 10.x to a newer version?
No. Once an affected device has been upgraded to 10.x, the recovery procedure described above must be performed before any further upgrades or downgrades can be carried out.
