Van ChromeOS naar Linux: Debian op Chromebook installeren

<section data-background="images/26-linux-chromebook/chromebook-1970s.jpg" data-state="frontpage">
<br><br><br>
<div class="atitle2">Van ChromeOS naar<br>
    <div class="atitle" style="font-size:180% !important"><span class="db8orange">Debian op<br>een Chromebook</span></div>
        <br>
        Acer Chromebook 13 CB5-311
        <br><br>
        <span class="apage1">by Peter Martin / <a href="https://db8.nl" target="_blank">db8.nl</a></span>
        <br>
        <span class="apage1">slides: <a href="https://petermartin.nl" target="_blank">https://petermartin.nl</a></span>
        <style>.atitle{text-shadow: 2px 2px 2px #000;}
        .atitle2{text-shadow: 2px 2px 2px #000;}
        </style>
</div>

---

<div style="position:relative;height:600px;">
<div class="sheet">Waarom overstappen?</div>
</div>

----

### Het apparaat

| | |
|---|---|
| Model | Acer Chromebook 13 CB5-311 |
| Board | `nyan_big` |
| SoC | NVIDIA Tegra K1, 4× Cortex-A15 @ 2,1 GHz |
| RAM | 4 GB |
| Opslag | 32 GB eMMC |
| Scherm | 1920×1080 |

<br>
<span class="fragment">
Op zich prima hardware. Alleen de software...
</span>

----

### ChromeOS is "end of life"

- Auto Update Expiration: <span class="db8orange">september 2019</span>
- Laatste versie: ChromeOS / Chrome **77**
- Geen beveiligingsupdates meer
- Websites ondersteunen Chrome-versie niet meer

<br><br>
<span class="fragment">
Laptop werkt prima, maar niet meer veilig browsen.
</span>

Note: Chrome 77 dateert uit 2019. In 2026 is dat zeven jaar zonder updates.

----

### Het plan

ChromeOS eruit → <span class="db8orange">Debian Linux</span> erin

- Actuele browser
- Beveiligingsupdates
- Het apparaat gaat weer jaren mee

---

<div style="position:relative;height:600px;">
<div class="sheet">Poging na poging</div>
</div>

----

### Valkuil 1: het is géén x86

```text
$ uname -m
armv7l
```

- ARMv7, **32-bit** (armhf)
- Bijna alle Chromebook→Linux-handleidingen:
  - voor x86-modellen
- <a href="https://docs.mrchromebox.tech/" target="_blank">MrChromebox</a> / coreboot-firmware
  - NIET voor ARM-Chromebooks
- arm64- en x86-images werken niet

Note: Let op: de CB5-571 is wél het x86-model. Verwar die twee niet bij het zoeken.

----

### Valkuil 2: verkeerd model

<span class="db8orange">CB5-311</span> ≠ CB5-571

| | CB5-311 | CB5-571 |
|---|---|---|
| CPU | NVIDIA Tegra K1 | Intel |
| Architectuur | ARM 32-bit | x86 |

<br>
<span class="fragment">
Eén cijfer verschil<br>compleet andere handleidingen.
</span>

----

### Poging: postmarketOS

```text
mmcblk0       7.5G  disk
├─mmcblk0p1    16M  part
├─mmcblk0p2   512M  part
└─mmcblk0p3   6.9G  part  /media/pe7er/pmOS_root
```

- Zou met <a href="https://wiki.nura.eco/wiki/Acer_Chromebook_13_CB5-311_(google-nyan-big)" target="_blank">google-nyan-big</a> moeten werken
- <a href="https://postmarketos.org" target="_blank">postmarketOS</a> op een SD-kaart gezet
  - "My mileage varied": startte niet op

----

#### Poging: write protect uitschakelen

Doel: GBB-vlaggen `0x19`
- Google Binary Block:
  - in firmware-chip "vlaggen" hoe firmware opstart
- Waarschuwingsscherm 2 s i.p.v. 30 s
- Geen pieptoon
- Developer mode permanent

----

#### Write protect: wat ging er fout?

- Schroef **JP10** verwijderd
  - → `crossystem wpsw_cur` bleef `1`
- Accu losgekoppeld
  - → hielp ook niet
- Geen betrouwbare locatie van het Write Protect-pad voor `nyan_big` gevonden

<span class="fragment">
- Bonus: accu los wiste de NVRAM
  → `dev_boot_usb` sprong terug naar `0`
</span>

Note: De WP-schroef overbrugt een gespleten koperen pad, meestal vlak bij de SPI-flash. Les: doe demontage voordat ChromeOS weg is, zolang je de instellingen nog makkelijk kunt herstellen.

----

### Resultaat

Write protect blijft aan.

Elke keer opstarten: 30 seconden wachten + pieptoon...

<span class="fragment">
...tenzij je op <span class="db8orange">Ctrl+D</span> drukt.
</span>

---

<div style="position:relative;height:600px;">
<div class="sheet">Hoe het wél lukte</div>
</div>

----

### Velvet OS

<a href="https://velvet-os.github.io/" target="_blank">velvet-os.github.io</a><br>
<span class="small">(voorheen hexdump0815/imagebuilder)</span>

- Debian-images voor ARM-Chromebooks:<br>
<span style="font-size:90%;">chromebook_nyan-armv7l-trixie-250907.img.gz</span>
  - Debian 13 Trixie,<br>kernel 6.12,<br>btrfs
  - Login: `linux` / `changeme`

----

### Stap 1: developer mode

<span class="db8orange">Esc + Refresh + Power</span>, dan <span class="db8orange">Ctrl+D</span>

⚠️ Wist het apparaat volledig

----

### Stap 2: extern booten toestaan

In ChromeOS: <span class="db8orange">Ctrl+Alt+F2</span>, login `root`

```bash
crossystem dev_boot_usb=1 dev_boot_signed_only=0
```

----

### Stap 3: SD-kaart schrijven

Op de Ubuntu-machine, run `flash-nyan.sh`<br>
met SD card tussen 4 en 17 GB:

```bash
zcat chromebook_nyan-armv7l-trixie-250907.img.gz \
  | dd of=/dev/mmcblk0 bs=4M status=progress conv=fsync
sync
```

<span class="fragment">
zcat pakt een gzip-bestand (.gz) uit en schrijft de inhoud naar stdout
</span>

----

### Stap 4: testen vanaf SD

- SD-kaart erin, aanzetten
- <span class="db8orange">Ctrl+U</span> = booten van SD/USB
- Menu-optie 2: `linux-big-fhd`

<span class="fragment">🎉 Debian draait!</span>

----

### Stap 5: vangnet

ChromeOS-recovery-stick maken<br>met <span style="font-size:80%;">write-recovery-usb.sh</span>

- <span style="font-size:60%;">chromeos_12371.75.0_nyan-big_recovery_stable-channel_big-mp-v2.bin</span>
- md5-controle vooraf
- Schrijft alleen naar een *removable* apparaat

-> enige weg terug naar Chrome. **Bewaren!**

----

### Stap 6: klonen naar de eMMC

Vanuit de draaiende Debian op de SD:

```bash
apt install -y gdisk cloud-guest-utils
sync
dd if=/dev/mmcblk1 of=/dev/mmcblk0 bs=4M status=progress
sync
sgdisk -e /dev/mmcblk0
poweroff
```

Note: mmcblk1 is de SD-kaart, mmcblk0 de interne eMMC. sgdisk -e verplaatst de backup-GPT naar het einde van de 29 GB schijf.

----

### `dd` lijkt te hangen?

Niet afbreken!

Page cache naar flashgeheugen schrijven = traag!

```bash
grep Dirty: /proc/meminfo
```

----

### Stap 7: rootfs vergroten

SD eruit, opstarten met <span class="db8orange">Ctrl+D</span>

```bash
sudo /scripts/extend-rootfs.sh
```

----

### Stap 8: afwerking

Standaard 1920×1080 in `/boot/extlinux/extlinux.conf`:

```text
DEFAULT linux-big-fhd
```

Hostname:

```bash
sudo hostnamectl set-hostname chromebook
```

Gebruikersnaam: `/scripts/rename-default-user.sh`

---

<div style="position:relative;height:600px;">
<div class="sheet">Waarschuwingen</div>
</div>

----

### Nooit op spatie drukken

Bij het scherm *"OS verification is OFF"*

Spatie = developer mode uit = apparaat gewist

----

### Gekloonde SD-kaart

Nooit in de draaiende Chromebook steken!

- Zelfde btrfs-UUID
- Zelfde partitielabel (`rootpart`)
- btrfs kan kaart als tweede device van rootfs zien

Wis de kaart op een *andere* machine:

```bash
sudo wipefs -a /dev/mmcblk0
sudo sgdisk --zap-all /dev/mmcblk0
```

----

### Accu niet leeg laten lopen

- vboot-instellingen staan in NVRAM
  - gevoed door de accu
- Valt developer mode terug
  - → recovery-scherm
- Dan heb je de recovery-stick nodig

---

<div style="position:relative;height:600px;">
<div class="sheet">Lessen</div>
</div>

----

- Check de **architectuur** vóór je gaat zoeken
- Zoek naar je **board-naam** (`nyan_big`),
  - niet alleen het model
- Test eerst vanaf **SD-kaart**
- Maak een **recovery-stick** voor je ChromeOS wist
- Demontage?
  - Doe het **vóór** ChromeOS weg is

----

### Resultaat

Een Chromebook uit 2014 met ChromeOS 77...

<span class="fragment">
...draait nu <span class="db8orange">Debian 13 Trixie</span> met kernel 6.12
</span>

---

----

### Advies: doe het niet

- Eigenlijk niet aan beginnen
- Kost veel tijd <span class="fragment"> en ergenis <span class="fragment">(veel gemopper ook)</span></span>
- resultaat is niet geweldig

---

<div style="position:relative;height:600px;">
<div class="sheet">Vragen?</div>
</div>

<span class="apage1">Peter Martin / <a href="https://db8.nl" target="_blank">db8.nl</a></span>
</section>