🛠 Premier réseau : Ethernet double gigabit, Wi-Fi optionnel et SSH

Objectifs

Mettre la ROCK 3B en réseau et la piloter en SSH sans écran. Particularité de la carte : deux ports Ethernet gigabit (gmac0 + gmac1 dans le device tree mainline) mais aucun Wi-Fi soudé — le sans-fil passe par un module M.2 E-Key que vous installez vous-même (Radxa annonce jusqu'au Wi-Fi 6). Un port Ethernet accepte le PoE avec le HAT Radxa 25 W.

Matériel

• Radxa ROCK 3B sous Radxa OS Debian (image officielle sur docs.radxa.com/download)
• Câble Ethernet + box/routeur DHCP ; éventuellement module M.2 E-Key Wi-Fi/BT
• PC avec un client SSH ; ou câble USB-C vers le port OTG pour la console série (1 500 000 bauds, l'UART est routé sur l'USB-C)

Code complet

# Ethernet — brancher le câble puis :
ip -br addr                        # eth0 (et eth1 si 2e câble) avec une IP
sudo ethtool eth0 | grep -i speed  # attendu : 1000Mb/s
sudo dmesg | grep -i -e gmac -e link

# Wi-Fi : N'EXISTE PAS en natif — vérifier la présence d'un module M.2 E-Key
lspci | grep -i network            # module PCIe vu ?
sudo apt install firmware-misc-nonfree   # selon la puce du module

# SSH côté carte (Radxa OS) :
sudo apt install openssh-server && sudo systemctl enable --now ssh
ip -br addr | awk '/eth/{print $2}'
# Côté poste client : ssh <utilisateur>@<IP>   — identifiants par défaut : voir
# les notes de publication de votre image Radxa OS (elles changent selon les versions)

Vérification attendue

ip -br addr montre une IPv4 sur eth0 (et eth1 si le second port est câblé) ; ethtool indique 1000 Mb/s ; le SSH aboutit depuis le poste voisin ; ping -c3 1.1.1.1 sort sur Internet. Sans module Wi-Fi installé, aucun wlan0 n'apparaît : c'est normal sur cette carte.

Erreurs fréquentes

• Sur une image non-Radxa (DietPi, Debian mainline…), un seul port Ethernet fonctionne à cause d'un vieux bootloader (eth1: Failed to reset the dma sur les noyaux récents) : flasher un U-Boot récent (mainline rock-3b-rk3568_defconfig ou image SPI Radxa) avant de chercher plus loin.
• Chercher wlan0 sans avoir acheté de module M.2 E-Key : CNX le reprochait déjà au lancement, les accessoires ne sont pas évidents à trouver.
• Se tromper de port pour le PoE : seul le port près de la pile USB est compatible, avec le HAT 25 W.
• Console série muette : le port console est l'USB-C (USB-CDC) à 1 500 000 bauds, pas un connecteur 4 broches classique.
• Exposer le SSH sans avoir changé le mot de passe par défaut de l'image.