Управление устройством ZONT через Home Assistant

В данной статье я расскажу, как достаточно просто и быстро прокинуть устройства из системы Zont в Home Assistant (HA). До этого момента я использовал плагин для Homebridge, написанный Maxmudjon. Он был удобен для управлением машины, но так как я все устройства держу в HA, жалко было тратить дополнительные ресурсы малины на Homebridge. Для меня было важно получить возможность запуска авто, открытия и закрытия, а также получение температуры с датчиков зонта. Включение самого термостата я не реализовывал (ни к чему мне), но кому надо - благодаря данной статье сможет реализовать. 

I. Подготовка

Для интеграции zont-online в систему HA нам необходимо получить токен, для этого нужно: 

1. Скачать Advanced REST Client (можно использовать плагин для хром).

2. Чтобы закодировать ваш login:password в Base64 формат использую https://www.base64decode.org/ 

 3. При помощи ARC (Advanced REST Client) отправить POST-request на https://zont-online.ru/api/get_authtoken  используя headers:

content-type: application/json
authorization: Basic XXXXXXXX
x-zont-client: your@email

(XXXXXXXX - ваш login:password закодированный в Bse64 (его должны были получить во втором шаге)your@email – ваш e-mail, использующийся при авторизации на сайте zont-online) Найти “token”: “yyyyyyyyyyyyyyyyyyyy” в ответе на запрос. Теперь у вас есть доступ к api через токен: x-zont-client: your@email x-zont-token: yyyyyyyyyyyyyyyyyyyy

4. Используя ARC, можете получить список команд всех ваших устройств. Отправить POST-request к https://zont-online.ru/api/devices, используя headers:

content-type: application/json
x-zont-client: your@email
x-zont-token: yyyyyyyyyyyyyyyyyy

и в body добавить: 
 {"load_io":true}

Теперь вы можете видеть все ваши параметры устройств в zont-online.

6. Найдите device id вашего устройство (к примеру “id”: 12345), вам необходимо скопировать Json путь до параметров устройства (для примера, devices[0].thermometers[0].last_value – ваше первое устройство, первый термометр, devices[0].thermometers[1].last_value - ваше первое устройство, первый термометр, devices[1].balance.value – ваше второе устройство, баланс устройства).

II. Интеграция в HA

7. В secrets.yaml добавляем наш e-mail адрес и токен (если нет данного файла, рекомендую его создать и хранить в нем все свои токены и пароли):
x_zont_client: your@email
x_zont_token: yyyyyyyyyyyyyyyyyyyy

8. Создаем rest/template sensor. Здесь прикладываю свой пример, где получаю информацию с датчиков температуры, состояния охраны и авто запуска авто.

- platform: rest resource: https://zont-online.ru/api/devices name: zont method: POST timeout: 30 scan_interval: 10 force_update: true headers: X-ZONT-Client: !secret x_zont_client X-ZONT-Token: !secret x_zont_token Content-Type: application/json payload: '{"load_io": true}' value_template: '{{ value_json.ok }}' json_attributes: - devices - platform: template sensors: # Название сенсора zont_first_floor: # Можете найти devices[X] и thermometers[Y] в 6 шаге инструкции value_template: '{{ states.sensor.zont.attributes.devices[0].thermometers[0].last_value }}' device_class: temperature friendly_name: 'Первый этаж' unit_of_measurement: '°C' - platform: template sensors: zont_second_floor: # Можете найти devices[X] и thermometers[Y] в 6 шаге инструкции value_template: '{{ states.sensor.zont.attributes.devices[0].thermometers[1].last_value }}' device_class: temperature friendly_name: 'Второй этаж' unit_of_measurement: '°C' - platform: template sensors: zont_auto_ignition: # Здесь используется второе устройство из Zonta. value_template: '{{ states.sensor.zont.attributes.devices[1].io["auto-ignition"].state }}' friendly_name: 'Автозапуск' - platform: template sensors: zont_guard: value_template: '{{ states.sensor.zont.attributes.devices[1].io["guard-state"] }}' friendly_name: 'Охрана'

9. Создаем rest-command (в configuration.yaml) 

zont_set_auto_ignition_enabled: url: https://zont-online.ru/api/set_io_port method: POST headers: X-ZONT-Client: !secret x_zont_client X-ZONT-Token: !secret x_zont_token Content-Type: application/json # Измените device_id на свой и 6 пункта данной инструкции payload: '{"device_id":12345,"portname":"auto-ignition","type":"auto-ignition","value":{"state":"enabled"}}' zont_set_auto_ignition_disabled: url: https://zont-online.ru/api/set_io_port method: POST headers: X-ZONT-Client: !secret x_zont_client X-ZONT-Token: !secret x_zont_token Content-Type: application/json # Измените device_id на свой и 6 пункта данной инструкции payload: '{"device_id": 12345,"portname":"auto-ignition","type":"auto-ignition","value":{"state":"disabled"}}' zont_set_guard_state_enabled: url: https://zont-online.ru/api/set_io_port method: POST headers: X-ZONT-Client: !secret x_zont_client X-ZONT-Token: !secret x_zont_token Content-Type: application/json # Измените device_id на свой и 6 пункта данной инструкции payload: '{"device_id":12345,"portname": "guard-state", "type": "string", "value": "enabled"}' zont_set_guard_state_disabled: url: https://zont-online.ru/api/set_io_port method: POST headers: X-ZONT-Client: !secret x_zont_client X-ZONT-Token: !secret x_zont_token Content-Type: application/json # Измените device_id на свой и 6 пункта данной инструкции payload: '{"device_id":12345,"portname": "guard-state", "type": "string", "value": "disabled"}'

10. Создание template switch для управлением машины.

#ZONT автозапуск - platform: template switches: zont_start: value_template: "{{ is_state('sensor.zont_auto_ignition', 'enabled') }}" turn_on: service: rest_command.zont_set_auto_ignition_enabled turn_off: service: rest_command.zont_set_auto_ignition_disabled #ZONT охрана - platform: template switches: zont_guard: value_template: "{{ is_state('sensor.zont_guard', 'enabled') }}" turn_on: service: rest_command.zont_set_guard_state_enabled turn_off: service: rest_command.zont_set_guard_state_disabled

После перезапуска НА у Вас должны появится сенсоры с состоянием охраны и автозапуска, а также свитчи для запуска и постановки на охрану. 

Информация по API Zont

За основу был взят материал kirill_ru

Всем спасибо за уделенное время!