Подключение умного септика G-Septik к Home Assistant: датчики и автоматизация
Подключение умного септика G-Septik (gseptik) к Home Assistant через REST API: создание сенсоров уровня, критической отметки и ошибок, а также настройка автоматизации при превышении порога.
Статья посвящена работе устройств в Home Assistant. Если требуется помощь с подключением устройств (Zigbee, Wi-Fi) и настройкой интеграций, можем помочь в рамках услуги Развитие умного дома. Если задача шире — доступны другие услуги.
Зачем интегрировать G-Septik с Home Assistant
Современный умный септик — это автономная инженерная система, которая может быть интегрирована в инфраструктуру умного дома. Устройства G‑Septik (gseptik) передают данные о текущем уровне жидкости, температуре, давлении, состоянии датчиков и возможных ошибках.
Для владельцев загородной недвижимости такая интеграция позволяет заранее увидеть риск переполнения ёмкости, контролировать работу оборудования и получать уведомления о критических состояниях. Home Assistant в этом случае выступает как единая система мониторинга инженерных систем дома.
В этой статье рассмотрим практическую интеграцию G-Septik с Home Assistant: получение данных через REST API, создание сенсоров уровня, температуры, давления и ошибок, а также настройку автоматизации уведомлений.
Материал основан на реальной конфигурации и примерах использования оборудования G‑Septik.
Подключение септика G-Septik к Home Assistant через REST API
Интеграция выполняется через платформу REST в Home Assistant. Home Assistant периодически отправляет HTTP‑запрос на сервер G‑Septik, используя предоставленный API. В ответ система получает JSON‑данные и на их основе создаёт сенсоры и бинарные сенсоры.
После подключения в системе появляются основные параметры септика:
- уровень жидкости
- критический уровень
- температура
- давление
- уровень сигнала
- текст ошибки
Ниже приведён пример конфигурации REST‑интеграции для Home Assistant, на основе которой создаются сенсоры септика. В конфигурации также добавлен бинарный сенсор «Превышение критического уровня септика». Он не является обязательным для работы интеграции, но на практике очень удобен для использования на дашбордах. Благодаря параметру device_class: problem такой сенсор автоматически подсвечивается в интерфейсе при возникновении проблемы и корректно локализуется на русском языке, что упрощает отображение аварийного состояния.
rest:
- resource: https://data.gseptik.ru/Api/public/v2/home-assistant/readings/API_TOKEN
method: GET
scan_interval: 300
timeout: 30
binary_sensor:
- name: Превышение критического уровня септика
unique_id: binary_sensor_gseptik_exceeds_x_level
device_class: problem
value_template: >
{{ value_json[0].exceeds_x_level in [true, 'true', 'True', 1, '1', 'on', 'ON', 'Да'] }}
sensor:
- name: Уровень жидкости септика
unique_id: sensor_gseptik_liquid_level
json_attributes_path: "$[0]"
value_template: "{{ value_json[0].liquid_level }}"
unit_of_measurement: "%"
- name: Температура септика
unique_id: sensor_gseptik_temperature
json_attributes_path: "$[0]"
value_template: "{{ value_json[0].temp }}"
unit_of_measurement: "°C"
- name: Давление септика
unique_id: sensor_gseptik_pressure
json_attributes_path: "$[0]"
value_template: "{{ value_json[0].pressure }}"
unit_of_measurement: "мбар"
- name: Критический уровень септика
unique_id: sensor_gseptik_x_level
json_attributes_path: "$[0]"
value_template: "{{ value_json[0].x_level }}"
unit_of_measurement: "%"
- name: Уровень сигнала септика
unique_id: sensor_gseptik_sdt
json_attributes_path: "$[0]"
value_template: "{{ value_json[0].sdt }}"
unit_of_measurement: "%"
- name: Ошибка септика
unique_id: sensor_gseptik_error_name
json_attributes_path: "$[0]"
value_template: "{{ value_json[0].error_name }}"
После добавления конфигурации необходимо перезапустить Home Assistant и убедиться, что новые сущности появились в разделе Инструменты разработчика → Состояния.
Если сенсоры отображаются корректно, значит REST‑интеграция работает и данные из септика успешно поступают в систему умного дома.
Как вывести данные септика на дашборд Home Assistant
После создания сенсоров их можно вывести на дашборд Home Assistant. Самый простой способ — использовать стандартную карточку entities.
- type: entities
title: G-Septik
state_color: false
show_header_toggle: false
entities:
- entity: sensor.uroven_zhidkosti_septika
icon: mdi:water-percent
- entity: sensor.temperatura_septika
icon: mdi:thermometer
- entity: sensor.davlenie_septika
icon: mdi:gauge
- entity: sensor.kriticheskii_uroven_septika
icon: mdi:water-minus
- entity: sensor.prevyshen_kriticheskii_uroven_septika
icon: mdi:water-alert
- entity: sensor.uroven_signala_septika
icon: mdi:signal
- entity: sensor.oshibka_septika
icon: mdi:alert-decagram-outline
Такой вариант позволяет быстро получить общий обзор состояния системы: текущий уровень жидкости, критическую отметку, температуру, давление и наличие ошибок.
Если требуется более наглядная визуализация уровня септика, можно использовать специализированную карточку Lovelace. Подробно этот вариант рассмотрен в статье Умный септик в Home Assistant: настройка Lovelace карточки septic-card.
Автоматизация контроля уровня септика
Одним из основных преимуществ интеграции септика в Home Assistant является возможность создавать автоматизации. Например, можно настроить уведомление при превышении критического уровня жидкости.
alias: "G-Septic: превышение критического уровня"
mode: single
trigger:
- platform: state
entity_id: binary_sensor.gseptik_exceeds_x_level
to: "on"
action:
- service: notify.notify
data:
title: "G-Septic: превышен критический уровень"
message: >
Текущий уровень: {{ states('sensor.gseptik_liquid_level') }}%
Сервис notify.notify — заглушка, замените его на ваш реальный канал уведомлений (Telegram, мобильное приложение Home Assistant и т. п.).
Итоги интеграции
После интеграции G‑Septik с Home Assistant септик становится частью общей инфраструктуры умного дома. В системе появляются сенсоры, которые показывают текущий уровень жидкости, фиксируют превышение критического порога, отображают температуру, давление и позволяют анализировать историю ошибок. На основе этих данных можно строить автоматизации, что значительно снижает риск переполнения септика и помогает своевременно реагировать на проблемы.
Полезные ссылки
- G-Septik — официальный сайт производителя оборудования для септиков
В Telegram-канале @iot7m_ru публикуются практические заметки по Home Assistant: опыт эксплуатации устройств, интеграция с различным оборудованием, создание дашбордов и разбор типовых проблем. Многие материалы основаны на реальных запросах и консультациях. Подпишитесь на @iot7m_ru, если используете Home Assistant на практике.