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.

Revisado: · ¿Has encontrado un error? Avísanos

¿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

  1. Guarda la configuración actual

    En la CLI, escribe diff all y guarda el texto en un archivo.

  2. Elige la placa

    En el Firmware Flasher, deja que la detecte o elígela manualmente.

  3. 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.

  4. Si no responde, modo DFU

    Mantén pulsado el botón boot de la placa mientras conectas el USB.

  5. No pegues la configuración antigua entera

    Si cambias de versión principal, vuelve a configurar o aplica solo lo necesario del diff antiguo.

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:

MotivoQué significa
RXLOSS / BADRXNo recibe señal de radio. Revisa el vínculo, el puerto y el protocolo.
THROTTLEEl gas no está a cero.
ANGLEEl dron está demasiado inclinado.
MSPEstá conectado a Betaflight App.
CLITienes la CLI abierta.
NOPREARMHay un interruptor de prearmado configurado y no está activado.
CALIBRATINGEstá 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.