Главная / Аддоны / MQTT учебник
📡 Страница 39 из 59

Инструкция по MQTT

Полное руководство по настройке и использованию протокола MQTT в Home Assistant для создания умного дома

Что такое MQTT?

📡

MQTT (Message Queuing Telemetry Transport)

MQTT — это легковесный протокол обмена сообщениями, разработанный для устройств с ограниченными ресурсами и низкой пропускной способностью сети. Он идеально подходит для интернета вещей (IoT) и умного дома.

💡 Преимущества MQTT в Home Assistant:

  • ✅ Низкое потребление трафика и ресурсов
  • ✅ Быстрая передача данных в реальном времени
  • ✅ Поддержка множества устройств и датчиков
  • ✅ Гибкая система топиков (тем)
  • ✅ Надежная доставка сообщений

Установка MQTT Брокера

1

Установка Mosquitto Broker

Перейдите в Настройки → Дополнения → Магазин и найдите "Mosquitto broker"

Нажмите "Установить" и дождитесь завершения установки

2

Запуск брокера

После установки нажмите "Запустить" в карточке Mosquitto broker

Брокер запустится и будет готов к настройке

3

Настройка параметров

Откройте настройки Mosquitto broker и настройте параметры

# Пример конфигурации Mosquitto broker
logins: []
anonymous: false
customize: {
  "active": true,
  "folder": "/mosquitto"
}
certfile: "fullchain.pem"
keyfile: "privkey.pem"
require_certificate: false

⚠️ Важно: Безопасность

Никогда не используйте анонимный доступ в production среде! Всегда создавайте пользователей с надежными паролями.

Настройка интеграции MQTT

1

Добавление интеграции

Перейдите: Настройки → Устройства и службы → Интеграции

Нажмите кнопку "+ Добавить интеграцию"

2

Поиск MQTT

В поиске введите "MQTT" и выберите интеграцию "MQTT"

Нажмите "Отправить"

3

Настройка подключения

Заполните форму настройки:

🌐 Сервер

Адрес: core-mosquitto (для локального брокера)

Порт: 1883 (по умолчанию)

🔐 Аутентификация

Логин: ваш логин

Пароль: ваш пароль

📋 Параметры

Birth message: онлайн статус

Will message: оффлайн статус

# configuration.yaml
mqtt:
  sensor:
    - name: "Температура"
      state_topic: "home/sensor/temperature"
      unit_of_measurement: "°C"
      value_template: "{{ value_json.temperature }}"

    - name: "Влажность"
      state_topic: "home/sensor/humidity"
      unit_of_measurement: "%"
      value_template: "{{ value_json.humidity }}"

✅ Успешное подключение

После успешной настройки вы увидите сообщение "Настройка интеграции MQTT завершена". Интеграция появится в списке настроенных интеграций.

Примеры устройств

1

Датчик температуры

# Датчик температуры
mqtt:
  sensor:
    - name: "Датчик температуры"
      unique_id: "temp_sensor_01"
      state_topic: "home/sensors/livingroom/temperature"
      device_class: "temperature"
      unit_of_measurement: "°C"
      value_template: "{{ value | float }}"
2

Переключатель (Switch)

# Переключатель света
mqtt:
  switch:
    - name: "Свет в гостиной"
      unique_id: "livingroom_light_01"
      command_topic: "home/livingroom/light/command"
      state_topic: "home/livingroom/light/state"
      payload_on: "ON"
      payload_off: "OFF"
      state_on: "ON"
      state_off: "OFF"
3

Датчик движения

# Датчик движения
mqtt:
  binary_sensor:
    - name: "Датчик движения"
      unique_id: "motion_sensor_01"
      state_topic: "home/sensors/motion"
      device_class: "motion"
      payload_on: "motion"
      payload_off: "no_motion"

💡 Совет: Именование топиков

Используйте иерархическую структуру топиков для лучшей организации:

  • 📂 home/этаж/комната/устройство/параметр
  • 📂 Пример: home/first_floor/livingroom/light_01/state

Автоматизация с MQTT

MQTT идеально подходит для создания автоматизаций. Вот примеры практического применения:

# automatons.yaml
- alias: "Включить свет при движении"
  trigger:
    - platform: "mqtt"
      topic: "home/sensors/motion"
      payload: "motion"
  action:
    - service: "mqtt.publish"
      data:
        topic: "home/livingroom/light/command"
        payload: "ON"

- alias: "Уведомление о температуре"
  trigger:
    - platform: "numeric_state"
      entity_id: "sensor.temperature"
      above: 25
  action:
    - service: "notify.telegram"
      data:
        title: "Температура"
        message: "Температура выше 25°C!"
🌅

Утренняя автоматизация

Включение света и кофе-машины по расписанию

🌙

Вечерний режим

Отключение ненужных устройств и плавное освещение

🔥

Безопасность

Мониторинг датчиков и уведомления

Расширенные возможности

1

Автоматическое обнаружение (Discovery)

MQTT Discovery позволяет автоматически добавлять устройства в Home Assistant без ручной настройки.

# Пример Discovery сообщения
topic: "homeassistant/sensor/temperature/config"
payload: {
  "name": "Температура",
  "device_class": "temperature",
  "state_topic": "home/sensor/temp/state",
  "unit_of_measurement": "°C",
  "value_template": "{{ value_json.temperature }}"
}
2

Last Will и Testament

Автоматическое уведомление при потере связи с устройством.

# Настройка LWT
mqtt:
  sensor:
    - name: "Статус устройства"
      state_topic: "home/device/status"
      availability_topic: "home/device/available"
      payload_available: "online"
      payload_not_available: "offline"
3

Retain сообщения

Сохранение последнего значения в топике для новых подписчиков.

# Публикация с retain
service: mqtt.publish
data:
  topic: "home/sensor/temperature"
  payload: "22.5"
  retain: true

Решение проблем

❌ Устройство не подключается

Решение: Проверьте правильность адреса брокера, порта и учетных данных. Убедитесь, что брокер запущен.

❌ Датчик не обновляется

Решение: Проверьте топик (topic) - он должен точно совпадать с тем, который публикует устройство. Используйте MQTT Explorer для мониторинга.

❌ Автоматизация не срабатывает

Решение: Проверьте логи Home Assistant. Убедитесь, что триггер правильно настроен и топики совпадают.

❌ Ошибка аутентификации

Решение: Проверьте логин и пароль в настройках интеграции. Убедитесь, что пользователь создан в настройках Mosquitto broker.

🔧 Полезные инструменты

  • 📊 MQTT Explorer: Графический интерфейс для работы с MQTT
  • 💻 mosquitto_pub/sub: Командная строка для тестирования
  • 📝 Логи Home Assistant: Панель управления → Система → Логи

Заключение

📚 Что вы узнали

MQTT - это мощный и гибкий протокол для создания умного дома на базе Home Assistant. С его помощью вы можете:

  • ✨ Подключать множество различных устройств
  • ⚡ Создавать быстрые автоматизации
  • 🔒 Обеспечивать надежную передачу данных
  • 📈 Масштабировать систему умного дома

🎉 Поздравляем!

Теперь вы знаете основы работы с MQTT в Home Assistant. Начните с простых устройств и постепенно усложняйте систему!