Introdução ao MeshCore

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.
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.
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á que 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 o dispositivo 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á que 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 o dispositivo NÃO será reiniciado automaticamente.
Configuração
Ligar o dispositivo
Levante o interruptor de energia para ligá-lo.
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 Meshcore APP.
![]()
Conectar via App
Clique em Connect e escolha o dispositivo de destino. O ID de dispositivo padrão é 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.
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)
- Abra o MeshCore Web App e clique no ícone Settings.
![]()
- Selecione a aba BLE e depois clique em Scan Now.
![]()
- Na janela pop-up de Bluetooth do sistema, selecione seu dispositivo (por exemplo, MeshCore-xxxxxx) e clique em Pair.
![]()
- Quando solicitado, insira a senha Bluetooth mostrada na tela do dispositivo e clique em OK. Essa senha não é
123456.
![]()
- 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 GPS, por favor ative-o.
Você pode ir ao APP em Position Settings para ativar o GPS. Ou você 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 controlar o buzzer ligando ou desligando.
![]()
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.
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 Method1 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. Você também pode 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, você também pode tentar reinstalar o bootloader.
O bootloader é restaurado pela porta serial USB (Serial DFU) com adafruit-nrfutil.
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;
adafruit-nrfutilo utiliza como está
Passo 2: Instalar o adafruit-nrfutil
- Windows
- macOS
- Linux
Verifique se o Python 3 e o pip estão disponíveis (se o pip estiver ausente, execute python -m ensurepip --upgrade primeiro):
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

python3 --version
python3 -m pip install --user adafruit-nrfutil
adafruit-nrfutil version
Se o pip estiver ausente, execute python3 -m ensurepip --upgrade primeiro.
python3 --version
python3 -m pip install --user adafruit-nrfutil
adafruit-nrfutil version
Se o pip estiver ausente, execute python3 -m ensurepip --upgrade primeiro.
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:
- Windows
- macOS
- Linux
Abra Device Manager → Ports (COM & LPT), por exemplo:
USB Serial Device (COM43)

ls /dev/cu.*
O dispositivo aparece como /dev/cu.usbmodemXXXX.
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
- macOS
- Linux
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".
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
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'
Isto NÃO é uma falha — o dispositivo já entrou em modo DFU em uma NOVA porta. No PC com Windows testado, 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*), então grave novamente na nova porta SEM --touch 1200:
- Windows
- macOS
- Linux
adafruit-nrfutil --verbose dfu serial --package "wio_tracker_l1_bootloader-0.10.0_s140_7.3.0.zip" -p COM45 -b 115200 --singlebank
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
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 testado). 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
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 Firmware Flashing para gravar o firmware de aplicação.
Solução de problemas
adafruit-nrfutilnão é reconhecido após a instalação: o diretório de scripts de usuário do Python não está no seu PATH (Scriptsno Windows,binno 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 usando a porta.
FileNotFoundError: could not open port ...apósTouched 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 DFU manual
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. Existem dois métodos para você fazer uma restauração de fábrica.
-
Flash Erase o firmware
-
Clique no botão
Factory Resetno aplicativo. 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 menor que -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 menor que -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 (pacote Serial DFU)
- (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