Introdução ao MeshCore

Adquira agora 🖱️

Gravação de firmware

Método 1 via Web Flasher

Conecte seu dispositivo ao computador com um cabo USB. Certifique-se de que o cabo suporta transmissão de dados.

atenção

Mantenha o cabo USB conectado durante a transmissão de dados, caso contrário o dispositivo pode ser danificado.

Acesse o Meshcore Web Flasher.

Escolha Seeed Studio Wio Tracker L1 Pro no grupo Community Firmware.

Escolha Companion Bluetooth. Dispositivos gravados com o firmware Companion Bluetooth podem ser conectados ao APP. Se você quiser gravar outro firmware, por favor clique aqui para ver o tutorial.

Apagar Flash

Clique em Enter DFU Mode, escolha a porta serial chamada "L1 Pro" ou "TinyUSB serial". Em seguida, clique em Erase Flash e escolha a porta serial.

Se você clicou em Erase Flash mas não houve resposta, clique em Enter DFU novamente e depois clique em Erase Flash para garantir que entrou no modo DFU com sucesso.

Se você vir "Flashing erase firmware:100%", o dispositivo foi apagado com sucesso.

Gravar firmware

Clique em Enter DFU Mode, escolha a porta serial chamada "L1 Pro" ou "TinyUSB" serial. Em seguida, clique em Flash e escolha a porta serial.

Se você clicou em Flash mas não houve resposta, clique em Enter DFU novamente e depois clique em Flash para garantir que entrou no modo DFU com sucesso.

Quando a barra de progresso estiver completamente preenchida, isso indica que a gravação foi concluída. Em seguida, o dispositivo será reiniciado automaticamente.

Método 2 Arrastar e soltar

Conecte seu dispositivo ao computador com um cabo USB. Certifique-se de que o cabo suporta transmissão de dados.

atenção

Mantenha o cabo USB conectado durante a transmissão de dados, caso contrário o dispositivo pode ser danificado.

Acesse o Meshcore Web Flasher.

Escolha Seeed Studio Wio Tracker L1 Pro no grupo Community Firmware.

Escolha Companion Bluetooth. Dispositivos gravados com o firmware Companion Bluetooth podem ser conectados ao APP. Se você quiser gravar outro firmware, por favor clique aqui para ver o tutorial.

Apagar Flash

Baixe o arquivo UF2.

Clique duas vezes no botão RST para entrar manualmente no modo DFU. Você verá um disco chamado TRACKER L1 aparecer após 10~15 s.

Arraste o arquivo UF2 baixado para o disco que apareceu.

O disco desaparecerá após o firmware ser gravado com sucesso. Neste momento não há firmware no dispositivo, portanto ele NÃO será reiniciado automaticamente.

Gravar firmware

Escolha a versão mais recente do firmware.

Baixe o arquivo UF2.

Clique duas vezes no botão RST para entrar manualmente no modo DFU. Você verá um disco chamado TRACKER L1 aparecer após 10~15 s.

Arraste o arquivo UF2 baixado para o disco que apareceu.

O disco desaparecerá após o firmware ser gravado com sucesso. Neste momento não há firmware no dispositivo, portanto ele NÃO será reiniciado automaticamente.

Configuração

Ligar o dispositivo

Empurre a chave de energia para cima 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.

Obter o APP

Baixe pela Google Store ou Apple Store. Ou clique aqui para obter o APP Meshcore.

Conectar via App

Clique em Connect e escolha o dispositivo de destino. O ID padrão do dispositivo é Meshcore-MAC Address. O endereço MAC pode ser visto na etiqueta na parte inferior do dispositivo.

Digite o código PIN mostrado na tela do dispositivo e depois clique em Pair para conectar o dispositivo.

dica

Se a conexão falhar, abra a lista de Bluetooth do seu telefone e forget ou Unpair o dispositivo. Em seguida, tente conectar novamente.

Conectar via interface web (BLE)

1. Abra o MeshCore Web App e clique no ícone Settings.

2. Selecione a aba BLE e clique em Scan Now.

3. Na janela pop-up de Bluetooth do sistema, selecione seu dispositivo (por exemplo, MeshCore-xxxxxx) e clique em Pair.

4. Quando solicitado, insira a chave de acesso Bluetooth mostrada na tela do dispositivo e clique em OK. Esta chave não é 123456.

5. Aguarde até que o status mude para conectado e seu nó apareça na interface do MeshCore.

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.

Em seguida, reinicie o dispositivo, caso contrário a configuração não terá efeito.

Lista de regiões

Region Code	Description	Frequency Range (MHz)	Duty Cycle (%)	Power Limit (dBm)
UNSET	Unset	N/A	N/A	N/A
US	United States	902.0 - 928.0	100	30
EU_868	European Union 868 MHz	869.4 - 869.65	10	27

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

Configurar GPS

Se você quiser usar o GPS, por favor ative-o.

Você pode ir ao APP Position Settings para ativar o GPS. Ou pode ir à página de GPS do dispositivo e pressionar o joystick de quatro direções para ligar ou desligar o GPS.

Configurar o buzzer

Clique no botão User quatro vezes para ligar ou desligar o buzzer.

Configurar sensor

O Wio Tracker L1 é enviado com o firmware MeshCore 1.12 pré-instalado. O suporte a sensores Grove por meio do conector Grove integrado foi adicionado no firmware 1.13; a versão mais recente é 1.16.

nota

Sensores Grove exigem firmware 1.13 ou posterior. Se o seu dispositivo ainda estiver executando a versão de fábrica 1.12, siga o Método1 via Web Flasher e selecione a versão mais recente.

A partir da versão 1.13, isso possibilita a integração direta de sensores ambientais — temperatura, umidade, qualidade do ar e mais — por meio do conector Grove integrado do L1, sem qualquer soldagem ou hardware adicional. Conecte um sensor Grove compatível ao conector e ele será reconhecido automaticamente.

Transmissão de mensagens

Se você tiver dois dispositivos compatíveis, e não houver muitos usuários MeshCore perto de você, grave o firmware BLE Companion em ambos para que você possa usar seus dispositivos para se comunicar com amigos e familiares próximos.

Anúncio

MeshCore permite que você transmita manualmente seu nome, posição e chave pública de criptografia, que também é assinada para evitar falsificação. Quando você clica no botão de anúncio, ele transmite esses dados via LoRa. MeshCore chama isso de Advert. Há duas maneiras de anunciar, "zero hop" e "flood".

• Zero hop significa que seu anúncio é transmitido para qualquer pessoa que possa ouvi-lo, e só isso.
• Flooded significa que ele é transmitido e depois repetido por todos os repetidores que o ouvirem.

Você pode enviar anúncios no APP. Também é possível enviar anúncios diretamente na página de anúncio do dispositivo.

Mensagem pública

Depois de configurar o LoRa, você pode enviar mensagens no canal primário. Todas as pessoas próximas na mesma faixa de frequência irão ouvi-las.

Mensagem privada

Os dois dispositivos só estabelecem uma conexão quando ambos tiverem recebido o anúncio um do outro.

FAQ

Dispositivo brickado e recuperação do bootloader

Descrição:

O dispositivo não responde, nenhum LED, não é possível parear com o seu app. Se você achar que o dispositivo está completamente morto após gravar seu próprio firmware, 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 o 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: Clique aqui para baixar o Bootloader — NÃO extraia o ZIP; o adafruit-nrfutil o usa como está

Passo 2: Instalar o adafruit-nrfutil

Windows

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

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

macOS

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

Se o pip estiver ausente, execute primeiro python3 -m ensurepip --upgrade.

Linux

Instale o adafruit-nrfutil com pipx:

sudo apt install pipx
pipx install adafruit-nrfutil
pipx ensurepath

No Fedora, use sudo dnf install pipx em vez de apt. Reabra o terminal e então verifique:

adafruit-nrfutil version

nota

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

Passo 3: Verificar a porta serial

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

Windows

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

USB Serial Device (COM43)

macOS

ls /dev/cu.*

O dispositivo aparece como /dev/cu.usbmodemXXXX.

Linux

ls /dev/ttyACM*

O dispositivo geralmente aparece como /dev/ttyACM0; se nada for listado, tente também ls /dev/ttyUSB*.

Passo 4: Gravar o bootloader

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

Windows

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".

macOS

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

Linux

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

Passo 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'

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

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

Windows

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

macOS

adafruit-nrfutil --verbose dfu serial --package "wio_tracker_l1_bootloader-0.10.0_s140_7.3.0.zip" -p /dev/cu.usbmodemXXXX -b 115200 --singlebank

Linux

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

Passo 6: Confirmar o resultado

A gravação foi bem-sucedida quando a saída termina com Device programmed.:

Depois disso, uma unidade UF2 aparece no seu PC (captura de tela do PC com Windows usado para teste). Seu rótulo de volume varia conforme a compilação do bootloader — a unidade testada mostrava 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:

Passo 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 os passos acima, siga Firmware Flashing 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 web flasher, Arduino IDE ou qualquer outra coisa que esteja usando a porta.
• FileNotFoundError: could not open port ... após Touched serial port ...: o dispositivo entrou em modo DFU em uma nova porta — siga o Passo 5.
• Não é possível entrar em modo DFU: veja Unable to enter DFU & Entering DFU Mode Manually.

Recuperação manual via DFU

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

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

Conecte o dispositivo ao seu PC e pressione o botão Reset duas vezes — 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á no modo DFU.

Saindo do modo DFU

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

Dispositivo desliga automaticamente

Descrição

• Depois que o dispositivo é ligado, ele desligará ou reiniciará automaticamente após algum 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 concluir o processo de transmissão de mensagens, sendo configurado......

Solução de problemas

Flash Erase o firmware

Restauração de fábrica

Se você quiser restaurar as configurações padrão, pode fazer a restauração de fábrica. Há dois métodos para você fazer uma restauração de fábrica.

• Flash Erase o firmware

• Clique no botão Factory Reset no app. O dispositivo será reiniciado automaticamente com a configuração de fábrica.

  

Qualidade do sinal

• SNR reflete a qualidade do link de comunicação. Dispositivos normais geralmente operam acima de -7 dB. Um dispositivo com SNR abaixo de -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 abaixo de -115 dBm é considerado como tendo baixo desempenho.

  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 substituir a antena do L1 Pro, clique aqui para obter uma.

Recursos

• Bootloader (Serial DFU package)
• (V1) arquivo de referência para impressão 3D
• (V2 Novo joystick de quatro direções) arquivo de referência para impressão 3D
• Desafio de design de gabinete L1
• Arquivo de contorno
• Certificação TELEC
• Certificação FCC
• Certificação CE
• Teste de consumo de energia e cálculo da vida útil da bateria

Suporte técnico e discussão sobre o produto