Links

eMMC Boot Guide

Prerequisite

Backup the eMMC with boot0/1 and rawnand.bin Have a PC running linux for eMMC preparation. (Android 10 only) download the eMMC overlay from the latest artifacts zip

Installation

eMMC preparation (for Android and Linux alongside HOS on a larger eMMC)

  1. 1.
    If you have a new eMMC, install it and write back boot0/1 and the rawnand bin in hekate.
  2. 2.
    Under Linux mount the eMMC with hekate. Deactivate write protect!
  3. 3.
    Check where linux has mounted the eMMC (sdb, sdc ...)
  4. 4.
    Open gparted and confirm the resize from the eMMC gpt table.
  5. 5.
    Close gparted.
  6. 6.
    Open Terminal and sudo gdisk /dev/sdx (where x is your the device letter)
  7. 7.
    Press x=>s=>20=>v=>w=>y to enlarge the gpt table to 20 entries. (If you also want to do linux on the eMMC you have to enter 24.)
  8. 8.
    Open gparted again.
  9. 9.
    HOS has 11 partitions, Android need 9 partitions we have to create them.
  10. 10.
    Add the 9 partitions and set the file system as deleted.
Partition
Name
Size
Vendor
vendor
1GiB
System
APP
2GiB
Linux Kernel
LNX
32MiB
Recovery (TWRP)
SOS
64MiB
Device Tree Reference
DTB
1MiB
Encryption*
MDA
16MiB
Cache
CAC
700 MiB
Miscellaneous
MSC
3MiB
Userdata
UDA
Custom
  1. 11.
    If you want to add Linux, add a partition with the label of your choice (e.g.: SWR-UBU for Ubuntu Bionic) and 3 dummy partitions with 1mb unformated. In order to have 24 partitions. gdisk cannot create 21 partitions because the sector is filled automatically (multiple of 4) if there are only 21 partitions on the eMMC and not 24 Horizon does not start. The bootloader checks that and Horizon brings up a pink screen.

Flashing the eMMC

  1. 1.
    Using dd in terminal flash the following (replacing hekate's Flash Android step)
ANDROID 10
File
Label
boot.img
LNX
twrp.img
SOS
tegra210-icosa.dtb
DTB
ANDROID 11
File
Label
boot.img
LNX
recovery.img
SOS
nx-plat.dtimg
DTB
  1. 2.
    For Linux, merge the install image with cat l4t.0* > ubuntu.img and dd it to SWR-UBU (replacing hekate's Flash Linux step). Refer to step 3 and 4 here for more detail.
  2. 3.
    Add the release files (bootfiles, ini, lineage zip, any extra zips) a. If running Android 11, add emmc=1 to bootloader/ini/android.ini b. If running Android 10, add overlays=tegra210-icosa_emmc-overlay to a new file switchroot/android/uenv.txt and add the emmc overlay from build artifacts to switchroot/overlays
  3. 4.
    Boot hekate -> More Configs -> click on the entry for you Android version while you press VOL +
  4. 5.
    In recovery, flash the lineage zip and any extra zips
WARNING: When setting up Android, under no circumstances use the sd card as a memory extension (adopted storage), otherwise it will be formatted. The FAT32 partition will be mounted regardless, so no need.