openelab.de
openelab.com
¿Qué es Meshtastic UI?
Meshtastic UI (MUI) es una interfaz de usuario independiente y completa diseñada específicamente para dispositivos Meshtastic. Su propósito principal es permitir a los usuarios interactuar directamente con su red mesh sin depender de una aplicación complementaria en el teléfono para la mayoría de las configuraciones diarias. Esto hace posible gestionar y monitorear los dispositivos de manera más autónoma. Inicialmente, MUI fue creada para dispositivos táctiles independientes, pero con el tiempo se ha ampliado para soportar sistemas nativos Linux, convirtiéndola en una solución versátil en una amplia variedad de plataformas de hardware. Aunque muchas configuraciones esenciales pueden ajustarse directamente a través de MUI, ciertas funciones avanzadas aún pueden requerir emparejamiento con otro dispositivo, como un smartphone, para desbloquear toda la funcionalidad.
El desarrollo de MUI comenzó a principios de 2024. Después de más de un año de trabajo activo, la primera versión preliminar estuvo disponible a principios de 2025. Para entonces, el proyecto había crecido significativamente, abarcando aproximadamente 12,000 líneas de código escrito a mano y 50,000 líneas de código generado. Se había portado con éxito a 10 dispositivos diferentes y traducido a 18 idiomas, demostrando su amplia aplicabilidad y alcance internacional. MUI continúa evolucionando, con actualizaciones en curso destinadas a introducir nuevas funciones, optimizar el rendimiento y ampliar la compatibilidad con plataformas de hardware adicionales.
Dispositivos compatibles
MUI es compatible con una amplia gama de dispositivos, incluyendo pero no limitado a:
-
Independiente LoRa dispositivos con ESP32-S3 y pantallas TFT:
-
LilyGo T-Deck
-
Seeed SenseCAP Indicator
-
unPhone
-
PICOmputer
-
-
Dispositivos estilo CYD con ESP32-S3 conectados vía serial a LoRa módulos:
-
T-HMI
-
Mesh-Tab "Replicator" (ESP-4848S040)
-
Makerfabs 4"
-
-
Integrado Dispositivos Linux con SPI/I2C y GPIO soporte:
-
Raspberry Pi
-
Milk-V
-
LuckFox con TFT SPI y LoRa hat
-
-
Configuraciones nativas de Linux:
-
PC con Meshstick o simulación SIMRadio usando X11 MUI
-
Instalación
Para la mayoría de los dispositivos independientes, MUI puede instalarse usando el Flasheador Web Meshtastic. Los usuarios deben buscar el logo MUI en el hardware compatible, seleccionar la versión de firmware 2.6 o superior y habilitar la opción Meshtastic UI durante el proceso de flasheo.
Algunos dispositivos no son compatibles con el flasheador web pero tienen binarios de firmware precompilados disponibles. Estos archivos de firmware pueden identificarse por el sufijo “-tft” en sus nombres. El firmware precompilado puede descargarse desde la página oficial de descargas.
Para ciertos dispositivos compatibles que no tienen compilaciones automáticas de firmware o soporte para flasheo web, se requiere compilación y flasheo manual. Las instrucciones detalladas para compilar firmware manualmente se encuentran en la documentación para desarrolladores.
Uso
Soporte para Tarjeta SD
Los dispositivos equipados con ranuras para tarjetas SD deben asegurarse de que la tarjeta esté correctamente formateada antes de usarla. El esquema de partición recomendado es MBR. MUI soporta los sistemas de archivos FAT32 y exFAT, siendo exFAT la opción preferida debido a su mejor rendimiento y compatibilidad.
Configuración inicial
Al iniciar MUI por primera vez, o después de realizar un restablecimiento de fábrica, el dispositivo mostrará una pantalla de configuración rápida. Esta pantalla permite a los usuarios establecer simultáneamente la región del dispositivo, el nombre largo y el nombre corto. Al consolidar estos pasos, solo se requiere un reinicio, agilizando el proceso de configuración en comparación con configurar cada ajuste por separado.
Panel de Inicio
Una vez completada la configuración inicial, el Panel de Inicio se convierte en la pantalla predeterminada que se muestra en cada arranque. Proporciona una visión concisa del estado del dispositivo y ofrece navegación rápida a áreas o configuraciones clave. Muchos elementos del panel admiten acciones de pulsación corta y larga, permitiendo funcionalidad adicional y personalización. Para un desglose detallado de los controles disponibles y sus funciones, los usuarios pueden consultar la Infografía del Panel.
En dispositivos independientes, también es visible un ícono de Tarjeta SD. Este ícono muestra el tamaño, formato y estadísticas de uso de la tarjeta SD detectada, tanto en gigabytes como en porcentaje. Al tocar el ícono se actualiza el estado de la tarjeta SD, lo cual es especialmente útil si la tarjeta ha sido intercambiada en caliente. Durante esta actualización, el firmware puede pausar brevemente.
Lista de Nodos
La Lista de Nodos proporciona una vista completa de todos los nodos dentro de la red mesh. Los usuarios pueden ver, filtrar y resaltar nodos según criterios seleccionados. Un toque simple en el ícono del Nodo abre la lista completa de nodos activos, mientras que una pulsación larga abre las Opciones de Nodo, donde se pueden aplicar filtros y resaltados para enfatizar nodos específicos.
Canales
La pantalla de Canales muestra todos los canales configurados para el dispositivo, con íconos que indican su estado de cifrado:
-
Llave amarilla: El canal está usando una Clave Precompartida (PSK) por defecto.
-
Candado verde: El canal está usando una PSK configurada de forma personalizada.
-
Candado rojo: El canal no tiene PSK configurada.
Tocar un canal configurado abre una ventana de chat para ese canal.
Chats
La pantalla de Chats lista todas las conversaciones disponibles, incluyendo canales compartidos y mensajes directos. La lista de chats se puede acceder tocando el ícono de chat. Mantener pulsado un chat revela una opción para eliminarlo, mientras que los mensajes no leídos se resaltan en naranja. Dentro de un chat, los mensajes están organizados en hilos: los mensajes entrantes aparecen a la izquierda y los mensajes salientes del dispositivo local aparecen a la derecha. El contorno de los mensajes cambia de color según el estado de reconocimiento, proporcionando retroalimentación inmediata sobre el éxito de la entrega.
Mapa
La pantalla de Mapa muestra los mosaicos del mapa almacenados en la tarjeta SD del dispositivo. No se incluyen mosaicos por defecto y deben añadirse manualmente. Los mosaicos deben ser imágenes PNG de 256x256, idealmente con una profundidad de color de 8 bits y una paleta de 256 colores. Un conjunto inicial de mosaicos que cubre los niveles de zoom 1–6 de la Tierra está disponible aquí. Los controles del mapa incluyen íconos de flechas para desplazarse, íconos de lupa para hacer zoom, un ícono de GPS para centrar en la ubicación actual del dispositivo y una mira para recentrar en la posición de inicio. Mantener pulsada la mira permite a los usuarios establecer una nueva posición de inicio. Si no hay datos de ubicación disponibles, el mapa se centra por defecto en el Big Ben en Londres, Reino Unido.
Configuración y Herramientas
La pantalla de Configuración y Herramientas ofrece acceso a la configuración del dispositivo y utilidades de diagnóstico. Está dividida en dos pestañas:
-
Configuración: Permite a los usuarios configurar varios aspectos del dispositivo directamente dentro de MUI.
-
Herramientas: Proporciona utilidades para diagnóstico y monitoreo de la red, incluyendo Detector de Malla, Escáner de Señal, Ruta de Rastreo, Estadísticas y Registro de Paquetes.
Acceder a esta pantalla es sencillo: un solo toque en el ícono de configuración la abre, mientras que una pulsación larga bloquea la pantalla (si la función de bloqueo está habilitada) o pone el dispositivo en modo de suspensión (si está deshabilitada).
Acceso a la Client API
MUI funciona como un cliente, similar a las aplicaciones de Android e iOS. Se ejecuta en un núcleo del MCU, mientras que el firmware estándar de Meshtastic se ejecuta en el otro. La comunicación entre MUI y el firmware se maneja a través de la Client API, que solo admite una conexión activa a la vez. Esto significa que no se pueden usar otros clientes simultáneamente mientras MUI está en funcionamiento. Dado que no todos los ajustes pueden configurarse dentro de MUI, los usuarios pueden necesitar cambiar al Modo de Programación Bluetooth o a BaseUI para liberar la API para otros clientes.
Modo de Programación Bluetooth
El Modo de Programación Bluetooth puede activarse de dos maneras: presionando y manteniendo el logo de Meshtastic durante el arranque, o seleccionando el ícono de Bluetooth en el menú de apagado/reinicio dentro de la configuración. Cuando se activa, el dispositivo se reinicia en Modo de Programación Bluetooth y muestra un PIN generado aleatoriamente, que debe ingresarse al conectar vía Bluetooth en la aplicación cliente. Para salir de este modo, presiona y mantén el ícono de Bluetooth nuevamente, y el dispositivo se reiniciará de vuelta en MUI.
Modo BaseUI
Desde la introducción del Firmware Unificado para dispositivos TFT en la versión 2.7, cambiar entre Meshtastic UI (MUI) y BaseUI se ha vuelto fluido. Los usuarios ya no necesitan reinstalar el firmware para cambiar de interfaz. Iniciar en BaseUI libera la conexión Client API, permitiendo que otros clientes como aplicaciones móviles o herramientas seriales se conecten y configuren ajustes avanzados.
Para entrar a BaseUI desde el Modo de Programación Bluetooth, presiona y mantén el ícono de Bluetooth hasta que el sistema se reinicie. Una vez en BaseUI, los usuarios obtienen acceso a una interfaz más tradicional que prioriza la compatibilidad con clientes externos. Este modo es particularmente útil cuando necesitas realizar configuraciones no disponibles directamente en MUI.
Volver a MUI es sencillo: navega a la Ventana del Sistema dentro de BaseUI, luego mantén presionado hasta que aparezca el diálogo de Acción del Sistema. Desde allí, selecciona Reiniciar/Apagar y elige Cambiar a MUI. El dispositivo se reiniciará y cargará nuevamente en el entorno Meshtastic UI.
Resumen
Meshtastic UI ofrece una interfaz potente, flexible y fácil de usar para gestionar redes mesh en una amplia gama de dispositivos. Con soporte para hardware LoRa independiente, sistemas Linux embebidos y configuraciones nativas para PC, MUI ofrece control directo sin requerir una aplicación telefónica para la mayoría de las tareas. Funciones como el Panel de Inicio, Lista de Nodos, Canales, Chats, integración de Mapas y herramientas de diagnóstico lo convierten en una solución integral tanto para principiantes como para usuarios avanzados.
Las opciones de instalación son variadas, desde un simple flasheo web hasta la compilación manual, asegurando accesibilidad en todo el hardware compatible. La inclusión de soporte para tarjetas SD, pantallas de configuración rápida y navegación intuitiva mejoran aún más la usabilidad. Para configuraciones avanzadas, los usuarios pueden alternar entre MUI, el Modo de Programación Bluetooth y BaseUI, proporcionando flexibilidad según sus necesidades.
A medida que continúa el desarrollo, MUI se expandirá con nuevas funciones, optimizaciones y un soporte de hardware más amplio, consolidando su papel como una interfaz clave para el ecosistema Meshtastic.
