Primeros pasos con Ripple

¿Qué es Ripple?

Ripple UI es un firmware con pantalla táctil para el L2 Pro. Te permite añadir contactos, enviar y recibir mensajes, ver mapas y registrar tus rutas GPS directamente en el dispositivo, sin usar un teléfono para estas tareas.

¿Cómo se relaciona Ripple con MeshCore?

MeshCore gestiona la comunicación en malla. Ripple UI te permite usarlo directamente en la pantalla táctil del L2 Pro.

Nombre	Propósito
MeshCore	Comunicación LoRa en malla
Firmware Ripple UI	Funcionamiento autónomo con pantalla táctil
Firmware MeshCore Companion	Funcionamiento a través de un teléfono u otro cliente

Flashea Ripple UI directamente; no es necesaria la instalación previa de Companion.

nota

El firmware actualizado usa perfiles MeshCore y ya no ofrece Ripple en la pantalla de New Network.

¿Para quién es Ripple?

• Usuarios que quieren chatear directamente en el dispositivo sin mantener un teléfono conectado.

• Usuarios al aire libre que quieren mapas sin conexión y un registro de su propia ruta.

• Usuarios que quieren cambiar entre diferentes perfiles de red MeshCore.

• Usuarios avanzados que necesitan gestionar repetidores MeshCore, Room Servers o nodos de sensores. Algunas funciones de gestión requieren un código de desbloqueo de pago.

Funciones

• Mensajería autónoma: Envía mensajes directos y de grupo desde la pantalla táctil.

• Múltiples perfiles de red: Mantén separados los ajustes de radio, identidades, contactos y preferencias.

• Pantalla de inicio personalizable: Añade accesos directos a contactos, canales y ajustes.

• Mapas: Carga mapas desde una microSD, arrastra para desplazarte y toca los botones para hacer zoom.

• Rutas GPS: Registra tu posición y marcas de tiempo, y luego ve tu ruta en el mapa.

• Capturas de pantalla: Mantén pulsada la esquina superior izquierda de la pantalla para capturar la vista actual.

• Administración remota: Desbloquea funciones de gestión de nodos con la autorización del nodo de destino.

Flashear el firmware

Si tu dispositivo ya tiene la versión de Ripple UI descrita aquí, salta a Configuración inicial.

Hay dos variantes de firmware disponibles:

• Ripple GUI: datos en tarjeta SD (-SD): Almacena la configuración y los datos en una tarjeta microSD. Inserta una tarjeta formateada en FAT32 de 32 GB o menos antes de usarla.

• Ripple GUI (Interno): Almacena la configuración y los datos en la memoria flash interna del dispositivo.

Paso 1: Abre el flasher web

Visita el Wio Tracker L2 Web Flasher y selecciona el firmware Ripple UI y la variante de almacenamiento para el L2. Usa un navegador de escritorio que admita acceso serie, como Chrome o Edge.

Selecciona Seeed Studio Wio Tracker L2 Pro, elige una variante Ripple GUI y selecciona la versión de firmware. La captura de pantalla de abajo muestra la v12.3.

Paso 2: Entra manualmente en modo de descarga

Mantén pulsado el botón U/B mientras conectas el cable de datos USB y luego pulsa RST para entrar en modo de descarga de firmware.

Paso 3: Selecciona el puerto y flashea

Haz clic en Flash!, selecciona tu dispositivo en el cuadro de diálogo de puerto serie y conéctate. Sigue las instrucciones en pantalla para completar el flasheo.

aviso

La opción Erase device mostrada arriba borra los datos y ajustes en la memoria flash interna, incluido el estado de desbloqueo. Haz copia de seguridad de los datos importantes y conserva tu Unlock Code antes de borrar.

Paso 4: Reinicia

Cuando termine el flasheo, pulsa RST para iniciar Ripple UI.

tip

Si no puedes continuar después de hacer clic en Flash, confirma que el dispositivo está en modo de descarga. Comprueba también el cable de datos USB, los permisos de serie del navegador y si otra aplicación está usando el puerto.

Configuración inicial

Sigue los tutoriales de pantalla táctil y botones en el primer arranque.

Crear un perfil de red

1. Completa los tutoriales de pantalla táctil y del botón Select que se muestran en el primer arranque.

2. Elige un ajuste preestablecido de radio apropiado para tu región o introduce la frecuencia, el factor de dispersión (SF) y otros parámetros usados por tu red local.

3. Nombra el perfil usando letras y números, sin espacios.

4. Guarda el perfil. Si se te solicita, reinicia el dispositivo para aplicar los ajustes.

Para una prueba con dos dispositivos, usa ajustes de radio coincidentes en ambos dispositivos. Seleccionar el mismo ajuste preestablecido es la opción más sencilla. Con ajustes personalizados, comprueba también el ancho de banda, la tasa de codificación y otros parámetros, en lugar de hacer coincidir solo la frecuencia y el SF.

Configura tu nombre

1. Toca L en la izquierda, abre el perfil de red actual y selecciona Identity.

2. Cambia el nombre predeterminado por algo reconocible, como micha o michb. Los nombres pueden contener hasta 12 caracteres.

Explora la interfaz

Toca G, L o M en el lado izquierdo de la pantalla para cambiar entre las tres páginas de inicio.

G: Grid

G es una pantalla de inicio personalizable con una cuadrícula de 3 × 4.

• Mantén pulsada una celda vacía para añadir un acceso directo a un contacto, canal de grupo o ajuste.

• Mantén pulsado un acceso directo existente para eliminarlo.

L: List

L muestra tus perfiles de red, contactos, canales de grupo y Discover. Usa esta página para añadir contactos, editar tu Identity y abrir conversaciones.

La captura de pantalla muestra nombres usados durante las pruebas. Tu lista dependerá de tus perfiles y contactos.

M: Map

M muestra el mapa, las posiciones y cualquier ruta GPS cargada.

• Arrastra la pantalla para desplazarte.

• Toca + o − para hacer zoom. El gesto de pellizcar para hacer zoom no es compatible.

• Toca el botón de seguimiento de ubicación para mantener el mapa centrado en tu posición. El botón se vuelve naranja cuando está activado y la pantalla permanece encendida.

Extra

Abre el menú de la pantalla de inicio en la esquina inferior izquierda para acceder a Extra, que contiene ajustes y herramientas del dispositivo.

• Display: Ajusta el tamaño de fuente, tema, animaciones y color de acento.

• Wi-Fi: Configura tu conexión y las descargas de mapas. La descarga de mapas requiere un código de desbloqueo.

• Networks: Crea y gestiona perfiles de red.

• GPS Config: Configura los ajustes de comunicación GPS; los valores predeterminados normalmente funcionan para el L2 Pro.

• Timezone: Establece el desfase local de UTC.

• SX1262: Comprueba el estado de inicialización de la radio LoRa. code=0 significa éxito.

Barra de título y menú del sistema

Área	Función
Tocar el lado izquierdo de la barra de título	Abre Switch To para cambiar perfiles de red
Mantener pulsada la esquina superior izquierda	Captura una pantalla
Centro de la barra de título	Abre los interruptores rápidos
Lado derecho de la barra de título	Abre la información de GPS
Menú inferior izquierdo en la pantalla de inicio	Abre los ajustes del sistema, incluidos Display, Wi-Fi, Networks y Timezone

Tomar una captura de pantalla

Mantén pulsada la esquina superior izquierda de la pantalla para capturar la vista actual. Puedes usar las capturas de pantalla para compartir ajustes o informar de un problema.

Las capturas de pantalla se guardan como archivos BMP con nombres de archivo de fecha y hora, como se muestra a continuación.

Envía tu primer mensaje

Haz que tus dispositivos sean detectables

1. Configura ambos dispositivos con ajustes de radio MeshCore coincidentes.
2. Asigna a cada dispositivo un nombre de Identity diferente.
3. Ajusta Advert a On para permitir anuncios de identidad.
4. Abre Discover desde la página L y espera a que aparezcan los nodos cercanos.

Para enviar un anuncio de identidad inmediatamente, abre el menú Discover:

Opción	Función
Send ID Local	Envía un anuncio de identidad de cero saltos a los dispositivos cercanos
Send ID Broadcast	Difunde tu identidad a la malla
Scan Local	Solicita respuestas de nodos cercanos que admiten respuestas de descubrimiento; se usa comúnmente para descubrir repetidores

Scan Local no muestra todos los dispositivos. Un nodo debe estar dentro del alcance y configurado para responder.

Añadir contactos

1. Selecciona el nodo de destino en Discover.

2. Abre el menú superior derecho y selecciona Add to Contacts.

3. Vuelve a L y confirma que el contacto aparece en la lista.

4. Repite en el otro dispositivo.

Enviar un mensaje directo

1. Abre el contacto.

2. Toca el campo de entrada y escribe un mensaje.

3. Pulsa ENTER para enviar y espera la confirmación.

4. Abre la conversación en el otro dispositivo y responde.

Los mensajes directos esperan una confirmación (ACK) del destinatario. Si el envío falla, comprueba la configuración de radio y la distancia, y vuelve a intentarlo. Si la ruta anterior ya no es utilizable, selecciona Flood (reset) en Path para encontrar una nueva ruta.

Mapas y rutas GPS

Preparar mapas sin conexión

1. Prepara una tarjeta microSD con formato FAT32 de 32 GB o menos.

2. Guarda teselas de mapa ráster usando esta estructura de carpetas en la tarjeta:

/tiles/{zoom}/{x}/{y}.png

3. Inserta la tarjeta, enciende el dispositivo y abre M.

4. Desplázate hasta un área cubierta por tus teselas y selecciona un nivel de zoom disponible.

zoom es el nivel de zoom; x e y son coordenadas de tesela. Los dispositivos bloqueados solo representan niveles de zoom 1–9. Los niveles de zoom más detallados requieren un código de desbloqueo.

Descargar mapas por Wi‑Fi (requiere desbloqueo)

1. Desbloquea el dispositivo usando las instrucciones de abajo.

2. Abre Wi-Fi desde el menú del sistema en la pantalla de inicio.

3. Introduce el nombre y la contraseña de tu red y habilita la descarga de mapas.

4. Pulsa ENTER para guardar y reinicia cuando se te indique.

5. Confirma que el menú de Wi‑Fi muestra un indicador de conexión naranja.

6. Abre el mapa y desplázate o haz zoom hasta el área requerida. Las teselas se descargan bajo demanda y se almacenan en caché en la tarjeta SD.

Establecer la ubicación usada en los anuncios

Ajuste de ubicación de anuncio	Ubicación utilizada
GPS	La posición obtenida por el GPS del dispositivo
Manual	Una posición fija seleccionada con Advert Loc en el mapa

Para usar un punto seleccionado en el mapa, primero establece Advert Location en Manual. En modo GPS, los anuncios siguen usando la posición del GPS.

Desbloquear funciones premium

Puedes probar la mensajería básica antes de comprar un código de desbloqueo. Desbloquea el dispositivo cuando necesites mapas detallados, descargas de mapas por Wi‑Fi, rutas más largas o funciones avanzadas de administración.

Encontrar el número de serie de tu dispositivo

Busca y abre Unlock en los menús del dispositivo. Anota el número de serie que se muestra en esa pantalla. Usa este número de serie completo para tu compra, en lugar de los últimos caracteres de una dirección MAC o un PIN de Pair Device.

Obtener un código de desbloqueo

Abre la página de código de desbloqueo de Ripple Ultra de Scott, sigue las instrucciones de compra y proporciona el número de serie que se muestra en tu dispositivo. Las licencias se emiten por dispositivo; introduce solo un número de serie de dispositivo por cada licencia.

Si tu dispositivo venía con un código de desbloqueo aplicable, continúa con el siguiente paso.

Introducir el código en tu dispositivo

1. Una vez que recibas el código de desbloqueo para tu número de serie, abre Unlock de nuevo.

2. Introduce el código completo y envíalo.

3. Tras la activación correcta, la opción Unlock desaparece.

4. Abre la función premium que quieras usar y confirma que está disponible.

Guarda el código junto con el número de serie de su dispositivo. En nuestra prueba, borrar la flash con erase_flash y reinstalar el firmware requirió introducir de nuevo el código de desbloqueo del dispositivo.

Funciones premium

• Telemetría automática: Solicita telemetría cuando abres una conversación con una ruta directa. Muestra ubicación, dirección y distancia si el otro nodo permite telemetría GPS.

• CLI de administración de sala: Accede a la línea de comandos del Room Server con su contraseña de administrador.

• Administrador de repetidor: Comprueba el estado del repetidor y gestiona el nodo de forma remota.

• Administrador de sensor: Accede a comandos de sensor, telemetría y gestión de permisos.

• Zoom de mapa más detallado: Muestra teselas de mapa por encima del nivel de zoom 9.

• Descarga por Wi‑Fi: Descarga teselas de mapa bajo demanda y guárdalas en caché en la tarjeta SD.

• Rutas GPS más largas: Registra más de los 64 puntos GPS permitidos en dispositivos bloqueados.

Uso avanzado

Crear y cambiar perfiles de red

1. Abre el menú del sistema en la pantalla de inicio y selecciona Networks.

2. Selecciona New Network, configura los ajustes de radio y nombra el perfil.

3. Guarda y reinicia si se te indica.

4. Toca el lado izquierdo de la barra de título y selecciona un perfil en Switch To.

Cada perfil tiene su propia identidad, contactos y preferencias. Abrir un contacto que pertenezca a otro perfil puede pedirte que cambies de perfil. Este aviso no indica que el dispositivo haya detectado qué red está usando actualmente el otro nodo.

Preguntas frecuentes (FAQ)

Código de estado SX1262

Esta pantalla muestra el código de retorno de RadioLib de la inicialización de la radio LoRa. 0 significa que la inicialización se realizó correctamente. La pantalla está pensada para diagnósticos de radio.

Descubrir otro dispositivo

• Confirma que ambos dispositivos usan perfiles MeshCore compatibles con ajustes de radio coincidentes.

• Habilita Advert en el otro dispositivo o pídele que envíe Send ID Local.

• Empieza con una prueba a corta distancia en un área abierta.

• Scan Local solo lista nodos que responden a solicitudes de descubrimiento; no sustituye los anuncios de identidad de todos los dispositivos.

Por qué el mapa está en blanco

Comprueba el formato de la tarjeta SD, las rutas de las teselas y si existen teselas para el área mostrada. En un dispositivo bloqueado, comprueba también que el nivel de zoom esté entre 1 y 9. Una posición GPS válida no significa que se hayan descargado teselas de mapa.

Recursos

• Actualizaciones del proyecto Ripple y para desarrolladores

• Código de desbloqueo de Ripple Ultra

• Proyecto MeshCore y documentación

Soporte técnico y debate sobre el producto