Analisar a blackbox do Betaflight: qual ferramenta usar?
Você tem um log de blackbox e quer saber o que ele diz? Este guia mostra o que o Betaflight 2026.6.2 grava no log, qual linha responde a qual pergunta e qual ferramenta faz a análise: o Blackbox Explorer no Betaflight App, PIDtoolbox, PIDscope, PID-Analyzer, FPVtune, PIDoctor e o fpvrates. Com fontes do código-fonte, da documentação do Betaflight e das páginas de cada ferramenta. O guia Como usar o Blackbox Explorer explica como usar o Explorer.
Resumo: qual pergunta, qual linha, qual ferramenta
Os nomes das linhas são os do Visualizador Blackbox do Betaflight App, onde ficam em inglês em todos os idiomas. Clique numa pergunta para ir à seção dela.
| Sua pergunta | O que olhar no log | Ferramenta |
|---|---|---|
| As minhas rates combinam com o meu stick? | RC Command e Setpoint por eixo, contados no voo inteiro; as rates do voo estão no cabeçalho | fpvrates (zonas, curso do stick sem uso, inclinação); Visualizador Blackbox para momentos isolados |
| O drone acompanha o meu stick? | Gyro contra Setpoint; o visualizador calcula com eles o PID Error | Visualizador Blackbox (“Error vs Setpoint”); resposta ao degrau: PIDtoolbox, PIDscope, PID-Analyzer |
| Propwash: ele balança nas descidas? | Gyro contra Setpoint em mudanças de velocidade e descidas, acelerador em RC Command [throttle] | Visualizador Blackbox (gyro e setpoint sobrepostos, PID Error) |
| Ele vibra? De onde vem o ruído? | Gyro e Unfiltered Gyro, log a 2 kHz; modos debug como RPM_FILTER ou FFT_FREQ | Analisador do Visualizador Blackbox (espectro, PSD); PIDtoolbox, PIDscope, PID-Analyzer |
| Quais PIDs e filtros devo usar? | Gyro, setpoint, termos PID e espectro; para a aba Autotune, um log com varredura chirp | Sugerem valores: FPVtune, PIDoctor, a aba Autotune do Betaflight App, PIDscope. O fpvrates não |
| Os motores chegam ao limite? | Motor [1] a [4] em %, barra de tempo “Maximum motor differential” | Visualizador Blackbox |
| A tensão da bateria cai? | Battery volt. (total e por célula), Amperage | Visualizador Blackbox (“Statistics” para o menor valor) |
| Quero fazer as contas eu mesmo (planilha, Python) | todos os campos em CSV | Exportar CSV no Visualizador Blackbox; blackbox_decode das blackbox-tools |
Sobre o que a blackbox grava, a documentação do Betaflight diz: “Tudo isso é gravado sem aproximação nem perda de precisão, então mesmo problemas bem sutis devem poder ser detectados no log de voo.”1 Quais linhas o seu log tem depende do que você deixou ligado; mais em O que o Betaflight grava no log.
As suas rates combinam? Stick e setpoint
RC Command é a posição do stick como o Betaflight a processa, para roll, pitch, yaw e acelerador; desde o Betaflight 4.3 ela é gravada sem suavização (4.3 Tuning Notes). Setpoint, segundo o código-fonte, é a velocidade de giro alvo em °/s que o controlador PID recebe, ou seja, o que as suas rates fazem com a posição do stick (blackbox.c). Colocando as duas linhas uma sobre a outra, você vê a sua curva de rates em ação. As linhas de cabeçalho do log dizem com quais rates ele foi voado; como lê-las está no guia do Explorer.
Mas um único momento não diz se as rates combinam com você. Para isso é preciso a distribuição: com que frequência o seu stick fica em cada ponto, até onde você vai no voo normal, quanto curso do stick fica sem uso? O Explorer não soma isso; o “Statistics” dele só mostra mínimo, máximo e média (mais no guia do Explorer).
É exatamente isso que o fpvrates calcula a partir do mesmo log: com RC Command, setpoint e gyro ele mede cinco zonas no seu stick (fino, precisão, voo normal, sem uso, flips e rolls) e se a sua curva fica íngreme demais perto da borda. Só conta o modo acro; o fpvrates descarta voos em angle e horizon, porque neles o drone se estabiliza sozinho e o giro não vem direto do seu stick. O check grátis mostra isso sem conta e sem sugestão. Actual Rates sob medida, como bloco CLI para o Betaflight App, vêm com o Tuning Pass por 19 € (1 drone) ou 29 € (5 drones), pagamento único. A análise roda no seu navegador e seu log não é enviado para nenhum servidor. O guia Configurar as rates do Betaflight explica como ajustar as rates.
As suas rates combinam com o seu stick? O check grátis mede isso no seu log de blackbox. Sem conta, seu log não é enviado para nenhum servidor.
Ainda não tem log? Ver um exemplo real · Ativar o registro, com imagens
Para o seu próximo dia de voo
- Betaflight App, aba Blackbox: dispositivo Flash Onboard ou cartão SD, frequência de log 1 kHz
- RC Commands, Setpoint e Gyro ligados, depois “Salvar e reiniciar”
- Voe de 3 a 5 baterias de acro normal
- Depois tire o log do quad e arraste para o check grátis
O drone acompanha? Setpoint, gyro e propwash
Gyro é a velocidade de giro que o drone realmente voa, depois dos filtros (blackbox.c). Se o gyro fica em cima do setpoint, o drone faz o que você pede. O Visualizador Blackbox calcula a diferença por conta própria como a linha PID Error: setpoint menos gyro (flightlog.js). No analisador, “Error vs Setpoint” mostra o erro médio por velocidade de giro (graph_spectrum_calc.js).
Segundo o PID Tuning Guide da documentação, o propwash surge nas mudanças de velocidade: as hélices criam turbulência e o drone fica instável ao pilotar, principalmente em descidas verticais. A documentação avalia o propwash pelo quanto o gyro acompanha o setpoint e observa que o propwash também gera PID Error. Então, no log, você procura mudanças de velocidade e descidas, por exemplo os momentos depois de cortar o acelerador (RC Command [throttle]), e compara ali o gyro com o setpoint. O que ajuda contra o propwash, do estilo de voo ao termo D, está em Propwash: o que é e o que ajuda.
A resposta ao degrau (step response) mostra o quão limpo o gyro acompanha um movimento rápido do stick. PIDtoolbox, PIDscope e o PID-Analyzer da Plasmatree calculam isso; o último, segundo o README, a partir de setpoint e gyro. Este guia deixa de fora, de propósito, o que mudar nos seus PIDs: o fpvrates mede rates, não PIDs nem filtros. Se o seu drone voa nervoso, Drone nervoso: causas e soluções passa pelas causas uma a uma.
Vibração e ruído: gyro, espectro, filtros
Além do gyro existe o Unfiltered Gyro, a velocidade de giro antes dos filtros (blackbox.c). A diferença entre os dois mostra o que os filtros tiram. Com a tecla A o visualizador abre o analisador. Ele mostra os espectros “Frequency”, “Freq. vs Throttle”, “Freq. vs RPM”, “Power Spectral Density”, “PSD vs Throttle” e “PSD vs RPM” (SpectrumAnalyser.vue). Segundo o blog do Betaflight, ele desenha por cima os cortes dos seus filtros, para você ver onde cada um fica em relação ao ruído que foi realmente gravado. A visão por RPM ajuda principalmente, segundo a documentação, quando o filtro RPM está ativo.
Para ruído você precisa de uma taxa de log alta, veja Taxa de log e modo debug. Um modo debug acrescenta mais linhas: segundo a documentação, RPM_FILTER grava a frequência de cada motor como o ESC informa, e FFT_FREQ grava as frequências centrais dos filtros notch dinâmicos (Debug Modes).
O PIDtoolbox e o PIDscope também mostram espectros e mapas de calor por acelerador ou tempo, e o PID-Analyzer, gráficos de ruído. A documentação recomenda o PID Toolbox várias vezes para análise espectral, por exemplo na página do filtro RPM, com logs de antes e depois de uma mudança.
Motores e bateria
Motor [1] a [4] são as saídas para cada motor; o visualizador mostra em porcentagem (flightlog_fields_presenter.js). Na barra de tempo você pode escolher “Maximum motor differential” para pular para os momentos com a maior diferença entre os motores. As 4.2 Tuning Notes explicam o que isso significa, com o exemplo de comandos rápidos de yaw: se um par de motores está em 100% e o outro em zero, o drone não consegue entregar o que você pede.
Com DShot bidirecional, o Betaflight também grava a rotação de cada motor (RPM [1] etc.); o visualizador converte para rpm e Hz com o número de polos do motor que está no log. Battery volt. mostra a tensão total e por célula, Amperage a corrente. O menor valor de um voo fica em “Statistics”.
O que o Betaflight grava no log
Na aba Blackbox do app, em “Campos de Depuração incluídos”, você define quais campos entram no log; de fábrica todos estão ligados. O guia Configurar e baixar o log de blackbox mostra como. Isto é o que está por trás de cada chave (código-fonte blackbox.c, Betaflight 2026.6.2):
- PID: P, I, D e feedforward por eixo, no visualizador “PID P”, “PID I”, “PID D” e “PID Feedforward”. O D só é gravado nos eixos em que o D não é zero. O “PID Sum” o próprio visualizador calcula.
- RC Commands: as posições do stick de roll, pitch, yaw e acelerador.
- Setpoint: a velocidade de giro alvo por eixo e o acelerador que o mixer usa no fim.
- Gyro e Gyro (Unfiltered): a velocidade de giro medida depois e antes dos filtros.
- Motor e RPM: a saída para cada motor e, com telemetria DShot, a rotação dele.
- Battery e RSSI: tensão, corrente e intensidade do sinal.
- Accelerometer, Attitude, Magnetometer, Altitude, GPS, Servo: aceleração, atitude, bússola, altura, posição e servos.
- Debug Log: oito valores cujo conteúdo o modo debug define.
Além disso, o Betaflight grava linhas de cabeçalho com as configurações do voo: versão do firmware, placa, craft name, rates, PIDs, filtros e feedforward (blackbox.c). Segundo o blog do Betaflight, o visualizador no app também lê esses cabeçalhos, então as configurações por trás de uma linha nunca ficam longe.
Taxa de log e modo debug
De fábrica, o Betaflight grava uma a cada quatro passadas do loop de controle. Segundo a documentação: “1/4 dá aproximadamente 2 kHz de registro e 1/8 aproximadamente 1 kHz. Para uma análise de tuning detalhada, recomenda-se 2 kHz; 1 kHz é suficiente para uso geral e reduz o espaço necessário.”2 As 4.3 Tuning Notes indicam 1 kHz para uso normal e 2 kHz para ajustar filtros, e com 1/16, segundo a documentação da blackbox, só aparecem problemas grosseiros, não vibrações. Para o fpvrates basta 1 kHz com RC Commands, setpoint e gyro.
O modo debug vem em NONE de fábrica; assim o Betaflight não grava valores de debug. Você muda isso na aba Blackbox ou na CLI com debug_mode; só um fica ativo por vez. Cuidado com guias antigos: o PID Tuning Guide da documentação ainda cita GYRO_SCALED, que o Betaflight 2026.6.2 não conhece mais (debug.c). Hoje o gyro sem filtro vem do campo Gyro (Unfiltered).
As ferramentas num relance
A documentação do Betaflight cita quatro ferramentas no PID Tuning Guide, em “Analysis Tools”: Blackbox Explorer, PID Toolbox, Plasmatree e blackbox-tools. PIDscope, FPVtune e PIDoctor não aparecem na documentação. Preços e situação conforme as páginas de cada fornecedor em 12 de novembro de 2026.
Visualizador Blackbox (Blackbox Explorer) no Betaflight App
Segundo as Release Notes 2026.6, ele tem gráficos configuráveis, um analisador de espectro, a atitude do drone em 2D e 3D, um mapa GPS, reprodução no tempo e exportação em CSV. Sugestões de configuração não fazem parte dessa lista. Roda em app.betaflight.com e nas versões para desktop e celular do app, código aberto (GPL-3.0). Desde a 2026.6 ele é uma aba do app; o Explorer independente antigo está congelado e, segundo o README, o repositório dele será arquivado em 1º de dezembro de 2026. Como usar: Como usar o Blackbox Explorer.
Aba Autotune do Betaflight App
Nova na 2026.6, experimental e visível só no modo avançado. Ela lê um log com varredura chirp (modo de voo CHIRP), calcula a resposta em frequência e recomenda valores para os controles deslizantes do Simplified Tuning; com a controladora conectada, “Apply Gains” grava esses valores (Release Notes 2026.6).
blackbox-tools
Programas de linha de comando do Betaflight: blackbox_decode transforma o log em arquivos CSV e blackbox_render numa sequência de imagens para um vídeo (README). Código aberto (GPL-3.0), último commit em 25 de outubro de 2026; o GitHub não lista downloads prontos no momento. Para uma planilha, a exportação em CSV do Visualizador Blackbox costuma bastar.
PIDtoolbox
Programa com visualizador de logs, resposta ao degrau, espectro, mapas de calor por acelerador e tempo e uma “PID slider tool”; a versão Pro acrescenta, entre outras coisas, uma simulação de filtros e sobreposições de RPM e notch (lista de funções no Patreon de 1º de outubro de 2026). Desde maio de 2024 as versões novas só saem pelo Patreon: o download faz parte dos níveis pagos de 6 dólares canadenses (padrão) ou 8 dólares canadenses (Pro) por mês. Segundo a última descrição no GitHub, ele roda no Windows e no Mac. Versão mais recente segundo o Patreon: V094 de 2 de agosto de 2026. O repositório no GitHub e o link do PIDtoolbox na documentação do Betaflight agora dão erro 404.
PIDscope
Fork livre do PIDtoolbox em GNU Octave: espectros, resposta ao degrau, mapas de calor de ruído, equilíbrio dos PIDs e atraso dos filtros, além de uma função de autotune baseada na do Betaflight App. Segundo o README, é grátis, sem nível Pro e sem assinatura; código aberto (GPL-3.0), para Windows, macOS e Linux. Versão 26.10.1 de 30 de outubro de 2026.
PID-Analyzer (Plasmatree)
Programa em Python que calcula a resposta ao degrau a partir de setpoint e gyro e mostra gráficos de ruído; o resultado sai como gráfico e PNG. Ele precisa do blackbox_decode e está disponível como código-fonte e programa para Windows no GitHub. Última versão 0.52 de 8 de junho de 2018, testada segundo o README com logs do Betaflight 3.x. Se funciona com logs atuais, não está escrito em lugar nenhum.
FPVtune
Serviço web: você envia o log e o CLI dump e recebe valores de PID, filtros e feedforward como comandos CLI, calculados por uma rede neural segundo o fornecedor. Para logs a partir do Betaflight 4.5. Segundo a página de preços, 9,90 dólares americanos por tune ou uma assinatura a partir de 19,95 dólares por mês com pagamento anual.
PIDoctor
Serviço web para Betaflight 4.x: diagnóstico com espectros FFT, eficácia dos filtros, resposta ao degrau e uma nota do tune, além de sugestões baseadas em regras para PIDs e filtros como comandos CLI, que ele também pode gravar direto na controladora conectada (pidoctor.app). Grátis segundo os termos, doações são voluntárias. Segundo a política de privacidade, o fornecedor guarda os logs enviados na sua conta, no servidor dele.
fpvrates
Mede como você usa o stick: zonas, curso do stick sem uso e se a curva fica íngreme demais perto da borda. O check grátis mostra isso sem conta e sem sugestão; o Tuning Pass por 19 € ou 29 €, pagamento único, dá Actual Rates sob medida como bloco CLI, com quantas rodadas você quiser. Para Betaflight 4.3 ou mais novo com Actual Rates ou rates do Betaflight, voando em acro. A análise roda no seu navegador e seu log não é enviado para nenhum servidor. O fpvrates não mexe em PIDs nem em filtros, de propósito.
Fontes
Atualizado em 12 de novembro de 2026, conferido com o Betaflight 2026.6.2 (firmware e app de 16 de setembro de 2026, as versões mais recentes naquele dia):
- Documentação do 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 de 20 de agosto de 2026.
- Código-fonte do firmware:
blackbox.c,blackbox_fielddefs.h,debug.c. - Código-fonte do app (Visualizador Blackbox):
flightlog.js,flightlog_fields_presenter.js,SpectrumAnalyser.vue,graph_spectrum_calc.js,stores/debug.js. - Ferramentas (lido em 11 e 12 de novembro de 2026): README do Blackbox Explorer, Release Notes 2026.6, blackbox-tools, PIDtoolbox no Patreon, PIDscope, PID-Analyzer, preços do FPVtune, termos do PIDoctor e a política de privacidade dele. Cada informação com a citação está na pesquisa deste guia.
Citações originais (em inglês) e fontes
As citações vêm da documentação do Betaflight em inglês. No texto elas aparecem traduzidas pelo fpvrates; aqui, no original, com a fonte.
- “This is all stored without any approximation or loss of precision, so even quite subtle problems should be detectable from the flight data log.” Documentação do 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.” Documentação do Betaflight: Blackbox Flight Data Recorder ↩
Atualizado em: 12 de novembro de 2026 · conferido com Betaflight 2026.6.2