Skip to content

Latest commit

 

History

History
757 lines (514 loc) · 28.8 KB

CONFIGURATION.md

File metadata and controls

757 lines (514 loc) · 28.8 KB
Raw

Далее по тексту обязательные парамтры выделены жирным.

Конфигурация платформы tion

  • type, enum: тип подключаемого бризера, может принимать значения: 4s, 3s, lt или o2
  • vport_id, id: идентификатор vport подключенного к бризеру. По-умолчанию: определяется автоматически.
  • update_interval, time: интервал опроса состония бризера. По-умолчанию: 15s.
  • state_timeout, time: время на прием ответа, после которого выставляется ошибка состояния если ответ не был получен. Должно быть меньше чем update_interval. По-умолчанию: 3s.
  • batch_timeout, time: время сбора команд обновления. По-умолчанию: 200ms.
  • force_update, boolean: поведение обновления состояний - только по изменению или всегда. По-умолчанию: False.
  • on_state, automation: автоматизация. переменная x будет содержать объект TionState с текущим состоянием бризера.
  • presets, object: см. Настройка presets
  • auto, object: см. Настройка auto
  • button_presets, object: см. Настройка button_presets

Настройка presets

В этой секции Вы можете настроить любое необходимое количество пресетов с именами по вашему вкусу. Пресеты можно переключать с помощью select[type=presets] или штатно из climate и fan.

Досупные параметры:

  • fan_speed, uint: скорость вентиляции. По-умолчанию: текущее состояние.
  • temperature, uint: целевая температура. По-умолчанию: текущее состояние.
  • heater, boolean: включить или выключить нагреватель. По-умолчанию: текущее состояние.
  • power, boolean: включить или выключить бризер. По-умолчанию: текущее состояние.
  • gate_position, enum: состояние заслонки. Может принимать значения: outdoor, indoor, mixed. Будет использовано только если ваш бризер поддерживает возможность смены в это состояние. По-умолчанию: текущее состояние.
  • auto, boolean: включить или выключить режим автоматической вентиляции. По-умолчанию: текущее состояние.

Пример использования:

presets:
  home: { fan_speed: 2, temperature: 16, heater: False }
  away: { fan_speed: 1, temperature: 10, heater: False }
  sleep: { fan_speed: 1, temperature: 18 }
  "много людей": { fan_speed: 5 }

Tip

В Home Assistant пресеты с именами home, away, boost, comfort, eco, sleep и activity для сущности climate будут автоматически переведены на язык системы и получат соответсвующие иконки.

Настройка auto

При задании параметра pi_controller, в основе автоматики лежит работа пропроционально-интегрального контроллера и исследование: https://www.sciencedirect.com/science/article/pii/S0378778823009477

Вы можете использовать собственный алгоритм определив его в автоматизации, в параметре lambda.

Параметры:

  • co2, id: идентификатор сенсора с датчиком CO2.
  • setpoint, uint: целевое значение CO2. Несовместим с number[type=auto_setpoint], детали там же.
  • min_fan_speed, uint: минимальная скорость вентиляции. Несовместим с number[type=auto_min_fan_speed], детали там же.
  • max_fan_speed, uint: максимальная скорость вентиляции. Несовместим с number[type=auto_max_fan_speed], детали там же.
  • pi_controller, object: объект с параметрами PI-контроллера:
    • kp, float: пропорцииональный коэффициент. По-умолчанию: 0.2736.
    • ti, float: время интегрирования (в минутах). По-умолчанию: 8.
    • db, int: зона нечувствительности. По-умолчанию: 50.
  • lambda, automation: автоматизация обрабатывающая значение CO2. Переменная x будет содержать текущее значение датчика CO2, вернуть необходимо скорость вентиляции. Скорость вентиляции будет применена относительно параметров min_fan_speed и max_fan_speed или их значений установленых с помощью number. Несовместим с pi_controller.

Примеры использования:

tion:
 ...
  auto:
    co2: my_co2_sensor
    lambda: |-
      if (x > 900) return 4;
      if (x > 800) return 3;
      if (x > 700) return 2;
      return 1;
tion:
 ...
  auto:
    co2: my_co2_sensor
    pi_controller:
tion:
 ...
  auto:
    co2: my_co2_sensor
    pi_controller:
      kp: 0.2736

Important

При ручном переключении скорости или выключении бризера, авто-режим отключается.

Настройка button_presets

Конфигурация физичеких кнопок. Установленое значение производителем: 2/4/6 и 10/20/25 °C.

Параметры:

  • fan_speed, list[uint]: список из 3 элементов со скоростями вентилятора.
  • temperature, list[uint]: список из 3 элементов с теперетурами в градусах цельсия.

Пример использования:

button_presets:
  fan_speed: [1, 3, 5]
  temperature: [12, 18, 24]

Important

Поддерживаемые модели: Lite.

Конфигурация сущностей ESPHome платформы tion

Каждая сущность минимально конфигурируется тремя обязательными параметрами - платформой tion, типом и именем. Пример:

# Платформа
- platform: tion
  # Тип
  type: entity_type
  # Имя
  name: Entity Name
  # Необязательный параметр, определяется автоматически,
  # необходим при конфигурации нескольких бризеров в одной прошивке.
  # Дальнее всегда будет опущен.
  #tion_id: tion_api

Исключение составляют сущности в домене climate и fan, для них указание типа отсутствует.

Некоторые сущности могут содерждать дополнительные параметры.

Если не описаны ограничения, то сущность поддерживается для всех моделей бризеров.

Во всех сущностях можно использовать стандартные для их домена переменные и автоматизации, документация доступна по ссылке в разделе, в названии домена.

Important

В силу особенностей реализации генерации идентификаторов в ESPHome, все имена сущностей должны быть на латинице. В дальнейшем вы можете переименовать их в вашей системе УД.

Important

Если не брать в расчет пакеты, то конкретный домен в конфигурации может быть только один, все сущности располагаются внутри него списком.

Домен binary_sensor

Мониторинг состояния параметров бризера в виде бинарного сенсора.

Пример использования:

binary_sensor:
  - platform: tion
    type: entity_type
    name: Entity Name

Тип state

Состояние общения с бризером. При отсутсвии ответа более интервала сконфигурированного в tion.state_timeout, изменяет свое состояние.

Тип power

Состояние работы бризира - включен или выключен.

Тип heater

Состояние обогревателя - включен или выключен.

Tip

Алиасы: heat

Тип heating

Состояние работы обогревателя - греет или не греет.

Note

Для бризеров 4S и Lite - состояние определяется аппаратно.

Для бризеров 3S и O2 - состояние определяется програмно.

Тип sound

Состояние звуковых оповещений.

Tip

Алиасы: buzzer

Important

Поддерживаемые модели: 3S, 4S, Lite.

Тип led

Состояние световых оповещений.

Tip

Алиасы: light

Important

Поддерживаемые модели: 4S, Lite.

Для модели Lite пока не понятна заложенная производителем функция.

Тип filter

Индикатор состояние ресурса замены фильтров.

Тип gate_error

Индикатор ошибки закрытия заслонки.

Important

Поддерживаемые модели: 4S, O2.

Тип gate

Состояние заслонки.

Tip

Алиасы: gate_state, gate_position, damper

Тип error

Индикатор наличия ошибки бризера.

Тип boost

Состояние работы турбо-режима Boost.

Домен sensor

Мониторинг состояния параметров бризера в виде числового сенсора.

Пример использования:

sensor:
  - platform: tion
    type: entity_type
    name: Entity Name

Тип fan_speed

Состояние скорости вентиляции.

Tip

Алиасы: fan, speed

Тип outdoor_temperature

Состояние датчика внешней температуры.

Тип current_temperature

Состояние датчика внутренней температуры.

Tip

Алиасы: indoor_temperature

Тип target_temperature

Состояние целевой температуры нагрева.

Тип productivity

Текущая производительность бризера.

Тип power

Текущаяя потребляемая мощность бризера.

Note

Вычисляется как сумма sensor[type=heater_power] + sensor[type=fan_power]

Тип heater_var

Процент потребления мощности работы нагревателя.

Important

Поддерживаемые модели: 4S, Lite.

Тип heater_power

Данные о потреблении нагревателя.

Note

Для бризеров 4S и Lite - состояние определяется аппаратно.

Для бризеров 3S и O2 - при включенном обогреве состояние константа - 1450 Вт.

Тип fan_power

Данные о петребляемой мощности работы вентилятора.

Используются следующие константы:

Tion O2:

  • Дежурный режим: 0.73 Вт
  • 1 скорость: 10.3 Вт
  • 2 скорость: 19.0 Вт
  • 3 скорость: 19.4 Вт
  • 4 скорость: 23.0 Вт

Tion 3S:

  • Дежурный режим: 0.73 Вт
  • 1 скорость: 17 Вт
  • 2 скорость: 21 Вт
  • 3 скорость: 26 Вт
  • 4 скорость: 23 Вт
  • 5 скорость: 27 Вт
  • 6 скорость: 29 Вт

Tion 4S:

  • Дежурный режим: 0.73 Вт
  • 1 скорость: 15.1 Вт
  • 2 скорость: 16.2 Вт
  • 3 скорость: 23.3 Вт
  • 4 скорость: 23.8 Вт
  • 5 скорость: 25.2 Вт
  • 6 скорость: 30.7 Вт

Tion Lite:

На текущий момент константы показания потребления экивалентны Tion 4S.

Note

Если у вас есть возможность точно измерить потребление, я с удовольствием изменю константы и обновлю эту иформацию.

Тип airflow

Данные счетчика прошедшего воздуха в m³.

Important

Поддерживаемые модели: 4S, Lite.

Тип boost_time_left

Оставшееся время работы турбо-режима Boost. Еденица измерения s (секунда), класс duration.

Тип filter_time_left

Данные об оставшимся времени жизни ресурса фильтра. Еденица измерения s (секунда), класс duration.

Note

В Home Assistant будет отображаться в вррмате HH:MM:SS, без дней - два дня будет отображено как 48 часов. Это ограничение HA. Если требуется видеть время в днях испольуйте сенсор sensor[type=filter_time_left_days].

Тип filter_time_left_days

Данные об оставшимся времени жизни ресурса фильтра. Еденица измерения d (день).

Тип work_time

Технические данные об общем времени работы бризера. Еденица измерения s (секунда), класс duration.

Note

В Home Assistant будет отображаться в вррмате HH:MM:SS, без дней - два дня будет отображено как 48 часов. Это ограничение HA. Если требуется видеть время в днях испольуйте сенсор sensor[type=work_time_days].

Important

Поддерживаемые модели: 4S, Lite, O2.

Тип work_time_days

Технические данные об общем времени работы бризера. Еденица измерения d (день).

Important

Поддерживаемые модели: 4S, Lite, O2.

Тип fan_time

Технические данные о времени работы вентилятора. Еденица измерения s (секунда), класс duration.

Note

В Home Assistant будет отображаться в вррмате HH:MM:SS, без дней - два дня будет отображено как 48 часов. Это ограничение HA. Если требуется видеть время в днях испольуйте сенсор sensor[type=fan_time_days].

Important

Поддерживаемые модели: 4S, Lite.

Тип fan_time_days

Технические данные о времени работы вентилятора. Еденица измерения d (день).

Important

Поддерживаемые модели: 4S, Lite.

Тип airflow_counter

Технические данные внутреннего счетчика прошедшего воздуха.

Important

Поддерживаемые модели: 4S, Lite.

Тип pcb_ctl_temperature

Технические данные датчика температуны на плате управления бризера.

Important

Поддерживаемые модели: 4S.

Тип pcb_pwr_temperature

Технические данные датчика температуны на плате бризера.

Important

Поддерживаемые модели: 4S, Lite.

Домен text_sensor

Мониторинг состояния параметров бризера в виде текстового сенсора.

Пример использования:

text_sensor:
  - platform: tion
    type: entity_type
    name: Entity Name

Тип errors

Отображает строку с ошибками (EC) и предупреждениями (WS) бризера.

Тип firmware_version

Отображает текущую версию прошивки бризера.

Tip

Алиасы: firmware

Тип hardware_version

Отображает текущую версию железа бризера.

Tip

Алиасы: hardware

Домен switch

Отображение и изменение состояния бризера переключателем.

Пример использования:

switch:
  - platform: tion
    type: entity_type
    name: Entity Name

Тип power

Отображает и изменяет состояние бризера - включен/выключен.

Тип heater

Отображает и изменяет состояние обогревателя - включен или выключен.

Tip

Алиасы: heat

Тип sound

Отображает и изменяет состояние звуковых оповещений.

Tip

Алиасы: buzzer

Important

Поддерживаемые модели: 3S, 4S, Lite.

Тип led

Отображает и изменяет состояние световых оповещений.

Tip

Алиасы: light

Important

Поддерживаемые модели: 4S, Lite.

Для модели Lite пока не понятна заложенная производителем функция.

Тип recirculation

Отображает и переключает состояние заслоники между забором воздуха с улицы или из помещения.

Important

Поддерживаемые модели: 3S, 4S.

Тип boost

Отображает и изменяет состояние турбо-режима Boost. Работа этого режима тесно связяна с tion.update_interval, автоматическое завершение возможно только в момент обновления состояния, на практике это не влияет на использование данной функции т.к. обновление состояния обычно происхходит не менее раза в миниту.

Дополнительные параметры:

  • duration, time: задает время работы режима. Минимальное значение 1min, максимальное 60min. Не совместим с параметром number[type=boost_time], при использовании совместно поведение определить невозможно. По умолчанию: <отсутствует>.
  • heater, boolean: задает состояние обогревателя во время работы режима. Если не установлен, то будет использовано текущее состояние обогревателя. По умолчанию: <отсутствует>.
  • temperature, uint: задает целевую температуру нагрева во время работы режима. Если не установлен или установлен в 0, то будет использована текущая температура нагрева. По умолчанию: <отсутствует>.

Important

Обратный отсчет оставшегося времени всегда будет кратен времени обновления состояния. Т.е. если время обновления 00:01:00 и время работы турбо-режима 00:01:30, то турбо-режим будет завершен через 2 мин.

Important

При ручном переключении скорости или выключении бризера, турбо-режим отключается.

Тип auto

Переключает работу вентиляции в автоматичекий режим.

Для работы необходимо установить целевое значения CO2, минимальную и максимальную скорость вентиляции, используя параметры в настройке платформы tion или соответствующие сущности number.

Caution

Работа этого режима находится в экспериментальной стадии.

Пример использования:

switch:
  - platform: tion
    type: auto
    name: Auto

Домен number

Отображение и изменение состояния параметров бризера в числовом виде.

Пример использования:

number:
  - platform: tion
    type: entity_type
    name: Entity Name

Тип fan_speed

Отображает и позволяет изменить скорость вентиляции.

Note

Скорость вентиляции 0 выключает бризер.

Тип target_temperature

Отображает и позволяет изменить целевую температуру нагрева.

Тип boost_time

Отображает и позволяет изменить время работы турбо режима Boost.

Особенности настройки интервала см. в описании switch[type=boost].

Дополнительные параметры:

  • initial_value, time: позволяет задать стартовое значение при инициализации.
  • restore_value, boolean: сохранять текущее значение и использовать после перезагрузки.
number:
  - platform: tion
    type: boost_time
    name: Boost Time
    initial_value: 20min
    restore_value: True

Important

Тип boost_time не совместим с параметром switch[type=boost].duration, при использовании совместно поведение определить невозможно.

Тип auto_setpoint

Устанавливает целевое значение CO2 при автоматическом управлении вентилятором.

Пример использования:

number:
  - platform: tion
    type: auto_setpoint
    name: Auto Setpoint
    initial_value: 700
    restore_value: True

Тип auto_min_fan_speed

Устанавливает минимальную скорость вентиляции при автоматическом управлении.

Пример использования:

number:
  - platform: tion
    type: auto_min_fan_speed
    name: Auto Min Fan Speed
    initial_value: 1
    restore_value: True

Может принимать значение 0, в этом случае бризер будет отключен. Максимальное значение на еденицу меньше максимальной скорости бризера.

Не может быть больше или равным number[type=auto_max_fan_speed].

Тип auto_max_fan_speed

Устанавливает максимальную скорость вентиляции при автоматическом управлении.

Пример использования:

number:
  - platform: tion
    type: auto_max_fan_speed
    name: Auto Max Fan Speed
    initial_value: 3
    restore_value: True

Минимальной значение 1, максимальное равно максимальной скорости вентиляции бризера. Не может быть меньше или равным number[type=auto_min_fan_speed].

Домен select

Пример использования:

select:
  - platform: tion
    type: entity_type
    name: Entity Name

Тип air_intake

Отображает список доступных режимов вентиляции и позволяет выбрать один из них.

Tip

Алиасы: gate_position

Important

Поддерживаемые модели: 3S, 4S.

Тип presets

Отображает список доступных пресетов и позволяет активировать один из них.

Домен button

button:
  - platform: tion
    type: entity_type
    name: Entity Name

Тип reset_filter

Производит сброс счетчика ресурса фильтров.

Important

Поддерживаемые модели: 3S, 4S, Lite.

Дополнительные параметры:

  • confirm, switch: защита от случайного нажатия, сброс будет срабатывать, только если переключатель включен. По умолчанию: <отсутствует>.

Пример использования:

climate:
  - platform: tion
    type: reset_filter
    name: Reset Filter
    confirm:
      name: Reset Filter Confirm

Домен climate

Мониторинг и изменение параметров бризера в виде компонента типа климат.

Дополнительные параметры:

  • enable_heat_cool, boolean: включает/выключает дополнительный режим HEAT_COOL, позволяющий включать бризер через сервис turn_on, с восстановлением предыдущего режима обогрева. По умолчанию: False.
  • enable_fan_auto, boolean: включает/выключает дополнительный режим вентиляции auto, позволяющий включать автоматический режим вентиляции. По умолчанию: False.

Пример использования:

climate:
  - platform: tion
    name: Climate
    enable_heat_cool: True
    enable_fan_auto: True

Домен fan

Мониторинг и изменение параметров бризера в виде компонента типа вентилятор.

Пример использования:

fan:
  - platform: tion
    name: Fan