====== Spotpear ESP32-S3-ETH как Bluetooth Proxy ======

===== Требования к сети =====

Для компиляции ESPHome необходим доступ к следующим ресурсам (добавь в VPN/прокси если заблокированы):

  * ''github.com''
  * ''registry.platformio.org''
  * ''platformio.org''

===== secrets.yaml =====

<code yaml>
api_key: "vK3pQ8xmN2hL5wRt9yBf4jC7nM0sX6zA1dE8gH3kP2o="
ota_password: "Spotpear$Proxy#2024!"
</code>

===== Конфигурация ESPHome =====

<code yaml>
esphome:
  name: spotpear-bt-proxy
  friendly_name: Spotpear Bluetooth Proxy
  platformio_options:
    board_build.flash_mode: dio

esp32:
  board: esp32-s3-devkitc-1
  framework:
    type: esp-idf

ethernet:
  type: W5500
  clk_pin: GPIO13
  mosi_pin: GPIO11
  miso_pin: GPIO12
  cs_pin: GPIO14
  interrupt_pin: GPIO10
  reset_pin: GPIO9

api:
  encryption:
    key: !secret api_key

ota:
  platform: esphome
  password: !secret ota_password

logger:

esp32_ble_tracker:
  scan_parameters:
    active: true

bluetooth_proxy:
  active: true

sensor:
  - platform: uptime
    name: "Uptime"
  - platform: internal_temperature
    name: "CPU Temperature"

binary_sensor:
  - platform: status
    name: "Status"
</code>

===== Первая прошивка =====

  - Подключи USB-C кабель к плате и серверу HA
  - Зажми **BOOT**, нажми **RESET**, отпусти **BOOT**
  - В ESPHome: **Install** → **Plug into the computer running ESPHome Dashboard**
  - Выбери порт (''/dev/ttyACM0'')
  - Дождись окончания прошивки

===== Запуск =====

  - Отключи USB
  - Подключи Ethernet с POE (или Ethernet + USB питание)
  - Устройство получит IP по DHCP
  - В HA: **Настройки** → **Устройства и службы** → добавь обнаруженное устройство
  - Проверь **Bluetooth** — появится новый адаптер

===== OTA обновления =====

После первой прошивки USB не нужен — выбирай **Install** → **Wirelessly**

===== Устранение проблем =====

==== Компиляция зависает на скачивании библиотек ====

Проверь доступ к ресурсам из контейнера ESPHome:

<code bash>
curl -I https://github.com
curl -I https://registry.platformio.org
</code>

Если таймаут — добавь адреса в маршрутизацию через VPN/прокси на роутере.