Files

T

shade 04bb5714c8 feat: Save & exit in radio editors, wiki docs with screen images

- экраны Frequency и Bandwidth: единица измерения в конце строки значения
  (868.731 MHz, 062.50 kHz), внизу отдельный пункт Save & exit
- после правки цифр пользователь переходит на Save & exit и удерживает кнопку:
  значения применяются, экран возвращается в предыдущее меню
- документация: страница posadmesh-docs/device-setup.md дополнена схемой управления
  и изображениями всех экранов (12 картинок в posadmesh-docs/_assets/wizard/)
- вики Gitea: страницы Home и Device-Setup с теми же иллюстрациями
- README: ссылка на вики, схема управления и запись в журнале изменений

2026-10-11 18:44:30 +03:00

9.3 KiB

Raw Permalink Blame History

Настройка с дисплея и кнопки

Мастер настройки работает прямо на репитере: не нужен ни компьютер, ни телефон. Он доступен на любой плате, у которой есть дисплей и кнопка, и отсутствует на платах без дисплея — там настройка выполняется через последовательный CLI или веб-панель.

Та же страница с теми же иллюстрациями есть в вики проекта: https://git.meshinfo.ru/shade/MeshCore-Posadmesh/wiki/Device-Setup.

Как войти и выйти

Действие	Результат
Двойное нажатие на экране состояния	вход в мастер (меню `Setup`)
Длинное нажатие на экране состояния	выключение питания узла
Пункт `Save & exit` внизу меню	выход из мастера, радиопараметры применяются

Если узел прошит «с нуля» и ещё не имеет имени, мастер открывается сам после заставки.

Экран состояния	Меню, начало списка	Меню, радиопункты и выход

Что настраивается

Мастер меняет только то, что нужно для быстрого ввода узла в сеть:

Пункт меню	Что делает	Команда CLI
`Coordinates`	широта и долгота узла	`set lat`, `set lon`
`Frequency`	частота: целые МГц шагом 1, кГц — по разрядам	`set radio`
`Bandwidth`	полоса, поразрядно	`set radio`
`CR`	coding rate, 5–8	`set radio`
`SF`	spreading factor, 5–12	`set radio`
`TX power`	мощность передатчика, 1–30 дБм	`set tx`
`Repeat`	пересылка пакетов включена или выключена	`set repeat`
`Path hash`	размер хэша пути: 0, 1 или 2 байта	`set path.hash.mode`
`Advert int`	интервал advert в минутах (0 — выключено, иначе 60–240)	`set advert.interval`
`Flood advert`	интервал flood advert в часах (3–168)	`set flood.advert.interval`
`Flood max`	лимит пересылки flood (0–64)	`set flood.max`
`Save & exit`	выход из мастера	—

Значения применяются сразу при выходе из пункта и сохраняются во флеш. Ответ устройства (OK или текст ошибки) показывается на экране — проверку выполняет тот же код, что и последовательный CLI, поэтому неверное значение не будет записано.

Управление кнопкой

Экран состояния (обычный режим):

короткое — включить или продлить подсветку экрана;
двойное — войти в мастер настройки;
длинное — выключить питание узла.

В меню:

короткое — следующий пункт, двойное — предыдущий;
длинное — войти в пункт.

В пункте с числом или списком:

короткое — увеличить значение, двойное — уменьшить;
длинное — применить и вернуться в меню.

Если узел прошит «с нуля» и ещё не имеет имени, мастер открывается сам после заставки.

Ввод координат

Координаты показываются в формате xx.xxxx yy.yyyy — сначала широта, затем долгота. Активная цифра выделена инверсией.

Действие	Что происходит
длинное нажатие	войти в изменение текущей цифры
короткое нажатие в режиме правки	цифра +1
двойное нажатие в режиме правки	цифра −1
длинное нажатие в режиме правки	применить цифру
короткое нажатие после применения	перейти к следующей цифре
длинное нажатие на экране `Save & exit?`	сохранить координаты и выйти
двойное нажатие на экране `Save & exit?`	вернуться к правке

Всего перебираются 12 цифр: шесть для широты и шесть для долготы. Когда применены все, короткое нажатие выводит экран подтверждения. Координаты сохраняются двумя командами — set lat и set lon; после сохранения узел появится на карте MeshCoreTel в течение следующего advert.

Правка разряда широты	Подтверждение сохранения

Ограничение: мастер вводит положительные координаты (формат без знака). Для южного полушария и западной долготы используйте CLI (set lat -33.1234) или веб-панель.

Ввод частоты и полосы

Частота показывается как 868.731 MHz, полоса — как 062.50 kHz. Под значением расположен пункт Save & exit, курсор ходит по всем позициям экрана.

Частота, позиции по порядку:

целые МГц (выделены целиком): короткое нажатие — +1 МГц, двойное — −1 МГц;
три разряда кГц по отдельности: короткое нажатие — +1, двойное — −1, принцип тот же, что у координат;
Save & exit — сохранение частоты и возврат в меню.

Порядок работы: длинное нажатие входит в правку позиции, короткое и двойное меняют значение, длинное применяет позицию, а короткое после применения переводит курсор к следующей позиции. Когда все цифры поправлены, перейдите короткими нажатиями на Save & exit и удерживайте кнопку — частота применится, и экран вернётся в меню.

Полоса вводится так же поразрядно и с тем же пунктом Save & exit внизу.

Выбраны целые МГц	Правка разряда кГц	Ответ устройства на экране

CR и SF меняются шагом: короткое нажатие — +1, двойное — −1, длинное — применить.

Полоса	CR	SF

Любой из четырёх пунктов отправляет команду целиком — set radio <частота>,<полоса>,<sf>,<cr>, поэтому остальные три параметра сохраняют свои значения. Устройство отвечает OK - reboot to apply: изменения радио вступают в силу после перезагрузки.

Ограничения

На экранах без кириллицы подписи меню выводятся латиницей.
Мастер не настраивает Wi-Fi, MQTT, регионы и список доступа: для них нужен последовательный CLI или веб-панель. На плате с Wi-Fi их удобнее задавать из веб-панели.
Если дисплея нет, мастер не компилируется в прошивку и на поведение узла не влияет.

9.3 KiB Raw Permalink Blame History Unescape Escape