SauresHA

Пожертвование на развитие проекта Яндекс.Деньги

Update 1: Начиная с версии 0.3:

сделан переход на новое клиентское API
добавлена необязательная настройка для sensor - scan_interval. Время обновления в минутах. По умолчанию = 10 минут.
из-за перехода появились новые атрибуты у сенсоров.

Update 2: версия 0.3.5:

уменьшено количество вызово API
ускорена первоначальная инициализация модуля
сделан переход на асинхронные методы
исправлена ошибка с заднием своего scan_interval
исправлена ошибка связанная с наличием русских букв в серийных номерах
на стороне Saures явно починили кеширование для нового API

Update 3: версия 0.3.8:

вернул синхронные вызовы

Update 4: Начиная с версии 0.5:

Существенно сокращено кол-во обращений к серверу Saures, для предотвращения блокировки.
Рекомендую в настройках указать:

  scan_interval:
    minutes: 30

Иначе могут быть блокировки в будущем.

Update 5: Начиная с версии 0.6:

значительно изменен механизм настройки
можно задавать свои мена для всего
можно в настройках делать ссылки на !secret
добавил в manifest, version

Содержание

Установка
- Ручная установка
- Установка через HACS
Настройка
- Параметры

Для связи: master@g-s-a.me

Интеграция котроллеров Saures c Home Assistant

Описание

В настоящее время поддерживаются следующие типы устройств от Saurus

Счетчик холодной воды (м³) = sensor в Home Assistant
Счетчик горячей воды (м³) = sensor в Home Assistant
Счетчик газа (м³) = sensor в Home Assistant
Датчик протечки (0 – нет протечки, 1 - протечка) = binary_sensor в Home Assistant
Датчик температуры (градусы) = sensor в Home Assistant
Электро-шаровой кран управление (0 – открыться, 1 - закрыться) - не поддерживается
Счетчик тепла (кВт*ч) = sensor в Home Assistant
Счетчик электричества (кВт*ч) (в том числе многотарифные) = sensor в Home Assistant
Сухой контакт (0 – деактивирован, 1 – активирован) = binary_sensor в Home Assistant
Электро-шаровой кран состояние (0 – не подключен модуль, 1 – неизвестное состояние, 2 – открыт, 3 - закрыт) = sensor в Home Assistant
Непосредственно сами контроллеры = sensor в Home Assistant

Установка

Ручная установка

Добавляем компонент в Home Assistant Распаковываем архив. Папку sauresha берем целиком и копируем в custom_components.
Осуществляем конфигурацию компонента в Home Assistant.

email и password - Ваши учетные данные личного кабинета на saures.ru.
controllers_sn - сериный номер контроллера
counters_sn - сериный номер счетчика или датчика (задать в личном кабине на saures.ru)
flat_id (как заполнить указано ниже)

Перезагружаем HA

HACS установка

Убедитесь, что HACS уже устновлен.
Перейдите на закладку SETTINGS
Введите https://github.com/volshebniks/sauresha и выберите категорию Integration, нажмите Сохранить
Новый репозиторий Integration Saures controllers with HA будет добавлен на закладке Integration
Устновите SauresHA из него
Настройте sauresha sensor и/или binary_sensor.
Перезапустите HA.

Как использовать

Параметры

Это добавляем в sensors (вместо ссылок на secret, можно использовать реальные название. Если имя оставить пустым, то оно будет сгенерено автоматически)

sensor:
  - platform: sauresha
    email: !secret saures_login
    password: !secret saures_pass
    flat_id: !secret saures_flat
    controllers:
      !secret saures_controller_id:
        name: my1
    counters:
      !secret saures_controller_cold:
        name: cold_water
      !secret saures_controller_hot:
        name: hot_water
    scan_interval:
      minutes: 30

Это добавляем, при наличии соответвующих датчиков в binary_sensors

- platform: sauresha
  email: вашemail
  password: вашпароль
  flat_id: 2
  counters:
	!secret saures_controller_1:
	  name: "12311111"
   !secret saures_controller_2:
      name: ""

Важно: Если не знаете как в личном кабине увидеть flat_id - высвечивается при наведении на адресс в адресной сроке, то вводите flat_id : 0. При наличии у вас только одного созданного адреса, работать будет и так. Но все же рекомендую - его узнать и заполнить - будет меньше запросов к API saures.

Узнать flat_id (усли указан flat_id: 0) можно найдя в логе Home Assistant, строки вида:
Цифра в конце, после двоеточия и есть необходимый flat_id

План развития проекта

Добавить проект в HACS
Сделать сенсоры для счетчиков с показаниями за день/месяц/год
Добавить управление кранами
Сделать pallete для Node-Red
Сделать полноценную интеграцию с Home Assistant (добавляется в раздел интеграции)

Credits

Большое спасибо следующим организациям и проектам, работа которых имеет важное значение для развития проекта:

Нет их пока :)