🛠 Gadget USB : Ethernet sur le port OTG + relais Wi-Fi

Objectifs

Utiliser le port micro-USB données (OTG, BCM2835) en mode gadget : la Zero W s'énumère comme carte Ethernet sur n'importe quel PC tout en relayant Internet par son Wi-Fi — le « Linux USB stick », sans rien configurer côté PC.

Matériel

• 1 Raspberry Pi Zero W (boot legacy : partition FAT avec config.txt, pas d'EEPROM)
• 1 câble micro-USB données vers le PC

Étapes

1. Activez le contrôleur : dans /boot/config.txt ajoutez dtoverlay=dwc2, et modules=dwc2 sur la ligne dwc_otg.lpm_enable=0 console=... de /boot/cmdline.txt.
2. Créez le gadget Ethernet via configfs/libcomposite (modprobe libcomposite, usb0 en g_ether RNDIS/CDC).
3. Reliez les deux faces réseau : activez le routage sysctl -w net.ipv4.ip_forward=1 et masqueradez derrière wlan0 : iptables -t nat -A POSTROUTING -o wlan0 -j MASQUERADE.
4. Sur le PC, l'interface apparaît (usb0 / « Remote NDIS ») et obtient une adresse en DHCP via dnsmasq côté carte.

Vérification

ip a montre usb0 UP ; depuis le PC, ping vers une IP publique sort par le Wi-Fi de la Zero W.

Erreurs fréquentes

• Brancher sur le port PWR : purement alimentation, aucun signal USB.
• Confondre OTG device et host : la Zero W n'a pas de port USB hôte ni de hub — le gadget mode est la seule voie USB.
• Oublier le NAT ou ip_forward : le PC voit le lien mais ne sort pas sur Internet.