Настройка с дисплея и кнопки
Мастер настройки работает прямо на репитере: ни компьютер, ни телефон не нужны. Он доступен на любой плате, у которой есть дисплей и кнопка, и отсутствует на платах без дисплея — там настройка выполняется через последовательный CLI или локальную веб-панель.
Как войти и выйти
| Действие | Результат |
|---|---|
| Двойное нажатие на экране состояния | вход в мастер (меню Setup) |
| Длинное нажатие на экране состояния | выключение питания узла (как раньше) |
Пункт Save & exit внизу меню |
выход из мастера, радиопараметры применяются |
Если узел прошит «с нуля» и ещё не имеет имени, мастер открывается сам после заставки.
| Экран состояния | Меню, начало списка | Меню, радиопункты и выход |
|---|---|---|
 |
 |
 |
Управление кнопкой
| Жест | В меню | В пункте с числом или списком | В редакторе цифр |
|---|---|---|---|
| короткое | следующий пункт | значение +шаг |
цифра +1 / следующая позиция |
| двойное | предыдущий пункт | значение −шаг |
цифра −1 / предыдущая позиция |
| длинное | войти в пункт | применить и вернуться в меню | войти в правку позиции или применить её |
Пункты меню
| Пункт | Что настраивает | Команда 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 |
Battery |
напряжение, процент заряда и текущий множитель ADC — только просмотр | get battery, get adc.multiplier |
ADC |
множитель ADC для калибровки измерения батареи: открывается с заводского значения платы (Heltec V4 — 5.420, Meshadventurer — 2.000), 0.000 возвращает заводское |
set adc.multiplier |
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 |
выход из мастера | — |
Значения применяются при выходе из пункта и сохраняются во флеш. Ответ устройства показывается на экране — проверку выполняет тот же код, что и последовательный CLI, поэтому неверное значение не будет записано.
Частота
Значение показано как 868.731 MHz, под ним — пункт Save & exit. Курсор проходит пять позиций: целые МГц, три разряда кГц и пункт сохранения.
| Позиция | Короткое | Двойное | Длинное |
|---|---|---|---|
| целые МГц (выделены целиком) | +1 МГц |
−1 МГц |
применить позицию |
| разряд сотен кГц | +1 |
−1 |
применить разряд |
| разряд десятков кГц | +1 |
−1 |
применить разряд |
| разряд единиц кГц | +1 |
−1 |
применить разряд |
Save & exit |
— | предыдущая позиция | сохранить и выйти в меню |
Порядок работы: длинное нажатие входит в правку позиции, короткое и двойное меняют значение, длинное применяет позицию, короткое после применения переводит курсор к следующей позиции. Когда все цифры поправлены, перейдите короткими нажатиями на Save & exit и удерживайте кнопку: частота применяется, экран возвращается в меню.
| Выбраны целые МГц | Правка разряда кГц | Ответ устройства на экране |
|---|---|---|
 |
 |
 |
Полоса, CR и SF
Полоса вводится так же поразрядно, формат 062.50 kHz, с тем же пунктом Save & exit внизу. CR и SF меняются шагом: короткое — +1, двойное — −1, длинное — применить.
| Полоса | CR | SF |
|---|---|---|
 |
 |
 |
Любой из четырёх радиопунктов отправляет команду целиком — set radio <частота>,<полоса>,<sf>,<cr>, поэтому остальные три параметра сохраняют свои значения. Устройство отвечает OK - reboot to apply: изменения радио вступают в силу после перезагрузки.
Координаты
Координаты показываются в формате xx.xxxx yy.yyyy — сначала широта, затем долгота. Активная цифра выделена инверсией.
| Действие | Что происходит |
|---|---|
| длинное нажатие | войти в изменение текущей цифры |
| короткое нажатие в правке | цифра +1 |
| двойное нажатие в правке | цифра −1 |
| длинное нажатие в правке | применить цифру |
| короткое нажатие после применения | перейти к следующей цифре |
длинное нажатие на экране Save & exit? |
сохранить координаты и выйти |
двойное нажатие на экране Save & exit? |
вернуться к правке |
Всего перебираются 12 цифр: шесть для широты и шесть для долготы. Когда применены все, короткое нажатие выводит экран подтверждения. Координаты сохраняются командами set lat и set lon; после сохранения узел появляется на карте MeshCoreTel в течение следующего advert.
| Правка разряда широты | Подтверждение сохранения |
|---|---|
 |
 |
Батарея и калибровка ADC
Пункт Battery показывает напряжение в вольтах, процент заряда и полоску, а также текущий множитель ADC; значения обновляются раз в секунду.
| Экран батареи | Правка множителя ADC |
|---|---|
 |
 |
- короткое нажатие — показать «сырое» значение АЦП в милливольтах (удобно сверять с мультиметром);
- длинное или двойное — вернуться в меню.
Процент берётся у платы, если она умеет его считать (например T-Beam с PMU). Если не умеет — считается линейно по напряжению между getBatteryMinMilliVolts() и getBatteryMaxMilliVolts() платы (обычно 3000–4200 мВ).
Пункт ADC правит множитель ADC поразрядно, формат x.xxx — так же, как полоса: длинное нажатие входит в правку разряда, короткое +1, двойное −1, длинное применяет разряд, короткое после применения переходит к следующему разряду, на пункте Save & exit длинное нажатие сохраняет значение и возвращает в меню. Под цифрами видно измеренное напряжение, поэтому калибровать удобно прямо на экране.
Поле открывается не с нуля, а с действующего значения платы: у Heltec V4 это 5.420, у Meshadventurer — 2.000. 0.000 означает «вернуть заводское значение платы». Значение применяется командой set adc.multiplier <x.xxx> — той же, что и в последовательном CLI.
Коррекция доступна на всех платах, которые измеряют батарею через ADC: механизм живёт в базовом классе ESP32Board (adcMultiplierBase() + adcMultiplier()). Платы, у которых батарея измеряется не через ADC (Station G2/G3, T-Beam с PMU), сообщают, что подстройка не поддерживается — команда вернёт Error: unsupported. На экране батареи заводское значение помечается словом base.
Экран загрузки
При включении узел показывает логотип, ссылку на базовый проект, версию прошивки с датой сборки и адрес проекта:
Всплывающие сообщения
Ответ устройства на любую команду показывается отдельным окном поверх экрана: рамка, свой фон, текст с переносом строк и кнопка OK. Окно модальное — пока оно открыто, экран под ним не меняется, а короткое нажатие кнопки закрывает его. Так видно и успешные ответы, и ошибки проверки значений.
После правки частоты, полосы, CR или SF окно показывает OK - reboot to apply — изменения радио вступают в силу после перезагрузки узла. Если в ответе ошибка (например значение вне диапазона), окно покажет её текст, а настройка не сохранится.
Ограничения
- На экранах без кириллицы подписи меню выводятся латиницей.
- Мастер вводит положительные координаты (формат без знака). Для южного полушария и западной долготы используйте CLI (
set lat -33.1234) или веб-панель. - Wi-Fi, MQTT, регионы и список доступа мастер не настраивает: для них нужен последовательный CLI или веб-панель.
- Если дисплея нет, мастер не компилируется в прошивку и на поведение узла не влияет.
См. также
- Главная страница вики
- Репозиторий и релизы: https://git.meshinfo.ru/shade/MeshCore-Posadmesh
- Каталог документации в репозитории:
posadmesh-docs/