🛠 Wi-Fi 6 et Bluetooth 5.4 : se connecter, choisir l'antenne, connaître sa révision

Objectifs

Exploiter le point fort de la ZERO 3W : un module Wi-Fi 6 (802.11 ax 2,4 + 5 GHz) et Bluetooth 5.4 dans un format Pi Zero — rare à ce prix. Mais la fiche source est claire : les premières cartes embarquaient un AP6212 (2,4 GHz seul, BT 4.0) et la révision courante V1.12I un module double bande (BL-M8800DS2 / FCS960KAAMD). Première étape : savoir ce qu'on a dans les mains, puis se connecter en CLI, et comprendre le double chemin d'antenne (embarquée + u.FL, commuté logiciel).

Matériel

• 1 Radxa ZERO 3W démarrant (voir le tuto flash)
• Un point d'accès 2,4 GHz et, si possible, 5 GHz
• Optionnel : antenne u.FL externe pour les boîtiers métalliques ou les placements difficiles

1) Identifier son module radio

# Puce Wi-Fi derrière sdmmc1 en SDIO (vue du device tree mainline)
ls /sys/bus/sdio/devices/
cat /sys/bus/sdio/devices/*/modalias 2>/dev/null
nmcli radio wifi                      # l'interface est-elle active ?
ip -br link                           # wlan0 (et p2p-dev / ap ?)
bluetoothctl show                     # côté Bluetooth : version LMP du contrôleur

Si le module est un AP6212 (cartes anciennes), le 5 GHz est matériellement absent — ce n'est pas un bug de pilote.

2) Se connecter (images NetworkManager : Radxa OS desktop, Armbian)

nmcli device wifi list                              # scan Wi-Fi 6
sudo nmcli device wifi connect "MonAP" password "s3cret" ipv4.method auto
ip -br addr show wlan0 && ping -c 3 1.1.1.1
nmcli -f SSID,BSSID,FREQ,IN-USE device wifi list    # vérifier la bande utilisée

3) Antenne embarquée vs u.FL

Le module D8 possède une antenne embarquée ET un connecteur u.FL ; le chemin d'antenne se choisit en logiciel. En boîtier plastique, l'antenne embarquée suffit ; en boîtier métal ou loin du routeur, vissez une antenne u.FL et basculez la sélection (l'option vit dans la configuration du pilote/firmware du module — la méthode exacte dépend de la révision, vérifiez la doc du module de votre carte). >

Vérification attendue

ping -c 3 1.1.1.1 sort sur Internet ; iw dev wlan0 link affiche le SSID, la fréquence et le signal. Sur un routeur Wi-Fi 6, la session négocie en 802.11ax (visible côté routeur). bluetoothctl liste le contrôleur BT 5.4 (ou 4.0 sur les anciennes cartes — révélateur de révision !).

Erreurs fréquentes

• Chercher le 5 GHz sur une carte AP6212 : la dispo des canaux 5 GHz dépend du module, du firmware ET du domaine réglementaire — Radxa elle-même dit que « cela doit être confirmé par des tests réels » (FAQ Q9).
• >
• Oublier le blocage avion logiciel : nmcli radio wifi off oublié donne une interface absente de ip link.
• Boîtier métal sans antenne u.FL : RSSI catastrophique alors que la carte « capte bien » hors boîtier.
• Domaine réglementaire non configuré : canaux 5 GHz indisponibles ; réglez le pays (sudo iw reg set FR).
• Deux cartes sans câble d'alim correct : le Wi-Fi 6 en émission tire des pics — une alimentation 5 V chichiteuse fait tomber la radio en pleine charge.