🛠 Installation headless : la Zero en carte réseau USB (g_ether)

Objetivo

Configurar la Zero sin monitor, sin teclado y sin cable de red, utilizando su modo de gadget OTG: al conectarla al puerto USB de un portátil, se enumera como un adaptador de red (g_ether) más un teclado, y te conectas por SSH. Esta es la configuración natural de la Zero — la placa no tiene WiFi, Bluetooth ni Ethernet.

Componentes

• Zero + microSD con Raspberry Pi OS Lite instalado
• Un cable micro-USB de datos real (muchos baratos son solo de carga)
• Una segunda fuente de alimentación de 5 V / 1,2 A en el puerto de alimentación — el puerto de datos no alimenta la placa

Pasos

En el portátil, monta la partición de arranque FAT de la tarjeta y añade dos líneas:

sudo mount /dev/sdX1 /mnt
echo "dtoverlay=dwc2" | sudo tee -a /mnt/config.txt
sudo sed -i 's/rootwait/rootwait modules-load=dwc2,g_ether/' /mnt/cmdline.txt
sudo umount /mnt

Arranca la Zero, luego conecta su puerto micro-USB de DATOS al portátil — aparece como usb0 / un adaptador de red RNDIS:

ssh pi@raspberrypi.local
sudo apt update && sudo apt full-upgrade -y

Verificación

El portátil muestra una nueva interfaz de red USB, ping raspberrypi.local responde y SSH te lleva a una shell en la Zero.

Problemas comunes

• cmdline.txt debe permanecer en una ÚNICA línea — un salto de línea en ese archivo rompe el arranque.
• Olvidar el cable de alimentación: el modo gadget a través del puerto de datos no alimenta la placa.
• Windows puede necesitar un controlador de Ethernet USB (RNDIS); Linux y macOS suelen funcionar directamente.
• Editar la partición raíz ext4 en lugar de la pequeña partición de arranque FAT donde se encuentran config.txt y cmdline.txt.