Найти в Дзене

Добавляем Qingping Air Monitor Gen 2 (CGS2) в умный дом Home Assistant (HA)

Я стал счастливым обладателем Qingping Air Monitor Gen 2 (CGS2) — компактного и стильного монитора качества воздуха. Так как у меня уже есть сервер с Home Assistant, то я сразу же решил разобраться, как интегрировать CGS2 в свою систему умного дома. В этой статье я поделюсь своим опытом и нюансами, с которыми столкнулся. Зачем вообще нужен монитор качества воздуха?
Мы проводим большую часть жизни в помещениях, и микроклимат в них напрямую влияет на наше самочувствие, продуктивность и здоровье. Высокий уровень CO₂ вызывает сонливость и затрудняет концентрацию, слишком сухой или влажный воздух провоцирует респираторные заболевания, а летучие органические соединения (VOC) от новой мебели или строительных материалов могут быть хоть и не заметны, но ощутимо вредны. Именно такой прибор, как Qingping Air Monitor, призван показать полную картину того, что мы обычно не видим, и помочь принять меры: вовремя проветрить комнату, включить увлажнитель или очиститель воздуха. Я уже больше трех лет по
Оглавление

Я стал счастливым обладателем Qingping Air Monitor Gen 2 (CGS2) — компактного и стильного монитора качества воздуха. Так как у меня уже есть сервер с Home Assistant, то я сразу же решил разобраться, как интегрировать CGS2 в свою систему умного дома. В этой статье я поделюсь своим опытом и нюансами, с которыми столкнулся.

В режиме ожидания. Состояние практически сразу после проветривания.
В режиме ожидания. Состояние практически сразу после проветривания.

Введение

Зачем вообще нужен монитор качества воздуха?
Мы проводим большую часть жизни в помещениях, и микроклимат в них напрямую влияет на наше самочувствие, продуктивность и здоровье. Высокий уровень
CO₂ вызывает сонливость и затрудняет концентрацию, слишком сухой или влажный воздух провоцирует респираторные заболевания, а летучие органические соединения (VOC) от новой мебели или строительных материалов могут быть хоть и не заметны, но ощутимо вредны.

Именно такой прибор, как Qingping Air Monitor, призван показать полную картину того, что мы обычно не видим, и помочь принять меры: вовремя проветрить комнату, включить увлажнитель или очиститель воздуха.

Главный экран. Состояние спустя время. CO₂ заметно повышен. Датчик PM2.5, PM10 отключился по таймеру, чтобы не нарушать ночную тишину. Хотя ради справедливости отмечу, он тихий.
Главный экран. Состояние спустя время. CO₂ заметно повышен. Датчик PM2.5, PM10 отключился по таймеру, чтобы не нарушать ночную тишину. Хотя ради справедливости отмечу, он тихий.

Предыстория

Я уже больше трех лет пользуюсь чем-то подобным из ESP8266 и датчика AM2302, собранного на коленке в картонную коробку.

Костыльный ардуиновский код и тем более внешний вид я даже показывать не хочу)

Хотя веб-мордочку могу показать:

-3

Со временем эта штука разрасталась.

Купили увлажнитель — для управления им появился ИК-светодиод и синяя кнопка в центре гигрометра.

Купили новогодние гирлянды — для управления ими добавил силовой выход на реле и радиомодуль 433МГц для радиореле.

Появился в доме HA — дописал эндпоинты для чтения датчиков и управления всем перечисленным (и возможным).

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

Апдейт невозможен

Да, были мысли набрать датчиков и собрать что-то свое. Но ящики с незавершенными проектами и так ломятся от своей длины.

Потому, поприкинув себестоимость, поразмыслив о времени на проект, пришел к выводу, что для меня будет вполне оправдано купить готовое.

По моим ощущениям на рынке не так много устройств, у которых значения действительно точные.

Или хотя бы в корпусе есть датчик, который измеряет конкретно то, единицы чего мы видим на экране. Имею ввиду устройство не занимается вычислением, например, того же CO₂, интерполяцией по некой таблице на основе значения с некого "датчика качества воздуха", который неизвестно на что и как реагирует.
Безусловно, значения у такого "прибора" будут совпадать с реальностью. Вопрос только когда и как часто?)

Выбор среди множества пал на CGS2. По нему много положительных отзывов. Является развитием CGS1, что я воспринял как "версию после исправления болячек". Стильный дизайн. Много датчиков. И самое главное — хороших датчиков. Может интегрироваться в HA.

Ну да ладно, пора перейти к основному — к интеграции CGS2 в HA!

Интеграция через MQTT

Я нашел полезный пост о настройке локального MQTT и добавлении в HA старшей модели, CGS1. Примерно на 80% вся инструкция применима и к CGS2. Оставшиеся 20% — как раз те нюансы и мои отличия, о которых и пойдет речь.

1. Регистрация в Qingping

Первое, с чем я столкнулся, — невозможность зайти на https://developer.qingping.co по номеру телефона. СМС с кодом приходил, но форма ругалась на неправильный формат номера. Пришлось зайти в мобильное приложение Qingping и привязать к своему аккаунту адрес электронной почты. После этого вход через почту на сайте разработчика прошел без проблем.

2. Получение доступа к MQTT

В инструкции по ссылке выше был переход в раздел "Private Access Config". Сейчас для него немного иная ссылка: https://developer.qingping.co/private/access-configuration. В остальном логика осталась той же: создаем конфигурацию с MQTT-брокером и привязываем к ней устройство.

3. Уменьшение периода отправки значений по MQTT

Далее по статье идет уменьшение периода отправки значений, чтобы данные в HA обновлялись чаще. Я повторил это через веб-интерфейс HA.

4. Добавление устройства в Home Assistant

А вот здесь начинается самое интересное — создание пакета для устройства packages/air_monitor.yaml. Интересно оно тем, что у CGS2 отличается набор датчиков и тип возвращаемых значений по сравнению с CGS1. Во-первых, в CGS2 добавился датчик уровня акустического шума. Во-вторых, датчик TVOC теперь возвращает не ppb (части на миллиард), а индекс качества воздуха (по шкале швейцарской компании Sensirion).

Поэтому конфигурацию пришлось адаптировать.
Код прямо здесь размещать не стал, т.к. платформа не оптимизирована для этого. Потому забирайте прям файлом
air_monitor.yaml с моего сервера.

В нем вам нужно будет заменить 582D34FFFFFF на MAC вашего устройства.

А так же убедиться, что в вашем configuration.yaml есть строчки, которые подключают папку с пакетами:

homeassistant:
packages: !include_dir_named packages

Выполняем перезагрузку конфигурации YAML в Home Assistant (Настройки -> Система -> Перезагрузка -> Перезагрузить конфигурацию YAML) и на этом всё! Мы должны увидеть новое устройство и все его сенсоры на панели HA.

Виджет CGS2 в HA. Значения практически сразу после проветривания.
Виджет CGS2 в HA. Значения практически сразу после проветривания.

Интересности

Во время написания статьи я наткнулся на готовую кастомную интеграцию для HA.
Сам я ее уже не пробовал, но присмотрел кое-что интересное в ней:

eTVOC Sensor: The sensor can be set to 3 different measurement units, by default it is VOC index. The component converts from voc index to get ppb and mg/m³.
ppb = ( math.log ( 501 - voc_index ) - 6.24) * -2215.4
mg/m³ = ( ppb * 4.5 * 10 + 5 ) / 10 / 1000

Получается при желании в моем конфиге можно будет изменить единицу измерений на ту, которая удобна вам. Хотя предупреждаю, что не знаю, насколько можно верить этим формулам и откуда взялись коэффициенты.

Еще встречал на форумах сообщения, что значения температуры и влажности сильно отличаются от реальных. Эталонного прибора нет, но в сравнении с AM2302, который находится в той же комнате и на высоте, отличающейся менее чем на метр, удаленном от CGS2 не более чем на два, я сильных отличий не наблюдал.

Для примера значения на момент написания этого предложения AM2302/CGS2: 24,0/23,7 °C, 46,4/41,2%. Тут либо оба врут в одну сторону и потому значения отличаются на уровне погрешности, либо мне попался экземпляр без дефекта.

Заключение

В общем-то CGS2 пока полностью оправдывает мои ожидания. Показаниям не верить он поводов не давал. Мои опасения по поводу периодически высокого CO₂ в комнате - подтвердил. С HA тоже заработал. В общем я доволен.

Реклама.
Если моя статья была вам полезна и вы решили приобрести CGS2, то буду благодарен, если вы перейдете по
моей ссылке. Так я получу небольшое вознаграждение от магазина, а для вас цена не изменится.
В дополнение скажу, что мне он достался примерно за 9 тысяч рублей.