# 🔌 Схема подключения Ambilight (ESP32 + SK6812)

## 1. Базовая схема (без level-shifter)

```
       ┌─────────────────┐
       │     ESP32       │
       │                 │
       │           GPIO5 ├───[330-470Ω]───► DIN ленты
       │                 │
       │             GND ├───────┬────────► GND ленты
       └─────────────────┘       │
                                  │
                         ┌────────┴────────┐
                         │   5V источник    │
                         │  (≥1.5A запас)   │
                         └────────┬────────┘
                                  │
                                  └────────► V+ ленты
```

## 2. Рекомендуемая схема (с level-shifter)

```
       ┌─────────────────┐        ┌─────────────────┐
       │     ESP32       │        │  74AHCT125/245   │
       │                 │        │  (3.3V → 5V)     │
       │           GPIO5 ├───────►│ A            Y   ├───[330-470Ω]───► DIN ленты
       │                 │        └─────────────────┘
       │             GND ├───────────────┬──────────────────────────────► GND ленты
       └─────────────────┘               │
                                          │
                                 ┌────────┴────────┐
                                 │   5V источник    │
                                 │  (≥1.5A запас)   │
                                 └────────┬────────┘
                                          │
                                          └────────► V+ ленты
```

## 3. Таблица соединений

| Сигнал | ESP32 | Лента SK6812 | Описание |
| :--- | :--- | :--- | :--- |
| **DATA** | GPIO5 | DIN | Через резистор 330-470Ω; рекомендуется level-shifter 3.3V→5V |
| **GND (логика)** | GND | GND | Обязательно, даже если питание ленты отдельное (см. ниже) |
| **GND (питание)** | — | GND | Общий с GND источника 5V ленты |
| **V+** | — | V+ | От отдельного 5V источника, не от USB-порта ESP32 |

## 4. Рекомендации

- **Level-shifter обязателен при нестабильной работе.** SK6812 рассчитан на 5V-логику
  с порогом распознавания "1" около 0.7×5V = 3.5V. ESP32 выдаёт 3.3V — формально ниже
  порога, особенно на длинной линии данных или при большом числе светодиодов (60+).
  Дешёвый 74AHCT125/74HCT245 между GPIO и DIN устраняет большинство случайных вспышек.
- **Общий GND — обязателен**, даже если ESP32 и лента питаются от разных источников
  (например, ESP32 от USB ПК, лента от отдельного блока питания или пауэрбанка). Без
  общей точки отсчёта логический "0" для чипов ленты плывёт — появляются случайные
  вспышки цвета. Физика явления — в [`THEORY.md`](./THEORY.md), раздел 5.
- **Конденсаторы:** электролитический ~440 мкФ на V+/GND у входа ленты гасит
  низкочастотные броски тока при резкой смене цвета/яркости; керамический 100nF у
  первого светодиода дополнительно гасит высокочастотный шум источника питания.
- **Источник питания с запасом по току.** SK6812 5050 при максимальной яркости белого
  на всех 4 каналах потребляет ориентировочно 15-20 мА на светодиод — 60 штук дают до
  ~1.1-1.2A. Слабый источник (в т.ч. USB-хаб) приводит к просадкам и миганию —
  используйте отдельный 5V блок питания на ≥1.5A, не запитывайте ленту от USB ESP32.
- **Не питайте ленту от того же USB, что и ESP32**, если лента больше 10-15 светодиодов —
  порт компьютера/хаба не рассчитан на такой ток.