// ПРОШИВКА

Прошивка
TMesh

Специальная прошивка для шлюзов и устройств TMesh. Основана на официальной прошивке Meshtastic с дополнительными функциями для городских сетей.

Поддержка кириллицы Force Next Hop Favorite Router Управление хопами Restricted Routing TMesh MQTT Meshtastic совместима

Что такое прошивка TMesh

Прошивка TMesh — это специальная сборка на основе официальной прошивки Meshtastic для устройств, работающих в сети TMesh. Она полностью совместима с обычными узлами Meshtastic, но содержит ряд доработок, повышающих качество работы в плотных городских сетях и при подключении к MQTT-серверу TMesh.

💡
Прошивка необходима для работы в качестве шлюза TMesh. Для обычного использования — по желанию.

Отличия от официальной прошивки

🔁
Режим ретрансляции KNOWN_ONLY работает иначе: ретранслируются только пакеты от узлов из списка избранных, а не от любых известных узлов.
🖥️
Если таймаут экрана установлен на 30 секунд, устройство не будет будить экран при входящих сообщениях — только по нажатию кнопки.
🇷🇺
Добавлена поддержка кириллических символов на дисплее устройства.
🎯
Функция Force Next Hop — принудительный выбор узла-ретранслятора для всех пакетов, включая публичные каналы и Node Info.
🔀
Функция Favorite Router — принудительная ретрансляция пакетов через указанный узел и сохранение счётчика хопов при ретрансляции через него.
🔢
Флаг управления хопами — не уменьшать счётчик хопов, если пакет ретранслировал любой узел из избранных (даже в роли Client), либо уменьшать его только на первом прыжке.

При подключении к MQTT-серверу TMesh

📡
Все пакеты, принятые устройством, отправляются на MQTT — независимо от флага ok_to_mqtt.
📊
Если включена телеметрия устройства, она отправляется раз в час — вне зависимости от текущей загруженности канала и числа онлайн-узлов в сети.
🔽
Пакеты, полученные с downlink-топика MQTT-сервера TMesh, ретранслируются в сеть без флага via_mqtt — как если бы они пришли напрямую по радио.
🔒
Пакеты с флагом ok_to_mqtt = false всё равно отправляются на MQTT-сервер TMesh для обеспечения связи через шлюз.

Настройка функций через флаги

Дополнительные функции прошивки — Force Next Hop, Favorite Router, управление хопами и Restricted Routing — включаются «флагами», записанными в поле Понятное имя (Friendly name) модуля «Датчик обнаружения» (Detection Sensor). Сам датчик для этого не нужен — модуль должен быть выключен.

Модуль: Датчик обнаружения (Detection Sensor)
Модуль включён
Нет — если модуль включён, флаги не применяются
Понятное имя
Строка флагов, начинающаяся с _t. Пример: _tr1_h0_n24e

Формат

Имя начинается с _t, дальше идут флаги, разделённые символом _. Каждый флаг — строчная латинская буква и значение. Порядок флагов не важен; неизвестные флаги и флаги с ошибками в значении игнорируются.

Доступные флаги
r1 … r5
Restricted Routing — уровень фильтрации пакетов
h0, h1
Управление хопами — режим уменьшения счётчика хопов
n + режим + ID
Force Next Hop: режим 0, 1 или 2, затем ID узла. Пример: n24e
f + режим + ID
Favorite Router: режим 0 или 1, затем ID узла. Пример: f14e

ID узла во флагах n и f

Узел задаётся последним байтом его ID — это два последних символа HEX-ID, которые вводятся как есть, без перевода в десятичный вид. Регистр не важен, значение 00 недопустимо.

Пример: ID !a3f2c84e → 4e.

Несколько флагов сразу

Флаги можно комбинировать. Например, имя _tr1_h0_n24e включает Restricted Routing уровня 1, режим хопов h0 и Force Next Hop в режиме 2 через узел, ID которого оканчивается на 4e.

⚠️
Поле «Понятное имя» вмещает не более 19 символов. Все четыре флага помещаются целиком — например, _tr5_h0_n24e_f14e (17 символов). Флаги читаются при запуске прошивки, поэтому после сохранения убедитесь, что устройство перезагрузилось.

Прежний способ настройки (Paxcounter)

В более ранних версиях прошивки Force Next Hop и Favorite Router настраивались через модуль «Счётчик прохожих» (Paxcounter), который доступен только на устройствах с Wi‑Fi. Теперь Paxcounter для этих функций не используется. Если у вас старая версия прошивки или нужно перенести старые настройки на флаги — см. отдельную страницу про настройку через Paxcounter.

Force Next Hop

В стандартной прошивке Meshtastic NextHop используется только для личных сообщений (DM) и автоматически выбирается маршрутизатором. Функция Force Next Hop позволяет принудительно указать, через какой из соседних узлов будут ретранслироваться пакеты от вашего устройства — включая сообщения на публичные каналы, Node Info, позицию и всё остальное.

ℹ️
Доступно начиная с версии прошивки TMesh 2.7.23. Функция полезна, если вы хотите направить трафик через конкретный шлюз с хорошим покрытием, а не через любого случайного соседа.

Настройка

Force Next Hop включается флагом n в поле Понятное имя модуля «Датчик обнаружения» (Detection Sensor) — см. общие правила настройки флагов.

Модуль: Датчик обнаружения (Detection Sensor)
Модуль включён
Нет
Понятное имя
Формат: _tnMXX
M — режим работы: 0, 1 или 2 — см. ниже
XX — последние два символа HEX-ID узла NextHop, без перевода в десятичный вид
Пример: ID !a3f2c84e, режим 1 → _tn14e

Режимы работы

n0
Только свои пакеты · мягкий
NextHop устанавливается только на пакеты от вашего устройства. Если при первых двух попытках никто не ретранслировал пакет — третья попытка будет без принудительного NextHop.
n1
Свои и ретранслируемые · мягкий
NextHop устанавливается на пакеты от вашего устройства и на все пакеты, которые вы ретранслируете. Как и в режиме n0, последняя попытка ретрансляции будет без NextHop.
n2
Свои и ретранслируемые · строгий
NextHop устанавливается на все пакеты как в режиме n1, но все попытки ретрансляции — включая последнюю — будут с принудительным NextHop.
⚠️
Если указанный NextHop-узел недоступен или не слышит ваш пакет — доставка может не состояться. Режимы n0 и n1 дают запасную попытку без NextHop, режим n2 — нет.

Favorite Router

Проблема 1: две ноды с направленными антеннами

У вас две ноды с направленными антеннами в разные стороны. Вы хотите, чтобы пакеты соседей, принятые одной из нод, всегда ретранслировались обеими нодами — в обе стороны — и чтобы счётчик хопов уменьшался только на 1 суммарно для обеих ретрансляций.

Решение: перевести обе ноды в роль ClientBase, добавить каждую в Favorites другой и настроить на обеих режим HOPS_AND_RELAY (флаг f1).

Проблема 2: сосед в роли Client

Ваша нода в роли ClientBase, и вы хотите, чтобы она не уменьшала хопы от всех пакетов, которые ретранслирует ваш сосед. Но у него нода в роли Client — и в стандартной прошивке это невозможно: не уменьшать хопы можно только если предыдущий ретранслятор сам в роутер-роли.

Решение: добавить ноду соседа в Favorites и настроить режим HOPS_ONLY (флаг f0).

ℹ️
Доступно начиная с версии прошивки TMesh 2.7.25. HOPS_ONLY требует любую роутер-роль (Router, RouterLate или ClientBase). HOPS_AND_RELAY работает только с ролью ClientBase.

Как это работает

В стандартной прошивке нода может не уменьшать счётчик хопов при ретрансляции только если выполнены два условия одновременно: сама нода должна быть в роутер-роли (Router, RouterLate или ClientBase), и предыдущий ретранслятор тоже должен быть в одной из этих ролей и добавлен в Favorites. HOPS_ONLY снимает второе ограничение — роль предыдущего ретранслятора больше не проверяется. Хопы не будут уменьшаться, даже если пакет пришёл от Client или любой другой роли. Ваша нода при этом всё ещё должна быть в роутер-роли.

В стандартной прошивке нода в роли ClientBase принудительно ретранслирует пакеты от Favorites в позднем окне, но только те, у которых поле from совпадает с ID из Favorites — то есть пакеты, отправленные непосредственно этой нодой. Пакеты, которые Favorites сами ретранслируют, под это не попадают. HOPS_AND_RELAY устраняет это ограничение — ваша нода будет принудительно ретранслировать все пакеты, прошедшие через указанный узел, включая те, которые он сам ретранслирует. Требует роль ClientBase.

Настройка

Функция включается флагом f в поле Понятное имя модуля «Датчик обнаружения» (Detection Sensor) — так же, как Force Next Hop, см. общие правила настройки флагов.

Модуль: Датчик обнаружения (Detection Sensor)
Модуль включён
Нет
Понятное имя
Формат: _tfMXX
M — режим работы: 0 (HOPS_ONLY) или 1 (HOPS_AND_RELAY) — см. ниже
XX — последние два символа HEX-ID целевого узла, без перевода в десятичный вид
Пример: ID !a3f2c84e, режим 1 → _tf14e

Режимы работы

f0
HOPS_ONLY
Снимает ограничение на роль предыдущего ретранслятора. Ваша нода должна быть в роутер-роли (Router, RouterLate или ClientBase), но хопы не будут уменьшаться, даже если пакет пришёл от Client или любой другой роли. Работает как для собственных пакетов указанного узла, так и для пакетов, которые он ретранслирует.
f1
HOPS_AND_RELAY
Счётчик хопов не уменьшается и ваша нода принудительно ретранслирует все пакеты, прошедшие через указанный узел — не только его собственные, но и те, которые он сам ретранслирует. Требует роль ClientBase.
⚠️
Режим HOPS_AND_RELAY увеличивает количество ретрансляций в сети. Используйте его осторожно — только если уверены, что целевой узел является ключевым ретранслятором и его пакеты регулярно теряются.
ℹ️
Если на устройстве задан флаг управления хопами (h0 или h1), то правила сохранения хопов определяет он, а не Favorite Router — см. «Управление хопами». Принудительная ретрансляция режима HOPS_AND_RELAY при этом продолжает работать.

Управление хопами

При ретрансляции пакета нода обычно уменьшает его счётчик хопов (hop_limit) на 1, а когда счётчик доходит до нуля, пакет дальше не передаётся. В стандартной прошивке Meshtastic счётчик не уменьшается только в одном случае: нода сама в роутер-роли (Router, RouterLate или ClientBase), а пакет ретранслировал избранный узел, тоже в одной из этих ролей. Флаг h меняет это правило.

ℹ️
Пакет, принятый напрямую от отправителя (без промежуточных ретрансляторов), всегда ретранслируется с уменьшением счётчика на 1 — в любом режиме. Это нужно, чтобы не ломались повторные попытки отправки.

Настройка

Режим выбирается флагом h в поле Понятное имя модуля «Датчик обнаружения» (Detection Sensor) — см. общие правила настройки флагов.

Модуль: Датчик обнаружения (Detection Sensor)
Модуль включён
Нет
Понятное имя
_th0 или _th1 — режим работы, см. ниже
Можно комбинировать с другими флагами, например _tr1_h0

Режимы работы

h0
Не уменьшать после любого избранного
Счётчик хопов не уменьшается, если пакет ретранслировал любой узел из ваших Избранных (Favorites) — независимо от его роли и от роли вашей ноды: режим работает, даже если у вас роль Client. Предыдущий ретранслятор определяется по последнему байту ID; если этот байт совпадает у нескольких известных вам узлов, счётчик уменьшается как обычно. Правила Favorite Router (f0 / f1) для счётчика хопов в этом режиме не применяются.
h1
Уменьшать только на первом прыжке
Счётчик уменьшается только у пакета, принятого напрямую от отправителя. Любой пакет, который уже прошёл через ретрансляторы, ваша нода передаёт дальше без уменьшения счётчика — независимо от ролей и Избранного. Правила Favorite Router (f0 / f1) для счётчика хопов в этом режиме тоже не применяются.

Если флаг h не задан, действуют стандартные правила Meshtastic и, при необходимости, Favorite Router.

⚠️
Сохранение хопов увеличивает радиус распространения пакетов и нагрузку на эфир. Особенно это касается режима h1: на такой ноде лимит хопов перестаёт ограничивать путь пакета. Включайте его осознанно и не на большом числе нод — иначе пакеты будут расходиться по сети значительно дальше обычного лимита.

Restricted Routing

Режим фильтрации пакетов, при котором устройство принимает и обрабатывает значительно меньше трафика, чем в стандартном режиме CORE_PORTNUMS_ONLY. Большинство пакетов отфильтровывается — остаются только выбранные типы в зависимости от уровня фильтрации.

ℹ️
Доступно начиная с версии прошивки TMesh 2.8. Полезно для устройств с ограниченным каналом или батареей, которым нужна только текстовая связь без служебного трафика.

Как включить

  1. Включите опцию CORE_PORTNUMS_ONLY: перейдите в Config → Device и установите Rebroadcast mode в значение CORE_PORTNUMS_ONLY.
  2. Перейдите в модуль Датчик обнаружения (Detection Sensor). В поле Понятное имя (Friendly name) введите одно из значений от _tr1 до _tr5 — в зависимости от нужного уровня фильтрации. Убедитесь, что сам модуль выключен. Флаг можно комбинировать с другими, например _tr1_h0 — см. общие правила настройки флагов.

Уровни фильтрации

_tr1
TEXT · TEXT_COMPRESSED · ADMIN
Минимальный набор: только текстовые сообщения (обычные и сжатые) и административные пакеты. Весь прочий трафик — позиция, телеметрия, NodeInfo, routing — отфильтровывается.
_tr2
То же, что _tr1, плюс ROUTING
Добавляет пакеты типа ROUTING — служебные подтверждения доставки (ACK/NAK). Необходимо, если важна надёжная доставка сообщений с подтверждением.
_tr3
То же, что _tr2, плюс TRACEROUTE
Добавляет пакеты трассировки маршрута (TRACEROUTE). Используйте, если нужна диагностика связи через данный узел.
_tr4
То же, что _tr2, плюс NODEINFO
Добавляет пакеты NodeInfo — информацию об узлах (имя, модель устройства). Нужен, если в сети должны отображаться имена узлов, а не только их ID. Трассировка маршрута по-прежнему отфильтровывается.
_tr5
То же, что _tr3, плюс NODEINFO
Самый широкий из ограниченных уровней: текст, админ-пакеты, ROUTING, TRACEROUTE и NODEINFO. Позиция и телеметрия по-прежнему отфильтровываются.

Особенности при подключении к MQTT TMesh

При работе в режиме Restricted Routing и подключении к MQTT-серверу TMesh действуют разные правила для разных источников пакетов:

📻
Пакеты, полученные по радио, обрабатываются по правилам выбранного уровня Restricted Routing (_tr1 … _tr5).
☁️
Пакеты, полученные из MQTT, обрабатываются по стандартным правилам CORE_PORTNUMS_ONLY — без дополнительной фильтрации Restricted Routing.

Установка прошивки

Прошивка устанавливается через веб-флешер — никаких специальных инструментов не нужно, только браузер на компьютере.

  1. Подключите устройство к компьютеру по USB.
  2. Откройте tmesh.ru/flasher в браузере Chrome или Edge.
  3. Следуйте инструкциям флешера.
  4. После прошивки настройте MQTT согласно инструкции в разделе «Настройка шлюза».
💡
Файлы прошивки можно скачать как ZIP-архив напрямую со страницы Cкачать прошивку. Выберите нужную сборку и перейдите по ссылке в поле zip_url.
ℹ️
Исходный код прошивки доступен на GitHub.