Skip to content

Boot Chain

bell07 edited this page Feb 10, 2020 · 3 revisions

Boot Chain for Gentoo on Nintendo Switch

  1. You need an exploitable Switch. See https://gbatemp.net/threads/firmware-status.495078/
  2. SD-Card. The Switch system storage is not touched by gentoo installation. Gentoo runs using SD-Card only.
    1. The SD-Card need at least 2x partitions: 1. vfat for hombrew part, and 2. ext4 for Gentoo root
  3. Hekate or similar homebrew bootloader https://gbatemp.net/threads/rcm-payload-hekate-ctcaer-mod.502604/
  4. The Coreboot "BIOS" is loaded as homebrew payload (vfat:/gentoo/coreboot.rom file).
  5. Inside the Coreboot the built in u-boot bootloader runs
  6. u-boot loads config file vfat:/gentoo/boot.scr with parameters to boot Linux kernel. The Kernel, Kernel command line, DTB-file and (optional) initramfs are loaded according the boot.scr
  7. Linux kernel mount the second partition on SD-Card as root and boots Gentoo Linux

Steps 4-7 are available as ebuilds in our overlay. The Files required for vfat:/gentoo/ are installed by portage in /boot. The template for vfat:/bootloader/ is merged to /usr/share/sdcard1/bootloader

Clone this wiki locally