kebab

OnePlus 8T (KB2003): https://wiki.lineageos.org/devices/kebab/

Upgrade LineageOS for microG (21.0 to 22.1)

Prerequisites

Software

1. OTA payload dumper, Archlinux: AUR package payload-dumper-go-bin
2. Android SDK platform tools, Archlinux: Extra package android-tools
3. GNU coreutils, Archlinux: Core package coreutils

Resources

1. OxygenOS firmware image KB2003_14.0.0.603(EX01): KB2003_11.H.26_3260_202409291635 (download with curl -O <URL>)
2. Additional firmware partition images dtbo.img and vbmeta.img, Download
3. LineageOS for microG 22.1
   • Recovery image file
   • OS zip file
4. Check all downloads with sha256sum or md5sum and compare them to the ones online

Full upgrade guide

1. Extract firmware images
   1. Unzip the payload.bin file out of the OxygenOS firmware image zip
   2. Dump the partition images: payload-dumper-go -o . payload.bin (Caution: This may overwrite existing files like dtbo.img and vbmeta.img!)
2. Enable USB Debugging
   1. Enable: System -> Settings -> Developer options -> Debugging -> USB-Debugging
   2. Check connection: adb devices
3. Update firmware
   1. Reboot to recovery: adb reboot recovery
   2. Enable: Advanced -> Enable ADB
   3. Check for DDR type: adb shell cat /proc/devinfo/ddr_type
      1. Output Device version: DDR4 (use xbl_config.img and xbl.img)
      2. Output Device version: DDR5 (use xbl_config_lp5.img and xbl_lp5.img)
   4. Enter fastboot: adb reboot fastboot
      1. Check connection: fastboot devices
   5. Update firmware
      1. If the latest required firmware is already installed this is optional only for vendor firmware.
         Do continue with the required additional partitions!
      2. Update firmware, part 1: Appendix A
      3. Update firmware, part 2: Appendix B (WARNING: Use the correct files for your DDR type!)
      4. Update additional partitions: Appendix C (This is always required!)
4. Update Recovery
   1. Flash LineageOS recovery image: fastboot flash --slot=all recovery lineage-22.1-xxxxxxxx-microG-kebab-recovery.img
   2. Reboot: fastboot reboot bootloader
5. Update OS
   1. Start recovery
   2. Enable: Advanced -> Enable ADB
   3. Initiate sideloading: Apply Update -> Apply from ADB
   4. Sideload: adb sideload lineage-22.1-xxxxxxxx-microG-kebab.zip
   5. Prompt: To install additional packages... Do you want to reboot recovery now? -> NO
   6. Start: Reboot System now
6. First start of the new OS
   1. Check user data
   2. Check self test in microG settings
   3. Reboot to recovery and redo the steps from Update OS to also update the second slot

Continuous firmware upgrade guide (after the full upgrade)

1. Download newer OxygenOS firmware from the link in Resources
2. Download the latest additional firmware partition images from the link in Resources
3. Follow the Full upgrade guide for these steps
   1. Extract firmware images
   2. Enable USB Debugging (only relevant if disabled)
   3. Update firmware (Tip: For a possible error situation, remember the current slot shown in recovery mode beforehand!)
4. Reboot: fastboot reboot bootloader
5. Start recovery
6. Start: Reboot System now

Appendix

Appendix A

Source: Update firmware on kebab: 7.

fastboot flash --slot=all abl abl.img
fastboot flash --slot=all aop aop.img
fastboot flash --slot=all bluetooth bluetooth.img
fastboot flash --slot=all cmnlib64 cmnlib64.img
fastboot flash --slot=all cmnlib cmnlib.img
fastboot flash --slot=all devcfg devcfg.img
fastboot flash --slot=all dsp dsp.img
fastboot flash --slot=all featenabler featenabler.img
fastboot flash --slot=all hyp hyp.img
fastboot flash --slot=all imagefv imagefv.img
fastboot flash --slot=all keymaster keymaster.img
fastboot flash --slot=all logo logo.img
fastboot flash --slot=all mdm_oem_stanvbk mdm_oem_stanvbk.img
fastboot flash --slot=all modem modem.img
fastboot flash --slot=all multiimgoem multiimgoem.img
fastboot flash --slot=all qupfw qupfw.img
fastboot flash --slot=all spunvm spunvm.img
fastboot flash --slot=all storsec storsec.img
fastboot flash --slot=all tz tz.img
fastboot flash --slot=all uefisecapp uefisecapp.img

Appendix B

Source: Update firmware on kebab: 8.

WARNING: Use the correct files for your DDR type!

For type DDR4:

fastboot flash --slot=all xbl_config xbl_config.img
fastboot flash --slot=all xbl xbl.img

For type DDR5:

fastboot flash --slot=all xbl_config xbl_config_lp5.img
fastboot flash --slot=all xbl xbl_lp5.img

Appendix C

Source: Install LineageOS on kebab: Flashing additional partitions

fastboot flash --slot=all dtbo lineage-22.1-xxxxxxxx-microG-kebab-dtbo.img
fastboot flash --slot=all vbmeta lineage-22.1-xxxxxxxx-microG-kebab-vbmeta.img