MeshCore: репитеры

Сеть MeshCore держится на репитерах: только они пересылают пакеты. Хороший репитер — стационарный, установлен высоко (крыша, верхние этажи, мачта) и с нормальной антенной. Один репитер в удачной точке полезнее нескольких на подоконниках первых этажей; слишком мощный «мегарепитер» над плотной сетью тоже может мешать.

Прошивка и первичная настройка

Прошейте прошивку Repeater (Прошивки).
Подключитесь к консоли репитера по USB (через веб-прошиватель MeshCore, Repeater Setup, или любой терминал) и выполните команды ниже.
Дальнейшее обслуживание можно делать удалённо по радио из приложения-компаньона (вход с паролем администратора). Параметры радио надёжнее менять по USB.

Порядок настройки через консоль

set radio 868.731,62.5,8,7
set txdelay 1
set path.hash.mode 1
set name ИМЯ_НОДЫ
powersaving on
clock sync
password НОВЫЙ_ПАРОЛЬ
set lat ШИРОТА
set lon ДОЛГОТА
advert

Команда	Что делает
`set radio 868.731,62.5,8,7`	Частота, полоса, SF, CR — тульские настройки
`set txdelay 1`	Задержка перед пересылкой. Если вокруг уже много репитеров — ставьте 2
`set path.hash.mode 1`	Размер хэша в анонсах репитера: 2 байта (прошивка 1.14.0+). Значение `0` — 1 байт
`set name …`	Имя репитера (см. ниже)
`powersaving on/off`	Режим энергосбережения
`clock sync`	Синхронизация часов (время репитера — в UTC)
`password …`	Смена пароля администратора — обязательно смените стандартный
`set lat` / `set lon`	Координаты. Точное место указывать не обязательно — можно соседний дом
`advert`	Анонс с ретрансляцией (flood) — сделайте после любых изменений. `advert.zerohop` — анонс без ретрансляции

Проверка текущих настроек: get radio. Полный справочник команд: https://github.com/meshcore-dev/MeshCore/wiki/Repeater-&-Room-Server-CLI-Reference

После смены параметров радио перезагрузите репитер.

Наименование репитеров

Чтобы в контактах и в маршрутах было видно, через какие районы и ориентиры идёт сообщение, репитеры рекомендуется называть так:

[код района] [название] [порядковый №] [направление антенны]

Примеры: CEN Arsenal 1, CEN Arsenal 2, PRO Laguna, SCH Pervomayskiy

Главное — в начале код района или населённого пункта (CEN, ZAR, PRO, PRI, LEN, SCH, UZL и т. п.). Коды — в правилах именования узлов.
Название места или ориентира — по желанию.
Слово Repeater не добавляйте: у репитера и так есть своя отметка, их можно отфильтровать в приложении, а длина имени ограничена (в приложении видно около 22 латинских символов).
По желанию — направление антенны по сторонам света: N, S, W, E и промежуточные (NE, SW). Для круговой антенны — 360°. Примеры: PRI Puteyskaya SW, LEN Barsuki 360°.

Для компаньонов правил нет — полная свобода самовыражения.

Ключи и совпадения идентификаторов

В маршрутах репитер обозначается первыми байтами своего публичного ключа. Если у соседних репитеров они совпадают, маршруты путаются. Размер хэша 2 байта (set path.hash.mode 1) уменьшает число совпадений; дополнительно можно сгенерировать ключ с нужным префиксом: https://gessaman.com/mc-keygen/ (инструкция по установке ключа — там же).

Экспорт ключа репитера: веб-прошиватель → Repeater Setup, или команда get prv.key. Сохраните ключ перед перепрошивкой.
После смены ключа обязательно сделайте advert. У соседей старый контакт придётся удалить и дождаться нового анонса.

Часы

У многих плат (Heltec V4, T3S3, Xiao) нет часов реального времени — после перезагрузки время сбивается. Выполняйте clock sync или подключите модуль RTC (DS3231). Компаньон с неверным временем (например, 2099 год) может не пустить на репитер — войдите с устройства с правильным временем.

Гостевой доступ

Без гостевого пароля гости не могут войти на репитер и посмотреть его статистику. В сообществе приветствуется ставить общий гостевой пароль 123456 — так любой участник сможет посмотреть состояние вашего репитера:

set guest.password 123456

Питание и энергосбережение

Для автономных репитеров лучше всего подходят платы на nRF52 (Heltec T114 и аналоги): неделя и больше от одной-двух банок 18650.
Для Heltec V3/V4 есть экспериментальные энергосберегающие прошивки (Прошивки); powersaving on на ESP32 заметно снижает нагрев и расход.
Солнечное питание: встроенные контроллеры Heltec и T114 рассчитаны на панели до ~6 В и уходят в защиту при большем напряжении — используйте внешний контроллер (например, CN3791). Зимой выработка панелей в Туле очень мала, закладывайте ёмкий аккумулятор. Панели ставьте почти вертикально, чтобы их не заносило снегом.

Мосты

Мосты с другими MeshCore-сетями на иных настройках (например, московской сетью на SF7) ставьте только с нулевым числом прыжков и по согласованию в группе — иначе чужой флуд затапливает тульскую сеть.