# Подключение APDS-9960

## Схема

```
     ESP32                    APDS-9960
  ┌───────────┐             ┌─────────────┐
  │       3V3 ├─────────────┤ VCC         │
  │       GND ├─────────────┤ GND         │
  │    GPIO21 ├─────────────┤ SDA         │
  │    GPIO22 ├─────────────┤ SCL         │
  │     GPIO2 ├──[R 220Ω]──[LED]──┐        │
  │           │                  │        │
  │       GND ├──────────────────┘        │
  └───────────┘             └─────────────┘
```

`GPIO2` со светодиодом — опционально, только для визуальной индикации
приближения в тестовом стенде ([main.cpp](src/main.cpp)). Для самого датчика
достаточно четырёх проводов VCC/GND/SDA/SCL.

## Таблица пинов

| APDS-9960 | ESP32 (esp32dev) | Назначение |
|-----------|-------------------|------------|
| VCC       | 3V3               | Питание 3.3V |
| GND       | GND               | Общий провод |
| SDA       | GPIO21            | Данные I2C |
| SCL       | GPIO22            | Тактирование I2C |

Пины `I2C_SDA`/`I2C_SCL` заданы в [main.cpp:4-5](src/main.cpp#L4-L5) —
при необходимости смените их под свою распиновку.

## Подтяжка линий I2C

Линиям SDA/SCL нужны подтягивающие резисторы к 3.3V (обычно 4.7 кОм), иначе
шина не будет держать логическую единицу и обмен будет нестабильным. На
большинстве готовых модулей APDS-9960 эти резисторы уже впаяны на плату —
отдельно добавлять их нужно, только если вы используете «голый» чип без
модуля-переходника.

## Примечание про пин VL

Если при правильно собранной схеме `Prox` в Serial Monitor всегда равен 0 —
проверьте напряжение на пине **VL** модуля. Если там 0V, соедините VL
перемычкой с VCC. На большинстве современных модулей это соединение уже
выполнено на заводе, но на части партий — нет, и датчик в таком случае
физически не включает ИК-подсветку, хотя по I2C отвечает нормально.

## Про пин INT

Для proximity-режима в этом компоненте пин прерывания (INT) не используется —
опрос данных идёт напрямую через регистр PDATA методом polling
(см. [main.cpp:44](src/main.cpp#L44)), без аппаратных прерываний по порогу.
Можно оставить его неподключённым.