Подключение умного септика G-Septik к Home Assistant: датчики и автоматизация

Подключение умного септика G-Septik (gseptik) к Home Assistant через REST API: создание сенсоров уровня, критической отметки и ошибок, а также настройка автоматизации при превышении порога.

Статья посвящена работе устройств в Home Assistant. Если требуется помощь с подключением устройств (Zigbee, Wi-Fi) и настройкой интеграций, можем помочь в рамках услуги Развитие умного дома. Если задача шире — доступны другие услуги.

Подключение умного септика G-Septik к Home Assistant: датчики и автоматизация

Зачем интегрировать 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 на практике.