Comienza con MeshTracker X1

note

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

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

Comenzar

Encender el dispositivo

Pulsa una vez para encender el dispositivo. Sonará una melodía ascendente y el LED verde 🟢 permanecerá encendido durante aproximadamente 1 s.

tip

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

Apagar el dispositivo

Mantén pulsado el botón durante más de 5 s. El dispositivo se apagará después de tres pitidos del zumbador.

Conectar mediante la App

Descarga la App Meshtastic:

• IOS App
• Android App

IOS App

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

• Introduce el código (el código predeterminado es 123456) y luego haz clic en Pair para conectar el dispositivo.

Android App

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

• Introduce el código (el código predeterminado es 123456) y luego haz clic en OK para conectar el dispositivo.

Configurar 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 según tu ubicación regional.

IOS App

Android App

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 868MHz	869.4 - 869.65	10	27

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 según tus necesidades.

Estado del dispositivo

Estado de la luz		Estado del dispositivo
🟢green	Constante	Dispositivo encendiéndose
	Parpadeo rápido	Funcionando normalmente
	Parpadeo lento	Cargando
	Constante	Totalmente cargado
🔴Red	Parpadeando	Batería baja
⚪️white	Constante	Modo DFU/Modo bootloader

Control del botón

Control del botón	Respuesta del dispositivo
Pulsar una vez (apagado)	Dispositivo encendiéndose
Pulsación larga durante 5 s	Dispositivo apagándose
Doble clic	Difundir ID de nodo y posición
Triple clic	Encender/apagar GPS
Cuatro clics	Encender/apagar temporalmente el zumbador

Flashear firmware

note

Por favor, don't use OTA para actualizar el firmware, ya que puede hacer que el dispositivo quede completamente inutilizable. Para información detallada, por favor haz clic aquí

Paso 1: Entrar en modo DFU

Entra en DFU a través del web flasher. Si esto falla muchas veces, entra en DFU manualmente.

Via Web Flasher

Visita Meshtastic Web Flasher.

Conecta el dispositivo a tu PC, selecciona el dispositivo como SenseCAP Mesh Tracker X1 y elige el firmware más reciente, luego haz clic en Flash.

Haz clic en Enter DFU Mode, aparecerá un puerto serie llamado X1 xxx. Haz clic y conéctalo.

Manually Enter

Conecta el cable USB a tu PC, mantén pulsado el botón del dispositivo y luego conecta rápidamente el cable de carga dos veces.

El LED blanco ⚪️ permanecerá fijo si el X1 está en modo DFU. Y debería aparecer una unidad llamada X1 en tu ordenador.

Paso 2: Borrado de la memoria flash

Antes de flashear el firmware, ¡bórralo primero!

Haz clic en el símbolo de trash.

Descarga el firmware de borrado y cópialo en la unidad.

Este proceso puede llevar algo de tiempo; espera a que la unidad desaparezca.

Paso 3: Flashear firmware

Selecciona el firmware más reciente y descarga el archivo UF2.

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

Tutorial avanzado

Configurar GPS

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

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

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: Abrir el sitio web

Haz clic aquí para ir al sitio web.

Paso 2: Añadir el nuevo dispositivo

Haz clic en "+ New Connection".

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

Bluetooth

Elige Bluetooth. Elige el ID del dispositivo en la ventana emergente.

Serial

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.

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.

Configurar sensor

Sensor	Descripción
Presión	✅
Sensor de 6 ejes (versión futura)	✅
Sensor de 3 ejes (versión futura)	✅

Configuración del zumbador y LED

	Tipo	PIN de salida
Zumbador	Zumbador PWM	25
LED	RGB	R:03 G:24 B:28
Vibra	-	05

IOS App

Ve a Settings -> External Notification -> Activa GPIO -> Configura Output Pin GPIO.

Aplicación Android

Ve a Settings -> External Notification -> Habilita GPIO -> Configura Output Pin GPIO.

Consulta External Notification Config para más detalles.

tip

Después de actualizar la configuración del dispositivo, este se reiniciará, lo que puede llevar algún tiempo.

Configurar tono de llamada

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

Aplicación IOS

Aplicación Android

The Legend of Zelda: Item Get

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

Super Mario Theme (Short)

24:d=4,o=5,b=100:16e6,16e6,32p,8e6,16c6,8e6,8g6,8p,8g

Mario Coin

24:d=8,o=6,b=200:b,e7

Nokia Ringtone

24:d=4,o=5,b=180:8e6,8d6,f#,g#,8c#6,8b,d,e,8b,8a,c#,e,2a

Mario Power-Up

powerup:d=16,o=5,b=200:g,a,b,c6,d6,e6,f#6,g6,a6,b6,2c7

Morse Code CQ

24:d=16,o=6,b=120:8c,p,c,p,8c,p,c,4p,8c,p,8c,p,c,p,8c,8p

Configurar zumbador

El zumbador está habilitado de forma predeterminada. Si quieres deshabilitar el zumbador, configura Alert Message buzzer, Alert bell buzzer y Use PWM buzzer como se muestra en la siguiente captura de pantalla.

Configurar alerta de mensajes

La alerta de mensajes se puede configurar en External Notification.

IOS

Ve a Setting -> External Notification

Puedes configurar buzzer off + vibra off.

O buzzer on + vibra on.

Android

Ve a Setting -> Module Configuration -> External Notification

Habilita External notification enabled, luego puedes configurar buzzer only, vibra only o buzzer on + vibra on.

Deshabilita External notification enabled, luego puedes configurar buzzer off + vibra off.

Preguntas frecuentes

Cómo comprobar el ID del dispositivo

Comprobar la parte trasera del dispositivo

Los últimos cuatro dígitos de la dirección MAC son el ID del dispositivo

Por ejemplo, el ID del dispositivo del dispositivo de abajo sería A0D4

A través de herramienta serie

Visita Meshtastic Web Flasher.

Haz clic en Open Serial Monitor, conecta el dispositivo a tu PC, revisa el registro serie, palabra clave using nodenum.

Cómo reiniciar el dispositivo

Mantén pulsado el botón y luego conecta el cable de carga.

Solución de problemas

El dispositivo nunca se enciende

• El dispositivo puede parecer apagado cuando el indicador LED y el zumbador no están activados. Antes de realizar los pasos anteriores, se recomienda comprobar los siguientes parámetros:

• Usa un cable USB que sepas que funciona para cargar el dispositivo de forma continua durante 1–2 horas para asegurarte de que la batería tenga suficiente energía para activar el sistema.

• Si el dispositivo sigue sin responder después de la carga, realiza un restablecimiento completo de la siguiente manera: Desconecta el cable USB. Mantén pulsado el botón y luego conecta el cable USB mientras mantienes pulsado el botón. Manténlo durante aproximadamente 3 segundos y luego suéltalo. Esto fuerza un reinicio del sistema.

• Si aún así no hay suerte, conecta un cable USB a un ordenador. Mantén pulsado el botón del dispositivo y luego conecta el dispositivo al ordenador, comprueba si aparece o no un disco en tu PC. Si es así, vuelve a instalar el bootloader

El dispositivo se queda atascado en un bucle de arranque

Descripción:

El dispositivo se reiniciará repetidamente y el puerto serie se conectará y desconectará repetidamente.

Solución:

• Paso 1: Intenta entrar en modo DFU manualmente: mantén pulsado el botón del dispositivo y luego conecta rápidamente el cable de carga dos veces

El dispositivo está en modo DFU si el LED blanco permanece encendido de forma fija.

nota

Para entrar correctamente en el modo DFU, debes realizar esta operación rápidamente. Puede que necesites intentarlo varias veces.

• Paso 2: Borrar la Flash

• Paso 3: Flashear el firmware

Instalación del bootloader

Instalar desde Adafruit-nrfutil

• Descarga del bootloader

note

Cuando estés flasheando el bootloader, asegúrate de que la conexión del cable sea estable y NO lo desconectes durante el proceso de flasheo.

Paso 1: Instalación de Adafruit-nrfutil

Para usuarios de Windows, pulsa la tecla "Win" y la tecla "r", luego introduce "cmd" en la ventana emergente y haz clic en "Enter". Esto puede abrir la línea de comandos.

Para usuarios de MAC, pulsa la tecla "Command" y la tecla "Space", para que puedas abrir Spotlight. Luego introduce "termial" y haz clic en "Return". Esto puede abrir la línea de comandos.

Requisitos previos

• Python3
• pip3

Comprueba en tu línea de comandos si Python y pip se han instalado correctamente.

python --version

python -m pip --version

Entonces deberían aparecer "Python xxx" y "pip xxx". Si no es así, intenta instalar Python de nuevo.

Este es el método recomendado para instalar la última versión:

pip3 install --user adafruit-nrfutil

Comprueba la ruta de instalación:

python -m pip show adafruit-nrfutil

Esta es la ubicación de instalación:

Para usuarios de Windows, puede que necesites añadir la ruta manualmente. Copia la ubicación de instalación mostrada en el último paso. Luego añádela como se indica a continuación:

Paso 2: Comprueba tu número de puerto

Conecta tu dispositivo a tu PC y comprueba el número de puerto.

Para usuarios de Windows, abre el administrador de dispositivos y ve a port; el número de puerto que aparece tras la conexión del dispositivo es el número de puerto del dispositivo.

Para usuarios de Mac, por ejemplo:

Para usuarios de Windows, por ejemplo:

Paso 3: Flashear el bootloader

En la terminal o símbolo del sistema, navega al directorio donde descargaste el paquete zip del bootloader y ejecuta el siguiente comando, sustituyendo el puerto correcto para tu dispositivo:

• Para Windows:

adafruit-nrfutil --verbose dfu serial --package mesh_tracker_x1_bootloader-0.10.0-13.zip -p COMxx -b 115200 --singlebank --touch 1200

Cambia COMXX por tu número de COM. Por ejemplo, si tu dispositivo está en com6, cambia el comando a:

adafruit-nrfutil --verbose dfu serial --package mesh_tracker_x1_bootloader-0.10.0-13.zip -p **COM6** -b 115200 --singlebank --touch 1200

Algunos dispositivos cambiarán su número de puerto después de introducir este comando. Así que si la instalación falla, comprueba de nuevo el número de puerto.

• Para otros:

adafruit-nrfutil --verbose dfu serial --package mesh_tracker_x1_bootloader-0.10.0-13.zip -p /dev/tty.SLAB_USBtoUART -b 115200 --singlebank --touch 1200

Cuando hayas completado los pasos anteriores, puedes seguir este paso para flashear el firmware de la aplicación.

Install from Source

Utiliza este método si tienes problemas instalando con PyPi o si quieres modificar la herramienta. Primero clona este repositorio y entra en su carpeta.

git clone https://github.com/adafruit/Adafruit_nRF52_nrfutil.git
cd Adafruit_nRF52_nrfutil

Nota: Los siguientes comandos usan python3; sin embargo, si estás en Windows, puede que necesites cambiarlo a python ya que la instalación de Windows de Python 3.x todavía usa el nombre python.exe

Para instalar en el espacio de usuario en tu directorio personal:

pip3 install -r requirements.txt
python3 setup.py install

Si obtienes errores de permisos al ejecutar pip3 install, tu pip3 es antiguo o está configurado para intentar instalar en los directorios del sistema. En ese caso, usa la bandera --user:

pip3 install -r --user requirements.txt
python3 setup.py install

Si quieres instalar en los directorios del sistema (generalmente no recomendado):

sudo pip3 install -r requirements.txt
sudo python3 setup.py install

Para generar un binario ejecutable autónomo de la utilidad (Windows y MacOS), ejecuta estos comandos:

pip3 install pyinstaller
cd Adafruit_nRF52_nrfutil
pip3 install -r requirements.txt
cd Adafruit_nRF52_nrfutil\nordicsemi
pyinstaller __main__.py --onefile --clean --name adafruit-nrfutil

Encontrarás el .exe en Adafruit_nRF52_nrfutil\nordicsemi\dist\adafruit-nrfutil (con .exe si estás en Windows). Cópialo o muévelo a otro lugar para tu comodidad, como un directorio en tu %PATH%.

Paso 2: Comprueba tu número de puerto

Conecta tu dispositivo a tu PC y comprueba el número de puerto.

Para usuarios de Windows, abre el administrador de dispositivos y ve a "port"; el número de puerto que aparece tras la conexión del dispositivo es el número de puerto del dispositivo.

Para usuarios de Mac, por ejemplo:

Para usuarios de Windows, por ejemplo:

Paso 3: Flashea el bootloader

En la terminal o símbolo del sistema, navega al directorio donde descargaste el paquete zip del bootloader y ejecuta el siguiente comando, sustituyendo el puerto correcto para tu dispositivo:

• Para Windows:

adafruit-nrfutil --verbose dfu serial --package mesh_tracker_x1_bootloader-0.10.0-13.zip -p COMxx -b 115200 --singlebank --touch 1200

Por favor, cambia COMXX por tu número de COM. Por ejemplo, si tu dispositivo está en com6, cambia el comando a:

adafruit-nrfutil --verbose dfu serial --package mesh_tracker_x1_bootloader-0.10.0-13.zip -p **COM6** -b 115200 --singlebank --touch 1200

Algunos dispositivos cambiarán su número de puerto después de que introduzcas este comando. Así que si la instalación falla, comprueba de nuevo el número de puerto.

• Para otros:

adafruit-nrfutil --verbose dfu serial --package mesh_tracker_x1_bootloader-0.10.0-13.zip -p /dev/tty.SLAB_USBtoUART -b 115200 --singlebank --touch 1200

Cuando hayas completado los pasos anteriores, puedes seguir este paso para flashear el firmware de la aplicación.

2) El dispositivo no puede entrar en modo DFU, pero se puede detectar el puerto serie.

• Abre una herramienta de puerto serie

• Ajusta la velocidad en baudios a 1200.

• Conecta el dispositivo. La luz parpadeará brevemente cuando lo conectes. Sigue intentándolo hasta que la luz permanezca encendida, lo que significa que el dispositivo puede volver al modo DFU, luego flashea el bootloader -> borra la flash -> flashea el firmware.

3) El dispositivo no puede entrar en modo DFU y no se muestra ningún puerto serie

• Mantén pulsado el botón del dispositivo y luego conecta el cable de carga. Después de que aparezca un disco en tu PC, es posible que veas el puerto serie.

• Si aún así no hay suerte, desconecta el cable de carga y deja el dispositivo unos días hasta que la batería se agote por completo, luego conecta el cable de carga e intenta emparejarlo de nuevo.

4) Si ninguno de los pasos anteriores funciona, contacta con el soporte técnico: [email protected]

El dispositivo se apaga automáticamente

• Descripción del fenómeno

• Después de encender el dispositivo, se apagará o 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 manualmente y a la fuerza el dispositivo cuando este se encuentra en los siguientes estados: sin haber terminado el proceso de transmisión de mensajes, estando en configuración......

• Solución de problemas

Haz clic aquí para realizar un borrado de la flash.

Restablecimiento de fábrica

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

• Haz clic aquí para borrar la flash del dispositivo 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.

  

Fallo de 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, podría deberse a que tu nodeDB ha almacenado información obsoleta de ese nodo. Necesitarás actualizarla.

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

Intercambiar información de usuario

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

Regenerar clave privada

Dos nodos necesitan conocer su clave privada entre sí para poder comunicarse entre ellos. Si un nodo sigue fallando en la transmisión de mensajes privados, intenta regenerar la clave privada para él.

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

nota

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

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 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 obstáculos, con una interferencia mínima.

Recursos

Soporte técnico y debate sobre el producto

Gracias por elegir nuestros productos. Estamos aquí para ofrecerte diferentes tipos de soporte y garantizar que tu experiencia con nuestros productos sea lo más fluida posible. Ofrecemos varios canales de comunicación para adaptarnos a diferentes preferencias y necesidades.