Saltar al contenido principal

Primeros pasos con Meshtastic

tip

La Wio Tracker L1 Serie comparte el mismo marco de hardware. Aunque la guía en video es para la L1 Pro, es aplicable a todos los demás productos de la serie L1.

Tutorial en video​

Parte 1 Desempaquetado​

Cuando utilices los modelos L1, L1 Lite o L1 E-Ink por primera vez, después de conectarlos a la fuente de alimentación USB, levanta el interruptor de encendido hacia arriba para encenderlos.

Parte 2 Flasheo de firmware​

note

Por favor, don't use NRF-OTA para actualizar el firmware, puede hacer que el dispositivo quede completamente inservible.

Parte 3 Uso del dispositivo​

Joystick de cuatro direcciones​

El latest Alpha firmware del firmware L1 E-Ink actualmente es compatible con el joystick de cuatro direcciones. Si quieres usar el joystick, por favor haz clic aquí para actualizar el firmware.

Barra de menú​

pir

Solo el firmware 2.7 es compatible con la barra de menú. Si quieres usar la barra de menú, sigue el Flash Firmware Tutorial para actualizar el firmware.

pir

Zumbador​

Si quieres encender o apagar el zumbador, primero update the firmware a la versión 2.7. Porque solo el firmware de la versión 2.7 tiene la barra de menú.

  • Encender el zumbador Setting (icon shaped like the gear) -> Notification -> Buzzer Action -> Disable
  • Apagar el zumbador Setting (icon shaped like the gear) -> Notification -> Buzzer Action -> All enabled

Parte 4 Conexión del teléfono​

Parte 5 Diferentes estados​

Primeros pasos​

note

Cuando el dispositivo se encuentre en los estados siguientes, por favor no lo reinicies ni lo apagues manualmente. De lo contrario, el dispositivo puede quedar inservible.

  1. No ha finalizado el proceso de transmisión de mensajes
  2. Está siendo configurado

Flashear firmware​

note

Por favor, don't use NRF-OTA para actualizar el firmware, puede hacer que el dispositivo quede completamente inservible.

Visita Meshtastic Web Flasher.

Para L1, L1 Lite y L1 Pro, selecciona el dispositivo de destino Seeed Wio Tracker L1 y elige el firmware más reciente, luego haz clic en Flash.

pir

pir

Para L1 E-Ink, selecciona el dispositivo de destino Seeed Wio Tracker L1 E-Ink y elige el firmware más reciente, luego haz clic en Flash.

pir

pir

Enciende el dispositivo, haz clic en Enter DFU Mode, aparecerá un puerto serie llamado Tracker L1, haz clic y conéctalo, y debería mostrarse una unidad llamada Tracker L1.

pir

Arrastra el archivo UF2 a la unidad DFU. El firmware debería flashearse después de que el archivo se copie y el dispositivo se reinicie.

Encender el dispositivo​

Conecta el cable USB para activar el dispositivo. Levanta el interruptor de encendido hacia arriba para encenderlo.

tip

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

Conectar mediante la app​

  • Selecciona el dispositivo de destino en el panel de Bluetooth.

pir

  • Introduce el código que aparece en la pantalla y luego haz clic en OK para conectar el dispositivo.

pir

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.

pir

Lista de regiones

Region CodeDescriptionFrequency Range (MHz)Duty Cycle (%)Power Limit (dBm)
UNSETSin establecerN/AN/AN/A
USEstados Unidos902.0 - 928.010030
EU_868Unión Europea 868MHz869.4 - 869.651027

Consulta LoRa Region by Country para obtener una lista más completa.

info

EU_868 debe cumplir una limitación de ciclo de trabajo por hora del 10%, calculada cada minuto sobre una base móvil de 1 hora. Tu dispositivo dejará de transmitir si alcanzas este límite, hasta que se le permita de nuevo.

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

Configuración avanzada​

Conectar mediante el sitio web​

Si quieres enviar mensajes de texto y comunicarte con otros nodos en el sitio web, ahora puedes conectar el dispositivo al sitio web de Meshtastic.

Paso 1: Abre el sitio web

Haz clic aquí para ir al sitio web.

pir

Paso 2: Añadir el nuevo dispositivo

Haz clic en "+ New Connection".

pir

Hay dos formas de conectar. Puedes elegir el método que prefieras.

Método 1: Vía Bluetooth

Elige el método Bluetooth. Elige el ID del dispositivo en la ventana emergente.

pir

Método 2: Vía serie

Elige el método serie. Abre el administrador de dispositivos para ver a qué puerto está conectado el dispositivo. Elige ese puerto en la ventana emergente.

pir

Tu dispositivo se mostrará en la lista. Haz clic para conectar. Si la conexión tiene éxito, podrás ver el estado del dispositivo directamente en el sitio web.

pir

Configurar GPS​

Por favor, activa el GPS. Puedes ajustar el intervalo de actualización y el intervalo de transmisión para obtener información de ubicación más actualizada.

pir

Para IOS, por favor activa Accurate Location. De lo contrario, el posicionamiento puede desviarse.

pir

Conexión de sensor​

pir

Puedes añadir sensores al dispositivo mediante la interfaz Grove. Los siguientes sensores han sido verificados como compatibles con la interfaz Grove del dispositivo.

Tipo de sensorModelo de sensor
Sensor ambientalPresiónBMP085
TemperaturaMCP9808 、PCT2075
Temperatura y humedadSHT31/SHTC3/SHT4X、AHT10
Temperatura, humedad y presiónBME280
OtrosFrecuencia cardíaca y SpO₂MAX30102
Teclado I2CCardKB
  • Activa Telemetry para obtener datos del sensor. Si quieres mostrar los datos del sensor en la pantalla OLED, activa on screen

pir

La pantalla OLED mostrará los datos del sensor si activas on screen.

pir

Conexión de pantalla​

  • Pantalla E-Ink Click here to get the compatible E-Ink screen.

pir

  • Pantalla OLED Click here to get the compatible OLED screen. The current OLED driver is SSD1306.

pir

Teclado virtual​

pir

¡La versión de firmware 2.7 ahora es compatible con el teclado virtual! Puedes escribir mensajes directamente en el dispositivo para comunicarte con otro dispositivo. Sigue el Flash Firmware Tutorial para actualizar el firmware.

pir

Configurar tono de llamada​

Ve a Settings -> Ringtone Config, luego introduce la cadena de tono RTTTL que quieras usar para las notificaciones externas.

pir

24:d=16,o=5,b=120:g,c6,d6,2g6

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 App. Si encuentras que el dispositivo está 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 de bootloader: Click here to download Bootloader — no extraigas el ZIP; adafruit-nrfutil lo usa tal cual

Paso 2: Instalar adafruit-nrfutil

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

python --version
python -m pip --version

Check Python and pip on Windows

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

adafruit-nrfutil version output on Windows

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:

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

USB Serial Device (COM43)

Wio Tracker L1 serial port in Windows Device Manager

Paso 4: Flashear el bootloader

Reemplaza el puerto con el que encontraste en el Paso 3:

Cierra cualquier monitor serie o flasher del navegador conectado al dispositivo. Si ya has entrado en modo DFU pulsando dos veces Reset, usa el puerto DFU actual y omite --touch 1200 de los comandos siguientes.

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

Paso 5: Gestionar el cambio de puerto serie

--touch 1200 solicita el modo DFU abriendo y cerrando el puerto serie a 1200 baudios. El sistema operativo puede entonces asignar un puerto diferente, y el primer comando puede detenerse con un traceback como este:

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

Comprueba si ha aparecido un nuevo puerto DFU antes de reintentar. Este error por sí solo no confirma que el dispositivo haya entrado en modo DFU ni que el bootloader se haya flasheado correctamente. En el PC con Windows probado, el puerto cambió de COM43 a COM45:

Puerto serie DFU tras la nueva enumeración en el Administrador de dispositivos de Windows

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:

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

Paso 6: Confirmar el resultado

El flasheo se ha realizado correctamente cuando la salida termina con Device programmed.:

Salida de adafruit-nrfutil terminando 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 aprobado/suspenso; no juzgues el resultado por el nombre de la unidad ni por INFO_UF2.TXT:

La unidad UF2 aparece después de flashear el bootloader

Paso 7: Reinstalar el firmware de la aplicación

aviso

Restaurar el bootloader NO reinstala el firmware de la aplicación: el dispositivo sigue sin firmware funcional hasta que lo vuelvas a flashear.

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

Solución de problemas

  • adafruit-nrfutil no se reconoce después de la instalación: añade el directorio de scripts de usuario de Python a tu PATH (Scripts en Windows, bin en tu directorio de inicio en macOS); en Linux, vuelve a abrir tu terminal después de pipx ensurepath.
  • Puerto ocupado / acceso denegado: cierra monitores serie, pestañas del flasher web, Arduino IDE o cualquier otra cosa que esté usando el puerto. En Linux, comprueba también los permisos del puerto serie y la pertenencia al grupo como se describe en el Paso 3.
  • FileNotFoundError: could not open port ... después de Touched serial port ...: comprueba si ha aparecido un nuevo puerto DFU y sigue el Paso 5. Si no aparece ningún puerto DFU, prueba la recuperación manual de DFU que se muestra a continuación.
  • No se puede entrar en modo DFU: consulta Unable to enter DFU & Entering DFU Mode Manually.

Recuperación manual de DFU

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 éxito se ve igual que en el Paso 6.

Unable to enter DFU & Entering DFU Mode Manually​

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 el botón Reset una vez para salir del modo DFU.

No se puede comunicar en el canal primario​

Si el dispositivo no puede comunicarse con nodos cercanos ni enviar mensajes, primero comprueba que la región LoRa y el preset del módem coinciden con los de los nodos circundantes. También debes comprobar si la PSK predeterminada se ha cambiado. Una PSK diferente en el canal primario impedirá que el dispositivo se comunique con otros nodos en ese canal.

La forma más sencilla de encontrar este problema es a través de la app móvil. Abre la app, conéctate al dispositivo de destino y luego ve a Settings -> Channels. Selecciona el canal primario y comprueba el valor de PSK. Si es diferente al de los nodos circundantes, actualízalo a la misma PSK y guarda la configuración del canal.

Comprobar la PSK del canal primario en la app de iOS

Solución

Si no estás seguro de qué ajustes se cambiaron, restaura el dispositivo a su configuración predeterminada siguiendo la guía Factory Reset. Si solo se cambió la PSK, vuelve a establecerla en AQ==.

El dispositivo se apaga automáticamente​

Descripción​

  • Después de encender el dispositivo, se apagará o se reiniciará automáticamente al cabo de un rato.
  • 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 a la fuerza cuando el dispositivo está en los siguientes estados: sin haber terminado el proceso de transmisión de mensajes, estando en configuración......

Solución de problemas​

click here para ver el vídeo. Necesitas realizar un borrado de la flash y luego volver a flashear el firmware más reciente.

Restablecimiento de fábrica​

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

  • click here para ver el vídeo. Necesitas realizar un borrado de la flash y luego volver a flashear el firmware más reciente.

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

    pir

Fallo en mensaje directo​

Restablecer NodeDB​

NodeDB es la base de datos local que almacena información sobre los nodos descubiertos en la red Mesh actual. Si te encuentras en una situación en la que no puedes comunicarte con un determinado nodo, puede deberse a que tu nodedB haya almacenado información obsoleta para ese nodo. Necesitarás actualizarla.

Abre la app y conéctate al dispositivo de destino. Ve a Settings->Device->Device Config->Reset NodeDB.

Ajustes del dispositivo y botón Reset NodeDB en la app

Intercambiar información de usuario​

Cada nodo enviará periódicamente su propia información de nodo, lo que permite que otros nodos de la malla lo "vean" y lo "reconozcan". Dos nodos necesitan intercambiar su información de nodo entre sí para poder comunicarse entre sí. Si no puedes enviar ni recibir mensajes privados con otro nodo de la lista, puedes pedirles manualmente que intercambien información en la app.

Entrada de dispositivo en Settings

Regenerar clave privada​

Cada nodo posee un par de claves pública/privada. Para intercambiar un mensaje privado cifrado, el remitente lo cifra con la clave pública del destinatario, y solo la clave privada de ese destinatario puede descifrarlo. Dos nodos pueden, por tanto, comunicarse de forma privada una vez que conocen la clave pública del otro. Si un nodo sigue fallando en la transmisión de mensajes privados, intenta regenerar su clave privada. Después de la regeneración, elimina ese nodo de las listas de nodos de los otros dispositivos para que puedan volver a conectarse y obtener su nueva clave pública.

Device entry in Settings

Reinicia el dispositivo defectuoso para que la función de configuración surta efecto.

nota

Después de la regeneración de la clave, otros dispositivos deben volver a conectarse con el nodo. Por lo tanto, es mejor eliminar el nodo de la lista de nodos de otros dispositivos.

Calidad de la señal​

  • SNR refleja la calidad del enlace de comunicación. Un dispositivo normal suele funcionar por encima de -7 dB. Un dispositivo con una 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. Un dispositivo con un RSSI inferior a -115 dBm se considera que 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 L1 Pro, haz clic aquí para conseguir una.

Recursos​

Soporte técnico y debate sobre el producto​

Loading Comments...