Интеграция счетчиков воды Saures в Home Asssistant

Как всё начиналось

Когда-то, чуть ли не в прошлой жизни, я хотел снимать показания со счетчиков воды автоматически и присылать их себе по SMS. Благо счетчики Valtec с необходимым импульсным выходом были в наличии. По-быстрому был найден пример в сети для Arduino и он был реализован. Но или пример был не удачен, или руки немного кривые, но работало нестабильно и, впоследствии, идея была заброшена.

Спустя много лет

Умный дом на базе Home Assistant настроен и функционирует, и вдруг я узнаю, что существуют контроллеры Saures, которые мало того, что умеют снимать показания со счетчиков воды (и не только с них, так еще и умеют отправлять эти данные в Мосводоканал.

Дело было вечером, делать было нечего и не долго думая, контроллер Saures R2 M5 был заказан, и спустя несколько дней получен.

Установка

Установка по инструкции заняла минут 10.  И вроде всё было подключено правильно, но, провозившись час и всё перепроверив, так  ничего не работало. И тут я обратил внимание на одну вещь.

Вот так выглядело в инструкции.

А вот так у меня.

Если кто еще не понял. На моем экземпляре наклейки с номерами выходов перепутаны. За минуту поменял номера выходов в настройках и всё тут же заработало.

Сотрудники Saures, если вы вдруг читаете эту статью - у вас хорошее устройство. Но вот такие мелочи сильно портят впечатление

Home Assistant (HA)

Так как HA был уже развёрнут и успешно использовался, естественно, возникло желание вывести в него показания и отслеживать заряд батареек в контроллере Saures. 

За 5 минут поисков был найден вот этот вот плагин. Автор хочет за него 150 р комиссия = 165 рублей. Но, как известно, часто бывает просто лень  делать самому. Соответственно, я честно заплатил за него. Установил и он вполне рабочий. Но, как оказалось, не выводит часть данных, приходящих от контроллера по Saures API (отдельно про него чуть ниже) и выводит информацию только по счетчикам, то есть заряд батареи, например, там не доступен.

Ну что же, видимо придется делать самому.

Первым делом, я запросил описание API у Saures (оно у них высылается по запросу) и вскоре мне его прислали. Но присланный документ вызывал у меня смешанные чувства, с одной стороны - в нем вроде описано API, а с другой - описание почти совсем не совпадает с реальностью, которую я, к тому моменту, уже реализовал, используя Postman. Кому интересно - можно скачать готовые запросы. 

В итоге, позаимствовавши чуть-чуть (на данный момент уже менее 10%) кода из купленного ранее аддона (надеюсь, автор не будет на меня обижаться), был написан cвой, со всем необходимыми плюшками.

Плагин доступен на sprut.ai. Выглядит это так:

Не буду здесь расписывать процесс установки, он достаточно стандартен и, опять же, расписан в разделе плагины на портале sprut.ai.

А теперь главное - зачем была написана эта статья:

• рассказать о своём опыте;
• поделиться разработанным проектом. Ведь, как известно: "Делай добро людям и оно не раз еще к тебе вернется"

Если кто вдруг захочет поддержать развитие проекта - милости просим. Если кто-то считает, что платить автору - это баловство, то по секрету - проект есть на GitHub. :)