forked from dentra/esphome-tion
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathREADME.md.j2
211 lines (162 loc) · 13.8 KB
/
README.md.j2
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
[![Version][version-shield]][version]
[![License][license-shield]][license]
[![ESPHome release][esphome-release-shield]][esphome-release]
[![Telegram][telegram-shield]][telegram]
[![Support author][donate-tinkoff-shield]][donate-tinkoff]
[![Support author][donate-boosty-shield]][donate-boosty]
[![Open in Visual Studio Code][open-in-vscode-shield]][open-in-vscode]
[version-shield]: https://img.shields.io/static/v1?label=Версия&message={{version_tion}}&color=green
[version]: https://github.com/dentra/esphome-tion/releases/
[license-shield]: https://img.shields.io/static/v1?label=Лицензия&message=MIT&color=orange&logo=license
[license]: https://opensource.org/licenses/MIT
[esphome-release-shield]: https://img.shields.io/static/v1?label=ESPHome&message={{version_esphome}}&color=green&logo=esphome
[esphome-release]: https://github.com/esphome/esphome/releases/
[open-in-vscode-shield]: https://img.shields.io/static/v1?label=+&message=Открыть+в+VSCode&color=blue&logo=visualstudiocode
[open-in-vscode]: https://open.vscode.dev/dentra/esphome-tion
[telegram-shield]: https://img.shields.io/static/v1?label=Поддержка&message=Телеграм&logo=telegram&color=blue
[telegram]: https://t.me/esphome_tion
[donate-tinkoff-shield]: https://img.shields.io/static/v1?label=Поддержать+автора&message=Тинькофф&color=yellow
[donate-tinkoff]: https://www.tinkoff.ru/cf/3dZPaLYDBAI
[donate-boosty-shield]: https://img.shields.io/static/v1?label=Поддержать+автора&message=Boosty&color=red
[donate-boosty]: https://boosty.to/dentra
# Tion
English version of this page is available via [google translate](https://github-com.translate.goog/dentra/esphome-tion?_x_tr_sl=ru&_x_tr_tl=en&_x_tr_hl=en&_x_tr_pto=wapp).
Компонет ESPHome для управления бризерами `Tion` с помощью ESP в вашей системе управления
умным домом. Поддерживаются Home Asistant [API](https://esphome.io/components/api.html) и
любые другие системы управления умным домом через протокол
[MQTT](https://esphome.io/components/mqtt.html).
Поддерживаемые модели и протоколы:
- Tion 4S (BLE/UART)
- Tion Lite (BLE)
- Tion 3S (BLE/UART)
- Tion O2/O2 Max (UART)
Компонент построен на платформе
[climate](https://esphome.io/components/climate/index.html) и позволяет управлять
функциями:
* Включение/Выключение
* Обогрев
* Целевая температуры нагрева
* Скорость притока воздуха
* Звуковое оповещение (кроме O2)
* Световое оповещение (только для 4S и Lite)
* Режим приток/рециркуляция (только для 4S)
* Режим приток/рециркуляция/смешанный (только для 3S)
* Поддержка пресетов
* Настройка времени пресета "Турбо"
* Сброс ресурса фильтров (кроме O2)
* Подтверждение сброса ресурса фильтра (кроме O2)
Дополнительно осуществляется мониториг следующих показателей:
* Температура снаружи
* Температура внутри
* Текущая потребяемая мощность нагревателя (только для 4S и Lite)
* Оставшееся время жизни фильтра (кроме O2)
* Индикация о требущейся замене/очистке фильтра (кроме O2)
* Оставшееся время работы режима "Турбо"
* Счетчик прошедшего воздуха (только для 4S и Lite)
* Текущая производительностью бризера
* Версия програмного обеспечения бризера
* Измерение энергопотребления (только для 4S и Lite)
* Контроль состояния заслонки (только для Lite)
А так же:
* Конфигурация пресетов сервисом
* Задание максимальной температуры нагрева 30°C, в том числе для Lite
* Дамп и сброс внутренних таймеров (только для 4S)
* Защита от обмерзания (только для 3S и O2)
* Контроль и зависимость состояния нагревателя от соостояния заслонки (только для 3S и 4S)
>
> ## <font color="red">⚠️ **ВНИМАНИЕ: Все что вы делаете, вы делаете исключительно на свой страх и риск!**</font>
>
## Подключение
Доступно два вида подключения BLE и UART.
BLE подключение работает так же как ваш пульт или официальное приложение.
UART подключние различно для разных моделей бризеров.
Для UART-подключения `Tion 4S` используется штатный интеграционный разъем бризера.
Рекомендуется приобрести стик [Lilygo T-Dongle S3](https://github.com/Xinyuan-LilyGO/T-Dongle-S3),
проще всего это сделать на Aliexpress. Или собрать самостоятельно на базе ESP32.
> ВАЖНО: Собрка и работа компонента на ESP8266 возможна, но стабильность не
гарантируется, так же, в этом направлении, не будет оказана никакая поддержка,
используйте ESP32!
Для UART-подключения `Tion 3S` использется штатный, но доступный только при небольшой
разборке бризера, разъем. Здесь рекумендуется использовать любую ESP8266
(ESP32 не тянет по питанию) используя [схему подключения](hardware/3s/NodeMCUv3-Tion.pdf).
При использовании ESP-01S не будет доступено подключение штатного модуля BLE,
в остальных случаях подключение будет полным.
> Буду благодарен за любые экперименты по использованию совремнных модулей ESP32,
например, серий S2, S3 или C3.
Для UART-подключения `Tion O2` использется штатный, но доступный только при небольшой
разборке бризера, разъем. Требуются начальные навыки работы с паяльником.
По вопросам подключения велкам в чат [Telegram][telegram].
## Прошивка
Вы можете загрузить и использовать примеры конфигурации для
[Tion 4S BLE](tion-4s-ble.yaml), [Tion 4S UART](tion-4s-uart.yaml),
[Tion Lite BLE](tion-lt-ble.yaml), [Tion 3S BLE](tion-3s-ble.yaml),
[Tion 3S UART](tion-3s-uart.yaml) и [Tion O2 UART](tion-o2-uart.yaml)
все файлы с подробным описанием (на английском)
* Скачайте конфигурацию соотствующую модели вашего бризера
* Измените секцию `substitutions` согласно вашим предпочтениям
* Измените набор подключаемых пакетов по вашему вкусу
* Поместите модифицированный файл в директорию с конфигурацией ESPHome
* Запустите сборку и прошивку вашей конфигурации
* Добавьте появившееся устройство в Home Assistant
## Использование в режиме BLE
После [прошивки](#прошивка) и перед первым использование вам необъходимо ввести
свой бризер в режим сопряжения (см. инструкцию) и только потом включать ESP или
провести перезагрузку ESP с помощью фукции `Restart`.
Дополнительно, только для `Tion 3S`, необходимо нажать кнопку `Pair` в Home Assistant.
## Использование в режиме UART
Никаких дополнительный действий не требуется.
## Полезности
### Просмотр и/или сброс внутренних таймеров Tion 4S
Добавьте в свою конфигурацию пакет `tion_4s_timers.yaml`:
```yaml
packages:
tion:
...
files:
...
- packages/tion_4s_timers.yaml
```
## Использование с системами УД отличными от Home Assistant
Вы можете испольовать этот компонент с любой системой УД через протокол MQTT.
Для этого в файле конфигурации найдите и раскомментуйте секцию `mqtt`, дополнительные параметры
broker, port и т.д. установите согласно настройкам вашей системы УД.
Со списком всех параметров можно ознакомиться на странице [документации](https://esphome.io/components/mqtt.html).
### Испольование с УД Sprut.Hub
Наобходимо настроить `mqtt` согласно описанию из секции выше и установить шаблон
от @l0rda https://github.com/l0rda/sprut-tion. Дополнительную помощь всегда можно
получить в [группе Telegram](https://t.me/esphome_tion).
## Принцип работы и тонкая настройка
### Получение состояния
Состояние бризера храниться исключительно в самом бризере и синхронизируется
раз в настраиваемый интервал времени `climate.update_interval` или сразу же
после отработки запроса на изменение. Если состояние получить невозможно, то об этом
информирует сенсор `climate.state_warnout`, таймаут получения ответа на запрос
состояния настраивается `climate.state_timeout` и должен быть меньше
интервала опроса `climate.update_interval`.
### Изменение состояния
Изменение состояния происходит относительно последнего ответа на запрос состояния
или предыдущего ответа запроса на изменение. Так как ответ может прийти медленней
чем придет новый запрос (актуально для скриптов) реализован механизм пакетной
отправки команд на изменение. Поступивший запрос на изменение стартует таймер,
время сработки которого задается параметром `climate.batch_timeout`, каждый последующий
запрос до сработки таймера объединяется с предыдущим и рестартует таймер, после
сработки таймера объединенный запрос отправляется бризеру на выполнение.
### Отправка команд
Все запросы выстраиваются в очередь и выполняются с интервалом `vport.command_interval`.
Размер очереди задается параметром `vport.command_size`. Минимальный интервал `0s` будет
срабатывать один раз в итерацию основного цикла.
## Планы на будущее
* ~~Поддержка физического подключения через интеграционный разъем для `Tion 4S`~~ (так же исследую возможность для ~~3S и~~ Lite)
* ~~Управление сбросом ресура фильтров~~
* Автоматическое управление притоком от внешнего датчика CO2
## Решение проблем и поддержка новых функций
Не стесняйтесь открывать [задачи](https://github.com/dentra/esphome-tion/issues) для сообщений об ошибках и запросов новых функций.
Так же вы можете воспользоваться [группой в Telegram](https://t.me/esphome_tion).
## Ваша благодарность
Если этот проект оказался для вас полезен и/или вы хотите поддержать его дальнейше
развитие, то всегда можно оставить вашу благодарность
[переводом на карту](https://www.tinkoff.ru/cf/3dZPaLYDBAI) или
[подпиской](https://boosty.to/dentra) и обычной звездой проекту.
## Коммерческое использование
По вопросам коммерческого использования или заказной разработки/доработки,
обращийтесь по почте dennis.trachuk на gmail.com