1# Imagen USB de prueba de mirada (GPU ajena / NVIDIA)
2
3Genera una USB live que arranca el compositor **mirada** para probarlo en hardware ajeno
4(NVIDIA/AMD/lo-que-sea). Cierra la parte de *imagen* del `HANDOFF-nvidia-mirada.md`.
5
6## Armar y quemar
7
8```sh
9scripts/mirada-usb.sh                 # → work/hammer-mirada-usb.img (~147 MB)
10sudo dd if=work/hammer-mirada-usb.img of=/dev/sdX bs=4M oflag=sync status=progress
11```
12
13Bootear con **Secure Boot OFF**. Aparece el menú de systemd-boot; ENTER arranca. La tecla **`e`**
14edita la cmdline en vivo (para alternar software/hardware, ver abajo).
15
16## Qué contiene
17
18- **Kernel** `linux-generic` 7.1.2 (nouveau/i915/radeon built-in + simpledrm fallback).
19- **mirada** ya sellado en el store: `mirada-compositor` (smithay) + `mirada-greeter` (wgpu/Vello) + `mirada-ctl`.
20- **Stack gráfico por software + nouveau** (mesa 26.1.1 de Alpine, musl): **llvmpipe** (GL) + **lavapipe**
21  (Vulkan) + `nouveau_dri.so` (GL por hardware si nouveau bindea). Más `seatd`, `libinput`,
22  `libxkbcommon`, datos XKB, PAM permisivo, busybox, loader musl.
23- `/sbin/init` = lanzador: monta pseudo-fs, arranca `seatd`, corre `mirada-compositor --drm --greeter`.
24
25La receta nueva es `recipes/mesa-swrast.toml` (softpipe takana-nativo, sin LLVM); el stack robusto de la
26imagen viene de Alpine (deuda de soberanía: falta `recipes/{llvm,mesa-llvmpipe,nvk}` desde fuente).
27
28## Estado validado (QEMU virtio-gpu, software)
29
30✅ **El compositor arranca entero**: libseat → `/dev/dri/card0` → GBM+EGL+**GlesRenderer** →
31`[8/8]` → «escritorio en marcha» → acepta clientes Wayland → dibuja la ventana del greeter.
32
33⚠️ **El greeter (login) NO termina de pintar por software.** Su renderer **Vello** exige la capacidad
34de shaders **float16** (`SHADER_FLOAT16_IN_FLOAT32`, `unpack2x16float`) que **llvmpipe y lavapipe NO
35proveen** — sólo una **GPU real**. Por eso el login sólo se pinta con hardware.
36
37## Target actual: GTX 1060 (Pascal / GP106)
38
39Pascal **no** usa GSP (eso es Turing+). La imagen hornea el firmware de aceleración `nvidia/gp106/`
40(ctxsw `gr/` + `acr`/`sec2`, **descomprimido a `.bin`**) que nouveau necesita para dar **GL 3D**.
41**NVK (Vulkan) no soporta Pascal** ⇒ el greeter va por el **backend GL de wgpu sobre gallium-nouveau**
42(que da `unpackHalf2x16` = float16). Reconstruir para otra GPU: `CHIP=<gpXXX> FW_SRC=<dir> scripts/mirada-usb.sh`.
43
44## Los dos modos (cmdline, editable con `e` en systemd-boot)
45
46- **Por defecto (`console=tty0`)** → HARDWARE nouveau. nouveau maneja la GTX 1060 (firmware ya horneado),
47  el compositor y el greeter pintan por gallium-nouveau GL. El init exporta `WGPU_BACKEND=gl` y tapa
48  lavapipe para que wgpu no caiga a software.
49- **Fallback software** → en el menú, `e`, agregá **`mirada.sw nouveau.modeset=0`**. Fuerza
50  llvmpipe/lavapipe sobre simpledrm: el **compositor** arranca seguro; el **greeter no completa**
51  (los rasterizadores software no dan float16). Útil si nouveau diera problemas.
52
53## Post-mortem del primer viaje (GTX 1060, 2026-07-16)
54
55**Qué se vio en el metal:** booteó, el fondo animado del greeter pintó bien (⇒ nouveau GL +
56float16 VALIDADOS end-to-end), pero **sin input** (ni teclado ni mouse) y el pendrive volvió
57**sin telemetría** (partición MIRADALOG vacía).
58
59**Por qué se perdió la telemetría (resuelto):** el GPT de respaldo de la imagen dd-eada queda en el
60*medio* del pendrive (al final de la imagen, no del disco) y el firmware de la máquina lo "reparó" en
61el POST: reconstruyó el respaldo al final del disco (bien) y reescribió el header primario apuntando
62las entradas a LBA 2016 **sin copiarlas ahí** (quedaron en LBA 2) ⇒ CRC inválido. Linux **no** cae al
63GPT de respaldo con el primario roto salvo `gpt` en la cmdline (`block/partitions/efi.c`, `force_gpt`)
64⇒ cero particiones ⇒ `findfs LABEL=MIRADALOG` falló ⇒ logs sólo en RAM. UEFI y Windows sí usan el
65respaldo — por eso el stick booteaba y Windows lo leía, mientras Linux no veía `sdX1/sdX2`.
66**Fix:** la cmdline por defecto ahora lleva `gpt`. Si un stick ya quedó mutilado: el header primario
67se repara apuntando `partition_entry_lba` de vuelta a 2 y recomputando su CRC (o `gdisk` menú
68recovery, opción `c` = load backup partition table + `w`).
69
70**Input muerto (abierto):** nunca se validó — la validación QEMU fue `-display none`. Sospechosos, en
71orden: enumeración libinput sobre `libudev-zero` (¿0 dispositivos?), falta de nodos `/dev/input/event*`
72(el kernel generic trae usbhid/evdev built-in, debería haberlos), foco. El próximo viaje ya trae la
73evidencia: `01-hardware.txt` snapshotea `/proc/bus/input/devices` (lado kernel) y mirada ahora loguea
74cada `DeviceAdded` de libinput con nombre y capacidades (lado userspace, va al `05-mirada.log`) —
75commit en tawasuyu `mirada-compositor/src/drm_backend/input.rs`. Con telemetría persistente funcionando,
76ese par de archivos separa kernel vs udev vs foco.
77
78## Pendiente / deuda
79
80- **Confirmar en el metal**: el camino nouveau-GL sólo se puede validar en la 1060 real (QEMU no tiene
81  nouveau; el proxy virgl requiere `egl-headless`, no disponible acá). El software sí está validado.
82- **Soberanía**: el stack GL/Vulkan viene de Alpine (mesa 26 + LLVM 22). Falta
83  `recipes/{llvm,mesa-llvmpipe,mesa-nouveau}` desde fuente. El firmware nouveau es un blob NVIDIA (no
84  reproducible por naturaleza).
85
86## Validar en VM
87
88```sh
89# compositor por software (virtio-gpu); el greeter no completa (float16) — es lo esperado:
90qemu-system-x86_64 -enable-kvm -m 4096 -smp 4 \
91  -kernel store/*-linux-generic/boot/bzImage -initrd work/metal-sdboot/initramfs.cpio.gz \
92  -append "console=ttyS0,115200 mirada.sw nouveau.modeset=0 rdinit=/init" \
93  -device virtio-gpu-pci -display none -serial stdio -no-reboot
94```