Capítulo 13 · Software
Betaflight: pestañas, armado y CLI
Betaflight es el firmware de código abierto más popular para freestyle y carreras. Aquí tienes para qué sirve cada pestaña, por qué un dron no arma y los comandos útiles de la CLI.
¿Configuras un dron por primera vez? Sigue el Tutorial de Betaflight paso a paso, con esquemas y una comprobación en cada paso. Este capítulo es la referencia para consultar después.
Herramientas para Betaflight en fpv.cat: diseña el OSD con el editor visual, guarda cada configuración en tu hangar y conecta el dron al Taller 3D para verlo moverse en directo.
1. Conectarse
- Usa Betaflight App, desde el navegador (Chrome o Edge) o la versión de escritorio.
- Un cable USB que transmita datos, no solo de carga. Muchos problemas de conexión son eso.
- En Windows, si no detecta el puerto, hay que instalar los controladores.
- Sin hélices. Siempre.
2. Actualizar el firmware
Guarda la configuración actual
En la CLI, escribe
diff ally guarda el texto en un archivo.Elige la placa
En el Firmware Flasher, deja que la detecte o elígela manualmente.
Elige la versión y las opciones
La última versión estable y, en las opciones de compilación, el protocolo de radio (CRSF para ELRS) y las funciones que uses: OSD, GPS, LED.
Si no responde, modo DFU
Mantén pulsado el botón boot de la placa mientras conectas el USB.
No pegues la configuración antigua entera
Si cambias de versión principal, vuelve a configurar o aplica solo lo necesario del
diffantiguo.
3. Alineación de la placa
Si has montado la controladora girada (por ejemplo, para que el conector USB quede a un lado), Betaflight tiene que saberlo. En la configuración puedes indicar los grados de giro o usar el asistente, que lo detecta moviendo el dron.
Compruébalo en la pestaña Setup: inclina el dron hacia delante y el modelo 3D tiene que hacer lo mismo. Si va al revés, la placa está mal alineada y el dron se estrellará al despegar.
4. Pestaña a pestaña
Recórrelas en este orden la primera vez, con el dron conectado por USB y sin hélices.
Setup
Comprueba que el modelo 3D se mueve como el dron y calibra el acelerómetro con el dron bien plano.
Ports
Activa Serial RX en la UART del receptor. VTX analógico: SmartAudio o Tramp; digital: MSP DisplayPort. No toques el puerto USB.
Configuration
DShot300 o DShot600, DShot bidireccional activado y polos del motor correctos (14 en la mayoría). Ponle nombre al dron.
Power & Battery
Ajusta la escala de voltaje comparándola con el multímetro y define el aviso de celda baja.
Failsafe
Si se pierde la señal, parar motores (Drop) o, con GPS, GPS Rescue.
Presets
Configuraciones de la comunidad para la placa, el receptor o un tune de base. Aplica pocas y entiende qué cambian.
PID Tuning
Los valores por defecto vuelan bien. Aquí también defines las rates (ver Aprender a volar).
Receiver
Protocolo CRSF y mapa de canales AETR. Cada stick mueve su canal, de 1000 a 2000 y centrado en 1500.
Modes
Armado en AUX1 en un interruptor de dos posiciones. Añade BEEPER y FLIP OVER AFTER CRASH (turtle).
Motors
Sin hélices: comprueba el orden (1 detrás derecha, 2 delante derecha, 3 detrás izquierda, 4 delante izquierda) y el sentido de giro.
OSD
Voltaje medio por celda, tiempo de vuelo, calidad de enlace (LQ) y avisos.
Video Transmitter
Tabla de VTX para elegir banda, canal y potencia. Pit mode para configurar sin interferir.
Blackbox
Registra los datos del vuelo. Actívalo para hacer tuning.
5. ¿Por qué no arma?
Betaflight bloquea el armado si detecta algo raro. La pestaña Setup y el OSD te dicen el motivo. Los más habituales:
| Motivo | Qué significa |
|---|---|
RXLOSS / BADRX | No recibe señal de radio. Revisa el vínculo, el puerto y el protocolo. |
THROTTLE | El gas no está a cero. |
ANGLE | El dron está demasiado inclinado. |
MSP | Está conectado a Betaflight App. |
CLI | Tienes la CLI abierta. |
NOPREARM | Hay un interruptor de prearmado configurado y no está activado. |
CALIBRATING | Está calibrando el giroscopio: no lo muevas. |
6. Funciones que vale la pena conocer
Filtro RPM
Con DShot bidireccional, elimina el ruido de los motores con precisión y permite filtrar menos. Actívalo siempre que el ESC lo permita.
GPS Rescue
Si pierdes la señal, el dron vuelve hacia el punto de despegue. Imprescindible en largo alcance. Pruébalo antes de confiar en él.
Tabla de VTX
Define qué canales y potencias puedes elegir. Sin ella, el control del VTX desde el OSD no funciona.
Menú OSD
Con los sticks (gas en el centro, yaw a la izquierda y pitch arriba) puedes cambiar PID, rates y VTX desde las gafas.
Perfiles
Varios juegos de PID y de rates: unos suaves para filmar y otros para hacer freestyle.
7. Comandos útiles de la CLI
# Muestra todo lo que has cambiado respecto a los valores por defecto
diff all
# Lista completa de la configuración
dump
# Estado del sistema, carga del procesador y errores
status
# Cambia un parámetro
set nom_del_parametre = valor
# Guarda y reinicia (sin este comando no se guarda nada)
save
Guarda el resultado de diff all en un archivo cada vez que tengas el dron como te gusta. Si un día tienes que volver a flashearlo, recuperar la configuración será cuestión de segundos.