mirror of
https://codeberg.org/canoeboot/cbwww.git
synced 2024-11-22 02:14:43 +00:00
deaec646fe
Signed-off-by: Leah Rowe <leah@libreboot.org>
169 lines
5.9 KiB
Markdown
169 lines
5.9 KiB
Markdown
---
|
|
title: Debian Bookworm Install on a Samsung Chromebook Plus
|
|
x-toc-enable: true
|
|
...
|
|
|
|
System Configuration
|
|
====================
|
|
|
|
Hardware: Samsung Chromebook Plus XE513C24 (gru\_kevin)
|
|
|
|
Tested on Libreboot 20230423 (Canoeboot is a fork of Libreboot)
|
|
|
|
Operating System: Debian Bookworm RC2
|
|
|
|
[https://wiki.debian.org/Firmware](https://wiki.debian.org/Firmware)
|
|
|
|
Install Media Preparation
|
|
=========================
|
|
|
|
Follow the Debian installation instructions in the link below:
|
|
|
|
[https://www.debian.org/devel/debian-installer/](https://www.debian.org/devel/debian-installer/)
|
|
|
|
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.
|
|
|
|
[https://cdimage.debian.org/cdimage/bookworm_di_rc2/arm64/iso-dvd/](https://cdimage.debian.org/cdimage/bookworm_di_rc2/arm64/iso-dvd/)
|
|
|
|
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
|
|
```
|
|
|
|
Installation
|
|
============
|
|
|
|
1. Insert the micro sdcard into the slot on the Chromebook.
|
|
2. Power on the Chromebook.
|
|
|
|
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.
|
|
|
|
![](https://av.canoeboot.org/xe513c24/debbook-grub.jpg)
|
|
|
|
At this point the installation proceeded normally.
|
|
|
|
![](https://av.canoeboot.org/xe513c24/debbook-lang.jpg)
|
|
![](https://av.canoeboot.org/xe513c24/debbook-packages.jpg)
|
|
|
|
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.
|
|
|
|
![](https://av.canoeboot.org/xe513c24/debbook-desktop.jpg)
|
|
![](https://av.canoeboot.org/xe513c24/debbook-firefox.jpg)
|
|
|
|
System Functionality
|
|
====================
|
|
|
|
Things that work:
|
|
|
|
* Wireless internet and bluetooth
|
|
* Touch screen and stylus
|
|
* Touchpad
|
|
* Audio (Speakers and headphone jack)
|
|
* Volume buttons on side of laptop.
|
|
* Graphics (the free software panfrost driver is impressive)
|
|
* Playing videos
|
|
|
|
Things that do not work:
|
|
|
|
* Powering off. You can shutdown in Debian and the system goes through the
|
|
normal shut down sequence, but then remains on indefinitely (blue light on
|
|
side near power button). You have to hold the power button down for 10
|
|
seconds or so to completely power off the system.
|