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 tutorial 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 nem desligue manualmente. Caso contrário, o dispositivo pode parar de funcionar.

  1. Não tiver concluído o processo de transmissão de mensagem
  2. Estiver 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, aparecerá uma porta serial chamada Tracker L1, clique e conecte-a, e deverá ser exibida uma unidade chamada 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 carregador de carga rápida.

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 ajustada 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 com base em uma janela contínua de 1 hora. Seu dispositivo vai 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 pelo website, pode conectar o dispositivo ao Website Meshtastic agora.

Passo 1: Abra o Website

Click here 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 que preferir.

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

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

pir

Conexão de tela​

  • Tela E-Ink Click here para obter a tela E-Ink compatível.

pir

  • Tela OLED Click here para obter a tela OLED compatível. O driver OLED atual é 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, em seguida, 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 de 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; o adafruit-nrfutil o utiliza como está

Passo 2: Instalar adafruit-nrfutil

Verifique se o Python 3 e o 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

Etapa 4: Gravar o bootloader

Substitua a porta pela que você encontrou na Etapa 3:

Feche qualquer monitor serial ou gravador via navegador conectado ao dispositivo. Se você já entrou no modo DFU pressionando duas vezes Reset, use a porta DFU atual e omita --touch 1200 dos comandos abaixo.

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 o 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 solicita o modo DFU abrindo e fechando a porta serial a 1200 baud. O sistema operacional pode então atribuir uma porta diferente, e o primeiro comando pode parar com um traceback como este:

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

Verifique se uma nova porta DFU apareceu antes de tentar novamente. Esse erro por si só não confirma que o dispositivo entrou no modo DFU ou que o bootloader foi gravado com sucesso. No PC com Windows testado, a porta 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 Device Manager → Ports (COM & LPT), ou execute novamente ls /dev/cu.* / ls /dev/ttyACM*), então grave 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

A gravação foi bem-sucedida 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 gravação 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 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: adicione o diretório de scripts de usuário do Python ao seu PATH (Scripts no Windows, bin no seu diretório pessoal no macOS); no Linux, reabra o terminal após pipx ensurepath.
  • Porta ocupada / acesso negado: feche monitores seriais, abas do gravador web, Arduino IDE ou qualquer outra coisa que esteja usando a porta. No Linux, verifique também as permissões da porta serial e a associação de grupo conforme descrito na Etapa 3.
  • FileNotFoundError: could not open port ... após Touched serial port ...: verifique se uma nova porta DFU apareceu e siga a Etapa 5. Se nenhuma porta DFU aparecer, tente a recuperação manual de DFU abaixo.
  • Não é possível entrar no modo DFU: veja Unable to enter DFU & Entering DFU Mode Manually.

Recuperação manual de DFU

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.

Não é possível entrar em DFU e Entrando no modo DFU manualmente​

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.

Não é possível 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 preset do modem 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 de 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 ligar, ele desliga ou reinicia automaticamente depois de um tempo.
  • O log da porta serial roda por um tempo e depois para.

Isso pode ser causado por reiniciar ou desligar o dispositivo manualmente e à força quando ele 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 da flash e então gravar novamente 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 da flash e então gravar novamente o firmware mais recente.

  • Clique no botão Factory Reset no App. O dispositivo será reiniciado 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 de 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​

Cada nó possui um par de chaves pública/privada. Para trocar uma mensagem privada criptografada, o remetente a criptografa com a chave pública do destinatário, e somente a chave privada desse destinatário pode descriptografá-la. Dois nós podem, portanto, se comunicar de forma privada assim que souberem a chave pública um do outro. Se um nó continuar falhando na transmissão de mensagens privadas, tente regenerar sua chave privada. Após a regeneração, exclua esse nó das listas de nós dos outros dispositivos para que eles possam se reconectar e obter sua nova chave pública.

Device entry in Settings

Reinicie o dispositivo com falha para que a função de configuração entre em vigor.

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 inferior a -10 dB indica baixo desempenho.

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

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

Antena compatível​

Se você precisar substituir a antena do L1 Pro, clique aqui para obter uma.

Recursos​

Suporte técnico e discussão sobre o produto​

Loading Comments...