sergio/takana

1#!/usr/bin/env sh
2# metal-firmware.sh — inyecta el firmware del WiFi AX201 (y reg.db) en /lib/firmware de un rootfs.
3#
4# El firmware de iwlwifi son BLOBS binarios NO compilables desde fuente (Intel no libera el código); la
5# soberanía de takana (build-from-source) no aplica acá — son datos fijos como el microcódigo de la CPU.
6# Se fijan por contenido (igual que un tarball pinned): se copian de un linux-firmware ya presente y se
7# descomprimen a .ucode plano (el kernel metal NO habilita FW_LOADER_COMPRESS, así evitamos esa dep).
8#
9# Target: Intel Wi-Fi 6 AX201 [8086:a0f0] en TigerLake ⇒ familias QuZ-a0-hr-b0 + cc-a0 (el driver elige
10# la API más alta que soporta) + regulatory.db(+.p7s) que cfg80211 verifica con la clave built-in.
11#
12# Copia además el firmware de i915 (DMC/GuC/HuC) y el de SOF (el DSP de audio de TigerLake). El nombre
13# del script dice «firmware» y no «wifi» a propósito: son las tres familias de blobs que el metal
14# necesita y ninguna se construye desde fuente.
15#
16# Uso:   scripts/metal-firmware.sh <rootfs-dir>
17# Vars:  FWSRC  dir origen del firmware (default /lib/firmware del host)
18#
19# TODO(soberanía): reemplazar FWSRC=host por un pin a un commit de linux-firmware (recipe fetch+extract).
20set -eu
21
22DST="${1:?uso: metal-firmware.sh <rootfs-dir>}"
23FWSRC="${FWSRC:-/lib/firmware}"
24OUT="$DST/lib/firmware"
25mkdir -p "$OUT"
26
27# patrones de firmware que el AX201 puede pedir (ambas familias, todas las API presentes)
28PATTERNS="iwlwifi-QuZ-a0-hr-b0-*.ucode iwlwifi-cc-a0-*.ucode"
29n=0
30for pat in $PATTERNS; do
31  for src in "$FWSRC"/$pat "$FWSRC"/$pat.zst "$FWSRC"/$pat.xz; do
32    [ -e "$src" ] || continue
33    base=$(basename "$src")
34    case "$base" in
35      *.zst) dst="$OUT/${base%.zst}"; zstd -q -d -f -o "$dst" "$src" ;;
36      *.xz)  dst="$OUT/${base%.xz}";  xz -dc "$src" > "$dst" ;;
37      *)     dst="$OUT/$base";        cp "$src" "$dst" ;;
38    esac
39    n=$((n+1))
40  done
41done
42
43# regulatory db (texto firmado; cfg80211 lo carga vía firmware loader y verifica .p7s con clave built-in)
44for f in regulatory.db regulatory.db.p7s; do
45  if [ -e "$FWSRC/$f" ]; then cp "$FWSRC/$f" "$OUT/$f"; n=$((n+1)); fi
46done
47
48# i915 (panel/GPU TigerLake): DMC (enciende el display tras ExitBootServices) + GuC/HuC. El driver pide
49# versiones EXACTAS por nombre; copiamos TODAS las tgl_* (1.3M) para que encuentre la que su versión usa.
50mkdir -p "$OUT/i915"
51for src in "$FWSRC"/i915/tgl_*.bin "$FWSRC"/i915/tgl_*.bin.zst; do
52  [ -e "$src" ] || continue
53  base=$(basename "$src")
54  case "$base" in
55    *.zst) zstd -q -d -f -o "$OUT/i915/${base%.zst}" "$src" ;;
56    *.xz)  xz -dc "$src" > "$OUT/i915/${base%.xz}" ;;
57    *)     cp "$src" "$OUT/i915/$base" ;;
58  esac
59  n=$((n+1))
60done
61
62# SOF (Sound Open Firmware) para TigerLake. Intel movió el audio de TGL al DSP: el kernel trae el
63# driver (`SND_SOC_SOF_TIGERLAKE`, encendido en linux-metal) pero **sin estos blobs carga y falla**, y en
64# el laptop no hay sonido aunque ALSA esté. En QEMU no importa: ahí manda la ruta HDA legacy.
65# Es el mismo patrón que i915 con su DMC/GuC — driver de fuente, firmware pineado por contenido.
66#
67# Tres piezas, y las tres hacen falta por motivos distintos:
68#   · sof-tgl.ri / sof-tgl-h.ri  el firmware del DSP (LP y H). Se copian los DOS porque el driver
69#     elige según el SKU y no queremos hornear la suposición. **`cp -L`**: en linux-firmware son
70#     SYMLINKS a `intel-signed/`, y un symlink relativo copiado a otro árbol apunta a la nada.
71#   · sof-tgl.ldc  el diccionario de logs del DSP. No es opcional en la práctica: el driver lo pide al
72#     inicializar y, si falta, el firmware arranca sin traza — o sea que el día que algo falle no hay
73#     por dónde mirar. 95 KB.
74#   · sof-tplg/*.tplg  las TOPOLOGÍAS: describen el grafo de audio (qué DAI, cuántos canales, qué
75#     códec). El driver pide UNA por nombre, derivado de la máquina, y no se puede saber cuál sin el
76#     hardware delante. Se copian las `sof-hda-generic-*` (el caso HDA sobre SOF, que es el del target)
77#     y las `sof-tgl-*` — ~2 MB en total. Copiar de más cuesta megas; copiar de menos cuesta un viaje
78#     físico al laptop para descubrir qué nombre pidió.
79mkdir -p "$OUT/intel/sof" "$OUT/intel/sof-tplg"
80for src in "$FWSRC"/intel/sof/sof-tgl.ri "$FWSRC"/intel/sof/sof-tgl-h.ri "$FWSRC"/intel/sof/sof-tgl.ldc; do
81  [ -e "$src" ] || continue
82  cp -L "$src" "$OUT/intel/sof/$(basename "$src")"
83  n=$((n+1))
84done
85for src in "$FWSRC"/intel/sof-tplg/sof-hda-generic-*.tplg "$FWSRC"/intel/sof-tplg/sof-tgl-*.tplg; do
86  [ -e "$src" ] || continue
87  cp -L "$src" "$OUT/intel/sof-tplg/$(basename "$src")"
88  n=$((n+1))
89done
90sof_ri=$(ls "$OUT"/intel/sof/*.ri 2>/dev/null | wc -l)
91sof_tplg=$(ls "$OUT"/intel/sof-tplg/*.tplg 2>/dev/null | wc -l)
92if [ "$sof_ri" -eq 0 ]; then
93  # Aviso y NO error: el audio del laptop se pierde, pero la imagen sigue booteando y en QEMU suena por
94  # HDA legacy. Fallar acá bloquearía builds que no necesitan SOF.
95  echo "metal-firmware: ⚠ SIN firmware SOF en $FWSRC/intel/sof — el laptop TigerLake no tendrá audio" >&2
96else
97  echo "metal-firmware: SOF = $sof_ri .ri + $sof_tplg topologías"
98fi
99
100[ "$n" -gt 0 ] || { echo "metal-firmware: NO encontré firmware AX201 en $FWSRC" >&2; exit 1; }
101echo "metal-firmware: $n blobs → $OUT"
102ls "$OUT" | sed 's/^/  /'