# Entrixy → ESPHome

ESPHome-конфиг для ESP32 / ESP8266 / Sonoff-устройств. Главный сценарий — связка через Home Assistant: ESPHome публикует `switch.lock_relay`, HA принимает webhook от Entrixy (см. `integrations/home-assistant/`) и дёргает switch.

Альтернативно можно сделать прямой webhook на ESPHome без HA — но это требует custom external_component (ESPHome native webhook-receiver не предоставляет).

## Рекомендуемая схема (через HA)

```
Entrixy app  →  webhook  →  Home Assistant  →  ESPHome switch  →  GPIO  →  Реле
```

1. Прошей `entrixy-esphome.yaml` в ESP32 через ESPHome (HA add-on или CLI).
2. В Home Assistant появится `switch.lock_relay`.
3. Настрой автоматизацию по образцу `integrations/home-assistant/configuration.yaml` — она вызывает `switch.turn_on: lock_relay` на webhook от Entrixy.

## Прямой webhook (продвинутый вариант)

Если HA ставить не хочешь — используй native Entrixy WebSocket-прошивку. Она подключается прямо к серверу Entrixy через WSS и принимает команды без посредников:

- Конфигуратор в браузере: [https://entrixy.com/esp/socket/](https://entrixy.com/esp/socket/) — собирает `.bin` под нужный чип и плату, прошивает через WebSerial.
- Исходник ESP32: [`/esp32-ws-example/`](https://entrixy.com/esp32-ws-example/)
- Исходник ESP8266 (Sonoff Mini, Wemos D1): [`/integrations/esp8266/`](https://entrixy.com/integrations/esp8266/)

ESPHome для прямого webhook требует кастомный компонент — это другой путь, см. `external_components`.

## Если приёмник не онлайн постоянно

Если у контроллера нет WiFi или нет розетки 220 В рядом — есть BLE-вариант, где телефон управляет напрямую по Bluetooth: [https://entrixy.com/esp/ble/](https://entrixy.com/esp/ble/).