Herramienta gratuita · Betaflight 4.x
Analizador Blackbox de Betaflight
Sube el log Blackbox de tu dron FPV y te digo qué ruido tiene, de dónde viene y qué cambiar en PIDs y filtros, con los comandos CLI listos para pegar en Betaflight. El log se analiza en tu navegador y no se sube.
El log se lee entero en tu navegador: no se sube a ningún servidor.
Diagnóstico
CLI propuesta
Antes de pegar, guarda un diff all para poder volver atrás. Aplica los cambios en grupos pequeños, vuela 1–2 minutos y toca los motores: si salen calientes, deshaz el último cambio.
Ruido del giroscopio
Picos de ruido
Ruido frente al throttle
Una franja diagonal que sube con el throttle es ruido de motor (lo quita el filtro RPM). Una franja horizontal a frecuencia fija es una resonancia del frame. Los puntos blancos marcan el pico dominante en cada nivel de throttle.
Respuesta a escalón
Cómo sigue el dron un cambio brusco de stick. Lo ideal es subir rápido hasta 1,0 y quedarse ahí. Si pasa de 1,0 hay sobreimpulso (falta D o sobra P); si sube despacio, falta P. Las líneas discontinuas tienen confianza baja.
Configuración leída del log
Qué analiza
Ruido de motores y del frame
Espectro del giroscopio antes y después de los filtros y mapa de ruido frente al throttle. Separa el ruido de motor, que sube con las vueltas, de las resonancias del frame, que se quedan a frecuencia fija.
Filtros
Comprueba si los picos pasan los filtros y propone el ajuste: filtro RPM con DShot bidireccional, rango y Q del notch dinámico, notch estático centrado en una resonancia, y filtrado del giroscopio y del término D.
PIDs
Respuesta a escalón de roll, pitch y yaw a partir del setpoint y el giroscopio, contrastada con los giros secos del vuelo. Mide sobreimpulso y retardo y propone subir D, bajar P o subir P, con un nivel de confianza.
CLI lista para pegar
Los comandos con los nombres de tu versión de Betaflight (4.2, 4.3, 4.4 o 4.5) y, si usas los sliders, moviendo los sliders. Con la tabla de PIDs actuales y propuestos.
Recomendaciones orientativas calculadas con reglas a partir de tu log. Cada dron es distinto: aplica los cambios poco a poco y comprueba la temperatura de los motores. AIRLAB FPV no está afiliado a Betaflight.
Guía: cómo ajustar PIDs y filtros con el Blackbox
Cómo hacer un tune de Betaflight con el Blackbox
- Prepara el registro: en la pestaña Blackbox, a 2 kHz o más. Con 1 kHz solo se ve ruido hasta 500 Hz y el ruido de motor se «dobla» a frecuencias falsas.
- Graba el giro sin filtrar: en Betaflight 4.4 y 4.5 el campo
gyroUnfiltse registra por defecto; en 4.3 o anteriores usaset debug_mode = GYRO_SCALED. Sin él solo se ve el ruido que ya ha pasado los filtros. - Vuela un log de prueba: 1–2 minutos con hélices en buen estado, subidas lentas de throttle de 0 a 100 % y, al final, 15–20 s de giros secos en roll y pitch (stick a fondo y soltar).
- Primero los filtros, después los PIDs: elimina el ruido de motor y las resonancias; con la señal limpia, ajusta P y D según la respuesta a escalón.
- Cambia poco y comprueba: aplica cada grupo de cambios, vuela 1–2 minutos, toca los motores y graba un log nuevo.
Ruido de motor y filtro RPM
El ruido de motor sube de frecuencia con las vueltas: en el mapa de ruido frente al throttle aparece como una franja en diagonal, a veces con sus armónicos. El filtro RPM lo elimina siguiendo las RPM reales de cada motor que envían los ESC por la telemetría DShot bidireccional. Necesita ESC con Bluejay, BLHeli_32 o AM32 y que motor_poles coincida con los imanes del motor (14 en la mayoría de motores de 5"). En Betaflight 4.3 y posteriores se activa con dshot_bidir y rpm_filter_harmonics.
Resonancias del frame y filtro notch
Una franja horizontal, a la misma frecuencia con cualquier throttle, es una vibración mecánica: brazos, stack, cámara o tornillería floja. Antes de filtrarla, revisa el montaje. Si sigue ahí, el notch dinámico la sigue si cae dentro de su rango (dyn_notch_min_hz y dyn_notch_max_hz); si no, un notch estático centrado en su frecuencia (gyro_notch1_hz y gyro_notch1_cutoff) la elimina con poco retardo.
Respuesta a escalón: P y D
La respuesta a escalón muestra cómo sigue el giroscopio a un cambio brusco del setpoint. Si pasa de 1,0 y oscila, falta amortiguación: se sube D o se baja P. Si llega tarde y sin pasarse, falta P. Con un D ruidoso, subir D calienta los motores, así que el analizador propone bajar P. El feedforward también adelanta la respuesta: si el sobreimpulso aparece justo al empezar el giro, prueba primero a bajarlo.
Retardo frente a ruido
Cada filtro añade retardo. Con una señal limpia (filtro RPM activo, hélices y motores en buen estado) se puede filtrar menos y el dron responde mejor al propwash; con mucho ruido hay que filtrar más para que no se calienten los motores. El analizador compara el ruido antes y después de los filtros para decirte hacia qué lado mover los sliders de filtrado.
Si estás montando el dron, empieza por el taller de montaje FPV y el configurador de drones FPV; si no arma después de tocar la configuración, revisa por qué no arma en Betaflight.
Otras herramientas gratuitas
Preguntas
¿Qué logs acepta?
Los logs Blackbox de Betaflight (.BBL y .BFL), de la tarjeta SD o descargados de la memoria flash con Betaflight Configurator, y los CSV exportados con Blackbox Explorer o blackbox_decode. También lee los de EmuFlight e INAV con el mismo formato, aunque las recomendaciones están pensadas para Betaflight 4.x.
¿Se sube mi log a algún servidor?
No. El log se lee y se analiza entero en tu navegador. No sale de tu ordenador o de tu móvil.
¿En qué se diferencia del Blackbox Explorer?
El Blackbox Explorer de Betaflight enseña las gráficas y el espectro, pero las conclusiones las sacas tú. Este analizador lee el mismo log, detecta los picos de ruido y la respuesta de los PIDs, y te dice qué cambiar, con los comandos CLI.
¿Cómo tengo que grabar el log?
A 2 kHz como mínimo (set blackbox_sample_rate = 1/2 con el lazo a 8 kHz), con el giro sin filtrar (en 4.4 o superior se graba por defecto; en 4.3 o anteriores, set debug_mode = GYRO_SCALED), 1–2 minutos de vuelo con cambios de throttle y 15–20 s de giros secos en roll y pitch.
¿Puedo fiarme de las recomendaciones?
Son un punto de partida calculado con reglas a partir de tu log, con un nivel de confianza en cada ajuste de PIDs. Aplica los cambios en grupos pequeños, vuela, toca los motores y vuelve a grabar un log para comprobar el resultado.
¿Qué es la respuesta a escalón?
Es cómo sigue el giroscopio a un cambio brusco del stick, calculada a partir del setpoint y del giro del log. Una buena respuesta sube rápido hasta el valor pedido y se queda ahí sin pasarse ni oscilar.
¿Qué hago si no recomienda cambios de PIDs?
Si el log no tiene suficientes giros secos, el analizador no se arriesga a proponer PIDs. Graba 15–20 s de snap rolls y flips en roll y pitch, además del vuelo normal, y vuelve a analizarlo.