Files
shade ce1b71d6fd feat: separate radio settings in the on-device setup wizard
- радиопресет заменён на четыре отдельных пункта меню: Frequency, Bandwidth, CR, SF
- частота: целые МГц шагом +-1, кГц правятся по разрядам (принцип как у координат)
- полоса: поразрядный ввод значения с точкой (формат 062.50)
- CR и SF: шаг +-1 с ограничением 5-8 и 5-12
- применение любого из четырёх пунктов отправляет set radio <частота>,<полоса>,<sf>,<cr>
  целиком, остальные значения сохраняются; внизу меню остаётся Save & exit
- документация device-setup.md обновлена, README: раздел и журнал изменений
- проверено сборкой: heltec_v4_repeater_mqtt, Meshadventurer_sx1262_repeater_mqtt,
  Generic_E22_sx1262_repeater_mqtt (без дисплея)
2026-10-11 18:06:55 +03:00

7.0 KiB
Raw Permalink Blame History

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

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

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

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

Пункт меню Что делает Команда 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. Курсор проходит четыре позиции: целые мегагерцы и три разряда килогерц.

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

Полоса вводится так же поразрядно, формат 062.50 — то есть 62,5 кГц.

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

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

Ограничения

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