GPIO firmwareПрошивка GPIO
MOVETAIN GPIO_v2 · Based on Meshtastic · GPL-3.0
Why GPIO_v2 exists
A Meshtastic-based build for controlling outputs and receiving sensor events in MOVETAIN. It retains standard Remote Hardware and adds MDS2 binary sensor events, event identity, bounded retries and portal receipts.
Зачем нужна GPIO_v2
Это специализированная сборка на базе Meshtastic для управления выходами и приёма событий датчика в MOVETAIN. Мы сохраняем стандартный протокол Remote Hardware, но расширяем доставку событий Sensor: бинарный формат MDS2, идентификация событий, ограниченные повторы и подтверждения портала.
One gpio channel for equipment
Create one enabled private channel named gpio. Both Remote Hardware and our Detection Sensor use it. Match its key on the GPIO node, receiving gateway and room Equipment settings. Frequency and modem preset must also match. Keep the primary channel for chat: gpio need not be primary and does not replace all other channels.
Compared with stock Meshtastic 2.7.15, the base of this build. Other versions may differ. Remote Hardware must be included in the firmware build.
| Feature | Meshtastic 2.7.15 | MOVETAIN GPIO_v2 | Practical result |
|---|---|---|---|
| Control channel | Remote Hardware already uses gpio. | The same gpio channel and standard Remote Hardware protocol. | GPIO control remains compatible. |
| Sensor channel | Detection Sensor uses the primary channel; sending is blocked with the default public channel. | Detection Sensor uses the same private gpio channel as Remote Hardware. | One equipment channel instead of separate channel rules for the two modules. |
| Primary chat | Sensor setup may require changing the primary channel. | gpio can remain a secondary channel; no primary-channel change is required. | Keep the usual chat channel. Other channels are not removed. |
| Key | gpio and the sensor primary channel are configured separately; keys depend on the setup. | One private gpio key for Hardware and Sensor, matching on the node, gateway and room Equipment. | Fewer settings to match. A generated key must still be configured on the other participants. |
| Events | Text messages describing detection and state. | Binary MDS2: node, GPIO, event identity, state and event time when a clock is available. | The portal distinguishes triggers from state reports and recognises redelivery. |
| Delivery acknowledgement | Stock Sensor sends with want_ack=false; there is no MOVETAIN portal receipt. | A portal receipt for a specific event, with bounded retries if missing. | Event reception can be acknowledged. This adds protocol traffic and cannot guarantee delivery through every outage. |
| Applications | Stock Sensor messages are intended for native Meshtastic clients. | Native apps can configure the module, but MOVETAIN processes the binary Sensor events. | Integration with portal Equipment, history and alerts; the stock Sensor journal is not MDS2-compatible. |
Example: Remote Hardware controls an LED on GPIO8; Sensor watches a button on GPIO20. Both use one gpio channel and key, but each pin belongs to only one module. If gpio or a valid private key is missing, our Sensor does not silently fall back to a public channel.
Один канал gpio для всего оборудования
Создайте один включённый приватный канал с именем gpio. Через него работают и Remote Hardware, и наш Detection Sensor. На GPIO-ноде, принимающем шлюзе и в Equipment комнаты укажите одинаковый ключ. Частота и пресет также должны совпадать. Основной канал можно оставить для чата: gpio не обязан быть основным и не заменяет все остальные каналы.
Сравнение со штатной Meshtastic 2.7.15 — базой этой сборки. Другие версии могут отличаться. Remote Hardware должен быть включён в сборку.
| Что сравниваем | Meshtastic 2.7.15 | MOVETAIN GPIO_v2 | Что это даёт |
|---|---|---|---|
| Канал управления | Remote Hardware уже использует канал gpio. | Тот же штатный канал gpio и протокол Remote Hardware. | Сохраняется совместимость управления GPIO. |
| Канал сенсора | Detection Sensor использует основной канал; при стандартном публичном канале отправка заблокирована. | Detection Sensor использует тот же приватный gpio, что и Remote Hardware. | Один канал оборудования вместо разных правил для двух модулей. |
| Основной чат | Для Sensor может понадобиться изменить основной канал. | gpio может оставаться дополнительным каналом; основной канал менять не требуется. | Можно оставить привычный канал общения. Другие каналы не удаляются. |
| Ключ | Канал gpio и основной канал Sensor настраиваются по отдельности; ключи зависят от выбранной конфигурации. | Один приватный ключ gpio для Hardware и Sensor, одинаковый на ноде, шлюзе и в Equipment комнаты. | Меньше настроек для согласования. Созданный ключ всё равно нужно передать остальным участникам самостоятельно. |
| События | Текстовые сообщения о срабатывании и состоянии. | Бинарные MDS2: нода, GPIO, идентификатор события, состояние и время события при наличии часов. | Портал отличает событие от отчёта состояния и распознаёт повторную доставку. |
| Подтверждение доставки | В штатной отправке Sensor want_ack=false; нашего подтверждения портала нет. | Подтверждение конкретного события порталом и ограниченные повторы при его отсутствии. | Можно подтвердить получение события. Это не гарантирует доставку при любой потере связи и добавляет служебный трафик. |
| Приложения | Штатные сообщения Sensor предназначены для родных клиентов Meshtastic. | Настройки доступны в родном приложении, но бинарные события Sensor обрабатывает MOVETAIN. | Интеграция с Equipment, журналом и алертами портала; штатный журнал Sensor не совместим с MDS2. |
Пример: LED на GPIO8 управляется через Remote Hardware, кнопка на GPIO20 работает через Sensor. Оба используют один канал gpio и его ключ, но каждый GPIO назначен только одному модулю. Нет канала gpio или подходящего приватного ключа — наш Sensor не переключается молча на публичный канал.
Meshtastic 2.7.15 · Detection Sensor · Meshtastic · Remote Hardware · GPIO_v2 · Sensor implementation
Compatibility and differences
Remote Hardware uses the standard Meshtastic protocol. Native apps can configure the modules. Our Detection Sensor events are intended for MOVETAIN; the stock Meshtastic sensor journal does not understand this format. Relay nodes do not need our sensor UI to forward packets; normal mesh constraints still apply.
Что совместимо, а что отличается
Remote Hardware использует штатный протокол Meshtastic. Родное приложение может настраивать модули. Наш Detection Sensor передаёт события для MOVETAIN: штатный журнал датчиков Meshtastic не понимает этот формат. Промежуточным нодам не требуется наш интерфейс сенсора для ретрансляции; действуют обычные ограничения mesh-сети.
What receipts do and do not prove
A portal receipt acknowledges a specific event. Retries are bounded, with no endless request loop. Disconnections and queue overflow remain possible. Periodic state reports do not replace ACKs. The last Inactive report does not prove there is no motion now: check reception time and freshness.
Доставка событий и ACK
Подтверждение портала относится к конкретному событию. Повторы ограничены, бесконечного цикла запросов нет. Потери связи и переполнение очереди всё ещё возможны. Периодический отчёт состояния не заменяет ACK. Последний Inactive не доказывает отсутствие движения сейчас: проверяйте время получения и устаревание данных.
Supported hardware
nRF52840 ProMicro DIY TCXO with the nrf52_promicro_diy_tcxo profile. The HT-RA62 illustration is not a wiring diagram; appearance alone does not prove compatibility. This is not Heltec/ESP32 firmware or a Wi-Fi/WSS gateway. The GPIO node communicates over LoRa; the portal receives data through its configured transport.
Для какой платы
nRF52840 ProMicro DIY TCXO с профилем nrf52_promicro_diy_tcxo. HT-RA62 на изображении — иллюстрация, а не схема распиновки. Совпадения внешнего вида недостаточно. Это не прошивка Heltec/ESP32 и не Wi-Fi/WSS-шлюз. GPIO-нода общается по LoRa; портал получает данные через настроенную линию связи.
First installation or replacing firmware
Direct installation from the portal and USB setup require desktop Chrome or Edge. Open the wizard, confirm the model, double-press Reset and select the UF2 drive (for example NICENANO). The wizard downloads and checks the image. In Firefox, download the verified UF2 and copy it to that drive manually. A compatible UF2 bootloader is required; a fully erased board needs separate bootloader recovery. Back up settings before replacing firmware. Read the version over USB after restart: copying alone does not prove the application started.
Установка на новую плату или замена прошивки
Прямая запись прошивки с портала и настройка по USB — только в настольных Chrome / Edge. Откройте мастер, подтвердите модель, дважды нажмите Reset и выберите появившийся диск UF2 (например NICENANO). Мастер сам загрузит и проверит образ. В Firefox скачайте проверенный UF2 и скопируйте на этот диск вручную. Нужен совместимый UF2-загрузчик; полностью стёртая плата без него требует отдельного восстановления. Сохраните настройки перед заменой прошивки. После перезапуска прочитайте версию по USB: копирование файла само по себе не подтверждает запуск.
Settings and the gpio channel
The wizard reads names, LoRa, Bluetooth, channels and modules. Changes require review and confirmation, followed by fresh readback. Use the same private gpio key on the node, gateway and room Equipment settings. A generated key is not automatically shared. The primary channel is preserved. Do not assign one pin to both enabled Remote Hardware and Detection Sensor.
Настройки и канал gpio
Мастер читает имена, LoRa, Bluetooth, каналы и модули. Изменения записываются только после проверки и подтверждения; затем требуется повторное чтение. Для приватного канала gpio используйте одинаковый ключ на ноде, шлюзе и в Equipment комнаты. Новый ключ автоматически между ними не распространяется. Основной канал сохраняется. Один GPIO нельзя назначать одновременно активным Remote Hardware и Detection Sensor.
Sensor modes and intervals
Either High/Low reports state transitions. Rising/Falling marks the selected edge: an event, not a persistent state. High/Low alerts on the selected level. Match the portal constructor mode to the node. The minimum interval limits alerts; the separate state interval schedules periodic reports. For a new sensor the wizard suggests 60-second state reports; 0 disables them. Increase the interval for slow or busy networks. Existing settings are preserved.
Режимы и интервалы Sensor
Either High/Low сообщает переходы состояния. Rising/Falling отмечает выбранный фронт — это событие, а не постоянное состояние. High/Low используется для тревоги при заданном уровне. В конструкторе портала выбирайте режим, совпадающий с нодой. Минимальный интервал ограничивает тревоги; отдельный интервал состояния задаёт периодические отчёты. Для нового сенсора мастер предлагает 60 секунд между отчётами; 0 отключает их. На медленной или загруженной сети увеличьте интервал. Существующие настройки сохраняются.
Meshtastic, GPL and source
GPIO_v2 is a modified Meshtastic build, not a separate radio-network protocol. Upstream attribution is retained. Firmware source is distributed under GNU GPL v3; third-party component licences remain applicable. The links below point to the published release source revision and full licence.
Meshtastic, GPL и исходники
GPIO_v2 — модифицированная сборка Meshtastic, а не отдельный протокол радиосети. Исходный проект и его авторство сохранены. Исходники прошивки распространяются по GNU GPL v3; лицензии сторонних компонентов сохраняются. Ниже — исходная ревизия опубликованного релиза и полный текст лицензии.