42 KiB
title, parent, nav_order, last_updated, description, aliases
| title | parent | nav_order | last_updated | description | aliases | |||
|---|---|---|---|---|---|---|---|---|
| Настройки — Модули и администрирование | Руководство пользователя | 8 | 2026-08-30 | Настрой дополнительные функциональные модули (MQTT, телеметрия, готовые сообщения, TAK и другие) и выполняй администрирование устройств. |
|
Настройки — Модули и администрирование
Настрой дополнительные функциональные модули и выполняй управление устройством. Модули расширяют Meshtastic с помощью специализированных возможностей — каждый из них можно включать или отключать отдельно.
💡 Совет: Тебе нужно включать только те модули, которые действительно используешь. Отключение неиспользуемых модулей снижает время передачи, экономит батарею и упрощает конфигурацию. A module you expect can be missing for three reasons: your node's role does not enable it, your firmware is older than the release that added it, or the firmware build excludes it for this hardware.
Настройки модулей используют макет на основе карточек с переключателями, выпадающими списками, текстовыми полями и ползунками:
Конфигурация модуля
Every module lives under Settings → Module configuration.
⚠️ Important: Saving a module screen restarts the radio — the button reads Save & restart, and the radio is unreachable for a few seconds afterwards. External Notification and Mesh Beacon are the exceptions: their button reads Save, and the radio may still restart for some changes.
Модуль MQTT
Мосты передают сообщения туда и обратно от брокера MQTT для подключения к интернету. Ты так расширишь сеть за пределы радиуса действия или интегрируешь её с системами домашней автоматизации.
| Настройка | Описание |
|---|---|
| MQTT включен | Переключить MQTT мост |
| Адрес | Адрес MQTT брокера |
| Имя пользователя | Имя пользователя для аутентификации |
| Пароль | Пароль аутентификации |
| Шифрование включено | Зашифровать MQTT-пейлоады |
| Вывод JSON включен | Publish and consume MQTT messages as JSON. Marked deprecated in the protobuf schema, but it is still the only toggle for this behavior and the firmware still honors it |
| TLS включен | Использовать защищённое соединение |
| Корневая тема | Базовый путь темы MQTT |
| Прокси клиенту включен | Let a connected phone carry the node's MQTT traffic, instead of the node reaching the broker itself |
| MQTT-прокси на этом телефоне | The phone-side half of Proxy to client enabled: whether this phone acts as that relay. See MQTT |
| Отчёты по карте | Publish position to the public map — see the Map reporting group that follows |
Turning Map reporting on reveals a consent card headed Consent to Share Unencrypted Node Data via MQTT, with an I agree. switch under it. The rest of the card does not exist on screen until you agree:
| Настройка | Описание |
|---|---|
| Я согласен. | Explicit consent to transmit your node data, including an approximate position, unencrypted. Map reporting does not start without it |
| Precision slider | The slider has no label of its own. It sets how coarsely your position is published, from 12 to 15; the line beneath reads ± the resulting distance, in your own units |
| Интервал отчета карты (в секундах) | How often to report. A dropdown of fixed intervals from 1 hour to 72 hours — nothing shorter is offered |
См. MQTT для подробного руководства по использованию, включая шифрование, конфиденциальность и настройку брокера.
Последовательный модуль
Позволяет общаться через последовательный порт с внешними устройствами (GPS-модулями, датчиками или собственной техникой). Когда включено, последовательный порт ноды может отправлять и получать данные в формате protobuf или текст, что позволяет внешним микроконтроллерам или компьютерам взаимодействовать с сетью.
| Настройка | Описание |
|---|---|
| COM-порт включен | Включить последовательное соединение |
| Echo включен | Echo получил обратно последовательные данные |
| Режим COM-порта | Which protocol the port speaks — Default, Simple, Proto, Text message, NMEA, CalTopo, WS85 weather station, VE.Direct, MeshSolar config, Log, or Log (text only) |
| RX / TX | GPIO pins for the serial connection |
| Скорость COM-порта | Port speed |
| Время ожидания истекло | How long to wait before considering an incoming message complete |
| Переопределить COM-порт консоли | Take over the port the debug console normally uses |
Модуль внешних уведомлений
Управляет зуммером, светодиодом или вибрацией на вашем радиооборудовании. Полезно для устройств, которым нужно физически сигнализировать о приходе сообщения — особенно удобно для неоснащенных персоналом или уличных установок.
There are two independent triggers — an incoming message, and a received bell character — and each can drive the LED, the buzzer and the vibration motor separately, giving six toggles.
| Настройка | Описание |
|---|---|
| Внешние уведомления включены | Master toggle for the module |
| Alert message LED / buzzer / vibra | Which outputs fire on an incoming message |
| Alert bell LED / buzzer / vibra | Which outputs fire on a received bell character |
| Выход LED (GPIO) | Pin the LED is wired to |
| Вывод светодиода активный высокий | Whether the LED pin is active high or low |
| Выход Буззера (GPIO) | Pin the buzzer is wired to |
| Вибросигнал (GPIO) | Pin the vibration motor is wired to |
| Использовать PWM-звукоизлучатель | Drive the buzzer with PWM, which allows tones rather than a single pitch |
| Использовать I2S как буззер | Send the alert through an I2S audio output instead |
| Продолжительность вывода (миллисекунды) | How long a single alert lasts |
| Таймаут Nag (в секундах) | Keep repeating the alert for this long until it is acknowledged. 0 disables nagging |
| Рингтон | The tone played on a PWM buzzer, in RTTTL. Can be imported from a file |
Модуль Store & Forward
Буферизирует сообщения для узлов, которые временно были недоступны, а затем ретранслирует их, когда эти узлы переподключаются. Важное значение для сеток, где узлы входят и выходят вне диапазона регулярно - обеспечивает отсутствие потери сообщений при коротких разъединениях.
| Настройка | Описание |
|---|---|
| Store & Forward включен | Активировать режим хранения и пересылки |
| Heartbeat | Периодически объявлять о наличии функции хранения и пересылки у этого узла |
| Количество записей | Максимальное количество сохраненных сообщений |
| Макс возврат истории | Максимум сообщений для повтора |
| Окно возврата истории | Окно времени для повтора |
| Сервер | Действовать как сервер хранения и пересылки для mesh-сети (требуется большой объем памяти, например, ESP32 с PSRAM) |
💡 Совет: Хранение и пересылка лучше всего работает на узлах с достаточной памятью (ESP32 с PSRAM). Узлы маршрутизатора являются идеальными кандидатами, так как они обычно всегда включены.
Модуль проверки дальности
⚠️ Warning: Range Test only works on a secured primary channel. As long as your primary channel still uses the default channel key, the interval and CSV controls stay disabled — you can still switch an already-enabled module off — and saving force-disables the module if the channel has reverted to public.
Автоматизированный инструмент для проверки дальности и оценки качества связи между нодами. Когда включено, нода периодически отправляет сообщения с увеличивающимся счетчиком. Приёмная нода записывает эти сообщения, что позволяет тебе уйти пешком или уехать на машине, а потом проанализировать, на каком расстоянии сообщения перестали приходить.
| Настройка | Описание |
|---|---|
| Проверка дальности включена | Активировать проверку дальности |
| Интервал сообщений отправителя (в секундах) | Time between test transmissions, chosen from a dropdown of fixed intervals |
| Сохранить .CSV в хранилище (только ESP32) | Log received test data to the radio's own filesystem. ESP32 hardware only |
Модуль телеметрии
Контролирует какими телеметрическими данными ваш узел делится с сеткой. Телеметрия включает данные о состоянии устройства (заряд батареи, время работы) и данные с датчиков окружающей среды (температура, влажность, давление).
Each of the four metric groups has its own enable toggle and its own interval, so you can report battery health often and sensors rarely.
| Настройка | Описание |
|---|---|
| Отправлять телеметрию устройства | Master toggle for device metrics. Only shown on firmware 2.7.12 and newer |
| Интервал обновления метрик устройства | How often to report battery, uptime and channel utilization |
| Модуль метрик окружения включен | Report the attached environment sensors |
| Интервал обновления метрик среды | How often to report them |
| Показатели окружения на экране включены | Also show these readings on the device's own display |
| Использовать метрику окружения в Fahrenheit | Use °F on the device's display. This is the radio's screen only — the app follows your phone's locale, see Units & Locale |
| Модуль измерения качества воздуха включен | Report particulate and CO₂ sensor data |
| Интервал обновления данных качества воздуха | How often to report them |
| Модуль метрик питания включен | Report the per-channel voltage and current readings |
| Интервал обновления метрик электропитания | How often to report them |
| Включить метрики питания на экране | Also show power readings on the device's display |
Посмотрите Телеметрия и датчики — для получения информации о поддерживаемых датчиках и рекомендациях по настройке.
Модуль шаблонных сообщений
Pre-configured messages accessible from the radio's physical buttons (for radios with rotary encoders, keypads, or similar input hardware). Определите список быстрых сообщений, которые могут быть переданы без подключённого телефона — идеально подходит для использования в поле.
| Настройка | Описание |
|---|---|
| ⚠️ Deprecated in the protobuf schema | |
| Сообщения | Список сообщений, разделённых новой строкой |
| Отправить колокольчик | Send a bell character alongside the message, so a receiving node's External Notification module can sound |
| Поворотный энкодер #1 включен | Use a rotary encoder as the input device |
| GPIO pin for rotary encoder A / B / Press port | The three pins the encoder is wired to |
| Generate input event on Press / CW / CCW | Which key event each encoder action produces |
| Вверх/Вниз/Выбирать включён | A separate, simpler input scheme using up/down/select buttons rather than an encoder |
| ⚠️ Deprecated in the protobuf schema |
Звуковой модуль
Поддержка аудио Codec2 для низкополосной голосовой связи через сетку. Это экспериментальная функция, которая кодирует голос в очень маленькие пакеты данных с помощью кодека Codec2.
| Настройка | Описание |
|---|---|
| CODEC 2 включен | Активировать модуль аудио |
| Частота дискретизации CODEC2 | Компромисс между качеством звука и полосой пропускания |
| Контакт PTT | GPIO pin for the push-to-talk button |
| I2S Word Select | GPIO контакт для I2S WS |
| I2S Data In | Пин GPIO для I2S DIN |
| I2S Data Out | Пин GPIO для I2S DOUT |
| I2S Clock | GPIO pin for the I2S bit clock |
ℹ️ Note: Audio requires specific hardware (I2S microphone and speaker). Качество голоса очень низкополосное — представьте себе «разборчивую радиосвязь», а не качество телефонного звонка.
Удаленный аппаратный модуль
Управление GPIO через mesh-сеть. Позволяет удалённому узлу читать и записывать состояния выводов GPIO на другом узле — полезно для активации реле, опроса переключателей или удалённого управления внешним оборудованием.
⚠️ Warning: Turning on Allow undefined pin access gives remote nodes access to all GPIO pins, which could interfere with the radio's own hardware. Turn it on only on dedicated GPIO nodes.
| Настройка | Описание |
|---|---|
| Удаленное оборудование включено | Активировать удаленный GPIO доступ |
| Разрешить неопределённый контакт | Разрешить доступ к любому GPIO-пину (риск для безопасности) |
| Доступные контакты | До 4 пинов GPIO, которые этот узел предоставляет для удалённого чтения и записи |
Модуль информации о соседях
Транслирует информацию о доступных услышанных соседей, включив ячейку сеточной топологии. Каждый включенный узел периодически делится списком других узлов которые он может слышать и их качество сигнала.
| Настройка | Описание |
|---|---|
| Информация о соседях включена | Включить трансляцию соседей |
| Интервал обновления (в секундах) | Как часто транслировать список соседей |
| Передать через LoRa | Также транслировать информацию соседей по LoRa, а не только MQTT/телефон. Недоступно на канале используя ключ по умолчанию и имя |
See Local Mesh Discovery for how to use neighbor data for mesh topology exploration.
Модуль окружающего освещения
Управляет встроенными светодиодами NeoPixel или другими адресуемыми RGB-светодиодами на поддерживаемом оборудовании. Может использоваться для визуальных статусовых индикаторов, световых уведомлений, или декоративных эффектов.
| Настройка | Описание |
|---|---|
| Состояние LED | Включить или выключить светодиод |
| Ток | Текущий лимит светодиодов (0–31) |
| Красный / Зеленый / Синий | Индивидуальные значения цветов канала (0–255) |
Модуль определения датчика
Превращает ваш узел в систему сигнализации на основе датчика движения или открытия двери. При обнаружении изменения состояния на выводе GPIO (например, сработал датчик движения или открылась дверь) узел отправляет по меш-сети оповещение.
| Настройка | Описание |
|---|---|
| Датчик определения включен | Активировать датчик обнаружения |
| GPIO контакт для мониторинга | Пин GPIO, подключенный к датчику |
| Тип триггера обнаружения | Как состояние пина интерпретируется как событие обнаружения (например, активный высокий/низкий уровень, срабатывание по фронту) |
| Использовать режим INPUT_PULLUP | Включить внутренний подтягивающий резистор пина |
| Минимальная трансляция (в секундах) | Минимальный интервал между оповещениями |
| Трансляция состояния (в секундах) | Интервал периодической отправки состояния |
| Отправить колокол с уведомлением | Включать символ колокола в оповещения |
| Понятное имя | Пользовательское имя для этого датчика |
Paxcounter Модуль
People counter using Wi-Fi and BLE probe requests. Засчитывает ближайшие устройства, пассивно прослушивая зондирующие запросы, чтобы телефоны и ноутбуки излучали при сканировании сетей. Доступно только на устройствах ESP32.
| Настройка | Описание |
|---|---|
| Paxcounter включен | Активировать подсчет людей |
| Интервал обновления (в секундах) | Как часто сообщать подсчитывания |
| Wi-Fi RSSI threshold | Ignore Wi-Fi probes weaker than this, so distant devices are not counted (defaults to −80 dBm) |
| BLE RSSI threshold | The same cut-off for BLE advertisements (defaults to −80 dBm) |
💡 Совет: Paxcounter полезен для приблизительной оценки пешеходного потока в местах начала маршрутов, на мероприятийных площадках или в других локациях. Счетчики приблизительны — один человек может иметь несколько устройств.
Status Message Module
The status message has no module screen. It is edited with the rest of the node's identity, on Settings — Radio & User.
Mesh Beacon Module
Broadcasts an invitation to your mesh, and receives invitations from others. The entry appears only on radios running firmware 2.8.0 or newer. See Local Mesh Discovery for the full walkthrough.
Модуль TAK
Интеграция Team Awareness Kit для совместимости с ATAK и WinTAK. Two things have to be
true before the entry appears in the module list: the radio runs firmware 2.8.0 or newer, and its
Device Role on Settings → Device configuration → Device is set to TAK or TAK_TRACKER.
См. TAK Integration для детальной настройки и использования.
Администрирование
Удаленное администрирование
Удалённо настраивай ноды, которые используют твой ключ администрирования:
- Выбери целевую ноду в списке нод.
- Перейди в Настройки этой ноды.
- Измени конфигурацию.
- Нажми Сохранить — изменения отправляются через сеть.
⚠️ Important: Requires an admin key configured on both your node and the target node.
Device Actions
Settings → Administration holds five one-shot actions, each behind a confirmation dialog:
| Действие | Что она делает |
|---|---|
| Установить время | Sends your phone's clock to the radio |
| Перезагрузка | Restarts the radio |
| Выключение | Powers the radio down |
| Сброс до заводских настроек | Returns every setting to its factory default |
| Очистка списка нод сети | Clears the radio's node database. This dialog carries a Preserve Favorites? switch |
⚠️ Warning: Factory reset erases all settings, channels, and keys, and cannot be undone. Before you reset, use Export configuration to save the radio's settings and Backup Keys on the Security screen to save its keys, so you can put both back afterwards.
Бэкап & Восстановление
Settings → Backup & Restore writes the connected radio's whole configuration to a file with Export configuration, and reads a saved file back in with Import configuration. Export before a factory reset, or to copy one radio's setup onto another. The section is shown for your own radio only, not over remote admin.
Расширенные
Settings → Advanced collects the tools that read or rewrite local state, and is likewise shown for your own radio only: Firmware Update on OTA-capable hardware, Clean Node Database, TAK Server, Local Mesh Discovery, and the Debug Panel.
Очистить базу данных нод
Prunes nodes from your node database — from the app's copy and from the radio's own, so this is not a display-only cleanup. The two filters combine rather than acting separately; the screen puts it as Selections are additive.
- Clean up nodes last seen older than N days — always applied. The slider runs from 7 days to 365 and starts at 30; with Clean up only unknown nodes turned on, its floor drops to 0.
- Clean up only unknown nodes — narrows the same purge to nodes that never sent their user info. The age limit still applies on top of it.
The screen lists the nodes queued for deletion as you move the filters. Clean Now carries the purge out, after one more confirmation, and it cannot be undone. Favorited nodes, ignored nodes, and nodes with a public key heard in the last seven days are never removed, whatever the filters say — that is why the queued list can be shorter than you expect.
Панель отладки
Открывает вкладки Пакет и Журналы приложений для просмотра, фильтрации и экспорта диагностических выходов. См. Отладочные журналы для полного прохождения.
App Settings
Two easy-to-miss entries on the Settings screen configure the app rather than the radio, and appear only when your own node is selected:
- Node Layout — how much detail each row of the node list shows.
- Message Filter — hides incoming messages that contain words you list. With no words configured it does nothing.
О приложении
Settings → About carries the app's own identity rather than the radio's:
Three sections:
- What is Meshtastic? — a short description of the project.
- Apps — opens with Need Hardware?, a rotating carousel of popular devices that links out to where to buy one. It also lists the GitHub repository, the running app version, and Acknowledgements (see the next section).
- Project information — links to the website and to this documentation.
Благодарности
Reached from About, this lists every open-source library the app ships, with its license, generated at build time by AboutLibraries. It was previously called the license screen.
Устранение неполадок удалённого администрирования
- "Нет ответа от целевого узла" — цель может находиться вне диапазона, в автономном режиме или иметь несоответствующий ключ администратора. Проверьте соответствие ключа администратора на обоих узлах.
- Изменения не применены — чтобы некоторые настройки вступили в силу, нужно перезагрузить устройство. Попробуй перезагрузить после сохранения.
- Не видны настройки удалённой ноды — убедись, что твоя нода имеет админ-ключ для целевой ноды. Админ-канал настраивается автоматически, когда задан ключ администратора.
Связанные темы
- Настройки — Радио и Пользователь — основные настройки радио и профиля пользователя
- Ссылка на конфигурацию модуля — подробная документация по модулям на meshtastic.org
- FAQ — общие вопросы на meshtastic.org