Meshtastic UI (MUI) — это независимый графический интерфейс для устройств Meshtastic, созданный для прямого взаимодействия с сетью без необходимости использовать мобильное приложение. Изначально MUI разрабатывался для автономных устройств с сенсорным экраном, но позже расширился до поддержки систем на базе Linux.
Разработка началась в начале 2024 года, и спустя год активной работы в начале 2025-го вышла первая публичная версия. На тот момент проект насчитывал 12 000 строк рукописного кода, был портирован на 10 устройств и переведен на 18 языков.
Поддерживаемые устройства
| Тип оборудования | Примеры устройств |
| Автономные LoRa (ESP32-S3 + TFT) | LilyGo T-Deck, SenseCAP Indicator, unPhone, PICOmputer. |
| Связка CYD + LoRa | Устройства типа «Cheap Yellow Display» (ESP32-S3), подключенные по Serial к любому LoRa-модулю. |
| Специализированные платы | T-HMI, Mesh-Tab «Replicator», Makerfabs 4″. |
| Embedded Linux | Raspberry Pi, Milk-V, LuckFox с TFT (через SPI/I2C и GPIO). |
| ПК | Симуляция через X11 (Meshstick или SIMRadio). |
Установка и запуск
- Через Web Flasher: Для большинства устройств MUI доступен в Meshtastic Web Flasher. Ищите логотип MUI, выбирайте прошивку 2.6+ и включите опцию «Meshtastic UI» перед прошивкой.
- Ручная прошивка: Если устройства нет во флешере, ищите файлы с суффиксом
-tftна странице загрузок. - Первая настройка: При первом запуске откроется экран быстрой конфигурации для выбора региона LoRa и задания имен (Long/Short name). Это позволяет настроить всё сразу и перезагрузиться лишь один раз.
Основные возможности интерфейса
🏠 Главный экран (Dashboard)
Центральный хаб, отображающий статус устройства. Многие элементы поддерживают короткое нажатие (действие) и длительное (настройки).
- Иконка SD-карты: Показывает объем и формат (рекомендуется exFAT, разметка MBR). Нажатие обновляет статус (полезно при горячей замене).
👥 Список узлов (Nodes)
- Нажатие: Открывает список всех активных узлов в сети.
- Длинное нажатие: Позволяет настроить фильтры или подсветку (Highlight) для определенных групп узлов.
💬 Каналы и Чаты
- Каналы: Отображают статус шифрования:
- 🟡 Желтый ключ: Стандартный пароль (PSK).
- 🟢 Зеленый замок: Пользовательский ключ.
- 🔴 Красный замок: Шифрование отсутствует.
- Чаты: Поддерживают цепочки сообщений.
- Рамка сообщения: 🟢 Зеленая (доставлено/ACK), 🔴 Красная (ошибка доставки), 🟡 Желтая (ретранслировано другими, но не подтверждено получателем).
🗺️ Карта (Map)
Отображает тайлы (картинки), сохраненные на SD-карте в папке /map.
- Карта работает автономно. Если координат нет, по умолчанию показывается Биг-Бен в Лондоне.
- Управление: стрелки (движение), лупа (зум), прицел (центрирование на «базе»).
Настройки и Инструменты
Доступны через иконку шестеренки:
- Settings (Настройки): Конфигурация интерфейса и устройства.
- Tools (Инструменты):
- Mesh Detector: Поиск узлов поблизости.
- Signal Scanner: Мониторинг силы сигнала.
- Trace Route: Трассировка маршрута пакета.
- Packet Log: Лог всех входящих/исходящих данных.
Режимы программирования и API
MUI работает на одном ядре процессора, а прошивка Meshtastic — на другом. Они общаются через Client API. Поскольку API поддерживает только одно подключение, вы не сможете использовать MUI и телефонное приложение одновременно.
Как подключить телефон (Bluetooth Programming Mode):
- При загрузке: Удерживайте логотип Meshtastic на экране.
- Через меню: Нажмите иконку Bluetooth в меню выключения.
- На экране появится PIN-код для сопряжения. Чтобы вернуться в MUI, удерживайте иконку Bluetooth.
Как переключиться в BaseUI:
Если у вас прошивка 2.7+, можно переключаться между MUI (графическим интерфейсом) и BaseUI (текстовым интерфейсом) без перепрошивки через меню системы (Reboot/Shutdown -> Switch to MUI/BaseUI).