Подключение NeboAir к Home Assistant через MQTT

Подключение NeboAir к Home Assistant

Интеграция не самая приятная тема для пользователя, который начала путь с Home Assistant (это я). В нашем датчике мы сделали возможность подключения через MQTT и я решил пошагово пройти этот путь сам.

В мире технологий "умного дома" ключевое значение имеет возможность подключения. Разработанный специально для Интернета вещей (IoT), MQTT представляет собой легкий транспортный уровень обмена сообщениями, который упрощает коммуникацию в умных домах. Даже при отключении от сети интернет, отправка MQTT-сообщений будет продолжаться.

Настройка брокера MQTT и Mosquitto на Home Assistant

Для взаимодействия через MQTT нам нужен MQTT-брокер для управления, хранения и обработки сообщений.

Прежде чем приступить к настройке, убедитесь, что у вас включен "расширенный режим". Для этого откройте свой профиль в Home Assistant и включите "расширенный режим".

Начало работы

Чтобы найти и установить Mosquitto, выполните следующие действия:

1. Во фронтенде/доме домашнего помощника перейдите в меню Настройки

2. Нажмите Дополнения

3. В правом нижнем углу щелкните ADD-ON STORE

4. Перейдите в поле Поиск дополнений

5. Введите Mosquitto broker

6. Выберите Mosquitto broker из списка

7. Нажмите УСТАНОВИТЬ и дождитесь установки Mosquitto broker

8. Нажмите START, чтобы запустить брокер

9. Перейдите на вкладку Журнал и убедитесь, что брокер был успешно запущен.

Затем вам нужно установить редактор файлов и произвести необходимые настройки:

1. В правом нижнем углу нажмите ADD-ON STORE

2. Перейдите в поле Поиск дополнений

3. Введите File editor

4. Выберите Файловый редактор из списка

5. Нажмите УСТАНОВИТЬ и дождитесь установки Файлового редактора

6. Нажмите ЗАПУСК

7. Нажмите кнопку Открыть веб-интерфейс

8. Нажмите на значок папки

9. Затем пропишите следующее значение в файле mqtt.yaml (Или вы можете загрузить готовый файл mqtt.yaml, скачав его по этой ссылке) :

sensor:
  - name: "neboair_pressure"
    state_topic: "homeassistant/pressure"
    device_class: "pressure"
    unit_of_measurement: "mmHg"
  - name: "neboair_humidity"
    state_topic: "homeassistant/humidity"
    device_class: "humidity"
    unit_of_measurement: "%"
  - name: "neboair_temperature"
    state_topic: "homeassistant/temperature"
    device_class: "temperature"
    unit_of_measurement: "°C"
  - name: "neboair_pm01"
    state_topic: "homeassistant/pm01"
    device_class: "pm1"
    unit_of_measurement: "µg/m³"
  - name: "neboair_pm10"
    state_topic: "homeassistant/pm10"
    device_class: "pm10"
    unit_of_measurement: "µg/m³"    
  - name: "neboair_pm25"
    state_topic: "homeassistant/pm25"
    device_class: "pm25"
    unit_of_measurement: "µg/m³"
  - name: "neboair_aqi"
    state_topic: "homeassistant/aqi"
    device_class: "aqi"

10. Затем добавьте следующее значение в файл configuration.yaml и сохраните настройки:

mqtt: !include mqtt.yaml

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

Теперь, вам нужно создать учетную запись пользователя mqtt.

1. Перейдите в меню Настройки

2. Нажмите на Пользователи

3. Нажмите на ДОБАВИТЬ ПОЛЬЗОВАТЕЛЯ в правом нижнем углу

4. Введите имя, в данном примере мы будем использовать nebo-mqtt

5. Введите пароль и подтвердите его (желательно не использовать логины и пароли длиннее 16 символов)

6. Нажмите кнопку СОЗДАТЬ

Настройки MQTT в приложении

Подключитесь к датчику с помощью приложения Nebo и заполните следующие поля в настройках MQTT:

1. IP-адрес устройства, на котором установлен Home Assistant

2. Порт

3. Имя созданного вами пользователя, в примере nebo-mqtt

4. Пароль для этого пользователя

5. В последнем поле введите имя "homeassistant"

Интеграция MQTT

1. Перейдите в меню Настройки

2. Нажмите на Devices & Services

3. Убедитесь, что вы находитесь в разделе Интеграции (показан в верхней части экрана).

4. MQTT должен появиться как обнаруженная интеграция в верхней части страницы

5. Нажмите на кнопку CONFIGURE на интеграции MQTT

6. Нажмите кнопку SUBMIT

7. Нажмите FINISH

Изменение конфигурации

1. Щелкните на конфигурации MQTT

2. Нажмите кнопку Настроить

3. Нажмите Переконфигурировать MQTT

4. Включите расширенный режим

5. Увеличьте значение параметра keep alive до 280 сек.

6. Измените версию протокола MQTT на версию 5.

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

Мы проделали длинный пусть, но теперь Nebo Air теперь подключен к Home Assistant!

Возможно для большинства читателей Хабра это был очевидный и простой путь, но я надеюсь этот опыт был полезен нашим пользователям, которые еще только задумываются над созданием своих умных домов с Home Assistant.