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 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á 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

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

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 senha Bluetooth mostrada na tela do dispositivo e clique em OK. Esta senha 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. Esta configuração controla qual faixa de frequência seu dispositivo usa e deve ser definida 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

Código da região	Descrição	Faixa de frequência (MHz)	Duty Cycle (%)	Limite de potência (dBm)
UNSET	Não definido	N/A	N/A	N/A
US	Estados Unidos	902.0 - 928.0	100	30
EU_868	União Europeia 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 em Position Settings no APP 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 três 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.

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

Falha na atualização de firmware / Recuperação OTA

Se o seu Wio Tracker L1 ficar sem resposta após uma atualização de firmware, tente o seguinte:

1. Conecte o dispositivo ao computador usando um cabo de dados USB e pressione duas vezes o botão Reset para entrar no modo DFU manualmente.
2. Se a unidade UF2 aparecer, siga o guia de Gravação de firmware para reinstalar o firmware de aplicativo apropriado.
3. Se o dispositivo ainda não puder ser recuperado e uma porta serial DFU estiver disponível, siga Dispositivo brickado e recuperação do bootloader, depois reinstale o firmware de aplicativo.

Se o dispositivo não conseguir entrar no modo DFU ou ser detectado pelo computador, entre em contato com o suporte técnico.

Dispositivo brickado e recuperação do bootloader

Descrição:

O dispositivo não responde, nenhum LED, não consegue parear com seu aplicativo. 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; adafruit-nrfutil o utiliza 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 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, em seguida, 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 da 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 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*), 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 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 aplicativo

atenção

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

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

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 a Etapa 5.
• Não é possível entrar no modo DFU: consulte 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 manualmente: conecte o dispositivo, pressione duas vezes Reset (o LED amarelo permanece aceso de forma contínua), 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 & Entrando no modo DFU manualmente

Conecte o dispositivo ao seu PC e pressione duas vezes o botão Reset — o LED amarelo permanece aceso de forma contínua 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.

Dispositivo desliga automaticamente

Descrição

• Após o dispositivo ligar, ele desligará ou reiniciará automaticamente depois de um tempo.
• O log da porta serial executou por um tempo e depois parou.

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 do 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 do firmware

• Clique no botão Factory Reset no 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 abaixo de -10 dB indica desempenho ruim.

• 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 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 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

Suporte técnico & discussão sobre o produto