Skip to content

Latest commit

 

History

History
154 lines (111 loc) · 8.36 KB

HOW-TO-INSTALL.md

File metadata and controls

154 lines (111 loc) · 8.36 KB
Raw

How to install LineageOS 19.1 for the Unihertz Atom L and XL

Getting adb and fastboot

Linux or MacOS

If you are using a Linux or a similar operating system on your PC or Mac chances are very high that you already have these two applications installed. Open a terminal and exectute the following commands.

adb version
fastboot --version

If one or both of these output an error you need to (re-)install adb and fastboot.

wget https://dl.google.com/android/repository/platform-tools-latest-linux.zip
unzip platform-tools-latest-linux.zip -d ~

Update your PATH variable for your environment

gedit ~/.profile

Add the following

# add Android SDK platform tools to path
if [ -d "$HOME/platform-tools" ] ; then
  PATH="$HOME/platform-tools:$PATH"
fi

Then update your environment

source ~/.profile

Windows

Download the latest version of adb and fastboot to a directory of your choice and extract the archive.

Note: I've had reports that under Windows adb/fastboot might not recognize the phone while in TWRP. For now I don't know whats causing this. So if that happends to you try using linux instead.

Unlocking

To be able to install anything on the Unihertz Atom L or XL we first need to unlock the bootloader.

  1. Boot your device into the official OS.
  2. Go to Settings > About phone, tap the "build number" several times to enable developer settings.
  3. Go to Settings > System > Developer Settings, enable OEM unlocking and ADB debugging.
  4. Connect your phone to your PC and open a terminal or a command line window.
  5. Run adb reboot bootloader on your PC (there is no way to enter bootloader directly, only possible through adb).
  6. Once your device has finished booting run fastboot flashing unlock and comfirm unlock on device (THIS WILL WIPE ALL DATA!).
  7. Run fastboot reboot to reboot your device and now you should see an unlocked warning during boot screen.

Disabling AVB (Android Verified Boot)

To get LineageOS to boot proberly we also need to disable AVB. Otherwise the bootloader will check the ROM with the wrong authorization keys and prevent the loading.

  1. Download vbmeta.img from the latest release page of your device.
  2. Connect your phone to your PC and open a terminal or a command line window.
  3. Run adb reboot bootloader on your PC to put your device in bootloader mode.
  4. Once your device has finished booting run fastboot --disable-verification --disable-verity flash vbmeta vbmeta.img.
  5. Then run fastboot --disable-verification --disable-verity flash vbmeta_system vbmeta.img.
  6. Also run fastboot --disable-verification --disable-verity flash vbmeta_vendor vbmeta.img.

Installing TWRP recovery

Attention: Make sure you have the correct stock ROM release to the kernel of the TWRP release. If not use the upgrade guide to switch stock ROM releases.

  1. Download recovery.img from the latest release page of your device.
  2. Connect your phone to your PC and open a terminal or a command line window.
  3. Run adb reboot bootloader on your PC to put your device in bootloader mode.
  4. Once your device has finished booting run fastboot flash recovery recovery.img.
  5. Run fastboot reboot and after the screen goes dark press volume up until you see the TWRP logo.
  6. Now you need to install a new ROM because booting into stock ROM will replace TWRP with the stock recovery.

Installing LineageOS ROM

Attention: Make sure you have the correct stock ROM release to the kernel of the TWRP release. If not use the upgrade guide to switch stock ROM releases.

  1. Download lineage-19.1-XXX-UNOFFICIAL-YYY-signed.zip from the latest release page of your device.
  2. Connect your phone to your PC and open a terminal or a command line window.
  3. Run adb reboot recovery on your PC or simply hold volume up while turning power on to boot your device into the recovery.
  4. In TWRP select Wipe > Advanced Wipe.
  5. Tick Dalvik / ART Cache, Cache, Data, Internal Storage.
  6. Swipe the slider on the bottom to the right to confirm. (THIS WILL WIPE ALL DATA!)

Using sideload method

  1. From home screen select Advanced > ADB Sideload.
  2. Swipe the slider on the bottom to the right to confirm.
  3. Run adb sideload lineage-19.1-XXX-UNOFFICIAL-YYY.zip from your PC.
  4. Wait for the process to finish. The recovery might prompt something about verification failure, just ignore it and continue anyway.

Using SD card

  1. Run adb push lineage-19.1-XXX-UNOFFICIAL-YYY.zip /external_sd on your PC or transfer the file beforehand onto your SD card.
  2. From home screen select Install.
  3. Use Select Storage to switch to your SD card.
  4. Select the previously transfered file.
  5. Swipe the slider on the bottom to the right to confirm.

Finishing up

  1. (Optional) At this point, you can then install the latest Magisk and/or NikGAPPS at your will. If installing Magisk / NikGAPPS fails, you can try rebooting into recovery again in advanced menus, then try installing them again.
  2. Select Reboot System to reboot into LineageOS and enjoy. Note that Magisk might cause your device to boot loop once or twice but it will eventually boot.

Troubleshooting

Partitions cannot be resized

If you get an error 7 mentioning assert failed: update_dynamic_partitions(package_extract_file("dynamic_partitions_op_list")) you need to do the following:

For the stock rom release 2021-05:

For the stock rom release 2021-11:

  1. Download super-YYYY-MM-XXX.7z from the release page of your device which corresponds with the latest stock rom release.
  2. Extract the already resized copy of super.img from the downloaded archive.
  3. Run adb push super.img /external_sd on your PC.
  4. In TWRP select Install.
  5. Use Select Storage to switch to your SD card.
  6. Use Install Image to switch to image installation mode.
  7. Select super.img from the list.
  8. Select Super (Product, Vendor, System) partition.
  9. Swipe the slider on the bottom to the right to confirm.
  10. Continue with Installing LineageOS ROM