work: функционал для работы с вятяжкой

* Добавил полный функционал управления elica через esp32 по MQTT
* Добавил в прошивку принудительную блокировку внешнего винтелятора при работающей вытяжке
* Добавил веб-панели для управления вытяжкой
This commit is contained in:
2026-09-26 23:59:01 +03:00
parent 3b3c7a3f13
commit bf832ac86b
12 changed files with 631 additions and 52 deletions
+96 -29
View File
@@ -19,14 +19,17 @@ class ElicaController:
service: ElicaService,
state_timeout: float = 3.0,
poll_interval: float = 0.05,
speed_inter_press_delay: float = 0.4,
):
self._service = service
self._state_timeout = state_timeout
self._poll_interval = poll_interval
self._speed_inter_press_delay = max(0.0, speed_inter_press_delay)
# Не допускаем одновременное выполнение нескольких
# последовательностей нажатий кнопок.
self._lock = asyncio.Lock()
self._external_fan_lock = asyncio.Lock()
@property
def service(self) -> ElicaService:
@@ -77,7 +80,7 @@ class ElicaController:
async def _power_on_locked(self) -> ElicaLogicalState:
"""Включает вытяжку. Вызывается только под self._lock."""
self._ensure_ready()
await self._ensure_ready()
state = self.state
if state.power:
@@ -92,7 +95,7 @@ class ElicaController:
async def _power_off_locked(self) -> ElicaLogicalState:
"""Выключает вытяжку. Вызывается только под self._lock."""
self._ensure_ready()
await self._ensure_ready()
state = self.state
if not state.power:
@@ -122,55 +125,72 @@ class ElicaController:
# ------------------------------------------------------------------
async def set_speed(self, speed: int) -> ElicaLogicalState:
"""
Устанавливает скорость 1-4.
"""Устанавливает скорость 1-4 последовательными нажатиями Speed.
Контроллер нажимает кнопку Speed и после каждого нажатия
проверяет фактическую скорость по индикаторам.
У Elica одна кнопка скорости и фиксированный цикл:
1 -> 2 -> 3 -> 4 -> 1
Поэтому сначала определяем текущую скорость по индикаторам,
вычисляем точное число нажатий и после каждого нажатия ждём
подтверждения следующей скорости.
"""
if not 1 <= speed <= 4:
raise ValueError("Elica speed must be between 1 and 4")
async with self._lock:
self._ensure_ready()
await self._ensure_ready()
state = self.state
if not state.power:
state = await self._power_on_locked()
# У Elica кнопка Speed сама включает вытяжку. Первое
# нажатие из состояния OFF запускает её на скорости 1.
# Поэтому при выборе скорости Power здесь не нажимаем.
await self._service.press_speed()
state = await self._wait_state(
lambda value: value.power and value.speed == 1,
"speed 1",
)
# После включения power LED может обновиться раньше speed LED.
if state.speed == 0:
# После физического отпускания кнопки Elica нужен
# небольшой гарантированный интервал до следующего
# нажатия. Иначе при быстром наборе 2/3/4 контроллер
# вытяжки иногда воспринимает два импульса как одно
# длинное нажатие или просто игнорирует следующий.
if speed != 1 and self._speed_inter_press_delay > 0:
await asyncio.sleep(self._speed_inter_press_delay)
# Если питание уже было включено, но индикатор скорости ещё
# не успел синхронизироваться, ждём корректное значение 1-4.
if not 1 <= state.speed <= 4:
state = await self._wait_state(
lambda value: value.power and 1 <= value.speed <= 4,
"initial speed",
)
if state.speed == speed:
return state
current_speed = state.speed
presses = (speed - current_speed) % 4
# Не предполагаем конкретный порядок скоростей.
# После каждого нажатия смотрим, что реально получилось.
for _ in range(4):
previous_speed = state.speed
for _ in range(presses):
expected_speed = current_speed % 4 + 1
await self._service.press_speed()
state = await self._wait_state(
lambda value: (
value.power
and 1 <= value.speed <= 4
and value.speed != previous_speed
lambda value, expected=expected_speed: (
value.power and value.speed == expected
),
"speed change",
f"speed {expected_speed}",
)
if state.speed == speed:
return state
current_speed = expected_speed
raise RuntimeError(
f"Unable to set Elica speed to {speed}; "
f"current speed: {state.speed}"
)
# Не нажимаем Speed повторно сразу после отпускания
# предыдущего импульса. Это особенно важно для переходов
# на 4-ю скорость, где требуется несколько нажатий подряд.
if current_speed != speed and self._speed_inter_press_delay > 0:
await asyncio.sleep(self._speed_inter_press_delay)
return state
# ------------------------------------------------------------------
# Timer
@@ -183,7 +203,7 @@ class ElicaController:
Состояние подтверждается по миганию индикатора скорости.
"""
async with self._lock:
self._ensure_ready()
await self._ensure_ready()
state = self.state
if not enabled and not state.power:
@@ -228,9 +248,56 @@ class ElicaController:
поэтому light_on/light_off реализовать достоверно нельзя.
"""
async with self._lock:
self._ensure_ready()
await self._ensure_ready()
await self._service.press_light()
# ------------------------------------------------------------------
# External fan (OUT5 / NC contact)
# ------------------------------------------------------------------
async def set_external_fan(self, enabled: bool) -> bool:
"""
Управляет внешним вентилятором через OUT5.
Вентилятор подключён к NC-контакту, поэтому для включения
вентилятора катушка реле должна быть выключена, а для выключения
— включена. Физическая инверсия скрыта внутри этого метода.
"""
async with self._external_fan_lock:
self._ensure_available()
relay = self._service.config.external_fan_relay
await self._service.wait_relay_feedback_ready(
relay,
timeout=self._state_timeout,
)
relay_enabled = (
not enabled
if self._service.config.external_fan_normally_closed
else enabled
)
if self._service.relay_state(relay) != relay_enabled:
self._service.set_relay(relay, relay_enabled)
await self._service.wait_relay_state(
relay,
relay_enabled,
timeout=self._state_timeout,
)
state = self._service.external_fan_state
if state.on is None:
raise RuntimeError("External fan state is unavailable")
return state.on
async def external_fan_on(self) -> bool:
return await self.set_external_fan(True)
async def external_fan_off(self) -> bool:
return await self.set_external_fan(False)
# ------------------------------------------------------------------
# Синхронизация начального состояния
# ------------------------------------------------------------------