Hardware: Samsung Chromebook Plus XE513C24 (gru_kevin)
Tested on Libreboot 20230423 (Canoeboot is a fork of Libreboot)
Operating System: Debian Bookworm RC2
Follow the Debian installation instructions in the link below:
At the time of this install Debian Bookworm RC2 was recommended on the download page and I selected the DVD image to have all the packages available when offline (3.7 gigabyte iso). See the notes below about alternately using the netinst version.
Write the iso file to a micro sdcard. Replace
sdcard_device below with the appropriate device path on your system.
# dd if=debian-bookworm-DI-rc2-arm64-DVD-1.img of=/dev/sdcard_device bs=1M status=progress; sync
The system automatically found an EFI image (efi/boot/bootaa64.efi), but after loading it the “Synchronous Abort” handler activated and the chromeboot would reboot.
Since canoeboot/uboot has a 2 second pause at the beginning to stop autoboot if desired I paused autoboot and it dropped me to the uboot command line. Look for the grub EFI image on the micro sdcard and started that up instead. Below are the series of uboot commands I used to understand the media and partition structure. Device 1 is the micro sdcard slot, and in this case the efi partition is 2.
Hit any key to stop autoboot: 0 => mmc list mmc@fe320000: 1 mmc@fe330000: 0 => mmc dev 1 switch to partitions #0, OK mmc1 is current device => mmc part Partition Map for MMC device 1 -- Partition Type: DOS Part Start Sector Num Sectors UUID Type 1 0 7766016 00000000-01 83 2 7766016 15168 00000000-02 ef Boot => ls mmc 1:2 efi/ 168 ubootefi.var 1 file(s), 1 dir(s) => ls mmc 1:2 efi/boot ./ ../ 872448 bootaa64.efi 4289984 grubaa64.efi 2 file(s), 2 dir(s) =>
The following two commands are the ones that were needed to boot the operating system.
=> load mmc 1:2 $loadaddr efi/boot/grubaa64.efi 4289984 bytes read in 187 ms (21.9 MiB/s) => bootefi $loadaddr
The grub text menu popped up at this point. See the screen shot below. I found the first option “Install” provided the easiest install experience as everything was in text mode and easy to read. The “Graphical install” worked also, however the screen resolution was so high that all the text and buttons were quite small on the display and harder to read.
At this point the installation proceeded normally.
Some users have mentioned experiencing corruption of the first partition after installing Debian Bookworm on a Canoeboot / uboot xe513c24 system. This is possibly due to the experimental nature of the canoeboot / uboot system at this time.
One potential workaround is to leave some unused space at the beginning of the drive before the first partition. This can be done by manually partitioning during install and configuring the first partition to start 100MB or so from the start of the drive.
Also, per instructions from alpernebbi on Libreboot IRC, when you arrive at the stage where the grub bootloader is installed take special note to select yes to the option to “Force installation to removable media path”, and also say no to the option to “Update NVRAM variables”. If one selects yes on updating NVRAM variables this can also lead to partition corruption in some instances.
Lastly when rebooting into your new system you will likely experience the same synchronous abort issue mentioned above. You can use the same method to pause the uboot script and drop to the uboot prompt to load and boot the grub efi image. Depending on how you partitioned the internal emmc drive during install, the partition number may vary, but below are the applicable commands on my system. The internal device is 0, and the efi partition was 1.
=> load mmc 0:1 $loadaddr efi/boot/grubaa64.efi 4289984 bytes read in 187 ms (21.9 MiB/s) => bootefi $loadaddr
Once booted into your Debian Bookworm system you can open a shell as root and go to the boot efi path to copy the grubaa64.efi file and overwrite it onto the bootaa64.efi file.
# cd /boot/efi/EFI/BOOT # mv BOOTAA64.EFI BOOTAA64.EFI.bak # cp grubaa64.efi bootaa64.efi
By doing this the system will boot from uboot normally without needing to drop to the uboot prompt. This will only last until the next time debian updates grub though, so you may need to repeat this as a workaround for now.
Below are a couple screen shots of the installed system running from the internal emmc.
Things that work:
Things that do not work:
Markdown file for this page: https://canoeboot.org/docs/uboot/uboot-debian-bookworm.md
This HTML page was generated by the untitled static site generator.