Configurar e baixar o log de blackbox

A blackbox é a caixa-preta do Betaflight: a cada voo ela grava o que o seu stick faz, o que a controladora calcula a partir disso e o que o gyro mede. São exatamente esses dados que o fpvrates precisa. Veja como ligar, como tirar o log do flash ou do cartão SD e como evitar os tropeços comuns.

Você precisa de: seu quad, um cabo USB de dados e um computador (com cartão SD: um leitor de cartão).

1. Ativar a blackbox

O Betaflight App atual não tem mais a caixa “BLACKBOX”, e o firmware não tem esse recurso (feature.h, Betaflight 2026.6.2). A documentação do Betaflight ainda descreve aqui uma versão antiga. O registro é ligado na aba Blackbox: coloque “Dispositivo de log do Blackbox” em “Flash Onboard” ou “Cartão SD” e clique em “Salvar e reiniciar”. Se estiver “Não gerar log”, o quad não grava nada. Na maioria das placas com flash ou cartão SD isso já vem de fábrica. Na CLI é set blackbox_device = SPIFLASH ou set blackbox_device = SDCARD.

App do Betaflight, aba Blackbox: dispositivo Flash Onboard, taxa de log 1 kHz, modo debug NONE, RC Commands, Setpoint e Gyro ligados
Aba Blackbox no app do Betaflight (2026.6.2): dispositivo, taxa de log, modo debug e os campos gravados.

2. Escolher a taxa de log

O Betaflight não grava cada ciclo de controle, só uma fração: “A taxa de amostragem da Blackbox é controlada pela configuração blackbox_sample_rate, que define qual fração das iterações do loop de PID é registrada. Os valores válidos são 1/1, 1/2, 1/4, 1/8 e 1/16. O padrão é 1/4.”1 Com o loop comum de 8 kHz isso quer dizer, 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

Para rates, 1 kHz basta: em testes com os logs de um quad de 5 polegadas, 2 kHz e os mesmos logs reduzidos a 1 kHz, 500 Hz e 250 Hz deram a mesma sugestão, e com 1 kHz cabe o dobro de tempo de voo no flash em comparação com 2 kHz. Quem também ajusta PIDs e filtros com outras ferramentas fica em 2 kHz. Qual fração dá 1 kHz depende da frequência do seu loop PID; o app mostra a taxa resultante entre parênteses. Com loop de 8 kHz é “1/8 (1kHz)”, com 4 kHz “1/4 (1kHz)”. Se não houver opção com (1kHz), por exemplo com gyros de 3,2 ou 6,4 kHz, escolha a mais baixa acima, normalmente “(1600Hz)”.

3. Quais campos são necessários

O fpvrates precisa de três grupos de campos que já vêm ligados de fábrica: RC Commands (o seu stick), Setpoint (a velocidade de giro que o Betaflight calcula a partir dele) e Gyro (a velocidade de giro medida). Eles ficam em “Campos de Depuração incluídos”; os nomes dos campos são em inglês em todos os idiomas. Attitude, Accelerometer, Debug Log e Gyro (Unfiltered) podem ficar desligados, isso economiza flash; deixe o modo debug em NONE se não precisar dele para outra coisa. O check grátis lê a sua configuração no log e avisa se faltar algo.

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.

Conferir meu log grátis

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

4. Voar

“A Blackbox começa a gravar dados assim que você arma o seu quad e para quando você desarma.”3 Se o seu quad não arma, o guia Drone não arma: todas as arming flags explica o que significa cada flag e como resolver. Voe de três a cinco baterias normalmente em acro: curvas, gaps, alguns rolls. Voos só em angle ou horizon não ajudam, porque ali o quad se nivela sozinho e a rotação não vem diretamente do seu stick. Depois de pousar: “Você deve esperar alguns segundos depois de desarmar o seu quad para que a Blackbox termine de salvar os dados.”4 Vários voos em um arquivo não são problema, o fpvrates reconhece cada log separadamente.

Com o flash cheio, nada mais acontece: “Se você tentar começar a gravar um voo novo quando o dataflash já estiver cheio, o registro da Blackbox será desativado e nada será gravado.”5 Se o espaço é curto, uma chave de log em um canal AUX ajuda: “Depois que você adiciona um modo, a Blackbox só registra dados de voo quando o modo está ativo.”6

5. Passar o log para o computador

  • Chip flash: quad no USB do computador, sem bateria, abra a aba Blackbox no app. O app recomenda “Ativar modo de armazenamento” (F4, G4, F7, H7 e AT32): o quad reinicia e a memória aparece no computador como unidade, da qual você copia os arquivos de log. Depois ejete e desligue o quad da energia por um instante. O outro caminho é “Salvar memória em um arquivo...”; a documentação: “clique no botão ‘Salvar memória em um arquivo...’. Salvar o log pode levar 2 ou 3 minutos.”7 Você recebe um arquivo .bbl. O próprio app chama esse caminho de lento e propenso a erros. Depois apague o flash: “Depois de baixar o log, não deixe de apagar o chip com o botão ‘Apagar flash’ para que ele fique pronto para ser usado de novo.”8
  • Cartão SD: o Betaflight cria um arquivo novo na pasta logs toda vez que você arma (LOG00001.BFL, LOG00002.BFL …; blackbox_io.c, Betaflight 2026.6.2). Tire o cartão só alguns segundos depois de desarmar e leia com um leitor de cartão no computador. Sem tirar, use “Ativar modo de armazenamento”: segundo o app, o cartão SD também aparece como unidade. Arraste juntos para o fpvrates todos os arquivos de uma rodada.
  • Direto pelo USB: no Chrome e no Edge em um computador, o fpvrates consegue ler o flash sozinho, botão “Carregar o log direto do quad (USB)” abaixo da área de arrastar. O app do Betaflight precisa estar desconectado, porque só um programa pode ocupar a porta USB.

Whoops e drones pequenos prontos para voar (BNF)

Muitos drones pequenos com Betaflight têm blackbox, mas nem todos. O fpvrates precisa de três coisas: Betaflight 4.3 ou mais novo, um chip flash ou um cartão SD para a blackbox e voos em acro.

Confira você mesmo: conecte o quad pelo USB ao Betaflight App e abra a aba Blackbox. Se o app não encontrar o seu quad, veja o guia Betaflight não conecta. Se ela mostrar “Espaço livre” ou “Espaço utilizado”, há um chip flash. Se disser “O seu controlador de voo não tem uma Memória flash compatível disponível.”, não há chip flash; um cartão SD aparece no seu próprio quadro “Cartão SD a bordo”. Mais rápido: o botão “Carregar o log direto do quad (USB)” do check grátis (Chrome ou Edge em um computador) avisa na hora se o chip flash estiver faltando.

O que os fabricantes informam, em 4 de novembro de 2026. Trata-se da memória para a blackbox, não da memória de programa do processador, que nas fichas técnicas muitas vezes também se chama “flash”.

DroneBlackbox segundo o fabricante
BetaFPV Meteor65 Pro II, Meteor75 Pro IIFlash de 16 MB (placa Matrix 1S 5IN1 II)
Fonte: betafpv.com (página da placa)
BetaFPV Air65, Air75Flash de 16 MB (placa Air Brushless)
Fonte: betafpv.com (página da placa)
BetaFPV Meteor65, Meteor65 Pro (2022, ELRS)Flash de 8 MB (placa F4 1S 5A)
Fonte: betafpv.com (página da placa)
BetaFPV Pavo20 Pro, Pavo PicoFlash de 16 MB
Fonte: betafpv.com (página do produto)
Happymodel Mobula6 2024 V3Flash de 16 MB (placa CrazybeeG473)
Fonte: happymodel.cn (página da placa)
Happymodel Mobula8 (UART ELRS V3, 2025)Flash de 16 MB
Fonte: happymodel.cn (página do produto)
Flywoo Firefly 1S Nano Baby V3Flash de 8 MB (placa GOKU F405 HD 1S)
Fonte: flywoo.net (página da placa)
GEPRC TinyGOFlash, informado como “16Mb”
Fonte: geprc.com (página do produto)
iFlight Defender 16Flash de 16 MB (placa Defender 16/20 F411 AIO)
Fonte: iflight.com (página da placa)
Happymodel Mobula7 1S HDmódulo de blackbox próprio com cartão SD
Fonte: happymodel.cn (página do produto)
  • Módulo externo: o Mobula7 1S HD grava a blackbox por um módulo próprio em um cartão SD próprio. Ainda não foi testado se os arquivos dele funcionam direto no fpvrates.
  • Sem informação do fabricante: para Happymodel Mobula6 2024 (V1 e V2), Happymodel Mobula7 1S (analógico), BetaFPV Meteor85 (2022), BetaFPV Cetus Pro e EMAX Tinyhawk III Plus, as páginas do fabricante não citam blackbox. Se há uma instalada, o app mostra como descrito acima.
  • Firmware antigo demais: para a versão SPI FrSky do Meteor65 (2022), a BetaFPV recomenda o Betaflight 4.2.11; o fpvrates precisa do 4.3 ou mais novo.
  • Sem Betaflight: segundo o fabricante, o BetaFPV Cetus FPV Kit (com motores escovados) voa com LiteSilver, um firmware próprio baseado no Silverware. Com ele, o fpvrates não funciona.
  • Memória pequena: 8 MB a 1 kHz guardam mais ou menos o mesmo tempo de voo que 16 MB a 2 kHz, uns três a quatro minutos. Salve o log a cada uma ou duas baterias e apague o flash depois.

Tropeços comuns

  • Arquivo vazio ou só testes no chão: na aba Blackbox, “Dispositivo de log do Blackbox” estava em “Não gerar log”, ou uma chave de log (modo BLACKBOX na aba Modos) estava desligada.
  • Flash lotou depois de uma bateria: taxa de log alta demais ou campos desnecessários ligados; além disso, apague depois de cada download. Para ter uma ideia: em um quad de 5 polegadas couberam em 16 MB a 2 kHz 189 segundos de voo em um log e 231 segundos em três logs; a 1 kHz cabe cerca do dobro. Para três a cinco baterias, salve e apague no meio do caminho; depois arraste juntos para o fpvrates todos os arquivos da rodada.
  • Log sem data (0000-01-01): a controladora não tinha relógio (sem GPS, sem conexão com o app). O fpvrates então pergunta o dia do voo.
  • No celular: o log está no flash ou no cartão, você precisa de um computador com USB ou leitor de cartão. A análise em si roda depois no navegador, sem upload.

O que acontece com os dados e como o Betaflight converte a posição do stick em velocidade de giro está no guia Actual Rates explicadas; como seguir depois, no guia Configurar as rates do Betaflight.

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.

  1. “The Blackbox sample rate is controlled by the blackbox_sample_rate setting, which defines what fraction of PID loop iterations are logged. Valid values are 1/1, 1/2, 1/4, 1/8, and 1/16. The default is 1/4.” Documentação do Betaflight: Blackbox Flight Data Recorder ↩
  2. “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 ↩
  3. “The Blackbox starts recording data as soon as you arm your craft, and stops when you disarm.” Documentação do Betaflight: Blackbox Flight Data Recorder ↩
  4. “You should wait a few seconds after disarming your craft to allow the Blackbox to finish saving its data.” Documentação do Betaflight: Blackbox Flight Data Recorder ↩
  5. “If you try to start recording a new flight when the dataflash is already full, Blackbox logging will be disabled and nothing will be recorded.” Documentação do Betaflight: Blackbox Flight Data Recorder ↩
  6. “Once you've added a mode, Blackbox will only log flight data when the mode is active.” Documentação do Betaflight: Blackbox Flight Data Recorder ↩
  7. “click the "save flash to file..." button. Saving the log can take 2 or 3 minutes.” Documentação do Betaflight: Blackbox Flight Data Recorder ↩
  8. “After downloading the log, be sure to erase the chip to make it ready for reuse by clicking the "erase flash" button.” Documentação do Betaflight: Blackbox Flight Data Recorder ↩

Atualizado em: 11 de novembro de 2026