Glossário Meshtastic

App / Application / Client Application

Uma aplicação que se liga a um nó Meshtastic para enviar e receber mensagens através da malha.

Ver também: Client

Airtime (Time on Air)

O tempo durante o qual uma transmissão LoRa ocupa o canal. Configurações de maior alcance costumam aumentar o airtime e reduzir o débito.

APRS (Automatic Packet Reporting System)

Um sistema de dados de rádio amador que algumas comunidades interligam com o Meshtastic. Verifique a regulamentação local e as orientações da comunidade antes de o usar.

Ver também: Gateway, MQTT Bridge

Band (ISM Band)

A faixa regional de frequência para LoRa, como 915 MHz ou 868 MHz. Os dispositivos têm de operar na banda regional correta.

Bandwidth (LoRa)

Um parâmetro de rádio LoRa que afeta a taxa de dados e o alcance. Está incluído nos modem presets.

BLE (Bluetooth Low Energy)

Ligação sem fios de curto alcance normalmente usada pelas apps Meshtastic para se ligarem aos nós.

Bridge

Termo genérico para a ligação da malha a outra rede ou serviço.

Ver também: Gateway, MQTT Bridge

Broadcast

Mensagem enviada para todos os participantes do canal atual.

Channel

Agrupamento lógico que define quem pode comunicar. Inclui nome, encriptação e definições.

Channel Key

A chave de encriptação partilhada por um canal.

Ver também: PSK (Pre-Shared Key)

Client

Nó usado principalmente para mensagens de utilizador. O comportamento exato depende do role atribuído.

Ver também: Role (Device Role)

CLIENT_BASE

Modo base de cliente usado por esta comunidade para nós pessoais, de forma a preferirem rotas diretas sem consumir hops desnecessários através de nós de infraestrutura.

Nas orientações da comunidade, routers, gateways e outros nós pessoais são frequentemente marcados como favoritos para que o CLIENT_BASE possa beneficiar de comportamento zero-hop quando apropriado.

Ver também: Client, Favorites

CLI (Command Line Interface)

Interface em modo texto, normalmente via USB ou serial, usada para configurar ou interagir com um nó.

Coding Rate (CR)

Definição de correção de erros forward do LoRa que troca velocidade por robustez. Está incluída nos modem presets.

Deduplication

Lógica que evita processar ou retransmitir o mesmo pacote várias vezes.

Ver também: Rebroadcast Logic

Device

Rádio compatível com Meshtastic a executar firmware Meshtastic.

Device Role

Modo de comportamento atribuído a um nó na malha.

Ver também: Role (Device Role)

DFU (Device Firmware Update)

Modo especial usado para atualizações de firmware.

Direct Message (DM)

Comunicação ponto a ponto encriptada que usa criptografia de chave pública.

Ver também: PKC (Public Key Cryptography)

Encryption

As mensagens de canal são protegidas com uma chave pré-partilhada. As mensagens diretas podem usar criptografia de chave pública.

ESP32

Microcontrolador da Espressif usado em muitos dispositivos. Normalmente consome mais energia do que o NRF52 e pode suportar funcionalidades Wi-Fi.

EUI / EIRP

Conceitos regulatórios e de potência que podem surgir em contextos de conformidade. Deve seguir sempre as regras regionais e as orientações de onboarding.

FAQ

Conjunto de respostas para dúvidas e práticas comuns da comunidade.

Favorites

Lista de nós preferidos na app Meshtastic. Nesta configuração comunitária, é normalmente usada para marcar routers, gateways e nós pessoais, para que os dispositivos cliente evitem gastar hops desnecessários.

Ver também: CLIENT_BASE

FEC (Forward Error Correction)

Outro nome para a definição de coding rate.

Ver também: Coding Rate (CR)

Firmware

Software de baixo nível que corre no microcontrolador de um nó.

Flash / Flashing

Instalação ou atualização do firmware num dispositivo.

Freq51

Coordenação comunitária em torno de implementações estáveis, definições recomendadas e onboarding para uma malha saudável.

Gateway

Nó que liga a malha a sistemas externos, muitas vezes via MQTT. Exige configuração cuidadosa para evitar loops e flood.

GPIO (General Purpose Input/Output)

Pinos digitais que podem ser usados para sensores, botões e outras integrações de hardware.

GPS

Global Positioning System. Os nós podem reportar a sua posição como telemetria.

Hop

Um salto através de outro nó.

Hop Limit

Número máximo de saltos que um pacote pode fazer. Ajuda a controlar a congestão e o uso de airtime.

Hidden Client

Role de cliente que participa sem aparecer de forma destacada em listas ou interfaces.

Ver também: Role (Device Role)

ID (Node ID / Long Name / Short Name)

Identificadores usados para reconhecer um nó na malha e nas interfaces.

Interval (Telemetry / Position)

Frequência com que a telemetria ou a posição são enviadas. Deve equilibrar visibilidade e uso de airtime.

Key (Channel Key)

A chave de encriptação partilhada por todos os nós de um canal.

Ver também: PSK (Pre-Shared Key)

LoRa

Tecnologia de rádio de baixo consumo e longo alcance usada pelo Meshtastic.

LoS (Line of Sight)

Percurso rádio desobstruído através do ar. A melhor qualidade de ligação normalmente exige linha de vista.

Lost and Found

Role especial usado em cenários de recuperação ou identificação.

Ver também: Role (Device Role)

Mesh Network

Rede descentralizada em que os nós podem encaminhar mensagens uns dos outros.

Modem Preset

Conjunto predefinido de parâmetros LoRa, como bandwidth, spreading factor e coding rate. Todos os nós que comunicam entre si têm de coincidir.

• SHORT_TURBO - Maior largura de banda e menor alcance.
• SHORT_FAST - Alta velocidade e curto alcance.
• SHORT_SLOW - Alcance moderado com velocidade relativamente alta.
• MEDIUM_FAST - Equilíbrio entre velocidade e alcance.
• MEDIUM_SLOW - Mais alcance e menos velocidade.
• LONG_FAST - Escolha por defeito com longo alcance e velocidade razoável.
• LONG_MODERATE - Mais alcance e airtime, mais lento do que LONG_FAST.
• LONG_SLOW - Orçamento de ligação muito alto e débito muito baixo.
• VERY_LONG_SLOW - Opção mais lenta, muito grande alcance e alto airtime.

Como base comunitária geral, LONG_FAST é a escolha mais segura, a menos que a malha coordene outra configuração.

MQTT / MQTT Bridge

Protocolo e bridge normalmente usados para ligar a malha a servidores ou serviços. Tópicos, filtros e lógica de retransmissão têm de ser configurados com cuidado para evitar loops.

Node

Dispositivo na malha que pode enviar, receber e retransmitir mensagens.

NRF52

Microcontrolador da Nordic usado em muitos dispositivos Meshtastic de baixo consumo.

OTA (Over-the-Air)

Capacidade de atualização de firmware sem fios, dependendo do dispositivo e da plataforma.

Packet

Unidade de dados enviada pela malha.

PKC (Public Key Cryptography)

Criptografia de chaves pública e privada usada em mensagens diretas ponto a ponto.

Preset

Nome abreviado para uma configuração de rádio agrupada.

Ver também: Modem Preset

Protobuf

Formato de serialização da Google usado pelos protocolos do Meshtastic.

PSK (Pre-Shared Key)

Chave de encriptação do canal. Todos os nós no mesmo canal precisam da mesma PSK para trocar mensagens.

Quiet Client (Muted Client)

Variante de cliente com rebroadcast ou chat limitados para ajudar a conservar airtime.

Ver também: Role (Device Role)

Rebroadcast

Retransmissão de um pacote recebido. O comportamento é controlado para minimizar duplicados e loops.

Ver também: Rebroadcast Logic

Rebroadcast Logic

Regras e filtros que decidem se e como as mensagens são retransmitidas, incluindo deduplicação. É crítica quando se usam bridges como MQTT.

Region

Domínio regulatório que determina as bandas de frequência e níveis de potência permitidos.

Ver também: Band (ISM Band)

Repeater

Nó de extensão de cobertura que não aparece na lista padrão de nós.

Role (Device Role)

Modo de comportamento de um nó na malha.

• CLIENT - Nó de utilizador padrão para enviar e receber mensagens.
• CLIENT_MUTE - Cliente com chat e rebroadcast reduzidos para conservar airtime.
• CLIENT_HIDDEN - Cliente que participa sem aparecer de forma destacada em listas ou interfaces.
• TRACKER - Role focado em reporte de posição com chat mínimo.
• LOST_AND_FOUND - Modo especial para cenários de recuperação e identificação.
• SENSOR - Publica telemetria de sensores ou do sistema.
• TAK - Integra funcionalidades do Team Awareness Kit.
• TAK_TRACKER - Role focado em tracking com TAK para reporte de posição.
• REPEATER - Estende cobertura e não aparece nas listas padrão de nós.
• ROUTER - Estende cobertura e aparece nas listas de nós.
• ROUTER_LATE - Variante de router afinada para retransmissões tardias ou atrasadas.

Router

Nó de extensão de cobertura visível nas listas padrão de nós.

ROUTER_LATE

Variante de role router afinada para retransmissão tardia ou atrasada.

Ver também: Role (Device Role)

rp2040

Microcontrolador Raspberry Pi usado em algumas boards Meshtastic.

RSSI (Received Signal Strength Indicator)

Medição da potência do sinal recebido.

RX (Receive)

Receção de dados no rádio.

Sensor

Role de nó ou função de dispositivo que publica dados ambientais ou do sistema como telemetria.

Serial

Ligação USB ou UART usada para acesso CLI e flashing de firmware.

SNR (Signal-to-Noise Ratio)

Medição da clareza do sinal em relação ao ruído de fundo.

Spreading Factor (SF)

Parâmetro LoRa que controla o comprimento do chirp. Valores mais altos aumentam alcance e airtime e reduzem a taxa de dados.

SWR (Standing Wave Ratio)

Medição RF da qualidade de adaptação entre antena e linha de alimentação.

TAK / TAK Tracker

Roles que suportam integrações Team Awareness Kit, normalmente focados em reporte de posição com chat limitado.

Telemetry

Transmissão periódica de métricas de sensores, GPS ou sistema a partir de um nó.

TX (Transmit)

Envio de dados pelo rádio.

UART

Interface serial de hardware usada para logs, acesso CLI e debugging.

Uplink / Downlink

Termos direcionais usados em gateways e bridges. Uplink normalmente significa malha para servidor, enquanto downlink significa servidor para malha.

VERY_LONG_SLOW

O modem preset padrão mais lento, pensado para alcance máximo à custa de alto airtime.

Ver também: Modem Preset

Voltage (Battery Voltage)

Métrica de telemetria que muitos nós anunciam para indicar o estado de alimentação.

Web UI

Página web local de configuração ou estado exposta por alguns dispositivos ou builds de firmware.

Wi-Fi

Em dispositivos ESP32 compatíveis, o Wi-Fi pode ser usado para funcionalidades como MQTT bridge ou Web UI.