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

Objetivos

Aprovechar el punto fuerte de la ZERO 3W: un módulo Wi-Fi 6 (802.11 ax, 2,4 + 5 GHz) y Bluetooth 5.4 en formato Pi Zero, algo raro a este precio. Pero la ficha técnica es clara: las primeras tarjetas llevaban un AP6212 (solo 2,4 GHz, BT 4.0) y la revisión actual V1.12I un módulo de doble banda (BL-M8800DS2 / FCS960KAAMD). Primer paso: saber qué tenemos en las manos, luego conectarnos por CLI y entender la doble ruta de antena (integrada + u.FL, conmutada por software).

Material

• 1 Radxa ZERO 3W que arranque (ver el tutorial de flasheo)
• Un punto de acceso de 2,4 GHz y, si es posible, de 5 GHz
• Opcional: antena u.FL externa para carcasas metálicas o ubicaciones difíciles

1) Identificar el módulo de 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 el módulo es un AP6212 (tarjetas antiguas), la banda de 5 GHz está ausente por hardware; no es un error del controlador.

2) Conectarse (imágenes con 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) Antena integrada vs u.FL

El módulo D8 posee una antena integrada Y un conector u.FL; la ruta de la antena se elige por software. En una carcasa de plástico, la antena integrada es suficiente; en una carcasa metálica o lejos del router, atornille una antena u.FL y cambie la selección (la opción reside en la configuración del controlador/firmware del módulo; el método exacto depende de la revisión, consulte la documentación del módulo de su tarjeta). >

Verificación esperada

ping -c 3 1.1.1.1 sale a Internet; iw dev wlan0 link muestra el SSID, la frecuencia y la señal. En un router Wi-Fi 6, la sesión negocia en 802.11ax (visible desde el router). bluetoothctl lista el controlador BT 5.4 (o 4.0 en las tarjetas antiguas, ¡indicador de la revisión!).

Errores frecuentes

• Buscar la banda de 5 GHz en una tarjeta AP6212: la disponibilidad de canales de 5 GHz depende del módulo, del firmware Y del dominio regulatorio; Radxa misma dice que «esto debe confirmarse mediante pruebas reales» (FAQ Q9).
• >
• Olvidar el bloqueo de avión por software: un nmcli radio wifi off olvidado deja la interfaz ausente de ip link.
• Carcasa metálica sin antena u.FL: RSSI catastrófico aunque la tarjeta «capte bien» fuera de la carcasa.
• Dominio regulatorio no configurado: canales de 5 GHz no disponibles; configure el país (sudo iw reg set FR).
• Dos tarjetas sin un cable de alimentación correcto: el Wi-Fi 6 en transmisión genera picos; una fuente de alimentación de 5 V insuficiente hace caer la radio bajo carga.