10/Q | 11/R 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. If you have a new eMMC, install it and write back boot0/1 and the rawnand bin in hekate.

  2. Under Linux mount the eMMC with hekate. Deactivate write protect!

  3. Check where linux has mounted the eMMC (sdb, sdc ...)

  4. Open gparted and confirm the resize from the eMMC gpt table.

  5. Close gparted.

  6. Open Terminal and sudo gdisk /dev/sdx (where x is your the device letter)

  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. Open gparted again.

  9. HOS has 11 partitions, Android need 9 partitions we have to create them.

  10. Add the 9 partitions and set the file system as deleted.

PartitionNameSize

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. 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. Using dd in terminal flash the following (replacing hekate's Flash Android step)

ANDROID 10

FileLabel

boot.img

LNX

twrp.img

SOS

tegra210-icosa.dtb

DTB

ANDROID 11

FileLabel

boot.img

LNX

recovery.img

SOS

nx-plat.dtimg

DTB

  1. 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. 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. Boot hekate -> More Configs -> click on the entry for you Android version while you press VOL +

  4. 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.

Last updated