Pular para o conteúdo principal

Introdução ao Meshtastic

dica

A Série Wio Tracker L1 compartilha a mesma estrutura de hardware. Embora o vídeo guia seja para o L1 Pro, ele é aplicável a todos os outros produtos da série L1.

Tutorial em Vídeo​

Parte 1 Desembalagem​

Ao usar os modelos L1, L1 Lite ou L1 E-Ink pela primeira vez, após conectar à fonte de alimentação USB, levante o interruptor de energia para ligá-lo.

Parte 2 Gravação de Firmware​

note

Por favor, don't use NRF-OTA para atualizar o firmware, isso pode fazer com que o dispositivo pare de funcionar completamente.

Parte 3 Uso do Dispositivo​

Joystick de Quatro Direções​

O latest Alpha firmware do firmware L1 E-Ink atualmente oferece suporte ao joystick de quatro direções. Se você quiser usar o joystick, por favor clique aqui para atualizar o firmware.

Barra de Menu​

pir

Apenas o firmware 2.7 oferece suporte à barra de menu. Se você quiser usar a barra de menu, siga o Flash Firmware Tutorial para atualizar o firmware.

pir

Buzzer​

Se você quiser ligar ou desligar o buzzer, primeiro update the firmware para a versão 2.7. Porque apenas o firmware da versão 2.7 possui a barra de menu.

  • Ligar o buzzer Setting (ícone em forma de engrenagem) -> Notification -> Buzzer Action -> Disable
  • Desligar o buzzer Setting (ícone em forma de engrenagem) -> Notification -> Buzzer Action -> All enabled

Parte 4 Conexão com o Telefone​

Parte 5 Diferentes Estados​

Introdução​

note

Quando o dispositivo estiver nos estados abaixo, por favor não reinicie ou desligue manualmente. Caso contrário, o dispositivo pode parar de funcionar.

  1. Não concluir o processo de transmissão de mensagem
  2. Estar sendo configurado

Gravar Firmware​

note

Por favor, don't use NRF-OTA para atualizar o firmware, isso pode fazer com que o dispositivo pare de funcionar completamente.

Visite o Meshtastic Web Flasher.

Para L1, L1 Lite e L1 Pro, selecione o dispositivo de destino como Seeed Wio Tracker L1 e escolha o firmware mais recente, depois clique em Flash.

pir

pir

Para L1 E-Ink, selecione o dispositivo de destino como Seeed Wio Tracker L1 E-Ink e escolha o firmware mais recente, depois clique em Flash.

pir

pir

Ligue o dispositivo, clique em Enter DFU Mode, haverá uma porta serial chamada Tracker L1, clique e conecte-a, e deve ser exibido um driver chamado Tracker L1.

pir

Arraste o arquivo UF2 para a unidade DFU. O firmware deve ser gravado após o download do arquivo e a reinicialização do dispositivo.

Ligar o dispositivo​

Conecte o cabo USB para ativar o dispositivo. Levante o interruptor de energia para ligá-lo.

dica

Se o dispositivo não responder quando você pressionar o botão, por favor carregue-o primeiro. Não use o carregador de carregamento rápido.

Conectar via App​

  • Selecione o dispositivo de destino no painel de Bluetooth.

pir

  • Digite o código exibido na tela e clique em OK para conectar o dispositivo.

pir

Configurar o LoRa​

Para começar a se comunicar pela malha, você deve definir sua região. Essa configuração controla qual faixa de frequência seu dispositivo usa e deve ser definida de acordo com sua localização regional.

pir

Lista de Regiões

Código da RegiãoDescriçãoFaixa de Frequência (MHz)Ciclo de Trabalho (%)Limite de Potência (dBm)
UNSETNão definidoN/AN/AN/A
USEstados Unidos902.0 - 928.010030
EU_868União Europeia 868MHz869.4 - 869.651027

Consulte LoRa Region by Country para uma lista mais abrangente.

info

EU_868 deve obedecer a uma limitação de ciclo de trabalho horário de 10%, calculada a cada minuto em uma base contínua de 1 hora. Seu dispositivo irá parar de transmitir se você atingir esse limite, até que seja permitido novamente.

Agora que você definiu a região LoRa no seu dispositivo, pode continuar configurando quaisquer LoRa Configs para atender às suas necessidades.

Configuração Avançada​

Conectar via Website​

Se você quiser enviar mensagens de texto e se comunicar com outros nós no website, pode conectar o dispositivo ao Website Meshtastic agora.

Passo 1: Abra o Website

Clique aqui para ir ao website.

pir

Passo 2: Adicionar o novo dispositivo

Clique em "+ New Connection".

pir

Há duas maneiras de conectar. Você pode escolher o método de sua preferência.

Método 1: Via Bluetooth

Escolha o método bluetooth. Escolha o ID do dispositivo na janela pop-up.

pir

Método 2: Via Serial

Escolha o método serial. Abra o gerenciador de dispositivos para ver em qual porta o dispositivo está conectado. Escolha essa porta na janela pop-up.

pir

Seu dispositivo será exibido na lista. Clique para conectar. Se a conexão for bem-sucedida, você poderá ver o status do dispositivo diretamente no site.

pir

Configurar GPS​

Defina o GPS como ativado. Você pode ajustar o intervalo de atualização e o intervalo de transmissão para obter informações de localização mais atualizadas.

pir

Para IOS, ative o Accurate Location. Caso contrário, o posicionamento pode desviar.

pir

Conexão de sensor​

pir

Você pode adicionar sensor ao dispositivo por meio da interface Grove. Os seguintes sensores foram verificados como compatíveis com a interface Grove no dispositivo.

Tipo de sensorModelo de sensor
Sensor ambientalPressãoBMP085
TemperaturaMCP9808 、PCT2075
Temperatura e umidadeSHT31/SHTC3/SHT4X、AHT10
Temperatura, umidade e pressãoBME280
OutrosFrequência cardíaca e SpO₂MAX30102
Teclado I2CCardKB
  • Ative Telemetry para obter dados do sensor. Se você quiser mostrar os dados do sensor na tela OLED, ative on screen

pir

A tela OLED exibirá os dados do sensor se você ativar on screen.

pir

Conexão de tela​

  • Tela E-Ink Click here to get the compatible E-Ink screen.

pir

  • Tela OLED Click here to get the compatible OLED screen. The current OLED driver is SSD1306.

pir

Teclado virtual​

pir

O firmware da versão 2.7 agora oferece suporte a teclado virtual! Você pode digitar mensagens diretamente no dispositivo para se comunicar com outro dispositivo. Siga o Flash Firmware Tutorial para atualizar o firmware.

pir

Configurar toque​

Vá para Settings -> Ringtone Config e insira a string de toque RTTTL que você deseja usar para notificações externas.

pir

24:d=16,o=5,b=120:g,c6,d6,2g6

FAQ​

Dispositivo inutilizado e recuperação do bootloader​

Descrição:

O dispositivo não está respondendo, nenhum LED, não é possível parear com seu App. Se você achar que o dispositivo está completamente morto após gravar seu próprio firmware, você também pode tentar reinstalar o bootloader.

O bootloader é restaurado pela porta serial USB (Serial DFU) com adafruit-nrfutil.

note

Durante a gravação, mantenha a conexão do cabo estável e NÃO a desconecte — mesmo que o número da porta serial mude.

Passo 1: Preparar

  • Um dispositivo da série Wio Tracker L1 (L1 / L1 Pro)
  • Um cabo de dados USB em bom estado (não apenas para carregamento)
  • Um PC com Windows, macOS ou Linux com Python 3 e pip
  • O pacote do bootloader: Click here to download Bootloader — não extraia o ZIP; adafruit-nrfutil o utiliza como está

Passo 2: Instalar adafruit-nrfutil

Verifique se Python 3 e pip estão disponíveis (se o pip estiver ausente, execute primeiro python -m ensurepip --upgrade):

python --version
python -m pip --version

Check Python and pip on Windows

Em seguida, instale e verifique (a versão testada para este guia é 0.5.3.post16):

python -m pip install --user adafruit-nrfutil
adafruit-nrfutil version

adafruit-nrfutil version output on Windows

nota

Sempre verifique a versão com adafruit-nrfutil version. Não use adafruit-nrfutil --version.

Passo 3: Verificar a porta serial

Anote a porta serial do dispositivo — os exemplos abaixo variam conforme o PC:

Abra Device Manager → Ports (COM & LPT), por exemplo:

USB Serial Device (COM43)

Wio Tracker L1 serial port in Windows Device Manager

Passo 4: Gravar o bootloader

Substitua a porta pela que você encontrou no Passo 3:

adafruit-nrfutil --verbose dfu serial --package "wio_tracker_l1_bootloader-0.10.0_s140_7.3.0.zip" -p COM43 -b 115200 --singlebank --touch 1200

Se o ZIP não estiver na pasta atual do seu terminal, passe seu caminho completo para --package, por exemplo "C:\path\to\wio_tracker_l1_bootloader-0.10.0_s140_7.3.0.zip".

Etapa 5: Lidar com a mudança de porta serial

--touch 1200 reinicia o dispositivo em modo DFU, então a porta serial geralmente muda e o primeiro comando pode parar com um traceback como este:

Touched serial port COM43
...
FileNotFoundError: could not open port 'COM43'

Isto NÃO é uma falha — o dispositivo já entrou em modo DFU em uma NOVA porta. No PC com Windows testado, por exemplo, ele mudou de COM43 para COM45:

Porta serial DFU após nova enumeração no Gerenciador de Dispositivos do Windows

Mantenha o cabo USB conectado. Encontre a nova porta (atualize o Device Manager → Ports (COM & LPT), ou execute novamente ls /dev/cu.* / ls /dev/ttyACM*), então faça o flash novamente na nova porta SEM --touch 1200:

adafruit-nrfutil --verbose dfu serial --package "wio_tracker_l1_bootloader-0.10.0_s140_7.3.0.zip" -p COM45 -b 115200 --singlebank

Etapa 6: Confirmar o resultado

O flash foi bem-sucedido quando a saída termina com Device programmed.:

Saída do adafruit-nrfutil terminando com Device programmed

Depois disso, uma unidade UF2 aparece no seu PC (captura de tela do PC com Windows testado). Seu rótulo de volume varia conforme a compilação do bootloader — a unidade testada mostrou XIAO-BOOT — e NÃO é um critério de aprovação/reprovação; não julgue o resultado pelo nome da unidade ou por INFO_UF2.TXT:

Unidade UF2 aparece após o flash do bootloader

Etapa 7: Reinstalar o firmware de aplicação

atenção

Restaurar o bootloader NÃO reinstala o firmware de aplicação — o dispositivo ainda não tem um firmware funcional até que você o grave novamente.

Quando você tiver concluído as etapas acima, siga Flash Firmware para gravar o firmware de aplicação.

Solução de problemas

  • adafruit-nrfutil não é reconhecido após a instalação: o diretório de scripts de usuário do Python não está no seu PATH (Scripts no Windows, bin no seu diretório pessoal no macOS/Linux) — adicione-o ao PATH ou reinstale sem --user.
  • Porta ocupada / acesso negado: feche monitores seriais, abas do web flasher, Arduino IDE ou qualquer outra coisa que esteja mantendo a porta ocupada.
  • FileNotFoundError: could not open port ... após Touched serial port ...: o dispositivo entrou em modo DFU em uma nova porta — siga a Etapa 5.
  • Não é possível entrar em modo DFU: veja Unable to enter DFU & Entering DFU Mode Manually.

Recuperação DFU manual

Se --touch 1200 não conseguir colocar o dispositivo em modo DFU (por exemplo, o firmware está completamente sem resposta), entre nele manualmente: conecte o dispositivo, pressione duas vezes Reset (o LED amarelo permanece aceso), encontre a porta serial DFU como na Etapa 3 e então execute o comando da Etapa 5 nessa porta SEM --touch 1200. O sucesso é igual ao da Etapa 6.

Unable to enter DFU & Entering DFU Mode Manually​

Conecte o dispositivo ao seu PC e pressione duas vezes o botão Reset — o LED amarelo permanece aceso e uma porta serial DFU aparece no seu PC.

Para gravar o bootloader neste modo, siga Device Bricked & Bootloader Recovery, mas ignore --touch 1200 — o dispositivo já está em modo DFU.

Saindo do modo DFU​

Pressione o botão Reset uma vez para sair do modo DFU.

Incapaz de se comunicar no canal primário​

Se o dispositivo não conseguir se comunicar com nós próximos ou enviar mensagens, primeiro verifique se a região LoRa e o modem preset correspondem aos nós ao redor. Você também deve verificar se o PSK padrão foi alterado. Um PSK diferente no canal primário impedirá o dispositivo de se comunicar com outros nós nesse canal.

A maneira mais fácil de encontrar esse problema é por meio do aplicativo móvel. Abra o app, conecte-se ao dispositivo de destino e navegue até Settings -> Channels. Selecione o canal primário e verifique o valor do PSK. Se for diferente dos nós ao redor, atualize-o para o mesmo PSK e salve as configurações do canal.

Verificar o PSK do canal primário no app iOS

Solução

Se você não tiver certeza de quais configurações foram alteradas, restaure o dispositivo para as configurações padrão seguindo o guia Factory Reset. Se apenas o PSK tiver sido alterado, defina-o novamente para AQ==.

Dispositivo desliga automaticamente​

Descrição​

  • Após o dispositivo ser ligado, ele desligará ou reiniciará automaticamente depois de um tempo.
  • O log da porta serial executa por um tempo e depois para.

Isso pode ser causado por reiniciar ou desligar o dispositivo manualmente e à força quando o dispositivo está nos seguintes estados: sem terminar o processo de transmissão de mensagens, sendo configurado......

Solução de problemas​

click here para ver o vídeo. Você precisa executar um apagamento do flash e então regravar o firmware mais recente.

Factory Reset​

Se você quiser restaurar as configurações padrão, pode fazer o factory reset. Há dois métodos para você fazer o factory reset.

  • click here para ver o vídeo. Você precisa executar um apagamento do flash e então regravar o firmware mais recente.

  • Clique no botão Factory Reset no App. O dispositivo irá reiniciar automaticamente com a configuração de fábrica.

    pir

Falha em mensagem direta​

Reset do NodeDB​

NodeDB é o banco de dados local que armazena informações sobre os nós descobertos na rede Mesh atual. Se você encontrar uma situação em que não consegue se comunicar com um determinado nó, isso pode ser porque seu nodedB armazenou informações desatualizadas para esse nó. Você precisará atualizá-lo.

Abra o app e conecte-se ao dispositivo de destino. Vá para Settings->Device->Device Config->Reset NodeDB.

Configurações do dispositivo e botão Reset NodeDB no app

Trocar informações do usuário​

Cada nó enviará periodicamente suas próprias informações de nó, permitindo que outros nós na malha o "vejam" e o "reconheçam". Dois nós precisam trocar suas informações de nó entre si para poder se comunicar um com o outro. Se você não conseguir enviar ou receber mensagens privadas com outro nó na lista, pode solicitá-los manualmente a trocar informações no app.

Entrada do dispositivo em Settings

Regenerar chave privada​

Dois nós precisam conhecer sua chave privada um do outro para poder se comunicar entre si. Se um nó continuar falhando na transmissão de mensagens privadas, tente regenerar a chave privada para ele.

Entrada do dispositivo em Settings

Reinicie o dispositivo com falha para que a configuração tenha efeito.

nota

Após a regeneração da chave, outro dispositivo precisa se reconectar ao nó. Portanto, é melhor excluir o nó da lista de nós do outro dispositivo.

Qualidade do sinal​

  • SNR reflete a qualidade do link de comunicação. Um dispositivo normal geralmente opera acima de -7 dB. Um dispositivo com SNR abaixo de -10 dB indica desempenho ruim.

  • RSSI é determinado em conjunto pelo dispositivo e seu ambiente ao redor. Um dispositivo normal geralmente opera acima de -110 dBm. Um dispositivo com RSSI abaixo de -115 dBm é considerado como tendo desempenho ruim.

    Para obter o melhor efeito de sinal, use o dispositivo em uma área aberta, desobstruída e com interferência mínima.

Antena compatível​

Se você precisar de uma antena de reposição para o L1 Pro, click here para obter uma.

Recursos​

Suporte Técnico e Discussão de Produtos​

Loading Comments...