universal9810: Support firmware upgrade

Description

universal9810: Support firmware upgrade

Issue(s)

https://gitlab.e.foundation/e/backlog/-/issues/3700

Test environment

Prepare q test builds for starlte star2lte with and without firmware/vendor images bundled.

star2lte

• With firmware: https://gitlab.e.foundation/e/priv/os/build/-/pipelines/135083
• Without firmware: https://gitlab.e.foundation/e/priv/os/build/-/pipelines/135084

starlte

• With firmware: https://gitlab.e.foundation/e/priv/os/build/-/pipelines/135085
• Without firmware: https://gitlab.e.foundation/e/priv/os/build/-/pipelines/135086

Prepare oreo test builds for star2lte starlte for testing as well: star2lte: https://gitlab.e.foundation/e/priv/os/build/-/jobs/199462 starlte: https://gitlab.e.foundation/e/priv/os/build/-/jobs/199461

Test procedures

Downloads:

• Oreo Vendor: https://androidfilehost.com/?fid=11410932744536982158
• TWRP:
  • star2lte: https://dl.twrp.me/star2lte
  • starlte: https://dl.twrp.me/star2lte

• In order to test the firmware upgradation process, you would need to be on a SW Rev. lower than F (Only then will the firmware be flashed)

• On your device:

  • adb shell getprop ro.boot.bootloader - Bootloader Version
  • adb shell getprop gsm.version.baseband - Baseband Version
  • Note these down

• Flash TWRP for your device.

• Flash the corresponding oreo test build for your device and oreo vendor image

• Boot to Android

• Reboot to Recovery

• Sideload the corresponding q test build without firmware (It should fail saying vendor image is incompatible)

• Sideload the corresponding q test build with firmware (Your firmware should be upgraded and you would automatically reboot into /e/ OS q)

• See if the bootloader and baseband version has been updated:

  • adb shell getprop ro.boot.bootloader - Bootloader Version
  • adb shell getprop gsm.version.baseband - Baseband Version

Technical details

• We are going to be shipping firmware with q stable builds, and not q dev builds. Firmware for Existing users on q dev channel will not be upgraded.

• If we are shipping firmware (ie. firmware for SM-x96xF), make sure that we dont flash on any non F (ie. non SM-x96xF) model. (Notably the Korean Exynos variants, SM-x96xN)

• Only upgrade the firmware, if the bootloader SW REV. is lower than what is mandated by the build (through board-info.txt). Else we are going to brick the device.

• If prebuilt vendor image is present in the build, make sure that we dont flash on any non F (ie. SM-x96xF) model. (Notably the Korean Exynos variants, SM-x96xN)

• Apart from that upgrade vendor image unconditionally.

Check list

• Self review
• Test procedure explained
• Tested on fresh install
• Tested applied as an update
• License
• Internal documentation
• User documentation