Analizar la blackbox de Betaflight: ¿qué herramienta usar?
¿Tienes un log de blackbox y quieres saber qué te dice? Esta guía explica qué escribe Betaflight 2026.6.2 en el log, qué traza responde a qué pregunta y qué herramienta la analiza: el Blackbox Explorer de la Betaflight App, PIDtoolbox, PIDscope, PID-Analyzer, FPVtune, PIDoctor y fpvrates. Con fuentes del código fuente, la documentación de Betaflight y las páginas de cada herramienta. La guía Cómo usar Blackbox Explorer explica cómo se usa el Explorer.
Resumen: qué pregunta, qué traza, qué herramienta
Los nombres de las trazas son los del Visor de Caja Negra de la Betaflight App, donde están en inglés en todos los idiomas. Haz clic en una pregunta para ir a su sección.
| Tu pregunta | Qué miras en el log | Herramienta |
|---|---|---|
| ¿Encajan mis rates con mi stick? | RC Command y Setpoint por eje, contados en todo el vuelo; las rates del vuelo están en las cabeceras | fpvrates (zonas, recorrido de stick sin usar, pendiente); Visor de Caja Negra para momentos concretos |
| ¿El dron sigue a mi stick? | Gyro frente a Setpoint; el visor calcula con ellos PID Error | Visor de Caja Negra («Error vs Setpoint»); respuesta al escalón: PIDtoolbox, PIDscope, PID-Analyzer |
| Propwash: ¿se tambalea al descender? | Gyro frente a Setpoint en cambios de velocidad y descensos, gas en RC Command [throttle] | Visor de Caja Negra (gyro y setpoint superpuestos, PID Error) |
| ¿Vibra? ¿De dónde viene el ruido? | Gyro y Unfiltered Gyro, log a 2 kHz; modos debug como RPM_FILTER o FFT_FREQ | Analizador del Visor de Caja Negra (espectro, PSD); PIDtoolbox, PIDscope, PID-Analyzer |
| ¿Qué PID y filtros pongo? | Gyro, setpoint, términos PID y espectro; para la pestaña «Auto-ajuste», un log con barrido chirp | Proponen valores: FPVtune, PIDoctor, la pestaña «Auto-ajuste» de la Betaflight App, PIDscope. fpvrates no |
| ¿Llegan los motores al tope? | Motor [1] a [4] en %, barra de tiempo «Maximum motor differential» | Visor de Caja Negra |
| ¿Cae el voltaje de la batería? | Battery volt. (total y por celda), Amperage | Visor de Caja Negra («Statistics» para el valor más bajo) |
| Quiero hacer mis propios cálculos (hoja de cálculo, Python) | todos los campos en CSV | Exportar a CSV en el Visor de Caja Negra; blackbox_decode de las blackbox-tools |
Sobre lo que registra la blackbox, la documentación de Betaflight dice: «Todo esto se guarda sin aproximaciones ni pérdida de precisión, así que incluso problemas bastante sutiles deberían poder detectarse en el log de vuelo»1. Qué trazas contiene tu log depende de lo que tengas activado; más en Qué escribe Betaflight en el log.
¿Encajan tus rates? Stick y setpoint
RC Command es la posición del stick tal como la procesa Betaflight, para roll, pitch, yaw y acelerador; desde Betaflight 4.3 se registra sin suavizar (4.3 Tuning Notes). Setpoint, según el código fuente, es la velocidad de giro objetivo en °/s que recibe el controlador PID, es decir, lo que tus rates hacen con la posición del stick (blackbox.c). Si pones las dos trazas una sobre otra, ves tu curva de rates en acción. Las líneas de cabecera del log dicen con qué rates se voló; cómo leerlas lo explica la guía del Explorer.
Pero un solo momento no te dice si las rates van contigo. Para eso hace falta la distribución: con qué frecuencia está tu stick en cada punto, hasta dónde llegas en vuelo normal, cuánto recorrido de stick queda sin usar. El Explorer no lo suma; su «Statistics» solo conoce mínimo, máximo y media (más en la guía del Explorer).
Justo eso calcula fpvrates a partir del mismo log: con RC Command, setpoint y gyro mide cinco zonas en tu stick (fino, precisión, vuelo normal, sin usar, flips y rolls) y si tu curva se vuelve demasiado empinada hacia el borde. Solo cuenta el modo acro; fpvrates descarta los vuelos en angle y horizon, porque ahí el dron se estabiliza solo y el giro no sale directamente de tu stick. El check gratis te lo muestra sin cuenta y sin propuesta. Las Actual Rates a tu medida, como bloque CLI para la Betaflight App, vienen con el Tuning Pass por 19 € (1 dron) o 29 € (5 drones), pago único. El análisis se hace en tu navegador y tu log no se sube a ningún servidor. La guía Configurar las rates de Betaflight explica cómo ajustar las rates.
¿Encajan tus rates con tu stick? El check gratis lo mide en tu log de blackbox. Sin cuenta, tu log no se sube a ningún servidor.
¿Aún no tienes log? Ver un ejemplo real · Activar el registro, con imágenes
Para tu próximo día de vuelo
- Betaflight App, pestaña Caja Negra: dispositivo flash integrada o tarjeta SD, frecuencia 1 kHz
- RC Commands, Setpoint y Gyro activados, luego «Guardar y reiniciar»
- Vuela de 3 a 5 baterías de acro normal
- Después saca el log del quad y arrástralo al check gratis
¿Te sigue el dron? Setpoint, gyro y propwash
Gyro es la velocidad de giro que el dron vuela de verdad, después de los filtros (blackbox.c). Si el gyro va pegado al setpoint, el dron hace lo que le pides. El Visor de Caja Negra calcula la diferencia por su cuenta como la traza PID Error: setpoint menos gyro (flightlog.js). En el analizador, «Error vs Setpoint» muestra el error medio por velocidad de giro (graph_spectrum_calc.js).
Según la PID Tuning Guide de la documentación, el propwash aparece con los cambios de velocidad: las hélices crean turbulencias y el dron se vuelve inestable al dirigirlo, sobre todo en los descensos verticales. La documentación evalúa el propwash según cómo sigue el gyro al setpoint y señala que el propwash también genera PID Error. Así que en el log buscas cambios de velocidad y descensos, por ejemplo los momentos después de cortar gas (RC Command [throttle]), y ahí comparas gyro con setpoint. Qué ayuda contra el propwash, del estilo de vuelo al término D, está en Propwash: qué es y qué ayuda.
La respuesta al escalón (step response) muestra con qué limpieza sigue el gyro a un movimiento rápido del stick. La calculan PIDtoolbox, PIDscope y el PID-Analyzer de Plasmatree; este último, según su README, a partir de setpoint y gyro. Esta guía no trata a propósito qué cambiar en tus PID: fpvrates mide rates, no PID ni filtros. Si tu dron vuela nervioso, Dron nervioso: causas y soluciones repasa las causas una por una.
Vibraciones y ruido: gyro, espectro, filtros
Además del gyro está Unfiltered Gyro, la velocidad de giro antes de los filtros (blackbox.c). La diferencia entre ambos muestra lo que quitan los filtros. Con la tecla A el visor abre el analizador. Muestra los espectros «Frequency», «Freq. vs Throttle», «Freq. vs RPM», «Power Spectral Density», «PSD vs Throttle» y «PSD vs RPM» (SpectrumAnalyser.vue). Según el blog de Betaflight, dibuja encima los cortes de tus filtros para que veas dónde quedan frente al ruido que realmente se registró. La vista por RPM ayuda sobre todo, según la documentación, cuando el filtro RPM está activo.
Para el ruido necesitas una frecuencia de log alta, consulta Frecuencia de log y modo debug. Un modo debug añade más trazas: según la documentación, RPM_FILTER registra la frecuencia de cada motor tal como la informa el ESC, y FFT_FREQ registra las frecuencias centrales de los filtros notch dinámicos (Debug Modes).
PIDtoolbox y PIDscope también muestran espectros y mapas de calor según gas o tiempo, y el PID-Analyzer, gráficos de ruido. La documentación recomienda PID Toolbox varias veces para el análisis espectral, por ejemplo en la página del filtro RPM, con logs de antes y después de un cambio.
Motores y batería
Motor [1] a [4] son las salidas a cada motor; el visor las muestra en porcentaje (flightlog_fields_presenter.js). En la barra de tiempo puedes elegir «Maximum motor differential» para saltar a los momentos con mayor diferencia entre motores. Las 4.2 Tuning Notes explican qué significa, con el ejemplo de órdenes rápidas de yaw: si un par de motores está al 100 % y el otro a cero, el dron no puede dar lo que le pides.
Con DShot bidireccional, Betaflight también registra las revoluciones de cada motor (RPM [1], etc.); el visor las convierte a rpm y Hz con el número de polos del motor que está en el log. Battery volt. muestra el voltaje total y por celda, Amperage la corriente. El valor más bajo de un vuelo está en «Statistics».
Qué escribe Betaflight en el log
En la pestaña Caja Negra de la app, en «Campos de depuración incluidos», eliges qué campos entran en el log; de fábrica están todos activados. La guía Configurar y descargar el log de blackbox explica cómo. Esto es lo que hay detrás de cada interruptor (código fuente blackbox.c, Betaflight 2026.6.2):
- PID: P, I, D y feedforward por eje, en el visor «PID P», «PID I», «PID D» y «PID Feedforward». D solo se registra en los ejes cuyo D no es cero. «PID Sum» lo calcula el propio visor.
- RC Commands: las posiciones del stick de roll, pitch, yaw y acelerador.
- Setpoint: la velocidad de giro objetivo por eje y el acelerador que usa al final el mixer.
- Gyro y Gyro (Unfiltered): la velocidad de giro medida después y antes de los filtros.
- Motor y RPM: la salida a cada motor y, con telemetría DShot, sus revoluciones.
- Battery y RSSI: voltaje, corriente e intensidad de señal.
- Accelerometer, Attitude, Magnetometer, Altitude, GPS, Servo: aceleración, orientación, brújula, altura, posición y servos.
- Debug Log: ocho valores cuyo contenido decide el modo debug.
Además, Betaflight escribe líneas de cabecera con los ajustes del vuelo: versión de firmware, placa, craft name, rates, PID, filtros y feedforward (blackbox.c). Según el blog de Betaflight, el visor de la app también lee estas cabeceras, así que los ajustes detrás de una traza nunca quedan lejos.
Frecuencia de log y modo debug
De fábrica, Betaflight registra una de cada cuatro pasadas del bucle de control. Según la documentación: «1/4 da aproximadamente 2 kHz de registro y 1/8 aproximadamente 1 kHz. Para un análisis de tuning detallado se recomiendan 2 kHz; 1 kHz basta para el uso general y reduce el espacio necesario»2. Las 4.3 Tuning Notes indican 1 kHz para el uso normal y 2 kHz para ajustar filtros, y con 1/16, según la documentación de la blackbox, solo se ven problemas gruesos, no vibraciones. A fpvrates le basta 1 kHz con RC Commands, setpoint y gyro.
El modo debug viene en NONE de fábrica; así Betaflight no escribe valores de debug. Lo cambias en la pestaña Caja Negra o en la CLI con debug_mode; solo puede haber uno activo. Ojo con las guías antiguas: la PID Tuning Guide de la documentación aún menciona GYRO_SCALED, que Betaflight 2026.6.2 ya no conoce (debug.c). Hoy el gyro sin filtrar te lo da el campo Gyro (Unfiltered).
Las herramientas de un vistazo
La documentación de Betaflight nombra cuatro herramientas en la PID Tuning Guide, bajo «Analysis Tools»: Blackbox Explorer, PID Toolbox, Plasmatree y blackbox-tools. PIDscope, FPVtune y PIDoctor no aparecen en la documentación. Precios y estado según las páginas de cada proveedor el 12 de noviembre de 2026.
Visor de Caja Negra (Blackbox Explorer) en la Betaflight App
Según las Release Notes 2026.6 ofrece gráficas configurables, un analizador de espectro, la orientación del dron en 2D y 3D, un mapa GPS, reproducción en el tiempo y exportación a CSV. Las propuestas de ajustes no forman parte de esa lista. Funciona en app.betaflight.com y en las versiones de escritorio y móvil de la app, es código abierto (GPL-3.0). Desde 2026.6 es una pestaña de la app; el Explorer independiente antiguo está congelado y, según su README, su repositorio se archivará el 1 de diciembre de 2026. Cómo usarlo: Cómo usar Blackbox Explorer.
Pestaña «Auto-ajuste» de la Betaflight App
Nueva en 2026.6, experimental y solo visible en modo experto. Lee un log con barrido chirp (modo de vuelo CHIRP), calcula la respuesta en frecuencia y recomienda valores para los deslizadores del Simplified Tuning; con la controladora conectada, «Apply Gains» los escribe (Release Notes 2026.6). En la app en inglés se llama «Autotune».
blackbox-tools
Programas de línea de comandos de Betaflight: blackbox_decode convierte el log en archivos CSV y blackbox_render en una serie de imágenes para un vídeo (README). Código abierto (GPL-3.0), último commit el 25 de octubre de 2026; GitHub no ofrece ahora descargas listas para usar. Para una hoja de cálculo suele bastar la exportación a CSV del Visor de Caja Negra.
PIDtoolbox
Programa con visor de logs, respuesta al escalón, espectro, mapas de calor según gas y tiempo y una «PID slider tool»; la versión Pro añade, entre otras cosas, una simulación de filtros y superposiciones de RPM y notch (lista de funciones en Patreon del 1 de octubre de 2026). Desde mayo de 2024 las versiones nuevas solo están en Patreon: la descarga va incluida en los niveles de pago de 6 dólares canadienses (estándar) u 8 dólares canadienses (Pro) al mes. Según su última descripción en GitHub funciona en Windows y Mac. Versión más reciente según Patreon: V094 del 2 de agosto de 2026. El repositorio de GitHub y el enlace a PIDtoolbox de la documentación de Betaflight devuelven ahora un error 404.
PIDscope
Fork libre de PIDtoolbox sobre GNU Octave: espectros, respuesta al escalón, mapas de calor de ruido, balance de PID y retardo de filtros, además de una función de autotune basada en la de la Betaflight App. Según su README es gratis, sin nivel Pro ni suscripción; código abierto (GPL-3.0), para Windows, macOS y Linux. Versión 26.10.1 del 30 de octubre de 2026.
PID-Analyzer (Plasmatree)
Programa en Python que calcula la respuesta al escalón a partir de setpoint y gyro y muestra gráficos de ruido; el resultado sale como gráfico y PNG. Necesita blackbox_decode y está como código fuente y programa para Windows en GitHub. Última versión 0.52 del 8 de junio de 2018, probada según el README con logs de Betaflight 3.x. En ningún sitio dice si funciona con logs actuales.
FPVtune
Servicio web: subes tu log y el CLI dump y recibes valores de PID, filtros y feedforward como comandos CLI, calculados por una red neuronal según el proveedor. Para logs desde Betaflight 4.5. Según su página de precios, 9,90 dólares estadounidenses por tune o una suscripción desde 19,95 dólares al mes con pago anual.
PIDoctor
Servicio web para Betaflight 4.x: diagnóstico con espectros FFT, eficacia de los filtros, respuesta al escalón y una puntuación del tune, más propuestas basadas en reglas para PID y filtros como comandos CLI, que también puede escribir directamente en la controladora conectada (pidoctor.app). Gratis según sus condiciones, las donaciones son voluntarias. Según su política de privacidad, el proveedor guarda los logs subidos en tu cuenta, en su servidor.
fpvrates
Mide cómo usas el stick: zonas, recorrido de stick sin usar y si la curva se vuelve demasiado empinada hacia el borde. El check gratis lo muestra sin cuenta y sin propuesta; el Tuning Pass por 19 € o 29 €, pago único, te da Actual Rates a tu medida como bloque CLI, con todas las rondas que quieras. Para Betaflight 4.3 o más nuevo con Actual Rates o rates de Betaflight, volando en acro. El análisis se hace en tu navegador y tu log no se sube a ningún servidor. fpvrates no toca los PID ni los filtros, a propósito.
Fuentes
Actualizado el 12 de noviembre de 2026, comprobado con Betaflight 2026.6.2 (firmware y app del 16 de septiembre de 2026, las versiones más recientes ese día):
- Documentación de Betaflight: Blackbox Flight Data Recorder, PID Tuning Guide, Debug Modes, DSHOT RPM Filtering, Power Spectral Density Charts, 4.2 Tuning Notes, 4.3 Tuning Notes, blog del 20 de agosto de 2026.
- Código fuente del firmware:
blackbox.c,blackbox_fielddefs.h,debug.c. - Código fuente de la app (Visor de Caja Negra):
flightlog.js,flightlog_fields_presenter.js,SpectrumAnalyser.vue,graph_spectrum_calc.js,stores/debug.js. - Herramientas (leído el 11 y el 12 de noviembre de 2026): README de Blackbox Explorer, Release Notes 2026.6, blackbox-tools, PIDtoolbox en Patreon, PIDscope, PID-Analyzer, precios de FPVtune, condiciones de PIDoctor y su política de privacidad. Cada dato con su cita está en la investigación de esta guía.
Citas originales (en inglés) y fuentes
Las citas proceden de la documentación de Betaflight en inglés. En el texto aparecen traducidas por fpvrates; aquí, en su versión original con la fuente.
- “This is all stored without any approximation or loss of precision, so even quite subtle problems should be detectable from the flight data log.” Documentación de Betaflight: Blackbox Flight Data Recorder ↩
- “1/4 gives approximately 2 kHz logging and 1/8 gives approximately 1 kHz. A rate of 2 kHz is recommended for detailed tuning analysis; 1 kHz is sufficient for general use and reduces storage requirements.” Documentación de Betaflight: Blackbox Flight Data Recorder ↩
Actualizado: 12 de noviembre de 2026 · comprobado con Betaflight 2026.6.2