🛠 Basculer le Wi-Fi du CM4 sur l'antenne externe U.FL (dtparam=ant2)

Objetivos

El módulo inalámbrico del CM4 (Cypress/Infineon CYW43455, Wi-Fi 802.11ac de doble banda + Bluetooth 5.0) posee dos antenas y un conmutador electrónico: la antena PCB integrada (ant1) y un conector U.FL para una antena externa (ant2). Este tutorial muestra cómo forzar el uso de la antena externa —indispensable cuando el módulo está encerrado en una carcasa metálica— y entender que la elección se fija al arrancar, no durante la ejecución.

Material

• 1 × CM4 con la función inalámbrica activada (dígito x=1 en el código de pedido, p. ej. CM4104032)
• 1 × IO Board CM4 + el Kit de Antena oficial (antena U.FL) o una antena de terceros
• Regla del fabricante: la antena integrada no debe estar rodeada de metal, incluyendo el plano de masa — de lo contrario, la antena externa es obligatoria
• Alimentar la IO Board, tener pantalla o SSH ya funcionales

Código completo

# 1. Sélectionner l'antenne externe (choix figé au boot)
echo 'dtparam=ant2' | sudo tee -a /boot/firmware/config.txt
sudo reboot

# 2. Après redémarrage : vérifier l'interface et le scan
ip -br link show wlan0
iw dev wlan0 scan | grep -E 'SSID|signal' | head -n 10
iw reg get | head -n 5          # vérifie le pays configuré

# 3. Mesurer la qualité du lien avant/après (même AP)
iw dev wlan0 link | grep -E 'Signal|tx bitrate'

# 4. (Optionnel) désactiver le Bluetooth par rail si non utilisé
# WL_nDisable / BT_nDisable sont des broches du module ; côté OS :
sudo systemctl disable --now bluetooth

Verificación esperada

Tras reiniciar con dtparam=ant2, iw dev wlan0 scan devuelve redes, iw dev wlan0 link muestra una señal coherente (por ejemplo, −60 dBm a 2 m), y el cambio de ant1 → ant2 modifica mediblemente la señal cuando el módulo está cerca de una carcasa metálica. dmesg | grep -i brcm confirma la inicialización del CYW43455.

Errores frecuentes

• Esperar un cambio de antena en caliente: el conmutador se configura al arrancar; sin reiniciar, ant2 no produce ningún cambio.
• Usar una antena de terceros sin preocuparse por la certificación: Raspberry Pi no ofrece ninguna ayuda de certificación para antenas de terceros — la certificación modular solo cubre el kit oficial.
• Carcasa metálica con la antena integrada: la hoja de datos lo prohíbe explícitamente (incluido el plano de masa); el Wi-Fi parece «muerto» aunque todo sea válido.
• Olvidar que la variante inalámbrica es un SKU: un CM4 sin el dígito inalámbrico en 1 simplemente no tiene radio — verificar el código de pedido antes de comprar un kit de antena.