🛠 Wi-Fi AP6212 : le piège de l'antenne U.FL non fournie

Objetivos

El BPI-M2 Zero incorpora un módulo AP6212 (clase BCM43430): Wi-Fi 802.11 b/g/n 1×1 sobre SDIO, únicamente en 2,4 GHz. La particularidad que arruina las primeras noches: la placa no incluía ninguna antena — solo un conector RF U.FL junto al mini-HDMI permite atornillar una. Medidas publicadas: sin antena, velocidades que oscilan entre 0,68 y 13 Mbit/s y una lista de redes fantasma; con una antena barata, aproximadamente 26/34 Mbit/s y una veintena de redes visibles. Vas a equipar la placa y conectarla correctamente.

Material

• BPI-M2 Zero con Armbian
• Antena U.FL (pequeña antena de 2,4 GHz por unos pocos euros) — imprescindible
• Punto de acceso de 2,4 GHz (el AP6212 NO ve la banda de 5 GHz)
• Consola (CON3 o gadget OTG) para la configuración

Código completo

# 1) Visser l'antenne U.FL (contact franc, connecteur fragile)
ip -br link show wlan0

# 2) État des lieux AVANT / APRÈS antenne : la différence est édifiante
sudo iw dev wlan0 scan | grep -c SSID    # relancer après avoir vissé l'antenne

# 3) Connexion en ligne de commande (NetworkManager)
sudo apt install -y network-manager
nmcli dev wifi connect "MON_SSID" password "MON_MDP" ifname wlan0
nmcli -f SSID,SIGNAL,CHAN dev wifi list | head

# 4) Vérifier le lien et le débit réel
iw dev wlan0 link
ping -c 3 9.9.9.9
iperf3 -c mon_serveur_lan

Verificación esperada

Con antena: una veintena de SSID en el escaneo, iw dev wlan0 link muestra un enlace conectado, iperf3 se acerca a los 26 a 34 Mbit/s publicados. Sin antena, la placa a menudo solo «ve» el hotspot más cercano con velocidades inestables — este es el comportamiento documentado, no una avería.

Errores frecuentes

• Concluir que el Wi-Fi está roto cuando simplemente falta la antena U.FL (no incluida en la caja).
• Intentar conectarse a una red de 5 GHz: el AP6212 es estrictamente de 2,4 GHz.
• Montar la carcasa metálica de un kit Zero W después de haber superado las pruebas: la carcasa actúa como jaula de Faraday, desplaza la antena fuera de la carcasa.
• Olvidar que el Bluetooth comparte el módulo: la configuración de BT es un tema aparte (consulta el tutorial de Bluetooth).
• Dejar el cable de la antena pegado al conector mini-HDMI: el rendimiento se degrada, deja el cable desplegado.