Пожертвование на развитие проекта Яндекс.Деньги
- сделан переход на новое клиентское API
- добавлена необязательная настройка для sensor - scan_interval. Время обновления в минутах. По умолчанию = 10 минут.
- из-за перехода появились новые атрибуты у сенсоров.
- уменьшено количество вызово API
- ускорена первоначальная инициализация модуля
- сделан переход на асинхронные методы
- исправлена ошибка с заднием своего scan_interval
- исправлена ошибка связанная с наличием русских букв в серийных номерах
- на стороне Saures явно починили кеширование для нового API
- вернул синхронные вызовы
- Существенно сокращено кол-во обращений к серверу Saures, для предотвращения блокировки.
Рекомендую в настройках указать:
scan_interval:
minutes: 30Иначе могут быть блокировки в будущем.
- значительно изменен механизм настройки
- можно задавать свои мена для всего
- можно в настройках делать ссылки на !secret
- добавил в manifest, version
- полностью переработан код для минимизации обращений к серверу Saures
- внедрен асинхронный режим работы
- Добавлено управление кранами
- настройка через GUI
- обновление модуля под Home Assistant 2025.1+ / 2026.x (актуальная версия на момент релиза)
- внедрён DataUpdateCoordinator: один опрос API Saures на все сущности вместо индивидуального polling
- сущности переведены на SensorEntity / BinarySensorEntity / SwitchEntity + CoordinatorEntity
- корректные device_class и единицы измерения (вода, газ, энергия, температура)
- исправлен OptionsFlow для совместимости с HA 2025.12+ (больше не падает при открытии параметров)
- добавлены unload/reload интеграции при изменении настроек
- обновлены manifest.json / hacs.json (
iot_class: cloud_polling,integration_type: hub) - исправлены ошибки API: auth lock, имя неизвестных контроллеров, URL команды управления краном
- устойчивость к обрывам связи с api.saures.ru (
Connection reset by peer): User-Agent как в доке API (HTTPie), отдельная IPv4-сессия, повтор запросов - сенсоры, binary_sensor и switch группируются в устройство контроллера в реестре устройств Home Assistant
- требуется Home Assistant >= 2025.1.0
- docstring’и функций и классов переведены на русский язык
- сущности обновляют состояние через
_attr_*(совместимость сcached_propertyв новых версиях HA) - исправлен старт интеграции: убрана пауза 10 сек между объектами при первом опросе (больше не возникает
CancelledError/ ошибка setup entry)
- исправлена ошибка сенсоров многотарифной электроэнергии со значением вида
4803.08/1774.58(больше не выставляется unitkWhдля комбинированной строки) - для тарифов T1..Tn создаются отдельные числовые сенсоры в кВт·ч
- исправлена ошибка
AttributeError: __attr_native_unit_of_measurementпри создании сенсоров на новых версиях Home Assistant
- исправлена типизация преобразования показаний:
float()не вызывается дляNone
- добавлена поддержка датчика давления (тип Saures 14, бар)
- добавлена поддержка теплосчётчиков типов 11 (кВт·ч) и 13 (Гкал)
- ошибка одного счётчика при setup больше не блокирует остальные сенсоры объекта
- binary_sensor «Подозрительный расход» для счётчиков холодной/горячей воды и газа (API state.number = 3)
- событие Home Assistant
sauresha_suspicious_consumptionпри срабатывании - у счётчиков: атрибуты
condition_number,suspicious_consumption - у контроллера: атрибуты
suspicious_consumption,suspicious_consumption_meters
- у датчика давления корректно выставляются unit (бар), device_class (pressure) и state_class (measurement)
Для связи: master@g-s-a.me
Интеграция котроллеров Saures c Home Assistant
В настоящее время поддерживаются следующие типы устройств от Saures (номер типа по API):
- Счётчик холодной воды (м³) = sensor в Home Assistant
- Счётчик горячей воды (м³) = sensor в Home Assistant
- Счётчик газа (м³) = sensor в Home Assistant
- Датчик протечки (0 – нет протечки, 1 – протечка) = binary_sensor в Home Assistant
- Датчик температуры (°C) = sensor в Home Assistant
- Электро-шаровой кран / реле — управление (0 – открыться, 1 – закрыться) = switch в Home Assistant
- Счётчик тепла = sensor в Home Assistant
- Счётчик электричества (кВт·ч), в том числе многотарифные (отдельные сенсоры T1..Tn) = sensor в Home Assistant
- Датчик / сухой контакт (0 – деактивирован, 1 – активирован) = binary_sensor в Home Assistant
- Состояние электро-шарового крана = binary_sensor в Home Assistant
- Счётчик тепла (кВт·ч) = sensor в Home Assistant
- Счётчик тепла (Гкал) = sensor в Home Assistant
- Датчик давления (бар) = sensor в Home Assistant
— Непосредственно сами контроллеры = sensor в Home Assistant
— Подозрительный расход по счётчикам воды/газа (API state = 3) = binary_sensor + событие
sauresha_suspicious_consumption
- Добавляем компонент в Home Assistant Распаковываем архив. Папку sauresha берем целиком и копируем в custom_components.
- Осуществляем конфигурацию компонента в Home Assistant через GUI.
- Перезагружаем HA
- Убедитесь, что HACS уже устновлен.
- Перейдите на закладку SETTINGS
- Введите https://github.com/volshebniks/sauresha и выберите категорию Integration, нажмите Сохранить
- Новый репозиторий Integration Saures controllers with HA будет добавлен на закладке Integration
- Устновите SauresHA из него
- Осуществляем конфигурацию компонента в Home Assistant через GUI.
- Перезапустите HA.
- Добавить проект в HACS
- Сделать сенсоры для счетчиков с показаниями за день/месяц/год
- Добавить управление кранами
- Сделать pallete для Node-Red
- Сделать полноценную интеграцию с Home Assistant (добавляется в раздел интеграции)
Большое спасибо следующим организациям и проектам, работа которых имеет важное значение для развития проекта:
Нет их пока :)
Пожертвование на развитие проекта Яндекс.Деньги