Android 11 OS Update Instruction for Family of Products on SDM660
Total Page:16
File Type:pdf, Size:1020Kb
Android 11 OS Update Instruction for Family of Products on SDM660 1 Contents 1. A/B (Seamless) OS Update implementation on SDM660 devices .................................................................................................... 2 2. How AB system is different to Non-AB system ................................................................................................................................ 3 3. OS Update from Zebra.com and LGE 3.0 .......................................................................................................................................... 4 4. Android AB Mode for OS Update ..................................................................................................................................................... 4 5. Recovery Mode for OS Update ......................................................................................................................................................... 5 6. Reset Packages and special recovery packages ................................................................................................................................ 5 7. OS Update Operations - Upgrade and Downgrade .......................................................................................................................... 6 8. OS Upgrade and Downgrade via EMMs ........................................................................................................................................... 7 9. AB Streaming Update ....................................................................................................................................................................... 8 10. User Notification for Full OTA package Upgrade or Downgrade ...................................................................................................... 9 11. OS Update - Screenshots ................................................................................................................................................................ 10 12. Recovery Mode ............................................................................................................................................................................... 12 13. UPL (Update Package List) mechanism .......................................................................................................................................... 17 14. Status messages to EMMs .............................................................................................................................................................. 20 15. Possible device interruptions during an OTA package update ....................................................................................................... 20 16. AB Fallback mechanism .................................................................................................................................................................. 21 17. Rescue Party Mode ......................................................................................................................................................................... 21 18. Recovery logs .................................................................................................................................................................................. 21 2 Zebra uses AB mechanism for OS Update on SDM660 products running Android O and above. This is a new OS Update mechanism which is unavailable on other Zebra products with Android O. The intent of this document is to advise Zebra customers and service about 1. AB OS Update mechanism 2. How to apply OTA packages on SDM660 3. How AB devices are different to legacy Non-AB systems 4. Fastboot flashing of AB devices List of supported devices on A11 are: TC97, EC30PR, EC300K, CC600, CC6000, VC8300, TC8300, L10AW, TC52, TC57, TC77, TC72, PS20J, TC57X, TC52X, TC21, TC26, MC2200, MC2700, WT6300, EC50, EC55, TC83, MC93, VC8308, VC8310, EC30, L10A, ET56, ET51, CC605, CC610, MC3300x, MC3300xC 1. A/B (Seamless) OS Update implementation on SDM660 devices • Full OTA and Delta OTA (Patch) updates can occur while the system is running, without interrupting the user. This means users can continue to use their devices during an OTA upgrade. After the installation of OTA package is completed, device reboots into the updated image. • AB device are fault tolerant by providing a backup slot. If device fails to boot-up, then it will fall back to a backup slot (reboot back into the old partition) and the device remains usable. • In AB Update, updates can be streamed to A/B devices, removing the need to download the complete package before installing it. Starting with A11 • Full OTA packages and Delta OTA packages of each LG release will be available on Zebra.com. • Delta OTA packages can be streamed and installed on the device. • OTA Delta packages available on Zebra.com will be sequential in nature. This means to upgrade from Patch1 (U01) to Patch5 (U05), one must apply all intermediate delta patches too (i.e., U01, U02, U03, U04 and U05) in the same order. To make things easier, user may skip applying delta packages sequentially and directly flash the Full OTA package of U05. • For customers who are using Zebra LGE solution, you can upgrade to the required LG patch version in a single step with help of a single OTA delta package. This OTA delta package is called as true delta package which contains the exact delta required to install the required LG patch version. This true delta OTA package will be serviced by LGE solution and will not be available on zebra.com. You can find more details on LGE solution at Zebra TechDocs portal. • The size of OTA delta packages will be much smaller than Full OTA packages. 2 2. How AB system is different to Non-AB system OS Update Use Case Non-AB AB Notes AB: Device shall apply Full OTA Package via Android AB mode when applied via EMM. Recovery Android AB User can manually enter recovery mode to apply Full OTA package Flashing Full OTA Package Mode Mode too. Non-AB: Device shall boot into recovery mode to apply any OTA package. AB: Device will apply OTA delta package via Android AB mode. User can manually enter recovery mode to apply OTA delta package too. Recovery Android AB Flashing Delta OTA Package Mode Mode Non-AB: Device shall boot into recovery mode to apply any OTA package. AB: Device shall boot into recovery mode to apply Enterprise and Factory Reset packages Recovery Recovery Flashing Reset Packages Mode Mode Non-AB: Device shall boot into recovery mode to apply Enterprise and Factory Reset packages AB: Full and Delta OTA updates can occur while the system is running, without interrupting the user. At the end, device reboots into the new installed image. Rebooting to new OS image is the only device downtime user will experience. Device downtime for OS Update - + Non-AB: Device reboots to recovery mode to install reset or special packages only. User cannot use the device while installing OTA package. AB device are fault tolerant by providing a backup slot. If device fails to boot-up, then it will fall back to backup slot (reboot back Fault tolerance - + into the old partition). Non-AB: If device fails to bootup, then device is bricked. Patch upgrades Y Y Starting A11, patch downgrades are not supported. Users have the option to use Full OTA package of the specific patch to perform OS downgrade. Patch downgrades Y N SDM660 Android O and above has Version Binding implementation which will cause data reset on downgrade. Hotfix patch support Y Y AB delta packages will be considerably small compared to Non-AB delta packages available for Zebra devices. Patch Size - + Customers using LGE APIs will be able to use a True Delta package. Silent Update - Y AB Full and Delta OTA updates are silent to user 3 3. OS Update from Zebra.com and LGE 3.0 OS Update Use Case Zebra.com LGE 3.0 Notes Full OTA OS Upgrade Y Y LGE 3.0 does not support OS downgrade. EMM can downgrade to an older version by downloading a Full OTA package of an older Full OTA OS Downgrade Y N version. Zebra.com customers can downgrade using EMM. LGE3.0 - Delta OTA packages will be streamed for customers using Y Y LGE solution. Delta OTA Upgrade Sequential True Delta Delta Zebra.com - Delta upgrades are sequential and can be installed using StageNow/EMM or from Recovery mode. Delta OTA packages cannot be used for Downgrade to an older Delta OTA Downgrade N N patch version. LGE 3.0 solution will enable AB streaming of OTA Full and Delta packages. Streaming Support N Y Zebra.com customers will have to manually download full OTA or delta packages to the device and install the same. LGE 3.0 APIs do not support flashing of Reset or Special packages. Reset Packages or Special Packages Y N Zebra.com customers can download, and flash Reset packages or any special packages available to them. 4. Android AB Mode for OS Update Full and delta OTA packages will be installed via Android AB mode. As part of this: a. Full and delta OTA package will be applied on the device silently in the background. b. User can continue using the device while OTA packages will be applied. c. Post installation is complete, a device notification will be displayed confirming the installation is completed and device shall auto-reboot after 15 secs. d. Device will auto-reboot to boot into new installed OS image after the OTA package installation is completed successfully. e. Customers can also configure the device to wait for Update clients (e.g., FOTA) or EMMs to