Интеграции

Интеграции — это всё, что связывает mesh‑сеть с внешними системами: логирование, боты, мосты в другие чаты, мониторинг, карты и т.п.

warning

Интеграции почти всегда увеличивают трафик. В mesh‑сетях это быстро превращается в задержки и потери, если не контролировать интервалы и объём данных.

Главные принципы

1. Не перегружайте эфир. Интеграции легко превращают сеть в “телеметрию каждую секунду”.
2. Минимизируйте утечки приватности. Координаты, имена нод, история сообщений — это персональные данные в контексте сообщества.
3. Делайте интеграционную ноду отдельно. Лучше одна стабильная стационарная нода, чем “бот” на каждом телефоне.

Рекомендуемый подход

• Выделите одну ноду под интеграции (стационарно, питание постоянно, хорошая антенна).
• Сначала убедитесь, что сеть стабильна без интеграций.
• Включайте функции постепенно и проверяйте влияние на задержки/потери.

Если появились задержки, коллизии и “всё стало хуже” — см. Производительность сети.

---

MQTT: самый частый “мост”

MQTT в Meshtastic вынесен в отдельную страницу: MQTT.

Если коротко, он нужен для:

• интеграций с Home Assistant, Node‑RED и скриптами;
• логирования;
• карт и мониторинга;
• связи между mesh‑сетью и интернет‑инфраструктурой.

Базовое правило остаётся тем же:

• не включайте MQTT “везде”;
• используйте одну интеграционную ноду;
• следите за объёмом трафика, downlink и приватностью.

Home Assistant

Home Assistant (HA) — популярная платформа для домашней автоматизации. Интеграция Meshtastic для HA позволяет использовать данные mesh‑сети для автоматизации, мониторинга и управления устройствами.

Расширение для Home Assistant на GitHub

Поддерживает соединения с нодой через:

• TCP/IP
• Последовательный порт
• Bluetooth (также работает с HA Bluetooth-прокси).

Поддерживаемые функции:

• Автоматическое обнаружение устройств по IP, Bluetooth и USB-Serial
• Прокси режим, позволяет использовать любые другие клиенты поверх интеграции (интеграция продолжить работать)
• Метрики узлов Meshtastic
• Запись полученных сообщений
• Отправка сообщений (в том числе в личку)
• Запись геолокаций нод
• Триггеры и действия устройств для автоматизации
• Другие действия (например, запрос метрик, трассировки маршрута).
• Поддержка прокси-сервера MQTT-клиента (Эта интеграция не требует MQTT, поэтому Вы можете использовать его для других интеграций).
• Интеграция веб клиента Meshtastic в Home Assistant.

Установка и настройка

1. Установите расширение в HA по инструкции из GitHub.
2. Перейдите в настройки Home Assistant Устройства и службы → Интеграции → Добавить интеграцию → Meshtastic. (возможно, на этапе Устройства и службы будет предложено сразу добавить ноду, перейдите к пункту 4, если это так).
3. Выберите способ подключения (TCP/IP, Bluetooth или Serial) и введите необходимые параметры (IP-адрес, порт, имя устройства и т.д.).
4. Вам будет предложено выбрать, какие функции включить:
   • Selected Nodes: Выберите, для каких сторонних нод включать интеграцию (эти ноды будут отображаться в HA и им можно будет отправлять сообщения).
   • Notification Platform:
     • Create Notification Targets for all Channels: Создаёт цель уведомлений для каждого канала, что позволяет отправлять сообщения в эти каналы через HA.
     • Create Direct Messages Notification Targets for:
       • None of the Nodes: Не получать уведомления о личных сообщениях от нод.
       • All known and newly discovered Nodes: Получать личные сообщений от всех известных и новых нод.
       • Selected Nodes: Получать личне сообщений только выбранных нод. (рекомендуется что бы не захламлять HA лишними нодами)
   • Meshtastic Web Client: Включает интеграцию Meshtastic веб клиента в HA (будет отображаться в меню слева).
   • Meshtastic TCP Proxy: Позволяет подключаться другим клиентам через расширение:
     • Enable TCP Proxy: Включить ли эту функцию.
     • TCP Proxy Port: Порт для TCP-прокси, можно менять если подключаете несколько нод к HA.
5. Сохраните настройки и дождитесь, пока HA добавит ноду. После этого вы увидите её в списке устройств и сможете использовать её данные для автоматизаций, мониторинга и управления.