«ПИК Комфорт» для Home Assistant

Интеграция для личного кабинета услуг ЖКХ группы компаний ПИК. Поддержка передачи показаний по счётчикам.

Integration for communal services personal cabinet from PIK Group. Supports meter readings submission.

Интеграция для домофонов системы «ПИК Домофон»: alryaz/hass-pik-intercom

Установка

1. Установите HACS (инструкция по установке на оф. сайте)
2. Добавьте репозиторий в список дополнительных:
   1. Откройте главную страницу HACS
   2. Откройте раздел Интеграции (Integrations)
   3. Нажмите три точки сверху справа (допонительное меню)
   4. Выберите Пользовательские репозитории
   5. Скопируйте https://github.com/alryaz/hass-pik-comfort в поле вводавыберите Интеграция (Integration) в выпадающем списке -> Нажмите Добавить (Add)
   6. Выберите Интеграция (Integration) в выпадающем списке
   7. Нажмите Добавить (Add)
3. Найдите PIK Comfort (ПИК Комфорт) в поиске по интеграциям
4. Установите последнюю версию компонента, нажав на кнопку Установить (Install)
5. Перезапустите Home Assistant

Конфигурация компонента

Компонент требует авторизацию через получение СМС-кода. Ввиду этого поддержку конфигурации посредством YAML пришлось отложить на неопределённый срок.

Таким образом, конфигурация компонента возможна через ерез раздел Интеграции (в поиске - PIK Comfort или ПИК Комфорт)

Использование компонента

⚠️ Внимание! Данный раздел находится в разработке.

Служба передачи показаний - pik_comfort.push_readings

Служба передачи показаний позволяет отправлять показания по счётчикам в личный кабинет, и имеет следующий набор параметров:

Название	Описание
target	Выборка целевых объектов, для которых требуется передавать показания
data.readings	Список / именованный массив показаний, передаваемых в ЛК
data.incremental	Суммирование текущих показаний с передаваемыми
data.ignore_readings	Игнорировать ограничения по значениям

Результатом вызова службы будет событие с идентификатором pik_comfort_push_readings и следующими значениями:

Название	Тип	Описание
comment	str	Коментарий (об состоянии передачи показаний)
success	bool	Успешность передачи показаний
readings	Dict[int, float]/None	Передаваемые показания (идентификатор тарифа => показание) (отсутствует при возникновении ошибки до фактической попытки передачи)
meter_uid	str	Уникальный идентификатор счётчика
meter_type	str	Тип объекта счётчика
meter_code	str/None	Серийный номер счётчика (если доступен)
call_params	Dict[str, Any]	Параметры вызова службы
entity_id	str	Идентификатор объекта, над которым производился вызов службы

Примеры вызова службы

1. Обычная передача показаний

• Например, если текущие, последние или принятые значения по счётчику – 321, 654 и 987 по зонам Т1, Т2 и Т3 соответственно, то показания не будут отправлены¹.

service: pik_comfort.push_readings
data:
  readings: "123, 456, 789"
target:
  entity_id: binary_sensor.1243145122_meter_123456789

... или, с помощью именованного массива:

service: pik_comfort.push_readings
data:
  readings:
    t1: 123
    t2: 456
    t3: 789
target:
  entity_id: binary_sensor.1243145122_meter_123456789

... или, с помощью списка:

service: pik_comfort.push_readings
data:
  readings: [123, 456, 789]
target:
  entity_id: binary_sensor.1243145122_meter_123456789

2. Форсированная передача показаний

Отключение всех ограничений по показаниям.

• Например, если текущие, последние или принятые значения по счётчику – 321, 654 и 987 по зонам Т1, Т2 и Т3 соответственно, то показания будут отправлены¹.

service: pik_comfort.push_readings
data_template:
  readings: [123, 456, 789]
  ignore_readings: true
target:
  entity_id: binary_sensor.1243145122_meter_123456789

3. Сложение показаний

• Например, если текущие, последние или принятые значения по счётчику – 321, 654 и 987 по зонам Т1, Т2 и Т3 соответственно, то показания будут отправлены¹.

Внимание: в данном примере будут отправлены показания 444, 1110 и 1776, а не 123, 456 и 789.

service: pik_comfort.push_readings
data_template:
  readings: [123, 456, 789]
  incremental: true
target:
  entity_id: binary_sensor.1243145122_meter_123456789