Primeros pasos con MeshCore en Wio Tracker L1 Pro

Consigue uno ahora 🖱️

Flasheo de firmware

Método 1 mediante Web Flasher

Conecta tu dispositivo al ordenador con un cable USB. Asegúrate de que el cable admite transmisión de datos.

aviso

Mantén el cable USB conectado durante la transmisión de datos, de lo contrario el dispositivo puede dañarse.

Ve al Meshcore Web Flasher.

Elige Seeed Studio Wio Tracker L1 Pro en el grupo Community Firmware.

Elige Companion Bluetooth. Los dispositivos flasheados con el firmware Companion Bluetooth se pueden conectar a la APP. Si quieres flashear otro firmware, por favor haz clic aquí para ver el tutorial.

Borrado de la Flash

Haz clic en Enter DFU Mode, elige el puerto serie llamado "L1 Pro" o "TinyUSB serial". Luego haz clic en Erase Flash y elige el puerto serie.

Si has hecho clic en Erase Flash pero no hay respuesta, haz clic en Enter DFU de nuevo y luego haz clic en Erase Flash para asegurarte de que has entrado correctamente en DFU.

Si ves "Flashing erase firmware:100%", el dispositivo se ha borrado correctamente.

Flashear firmware

Haz clic en Enter DFU Mode, elige el puerto serie llamado "L1 Pro" o "TinyUSB" serial. Luego haz clic en Flash y elige el puerto serie.

Si has hecho clic en Flash pero no hay respuesta, haz clic en Enter DFU de nuevo y luego haz clic en Flash para asegurarte de que has entrado correctamente en DFU.

Cuando la barra de progreso esté completamente llena, indica que el flasheo ha finalizado. Entonces el dispositivo se reiniciará automáticamente.

Método 2 Arrastrar y Soltar

Conecta tu dispositivo al ordenador con un cable USB. Asegúrate de que el cable admite transmisión de datos.

aviso

Mantén el cable USB conectado durante la transmisión de datos, de lo contrario el dispositivo puede dañarse.

Ve al Meshcore Web Flasher.

Elige Seeed Studio Wio Tracker L1 Pro en el grupo Community Firmware.

Elige Companion Bluetooth. Los dispositivos flasheados con el firmware Companion Bluetooth se pueden conectar a la APP. Si quieres flashear otro firmware, por favor haz clic aquí para ver el tutorial.

Borrado de la Flash

Descarga el archivo UF2.

Haz doble clic en el botón RST para entrar manualmente en el modo DFU. Podrás ver que aparece un disco llamado TRACKER L1 después de 10~15 s.

Arrastra el archivo UF2 descargado al disco emergente.

El disco desaparecerá después de que el firmware se haya flasheado correctamente. En este punto no hay firmware en el dispositivo, por lo que el dispositivo NO se reiniciará automáticamente.

Flashear firmware

Elige la versión de firmware más reciente.

Descarga el archivo UF2.

Haz doble clic en el botón RST para entrar manualmente en el modo DFU. Podrás ver que aparece un disco llamado TRACKER L1 después de 10~15 s.

Arrastra el archivo UF2 descargado al disco emergente.

El disco desaparecerá después de que el firmware se haya flasheado correctamente. En este punto no hay firmware en el dispositivo, por lo que el dispositivo NO se reiniciará automáticamente.

Configuración

Encender el dispositivo

Levanta el interruptor de encendido hacia arriba para encenderlo.

tip

Si el dispositivo no responde cuando pulsas el botón, por favor cárgalo primero. No utilices un cargador de carga rápida.

Obtener la APP

Descárgala desde Google Store o Apple Store. O haz clic aquí para obtener la APP Meshcore.

Conectar mediante la App

Haz clic en Connect y elige el dispositivo de destino. El ID de dispositivo predeterminado es Meshcore-MAC Address. La dirección MAC se puede ver en la etiqueta en la parte inferior del dispositivo.

Introduce el código PIN que se muestra en la pantalla del dispositivo y luego haz clic en Pair para conectar el dispositivo.

tip

Si la conexión falla, abre la lista de Bluetooth de tu teléfono y forget o Unpair el dispositivo. Luego intenta reconectar de nuevo.

Conectar mediante la interfaz web（BLE）

1. Abre la MeshCore Web App y haz clic en el icono Settings.

2. Selecciona la pestaña BLE y luego haz clic en Scan Now.

3. En la ventana emergente de Bluetooth del sistema, selecciona tu dispositivo (por ejemplo, MeshCore-xxxxxx) y haz clic en Pair.

4. Cuando se te solicite, introduce la clave de acceso Bluetooth que se muestra en la pantalla del dispositivo y luego haz clic en OK. Esta clave de acceso no es 123456.

5. Espera hasta que el estado cambie a conectado y tu nodo aparezca en la interfaz de MeshCore.

Configurar el LoRa

Para empezar a comunicarte a través de la malla, debes establecer tu región. Este ajuste controla qué rango de frecuencias utiliza tu dispositivo y debe configurarse de acuerdo con tu ubicación regional.

Luego reinicia el dispositivo, de lo contrario la configuración no surtirá efecto.

Lista de regiones

Código de región	Descripción	Rango de frecuencia (MHz)	Ciclo de trabajo (%)	Límite de potencia (dBm)
UNSET	Sin configurar	N/A	N/A	N/A
US	Estados Unidos	902.0 - 928.0	100	30
EU_868	Unión Europea 868 MHz	869.4 - 869.65	10	27

Ahora que has configurado la región LoRa en tu dispositivo, puedes continuar configurando cualquier parámetro LoRa para adaptarlo a tus necesidades.

Configurar el GPS

Si quieres usar GPS, por favor actívalo.

Puedes ir a Position Settings en la APP para activar el GPS. O puedes ir a la página de GPS del dispositivo y pulsar el joystick de cuatro direcciones para encender o apagar el GPS.

Configurar el zumbador

Haz clic en el botón de usuario cuatro veces para controlar el encendido o apagado del zumbador.

Configurar el sensor

El Wio Tracker L1 se envía con el firmware MeshCore 1.12 preinstalado. La compatibilidad con sensores Grove a través del conector Grove integrado se añadió en el firmware 1.13; la versión más reciente es 1.16.

nota

Los sensores Grove requieren el firmware 1.13 o posterior. Si tu dispositivo aún ejecuta la versión de fábrica 1.12, sigue el Método1 vía Web Flasher y selecciona la versión más reciente.

Desde la versión 1.13 en adelante, esto permite una integración sencilla de sensores ambientales — temperatura, humedad, calidad del aire y más — a través del conector Grove integrado del L1, sin necesidad de soldar ni de hardware adicional. Conecta un sensor Grove compatible al conector y será reconocido automáticamente.

Transmisión de mensajes

Si tienes dos dispositivos compatibles, y no hay muchos usuarios de MeshCore cerca de ti, flashea ambos con el firmware BLE Companion para que puedas usar tus dispositivos para comunicarte con tus amigos y familiares cercanos.

Anuncio

MeshCore te permite difundir manualmente tu nombre, posición y clave pública de cifrado, que también se firma para evitar suplantaciones. Cuando haces clic en el botón de anuncio, se difunden esos datos por LoRa. MeshCore llama a esto un Anuncio. Hay dos formas de anunciar, "zero hop" y "flood".

• Zero hop significa que tu anuncio se difunde a cualquiera que pueda oírlo, y eso es todo.
• Flooded significa que se difunde y luego se repite por todos los repetidores que lo escuchan.

Puedes enviar anuncios en la APP. También puedes enviar anuncios directamente en la página de anuncios del dispositivo.

Mensaje público

Después de configurar LoRa, puedes enviar mensajes en el canal principal. Todas las personas cercanas en la misma banda de frecuencia lo escucharán.

Mensaje privado

Los dos dispositivos solo establecen una conexión cuando ambos han recibido el anuncio del otro.

Preguntas frecuentes (FAQ)

Dispositivo bloqueado y recuperación del bootloader

Descripción:

El dispositivo no responde, no hay LED, no se puede emparejar con tu aplicación. Si encuentras el dispositivo completamente muerto después de flashear tu propio firmware, también puedes intentar reinstalar el bootloader.

El bootloader se restaura a través del puerto serie USB (Serial DFU) con adafruit-nrfutil.

note

Durante el flasheo, mantén la conexión del cable estable y NO lo desconectes, incluso si el número de puerto serie cambia.

Paso 1: Preparar

• Un dispositivo de la serie Wio Tracker L1 (L1 / L1 Pro)
• Un cable de datos USB en buen estado (no solo de carga)
• Un PC con Windows, macOS o Linux con Python 3 y pip
• El paquete del bootloader: Haz clic aquí para descargar el Bootloader — NO extraigas el ZIP; adafruit-nrfutil lo usa tal cual

Paso 2: Instalar adafruit-nrfutil

Windows

Comprueba que Python 3 y pip estén disponibles (si falta pip, ejecuta primero python -m ensurepip --upgrade):

python --version
python -m pip --version

Luego instala y verifica (la versión probada para esta guía es 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

Si falta pip, ejecuta primero python3 -m ensurepip --upgrade.

Linux

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

Si falta pip, ejecuta primero python3 -m ensurepip --upgrade.

nota

Comprueba siempre la versión con adafruit-nrfutil version. NO uses adafruit-nrfutil --version.

Paso 3: Comprobar el puerto serie

Toma nota del puerto serie del dispositivo; los ejemplos siguientes varían según el PC:

Windows

Abre Device Manager → Ports (COM & LPT), por ejemplo:

USB Serial Device (COM43)

macOS

ls /dev/cu.*

El dispositivo aparece como /dev/cu.usbmodemXXXX.

Linux

ls /dev/ttyACM*

El dispositivo normalmente aparece como /dev/ttyACM0; si no se lista nada, prueba también con ls /dev/ttyUSB*.

Paso 4: Flashear el bootloader

Sustituye el puerto por el que encontraste en el Paso 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

Si el ZIP no está en la carpeta actual de tu terminal, pasa su ruta completa a --package, por ejemplo "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

Paso 5: Gestionar el cambio de puerto serie

--touch 1200 reinicia el dispositivo en modo DFU, por lo que el puerto serie normalmente cambia y el primer comando puede detenerse con un traceback como este:

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

Esto NO es un fallo: el dispositivo ya entró en modo DFU en un puerto NUEVO. En el PC con Windows probado, por ejemplo, cambió de COM43 a COM45:

Mantén el cable USB conectado. Encuentra el nuevo puerto (actualiza Device Manager → Ports (COM & LPT), o vuelve a ejecutar ls /dev/cu.* / ls /dev/ttyACM*), luego vuelve a flashear en el nuevo puerto SIN --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

Paso 6: Confirmar el resultado

El flasheo se realizó correctamente cuando la salida termina con Device programmed.:

Después de eso, aparece una unidad UF2 en tu PC (captura de pantalla del PC con Windows probado). Su etiqueta de volumen varía según la compilación del bootloader — la unidad probada mostraba XIAO-BOOT — y NO es un criterio de aprobación o fallo; no juzgues el resultado por el nombre de la unidad ni por INFO_UF2.TXT:

Paso 7: Reinstalar el firmware de la aplicación

aviso

Restaurar el bootloader NO reinstala el firmware de la aplicación: el dispositivo aún no tiene un firmware funcional hasta que lo vuelvas a flashear.

Cuando hayas completado los pasos anteriores, sigue Firmware Flashing para flashear el firmware de la aplicación.

Solución de problemas

• adafruit-nrfutil no se reconoce después de la instalación: el directorio de scripts de usuario de Python no está en tu PATH (Scripts en Windows, bin en tu directorio de inicio en macOS/Linux); añádelo al PATH o reinstala sin --user.
• Puerto ocupado / acceso denegado: cierra monitores serie, pestañas de web flasher, Arduino IDE o cualquier otra cosa que esté usando el puerto.
• FileNotFoundError: could not open port ... después de Touched serial port ...: el dispositivo entró en modo DFU en un puerto nuevo; sigue el Paso 5.
• No se puede entrar en modo DFU: consulta Unable to enter DFU & Entering DFU Mode Manually.

Recuperación DFU manual

Si --touch 1200 no puede poner el dispositivo en modo DFU (por ejemplo, el firmware no responde en absoluto), entra en él manualmente: conecta el dispositivo, pulsa dos veces Reset (el LED amarillo permanece fijo), encuentra el puerto serie DFU como en el Paso 3 y luego ejecuta el comando del Paso 5 en ese puerto SIN --touch 1200. El resultado satisfactorio se ve igual que en el Paso 6.

No se puede entrar en DFU y entrar en modo DFU manualmente

Conecta el dispositivo a tu PC y pulsa dos veces el botón Reset; el LED amarillo permanece fijo y aparece un puerto serie DFU en tu PC.

Para flashear el bootloader en este modo, sigue Device Bricked & Bootloader Recovery, pero omite --touch 1200; el dispositivo ya está en modo DFU.

Salir del modo DFU

Pulsa una vez el botón Reset para salir del modo DFU.

El dispositivo se apaga automáticamente

Descripción

• Después de que el dispositivo se enciende, se apagará o reiniciará automáticamente después de un tiempo.
• El registro del puerto serie funcionó durante un tiempo y luego se detuvo.

Esto posiblemente se deba a reiniciar o apagar el dispositivo manualmente y por la fuerza cuando el dispositivo se encuentra en los siguientes estados: sin haber terminado el proceso de transmisión de mensajes, estando en configuración......

Solución de problemas

Flash Erase del firmware

Restablecimiento de fábrica

Si quieres restaurar la configuración predeterminada, puedes hacer el restablecimiento de fábrica. Hay dos métodos para que realices un restablecimiento de fábrica.

• Flash Erase del firmware

• Haz clic en el botón Factory Reset en la app. El dispositivo se reiniciará automáticamente con la configuración de fábrica.

  

Calidad de la señal

• SNR refleja la calidad del enlace de comunicación. Los dispositivos normales suelen funcionar por encima de -7 dB. Un dispositivo con un SNR inferior a -10 dB indica un rendimiento deficiente.

• RSSI está determinado conjuntamente por el dispositivo y su entorno. Un dispositivo normal suele funcionar por encima de -110 dBm. Se considera que un dispositivo con un RSSI inferior a -115 dBm tiene un rendimiento deficiente.

  Para lograr el mejor efecto de señal, utiliza el dispositivo en un área abierta y sin obstrucciones, con una interferencia mínima.

Antena compatible

Si necesitas un reemplazo de antena para el L1 Pro, haz clic aquí para conseguir una.

Recursos

• Bootloader (paquete Serial DFU)
• Archivo de referencia de impresión 3D (V1)
• Archivo de referencia de impresión 3D (V2 nuevo joystick de cuatro direcciones)
• Desafío de diseño de carcasa L1
• Archivo de contorno
• Certificación TELEC
• Certificación FCC
• Certificación CE
• Prueba de consumo de energía y cálculo de la vida útil de la batería

Soporte técnico y debate sobre el producto