====== MeshCore: репитеры ======

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

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

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

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

<code>
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
</code>

^ Команда ^ Что делает ^
| ''set radio 868.731,62.5,8,7'' | Частота, полоса, SF, CR — [[meshcore:nastrojki|тульские настройки]] |
| ''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]]

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

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

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

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

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

  * Главное — **в начале код района или населённого пункта** (CEN, ZAR, PRO, PRI, LEN, SCH, UZL и т. п.). Коды — в [[:node-name-rules|правилах именования узлов]].
  * Название места или ориентира — по желанию.
  * **Слово 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''** — так любой участник сможет посмотреть состояние вашего репитера:

<code>
set guest.password 123456
</code>

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

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

===== Мосты =====

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