Модуль Serial предоставляет интерфейс для управления устройством Meshtastic и обмена данными через последовательный порт. Настройка модуля осуществляется с помощью административного сообщения через Protobuf-пакет ConfigModule.Serial.
Этот модуль позволяет использовать устройство в различных режимах: от простого «прозрачного» туннеля для данных до вывода логов или навигационных данных в формате NMEA.
Основные параметры конфигурации
| Параметр | Описание |
| Enabled | Включает или выключает модуль Serial. |
| Echo | Если включено, все отправленные вами пакеты будут возвращаться (эхо) обратно на ваше устройство. |
| Mode | Режим работы модуля (подробнее см. ниже). По умолчанию: SIMPLE. |
| Receive GPIO (RX) | Номер пина GPIO для приема данных. |
| Transmit GPIO (TX) | Номер пина GPIO для передачи данных. |
| Baud Rate | Скорость передачи данных (бит/с). |
| Timeout | Время ожидания (в мс), после которого пакет данных считается завершенным. |
| Override Console | Позволяет модулю использовать основной USB-порт устройства (полезно для NMEA/CalTopo). |
Режимы работы
1. Передача данных и сообщений
- SIMPLE / DEFAULT: Работает как обычный «глупый» UART-туннель. Всё, что входит в порт, передается в сеть, и наоборот. Требуется канал с именем
serial. - TEXTMSG: Позволяет отправлять текстовые строки через серийный порт, которые будут транслироваться как текстовые сообщения в основной канал. Входящие сообщения выводятся в формате
<Имя>: <текст>. - PROTO: Открывает доступ к Protobuf Client API. Используется для подключения внешних контроллеров (например, Arduino) к Meshtastic.💡 Совет: В режиме
PROTOвы не увидите обычного текста в мониторе порта. Используйте Python CLI с флагом--listenдля отладки.
2. Навигация и картография
- NMEA: Выводит поток данных NMEA 0183 (координаты GPS узла и местоположение других узлов в виде путевых точек — WPL).
- CALTOPO: Аналогичен NMEA, но оптимизирован для SARTopo/CalTopo; отправляет путевые точки (WPL) каждые 10 секунд.
3. Специализированные режимы
- VE_DIRECT: Протокол для работы с продуктами компании Victron Energy.
- WS85: Режим для работы с ультразвуковым анемометром Ecowitt WS85. Требует аппаратной модификации датчика.
- MS_CONFIG: Используется для настройки параметров системы MeshSolar.
4. Логирование
- LOG: Вывод краткого форматированного лога всех отправленных и полученных пакетов (текст, телеметрия).
- LOGTEXT: Логирование только текстовых сообщений.
Подключение и GPIO
Важные советы по железу:
- Перекрестное соединение: Всегда подключайте TX одного устройства к RX другого, и наоборот. Не забудьте соединить их контакты заземления (GND), если они не питаются от одного USB-источника.
- RAK4631: * Для базовых плат RAK19007 (и некоторых RAK19003) стандартные пины: TX=16, RX=15.
- Важно: Для работы этих пинов необходимо установить режим
GPS Modeв значениеNot_Present. - На других версиях RAK19003 используются пины TX=20, RX=19.
- Важно: Для работы этих пинов необходимо установить режим
Переопределение консольного порта (Override Console Serial Port)
Если эта опция включена (true), модуль берет под контроль основной USB-порт.
- Для чего: Удобно для вывода данных NMEA/CalTopo напрямую в компьютер через USB.
- Ограничение: Если вы вручную укажете конкретные номера пинов TX/RX в настройках, этот параметр будет игнорироваться.
⚠️ Важно: После изменения любых настроек модуля Serial требуется перезагрузка (Reset) устройства для вступления изменений в силу.