Trocar de rates com uma chave: perfis de rates no Betaflight

O Betaflight não guarda as suas rates uma vez só, mas em perfis de rates (no App em português: “Perfil de taxa”) entre os quais você pode trocar: no App, na CLI, no menu do OSD ou com uma chave do rádio. Aqui você vê quantos perfis existem, o que diferencia um perfil de taxa de um perfil de PID, como funciona cada forma de trocar, como o OSD mostra qual perfil está ativo e o que dá errado quando a chave e a CLI se referem a perfis diferentes. Conferido com o firmware e o App 2026.6.2 e a documentação do Betaflight, em 15 de novembro de 2026. Valores de exemplo para perfis ficam de fora de propósito.

Resposta curta

  • Quantos: quatro perfis de taxa e quatro perfis de PID. O App conta de 1 a 4, a CLI de 0 a 3.
  • Por chave: não na aba “Modos”, mas na aba “Ajustes”, com “Selecionar perfil de taxa” e o intervalo inteiro de 900 a 2100. Uma chave de 3 posições alcança os perfis 1 a 3; ao ligar, vale a posição da chave.
  • Na CLI: rateprofile mostra o perfil ativo, rateprofile 2 troca para o Perfil de taxa 3 e save grava. As linhas set sempre gravam no perfil de taxa ativo.
  • No OSD: o elemento “Perfil: PID e taxas” mostra, por exemplo, “1-3”: perfil de PID 1 e perfil de taxa 3.
  • fpvrates: o bloco CLI do Tuning Pass começa os comandos com rateprofile 2 e grava no Perfil de taxa 3. Se a seleção de perfil está em uma chave, ela precisa estar no perfil 3, senão você voa as rates antigas.

Quantos perfis de taxa existem?

No Betaflight 2026.6.2 são quatro. Isso está fixo no código-fonte: CONTROL_RATE_PROFILE_COUNT 4, logo ao lado de PID_PROFILE_COUNT 4 (common_pre.h). A documentação do App diz o mesmo para a aba Afinação de PID: “4 perfis que podem ser configurados para as definições de rates.”1 O número nem sempre foi o mesmo. No Betaflight 4.3, placas com mais de 128 KB de flash tinham seis perfis de taxa e as menores, três; desde a 4.4 são quatro em todas (common_pre.h na 4.3.2, na 4.4.0). Desde o Betaflight 2025.12 (versão MSP 1.47, msp_protocol.h) o App pergunta o número à controladora e, com firmware mais antigo, assume quatro (PidTuningTab.vue).

Existem duas formas de contar, e vale não misturar. O App chama os perfis de “Perfil de taxa 1” a “Perfil de taxa 4”, a CLI conta a partir de 0: rateprofile 0 é o Perfil de taxa 1 e rateprofile 3 é o Perfil de taxa 4. Com qualquer outro número a CLI responde RATE PROFILE OUTSIDE OF [0..3] (cli.c). De fábrica, o perfil de taxa 0, ou seja, o Perfil de taxa 1, está ativo (config.c).

Perfil de taxa ou perfil de PID?

O Betaflight tem dois tipos de perfil separados. A documentação: “Um perfil de taxa é um conjunto de definições relacionadas às rates. Esses perfis guardam as definições de Rate Type, RC Rate, Super Rate e Expo para Pitch, Roll e Yaw.”2 O perfil de PID, por outro lado, guarda PIDs, filtros, feedforward e anti-gravity. Antes os dois andavam juntos, e cada perfil de PID tinha os seus próprios perfis de taxa; “o Betaflight 3.2 quebrou esse vínculo e nos deu perfis e perfis de taxa independentes.”3 Então você escolhe o perfil de PID e o perfil de taxa separadamente, e qualquer combinação é possível. O OSD mostra os dois números com um hífen, veja OSD.

O que exatamente um perfil de taxa contém é definido em settings.c: todos os parâmetros marcados com PROFILE_RATE_VALUE fazem parte dele (settings.c). A tabela mostra esses parâmetros com o valor de fábrica, que é igual nos quatro perfis (controlrate_profile.c). O valor de fábrica é o que fica depois de gravar o firmware, não uma recomendação.

O que um perfil de taxa contém (Betaflight 2026.6.2, settings.c): valor de fábrica, igual nos quatro perfis, não é recomendação
Parâmetro (CLI)No AppPadrãoO que é
rateprofile_nameNome do perfil de taxasvazioNome com 1 a 8 caracteres. Aparece no elemento do OSD e no menu do OSD; sem nome, o OSD mostra RATE_1 a RATE_4.
rates_typeTipos de taxasACTUALModelo de rates: BETAFLIGHT, RACEFLIGHT, KISS, ACTUAL ou QUICK. Decide o que os três números por eixo significam.
roll_rc_rate, pitch_rc_rate, yaw_rc_rateSensibilidade (com Actual)7 (= 70 °/s)Center: inclinação da curva no centro do stick. A CLI guarda o valor dividido por 10.
roll_srate, pitch_srate, yaw_srateTaxa máxima (com Actual)67 (= 670 °/s)Max: velocidade de giro com o stick no fim do curso. A CLI guarda o valor dividido por 10.
roll_expo, pitch_expo, yaw_expoExpo (com Actual)0 (= 0.00)Expo: desloca a curvatura para fora sem mudar center e max. A CLI guarda o valor vezes 100.
roll_rate_limit, pitch_rate_limit, yaw_rate_limitsem campo, só CLI; o app o inclui na coluna “Velocidade Máxima [deg/s]”1998Teto rígido em °/s aplicado depois da curva de rates, de 200 a 1998.
quickrates_rc_exposem campo, só CLIOFFSó no tipo Quick: aplica o expo no stick em vez de na rate.
thr_mid, thr_expo, thr_hoverMEIO do Acelerador, EXPO do Acelerador, Ponto de Pairar50, 0, 50Curva de acelerador: meio, expo e ponto de pairar em porcentagem. Faz parte do perfil de taxa, não do perfil de PID.
throttle_limit_type, throttle_limit_percentLimite do Acelerador, % do Limite do AceleradorOFF, 100Teto de acelerador: OFF, SCALE ou CLIP e de 25 a 100 por cento.

Fonte: settings.c, controlrate_profile.c

O que não está no perfil de taxa: o TPA. No Betaflight 4.3 ele ainda fazia parte; desde a 4.4, tpa_rate, tpa_breakpoint e tpa_mode ficam no perfil de PID (settings.c na 2026.6.2, 4.3.2, 4.4.0). A página Profiles da documentação e o texto de ajuda do App ao lado do seletor de perfil ainda contam o TPA como parte do perfil de taxa; os dois descrevem o estado antigo. O que os três valores de rates fazem está em Configurar as rates do Betaflight, a fórmula em Actual Rates explicadas.

Trocar no App

O seletor de perfil fica na aba “Afinação de PID”, na subaba “Definições do Perfil de Rate”, no canto superior esquerdo em “Perfil de taxa”. A aba sempre abre na subaba “Definições do perfil PID”, e o “Perfil” no canto superior esquerdo ali é o perfil de PID. A documentação: “Selecionar um perfil de taxa também ativa esse perfil de taxa para o uso atual.”4 No código, o App envia a escolha para a controladora na hora (PidTuningTab.vue, msp.c); a controladora, porém, só a guarda na memória de trabalho, e ela só fica gravada com “Salvar”. Enquanto houver valores não salvos na aba, o seletor fica bloqueado: primeiro “Salvar” ou “Atualizar” (PidTuningTab.vue).

Um perfil escolhido assim continua valendo: “Além disso, ao trocar o nosso perfil de taxa, esse perfil continua sendo o ativo mesmo depois de desligar e ligar, exceto quando se usa a opção do canal AUX.”5 A exceção é a chave, veja a próxima seção. No sentido contrário, o App acompanha quando o rádio troca o perfil com ele conectado: consulta o status a cada 250 ms, muda o seletor e escreve no registro do App “Perfil de taxas aplicado a partir do controlador de voo: 3”; com alterações não salvas, não faz isso (PidTuningTab.vue).

Por chave: a aba “Ajustes”

Na aba “Modos” não existe modo para perfis de taxa; o firmware não tem nenhuma caixa para isso (msp_box.c). A chave funciona pelos ajustes (adjustments): a função 12 “Selecionar perfil de taxa” (rc_adjustments.h), no App na aba “Ajustes”, que só aparece no modo avançado (sidebar_items.js). O caminho passo a passo com todos os campos, “Quando o canal”, “Estiver no Intervalo”, “Então ajustar”, “Via canal”, está em Configurar as rates do Betaflight. Aqui o assunto é o que acontece por trás.

Os dois campos de canal recebem o mesmo canal AUX, e o intervalo é o curso inteiro de 900 a 2100. A documentação dos ajustes explica por quê: “O canal de intervalo e o canal de ajuste podem ser o mesmo canal. Isso é útil quando você quer que uma única chave de 3 posições fique dedicada a uma só função de ajuste, independentemente da posição das outras chaves.”6 O intervalo diz quando o ajuste está ativo; o canal de “Via canal” fornece a posição. O firmware divide 900 a 2100 em três posições de mesma largura, de 400 µs: abaixo de 1300 é a posição 1, de 1300 a 1699 a posição 2 e a partir de 1700 a posição 3 (rc_adjustments.c). A posição 1 escolhe o perfil de taxa 0, ou seja, o Perfil de taxa 1, a posição 2 o Perfil de taxa 2 e a posição 3 o Perfil de taxa 3. Uma chave de 3 posições não alcança o Perfil de taxa 4.

O firmware só avalia quando o valor do canal muda. Se o perfil escolhido é diferente do ativo, ele troca, grava um evento no log de blackbox e faz o buzzer bipar tantas vezes quanto o número da posição: uma vez para o Perfil de taxa 1, duas para o 2, três para o 3 (rc_adjustments.c). Se a chave já está no perfil ativo, nada acontece. Ao ligar, o primeiro valor lido do canal conta como mudança; por isso, “quando o Betaflight inicia, o perfil ativo é escolhido pela posição do canal AUX.”7 Nada é salvo nesse processo, e nem precisa: a chave define o perfil de novo a cada inicialização.

Na CLI, a mesma coisa se chama adjrange. A documentação de In-Flight Adjustments explica os campos: índice de 0 a 29, depois um 0 (um espaço reservado de versões antigas), o canal de intervalo contado a partir de 0 (AUX1 = 0), início e fim do intervalo, a função (12), o canal de posição, center e scale (os dois em 0 para a seleção de perfil). O exemplo da documentação para uma chave no AUX4 está no guia de rates.

Com rate_6pos_switch = ON, um parâmetro que só existe na CLI (de fábrica OFF), o firmware divide o mesmo curso em seis posições de 200 µs (settings.c, rc_adjustments.c). Aí uma chave de 6 posições ou um potenciômetro também alcança o Perfil de taxa 4. As posições 5 e 6, a partir de 1700 µs, não mudam nada com quatro perfis, porque o firmware só aceita números de perfil menores que 4; segundo o código, o buzzer bipa mesmo assim cinco ou seis vezes (controlrate_profile.c). A tabela de funções de ajuste da documentação ainda fala em “3 ou 6 perfis de rates”, o que vem da época dos seis perfis. Isso não foi testado em um drone; foi lido no código.

Na CLI: rateprofile, diff rates, diff all

Na aba “Linha de comandos”, rateprofile sem número mostra o perfil de taxa ativo e rateprofile 2 troca para o Perfil de taxa 3 (cli.c). Como no App, a troca vale na hora, mas só na memória de trabalho; save grava na flash e reinicia a controladora. Para o perfil de PID o comando é profile.

Importante para todo bloco que você colar: as linhas set de valores de rates gravam no perfil de taxa escolhido naquele momento na CLI, ou seja, sem uma linha própria, no ativo (cli.c). Se antes das linhas set houver um rateprofile 2, elas vão para o Perfil de taxa 3, que ao mesmo tempo fica ativo. Sem essa linha, você sobrescreve o perfil que estiver ativo, seja qual for.

Para consultar e fazer backup, diff e dump aceitam as opções master, profile, rates, hardware e all (cli.c):

  • diff rates mostra só o perfil de taxa ativo, e dele só os valores que diferem dos de fábrica. A saída começa com rateprofile N e depois vêm as linhas set (cli.c). dump rates mostra o mesmo perfil com todos os valores.
  • diff all passa primeiro pelos quatro perfis de PID, depois pelos quatro perfis de taxa, cada um com a sua linha rateprofile na frente, e em seguida pelos perfis de bateria (battery_profile). No fim vêm a linha de comentário # restore original rateprofile selection e, abaixo dela, rateprofile X com o perfil que estava ativo antes, depois o mesmo para o perfil de bateria e, por último, save (cli.c). Se você colar um backup desses de volta, no fim ele também restaura o perfil de taxa que estava ativo na época.

Para backups, a documentação indica a CLI: “Atualmente, um backup feito pelo Betaflight App só salva o perfil e o perfil de taxa ativos. Por isso, a melhor forma de ver e fazer backup de todos os perfis é usar a CLI.”8 A própria documentação explica em Profiles (em inglês) como tirar os perfis com diff e dump.

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

Pelos sticks: só no código

Para os perfis de PID, a documentação descreve comandos de stick (throttle embaixo, yaw para a esquerda, mais roll ou pitch). Para os perfis de taxa também existem no código-fonte, mas não na documentação (Controls, rc_controls.c): throttle em cima, yaw no centro e, além disso, pitch para a frente para o Perfil de taxa 1, pitch para trás para o 2, roll para a direita para o 3 e roll para a esquerda para o 4. Só funciona desarmado, depois de segurar a posição por pelo menos 50 ms e uma vez por posição. No modo angle ou horizon, as mesmas posições ajustam o trim do acelerômetro em vez disso. Segundo o código, a troca não faz o buzzer bipar, ao contrário do perfil de PID (config.c). Como a documentação não diz nada sobre isso e não foi conferido em um drone: prefira o App, a CLI ou uma chave e confira o resultado no OSD.

Exibição no OSD e menu do OSD

Dois elementos do OSD mostram o perfil de taxa. “Perfil: PID e taxas” (CLI osd_pidrate_profile_pos) escreve o perfil de PID e o perfil de taxa com um hífen, os dois contados a partir de 1: “1-3” quer dizer perfil de PID 1 e Perfil de taxa 3 (osd_elements.c, settings.c). “Perfil: nome do perfil de taxa” (osd_rate_profile_name_pos) mostra o nome do perfil de taxa ativo em maiúsculas; sem nome aparece RATE_1 a RATE_4 (osd_elements.c). Os dois são ligados na aba “OSD” do App, em “Elementos”. A janela com que o OSD confirma outros ajustes não aparece para o perfil de taxa, porque ele tem esse elemento próprio (rc_adjustments.c).

Você também pode trocar no menu do OSD: menu principal “PROFILE” e depois a linha “RATE PROF” com número e nome (cms_menu_main.c, cms_menu_imu.c). A mudança vale na hora; a documentação: “Não se esqueça de salvar com Save + Exit ou Save + Reboot.”9

Nomes de perfil e cópia

Cada perfil de taxa pode ter um nome de 1 a 8 caracteres: na CLI rateprofile_name, no App o campo “Nome do perfil de taxas” ao lado do seletor de perfil (settings.c, PidTuningTab.vue). O nome aparece no elemento do OSD e no menu do OSD ao lado do número. Para que você usa os nomes fica a seu critério; o texto de ajuda do App dá o tipo de voo como exemplo.

Copiar só funciona no App: no canto superior direito da subaba Definições do Perfil de Rate, o botão “Copiar perfil de taxa”, e depois você escolhe o perfil de destino. O diálogo avisa: “Todos os valores no perfil de destino serão substituídos”10. O firmware copia o perfil inteiro como um bloco, também o nome, o tipo de rates e a curva de throttle, de início só na memória de trabalho; depois você precisa salvar (controlrate_profile.c, msp.c, PidTuningTab.vue). Não existe comando de CLI para copiar (lista de comandos em cli.c). Na CLI, o desvio pelo diff rates ajuda: a saída começa com rateprofile N; se você mudar esse número antes de colar o texto de volta, os valores vão para o outro perfil.

Erros típicos

  • A chave não troca nada, ou só no meio. Ao ligar uma linha, o App coloca o intervalo de 1300 a 1700 (useAdjustmentsData.js). Com o mesmo canal nos dois campos, o ajuste então só fica ativo na posição do meio e ali escolhe o Perfil de taxa 2; embaixo e em cima nada acontece. Coloque o intervalo de 900 a 2100. Confira também na aba “Receptor” se a sua chave realmente fica abaixo de 1300 e acima de 1700; a documentação: “Os valores de início e fim do intervalo devem corresponder aos valores que o seu receptor envia.”11
  • Depois de ligar, o perfil errado está ativo. Com uma chave na seleção de perfil, ao iniciar só vale a posição da chave, não o perfil escolhido no App ou na CLI. Coloque a chave no perfil que você quer voar e confira o elemento do OSD.
  • O bloco CLI gravou no perfil errado. Sem a linha rateprofile, as linhas set vão para o perfil ativo. Veja com diff all qual perfil recebeu os valores e cole o bloco de novo com a linha certa.
  • O seletor de perfil no App está cinza. Há alterações não salvas na aba. “Salvar” ou “Atualizar”, e o seletor volta a funcionar.
  • O buzzer bipa cinco ou seis vezes e o perfil não muda. rate_6pos_switch está em ON e a chave está na posição 5 ou 6, para as quais não existe perfil com quatro perfis. Use as posições 1 a 4 ou coloque rate_6pos_switch = OFF.
  • Uma chave de 3 posições não alcança o Perfil de taxa 4. Isso é proposital: três posições, três perfis. Para o perfil 4 você precisa do rate_6pos_switch com uma chave de 6 posições ou um potenciômetro, do App, da CLI ou do menu do OSD.
  • O texto de ajuda do App fala em três perfis e em TPA. O texto é mais antigo que o firmware. A 2026.6.2 tem quatro perfis de taxa, e o TPA fica no perfil de PID.

O bloco CLI do fpvrates e o seu perfil de taxa

O bloco CLI que o Tuning Pass gera a partir do seu log de blackbox traz na linha 1, como comentário, o drone de destino, na linha 2 o perfil, e começa os comandos com rateprofile 2. Ou seja, ele grava no Perfil de taxa 3 do App e o ativa; os seus outros perfis ficam como estão. O save no fim grava e reinicia a controladora. Se você já usa o Perfil de taxa 3, mude a linha para um perfil livre antes de colar: rateprofile 0 para o Perfil de taxa 1 ou rateprofile 1 para o Perfil de taxa 2.

Três coisas fazem parte disso. Primeiro, o backup: antes de colar, digite diff all e salve a saída; com ela você volta a qualquer momento aos quatro perfis. Segundo, a chave: se a sua seleção de perfil está em uma chave AUX, na próxima vez que você ligar o drone vale a posição da chave, não o bloco. Coloque-a no Perfil de taxa 3, senão você voa as rates antigas sem entender por quê. O elemento do OSD “Perfil: PID e taxas” mostra o que vale. Terceiro, o log para a próxima rodada: o cabeçalho da blackbox traz as rates do perfil que estava ativo quando o log começou (blackbox.c), e o fpvrates lê as suas rates exatamente desse cabeçalho. Então não troque de perfil no meio de um voo que você quer analisar, senão cabeçalho e dados do voo não batem. Como gravar logs: Configurar e baixar o log de blackbox. Se um perfil antigo ainda tem rates Betaflight (RC Rate, Super Rate, Expo), o conversor passa essas rates para Actual Rates.

O check grátis mostra no seu próprio log se o seu perfil atual combina com o seu stick: cinco zonas de stick por eixo e o quanto a sua curva é íngreme, sem conta e sem enviar o seu log para nenhum servidor.

Fontes

Em 15 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 nesse dia) e a documentação do Betaflight (repositório em 15 de novembro de 2026):

Citações originais (em inglês) e fontes

As citações vêm da documentação do Betaflight em inglês e do código-fonte do Betaflight. No texto elas aparecem traduzidas pelo fpvrates; aqui, no original, com a fonte.

  1. “4 profiles that can be configured for Rate settings.” Documentação do Betaflight: PID Tuning Tab ↩
  2. “A Rate Profile is a set of Rate related settings. These profiles store the settings for Rate Type, RC Rate, Super Rate, Expo for Pitch, Roll, & Yaw.” Documentação do Betaflight: Profiles ↩
  3. “Betaflight 3.2 broke this link, giving us independent Profiles and Rate Profiles.” Documentação do Betaflight: Profiles ↩
  4. “The action of selecting a Rate Profile also activates that rate profile for current use.” Documentação do Betaflight: Profiles ↩
  5. “Also, when changing our Rate Profile that profile will remain the active Profile even over power cycles, except when using the AUX channel option.” Documentação do Betaflight: Profiles ↩
  6. “The Range Channel and the Adjustment Channel can be the same channel. This is useful when you want a single 3 Position switch to be dedicated to a single adjustment function regardless of other switch positions.” Documentação do Betaflight: In-Flight Adjustments ↩
  7. “When BetaFlight boots the active profile is selected by the position of the AUX channel.” Documentação do Betaflight: Profiles ↩
  8. “Currently creating a backup from the Betaflight App only backs up the active Profile and Rate Profile. So the best way to see and backup all Profiles is to use CLI.” Documentação do Betaflight: Profiles ↩
  9. “Make sure to Save + Exit or Save + Reboot to save settings.” Documentação do Betaflight: Profiles ↩
  10. “All values on the destination profile will be wiped and overwritten” Código-fonte do Betaflight: Betaflight App 2026.6.2, locales/en/messages.json (dialogCopyProfileNote) ↩
  11. “Range Start/End values should match the values sent by your receiver.” Documentação do Betaflight: In-Flight Adjustments ↩

Atualizado em: 16 de novembro de 2026 · conferido com Betaflight 2026.6.2