‹ Voltar para a comunidade

Guia Completo: Configurações de Papel (Role) no Meshtastic

meshtastic-node-forest.jpg

Quando você conecta seu primeiro nó Meshtastic e começa a explorar as configurações, uma das primeiras dúvidas que aparece é: qual role (papel) devo escolher para o meu dispositivo?

A resposta curta é: depende do que você quer que o nó faça na rede. A resposta longa é este artigo.

Por que os roles existem?

Em uma rede mesh, nem todos os nós precisam fazer a mesma coisa. Imagine uma rede municipal com 50 nós espalhados por bairros diferentes. Se todos os nós tentarem retransmitir todas as mensagens, o tráfego vai colidir, o airtime (tempo de uso do canal de rádio) vai saturar, e a rede inteira vai degradar.

Os roles resolvem esse problema definindo o comportamento de cada nó: alguns retransmitem tudo, outros só ouvem, outros priorizam GPS, outros focam em telemetria. A escolha corta do role é o que permite que a rede escale de 2 nós em casa para centenas espalhados por uma cidade.

Onde encontrar essa configuração

No aplicativo do Meshtastic (Android, iOS ou Web):

Configurações (Settings) > Configuração do Rádio (Radio Configuration) > Dispositivo (Device) > Papel (Role)

Agora vamos detalhar cada um dos roles disponíveis.

CLIENT - O padrão

O CLIENT é o role padrão. É o que vem de fábrica em praticamente todo dispositivo Meshtastic.

O que faz: Funciona como um dispositivo de comunicação normal. O usuário se conecta via app para enviar e receber mensagens. Quando recebe um pacote que nenhum outro nó retransmitiu, ele retransmite para ajudar a propagar a rede.

Comportamento de retransmissão: Retransmite pacotes, mas cancela a retransmissão se ouvir outro nó fazendo isso primeiro. Isso evita retransmissões redundantes.

Consumo de energia: Regular. Pode usar power saving se ativado (em placas ESP32).

Quando usar: Para o usuário comum. Seu nó de bolso, seu nó de mesa conectado ao celular, a maioria dos nós da sua rede. É o ponto de partida - se você não tem um motivo específico para mudar, mantenha como CLIENT.

CLIENT_MUTE - O que fica calado

O que faz: Igual ao CLIENT, mas não retransmite nenhum pacote de outros nós. Participa da rede apenas com suas próprias mensagens.

Comportamento de retransmissão: Nenhum. Não retransmite nada.

Consumo de energia: O mais baixo entre os roles que mantêm conectividade com o app.

Quando usar:

  • Em ambientes densos onde muitos nós já estão retransmitindo e o seu não precisa ajudar
  • Quando você tem vários nós próximos de casa e quer que apenas um faça o trabalho de retransmissão
  • Para reduzir o tráfego desnecessário na rede
  • Em nós móveis que só precisam enviar e receber suas próprias mensagens

CLIENT_HIDDEN - Stealth

O que faz: Similar ao CLIENT, mas transmite apenas o necessário. Reduz drasticamente os broadcasts periódicos de NodeInfo e outras informações de presença.

Comportamento de retransmissão: Apenas local. Não retransmite pacotes de outras redes Meshtastic próximas que usem canais e chaves diferentes das suas.

O que isso significa? Uma rede Meshtastic é definida pelos seus canais e chaves (PSK). Se houver outra rede Meshtastic operando na mesma frequência de rádio na sua área (por exemplo, um vizinho com sua própria rede e chaves diferentes), o seu nó vai ouvir esses pacotes mas não vai conseguir descriptografá-los. O CLIENT_HIDDEN simplesmente ignora esses pacotes - ele só retransmite o tráfego dos seus próprios canais.

Visibilidade: Não aparece na lista de nós de outros dispositivos.

Quando usar:

  • Quando você quer participar da rede sem chamar atenção
  • Para economizar bateria em nós que não precisam ser vistos
  • Em deployments discretos ou de segurança

CLIENT_BASE - Estação-base pessoal

O que faz: É uma estação-base pessoal. Sempre retransmite pacotes de ou para os nós marcados como favoritos. Para todos os outros pacotes, comporta-se como um CLIENT normal.

Comportamento de retransmissão: Prioriza rota para nós favoritos. Marque seus outros nós como favoritos a partir do CLIENT_BASE para que ele sempre retransmita o tráfego deles.

Quando usar:

  • Nó posicionado no telhado ou sótão com antena superior
  • Nó que serve como ponto central para seus dispositivos mais fracos (indoor, antena pequena)
  • Para dar um "boost" na distribuição de mensagens dos seus próprios nós

Este role é diferente de um ROUTER. O ROUTER retransmite tudo para todos. O CLIENT_BASE retransmite prioritariamente o tráfego dos seus nós favoritos, sendo muito mais eficiente para o uso pessoal.

TRACKER - Rastreador GPS

O que faz: Prioriza o envio de pacotes de posição GPS. Quando combinado com power saving (em ESP32 ou NRF52), o dispositivo dorme entre transmissões de posição e acorda apenas para enviar a localização.

Comportamento de retransmissão: Retransmite normalmente quando acordado, mas não retransmite enquanto dorme entre intervalos de transmissão.

Tela: Desabilitada por padrão.

Quando usar:

  • Rastreamento de veículos
  • Rastreamento de ativos
  • Monitoramento de posição em expedições ou eventos

⚠️ Não é recomendado para rastrear animais de estimação em florestas - o sinal LoRa é muito instável nesse cenário, especialmente com o nó a poucos centímetros do chão.

SENSOR - Coleta de dados

O que faz: Prioriza o envio de pacotes de telemetria (temperatura, umidade, tensão da bateria, etc.). Combinado com power saving, dorme entre leituras e acorda apenas para coletar e enviar dados dos sensores.

Comportamento de retransmissão: Igual ao TRACKER - retransmite quando acordado, não retransmite enquanto dorme.

Tela: Desabilitada por padrão.

Quando usar:

  • Estações meteorológicas remotas
  • Monitoramento ambiental
  • Coleta de dados agrícolas
  • Qualquer cenário onde o nó precisa apenas reportar dados de sensores periodicamente

LOSTANDFOUND - Recuperação de dispositivos

O que faz: Transmite sua localização regularmente como mensagem no canal padrão, para ajudar na recuperação do dispositivo em caso de perda.

Quando usar:

  • Quando você perdeu um nó e quer localizá-lo
  • Em nós de alto valor que podem ser perdidos em campo

Na prática, este role consome bastante airtime porque está sempre transmitindo. Use com moderação.

TAK - Integração com ATAK

O que faz: Otimizado para comunicação com o sistema ATAK (Android Team Awareness Kit). Reduz broadcasts rotineiros para priorizar o tráfego ATAK via Plugin do Meshtastic.

Quando usar: Exclusivamente quando você está usando o ATAK com o Meshtastic ATAK Plugin para operações táticas ou coordenadas.

TAK_TRACKER - ATAK + GPS standalone

O que faz: Combina a otimização do TAK com transmissão automática de PLI (Position Location Information) para o ATAK, sem precisar de um celular conectado.

Quando usar: Nós standalone (sem app conectado) que precisam enviar posição para o ATAK automaticamente.

ROUTER - Infraestrutura principal

O que faz: Nó de infraestrutura. Sempre retransmite pacotes uma vez. Pensado para ser posicionado em locais estratégicos e elevados para maximizar a cobertura da rede.

Comportamento de retransmissão: Sempre retransmite (rebroadcast obrigatório). Usa a "janela de contenção antecipada" (early contention window), ou seja, retransmite antes dos nós CLIENT, dando prioridade à infraestrutura.

Visibilidade: Aparece na lista de nós e na topologia da rede.

Tela e conectividade: Tela desabilitada. Bluetooth desabilitado em ESP32 (porque power saving é ativado automaticamente e não pode ser desativado).

⚠️ Para atualizar um ROUTER via BLE, é recomendado usar um canal admin para mudar temporariamente o role, atualizar, e depois reverter.

Quando usar:

  • Nó fixo em local elevado (torre, prédio alto, morro)
  • Quando você quer estender a cobertura da rede para uma área ampla
  • Em redes maiores que precisam de pontos de relay confiáveis

⚠️ Não use ROUTER em nós móveis ou em áreas onde já existem muitos routers próximos. Routers próximos demais causam colisões de pacotes e degradam a rede.

ROUTER_LATE - Infraestrutura polida

O que faz: Semelhante ao ROUTER, mas retransmite na "janela de contenção tardia" (late contention window). Isso significa que ele dá prioridade a todos os outros nós antes de retransmitir.

Como funciona na prática: Se um ROUTER_LATE ouve outro nó retransmitindo o pacote antes dele (em qualquer janela), ele adia sua retransmissão para a janela final. Se na janela final ele ainda não ouviu ninguém retransmitir, ele faz a retransmissão.

Visibilidade: Aparece na lista de nós e na topologia.

Quando usar:

  • Em locais que precisam de cobertura adicional, mas que não são pontos altos ideais para um ROUTER
  • Para servir um cluster de nós que está em uma área bloqueada (outro lado de uma colina, fundo de um vale)
  • Quando você quer adicionar redundância sem atrapalhar o comportamento normal da rede

O artigo oficial "Demystifying ROUTER_LATE" do blog do Meshtastic explica em detalhes como este role funciona.

REPEATER - Relay puro

O que faz: Semelhante ao ROUTER, mas ainda mais focado. Sempre retransmite pacotes uma vez com mínimo overhead. Não aparece na lista de nós nem na topologia da rede.

Comportamento de retransmissão: Sempre retransmite, usando a janela antecipada como o ROUTER.

Visibilidade: Não aparece na lista de nós. É "invisível" para os usuários da rede.

Quando usar:

  • Quando você quer estender a cobertura sem adicionar "ruído" à lista de nós
  • Em deployments de infraestrutura onde a transparência é importante
  • Como relay intermediário entre dois pontos distantes

Quadro comparativo rápido

Aqui está um resumo para consulta rápida:

CLIENT

  • Tela: Sim
  • Retransmissão: Sim (cancela se outro nó fizer primeiro)
  • Melhor uso: Uso geral, nó de bolso

CLIENT_MUTE

  • Tela: Sim
  • Retransmissão: Não
  • Melhor uso: Reduzir tráfego em redes densas

CLIENT_HIDDEN

  • Tela: Sim
  • Retransmissão: Apenas local
  • Melhor uso: Discrição, economia de energia

CLIENT_BASE

  • Tela: Sim
  • Retransmissão: Prioriza favoritos
  • Melhor uso: Estação-base pessoal (telhado/sótão)

TRACKER

  • Tela: Não
  • Retransmissão: Quando acordado
  • Melhor uso: Rastreamento GPS

SENSOR

  • Tela: Não
  • Retransmissão: Quando acordado
  • Melhor uso: Coleta de telemetria

LOSTANDFOUND

  • Tela: Não
  • Retransmissão: Sim
  • Melhor uso: Recuperar dispositivo perdido

TAK

  • Tela: Opcional
  • Retransmissão: Sim
  • Melhor uso: Integração com ATAK

TAK_TRACKER

  • Tela: Opcional
  • Retransmissão: Sim
  • Melhor uso: ATAK com PLI automático

ROUTER

  • Tela: Não
  • Retransmissão: Sempre (janela antecipada)
  • Melhor uso: Infraestrutura em local elevado

ROUTER_LATE

  • Tela: Sim
  • Retransmissão: Sempre (janela tardia)
  • Melhor uso: Cobertura de áreas bloqueadas

REPEATER

  • Tela: Não
  • Retransmissão: Sempre (janela antecipada)
  • Melhor uso: Relay invisível, estender cobertura

Dicas práticas

Comece com CLIENT. Sempre. A menos que você tenha um motivo muito específico, o CLIENT é a escolha certa para a maioria dos nós.

Não vicie em routers. A tentação de colocar ROUTER em todo nó fixo é real, mas é um erro. Routers demais próximos uns dos outros causam colisões e degradam a rede inteira. Um bom ROUTER bem posicionado vale mais que cinco mal posicionados.

Use CLIENTBASE no nó do telhado. Se você tem um nó fixo em casa com antena melhor, marque seus outros nós como favoritos e use CLIENTBASE. O resultado é melhor que ROUTER para uso pessoal.

TRACKER e SENSOR para nós solares. Se você tem um nó solar remoto que só precisa reportar posição ou telemetria, use TRACKER ou SENSOR com power saving. A bateria vai durar muito mais.

ROUTERLATE para áreas difíceis. Se um grupo de nós está atrás de uma obstrução e o seu ROUTER principal não os alcança bem, um ROUTERLATE na área pode resolver sem prejudicar o resto da rede.

Referências