APDS9960 и Arduino: руководство по датчику жестов, приближения и цвета
Руководство по APDS9960 и Arduino: подключение I2C и 3,3 V, жесты влево, вправо, вверх и вниз, приближение и RGB, код SparkFun и Adafruit, пин INT, ESP32 и Pico.
В проектах с APDS9960 и Arduino одна крошечная микросхема выполняет четыре задачи: распознаёт движения руки вправо, влево, вверх и вниз, определяет приближение объекта, а также измеряет окружающую освещённость и цвет по красному, зелёному и синему каналам. Это родственник датчика в телефоне, который выключает экран, когда ты подносишь его к уху, и подстраивает яркость под освещение в комнате. Он отлично подходит для первых проектов, в которых можно включать лампу, переключать песни или перемещаться по меню взмахом руки, ни к чему не прикасаясь.
В этом руководстве ты узнаешь, что находится внутри APDS-9960, как он распознаёт жесты, почему ему нужно питание 3,3 V и как подключить его к Arduino Uno, ESP32 и Raspberry Pi Pico. С библиотеками SparkFun и Adafruit ты сделаешь тест жестов, светодиод, который становится ярче при приближении руки, измерение цвета и освещённости в люксах, управление светодиодами и музыкой с помощью жестов. Также разберёшься, как использовать пин INT для прерываний и какова реальная дальность датчика.

Что такое APDS-9960 и как он работает?
APDS-9960 — датчик компании Broadcom (ранее Avago), в корпусе размером около 4 × 2,4 мм которого размещены инфракрасный (ИК) светодиод и несколько фотоприёмников. При определении приближения ИК-светодиод излучает короткие импульсы, отражённый от объекта перед датчиком свет возвращается на фотодиоды, и чем сильнее отражение, тем ближе объект. Результат — число от 0 до 255. При измерении цвета светодиод не используется: окружающий свет попадает на четыре отдельных фотодиода с красным, зелёным, синим фильтрами и без фильтра (clear), каждый из которых выдаёт 16-битное число.
Распознавание жестов — самая интересная часть. Внутри микросхемы есть четыре фотодиода, направленные вверх (U), вниз (D), влево (L) и вправо (R). Когда рука проходит над датчиком, один диод видит отражение первым, а противоположный — позже. Когда значение приближения превышает порог входа (40 в библиотеке SparkFun), запускается блок распознавания жестов, записывает показания четырёх диодов в буфер FIFO на 32 записи и останавливается, когда рука удаляется. Arduino считывает эти записи и анализирует, как со временем меняется разность между U и D, а также между L и R: если сначала больше U, а затем D, рука двигалась вниз.
| Характеристика | Значение |
|---|---|
| Производитель | Broadcom (ранее Avago) |
| Питание микросхемы (VDD) | 2,4–3,6 V |
| Питание ИК-светодиода (VL) | 3,0–4,5 V |
| Интерфейс | I2C, до 400 kHz |
| I2C-адрес | 0x39 (фиксированный, изменить нельзя) |
| Приближение | 8 бит (0–255) |
| Цвет и освещённость | 4 канала (без фильтра, красный, зелёный, синий), 16 бит на канал |
| Жесты | 4 направленных фотодиода (U, D, L, R), FIFO на 32 записи |
| ИК-светодиод | 950 нм, ток регулируется от 12,5 до 100 mA |
| Практическая дальность распознавания жестов | Около 10–20 см |
| Выход прерывания | INT, открытый сток, при событии переходит в LOW |
Пины модуля и вопрос питания 3,3 V
Чаще всего встречаются плата-переходник SparkFun и её фиолетовый клон GY-9960. У обеих шесть пинов. На обратной стороне большинства модулей есть паяная перемычка PS; пока она замкнута, питание ИК-светодиода (VL) напрямую соединено с VCC, а пин VL нужно оставить неподключённым.
| Пин | Назначение | Куда подключить |
|---|---|---|
| VL | Вход питания ИК-светодиода | Оставь неподключённым, если перемычка PS замкнута |
| GND | Земля | GND |
| VCC | Питание микросхемы | 3,3 V |
| SDA | Линия данных I2C | Пин SDA платы |
| SCL | Тактовая линия I2C | Пин SCL платы |
| INT | Выход прерывания (открытый сток) | Цифровой пин с поддержкой прерываний |
Подключение: Arduino Uno, ESP32 и Raspberry Pi Pico
| APDS-9960 | Arduino Uno | ESP32 | Raspberry Pi Pico |
|---|---|---|---|
| VCC | 3.3V | 3V3 | 3V3 (OUT) |
| GND | GND | GND | GND |
| SDA | A4 (через преобразователь уровней) | GPIO 21 | GP4 |
| SCL | A5 (через преобразователь уровней) | GPIO 22 | GP5 |
| INT | D2 | GPIO 4 | GP15 |
| VL | Не подключён (PS замкнута) | Не подключён (PS замкнута) | Не подключён (PS замкнута) |
У ESP32 и Pico пины уже работают с 3,3 V, поэтому их можно подключать напрямую. С Uno немного сложнее: библиотека Wire на Uno включает внутренние подтягивающие резисторы на SDA и SCL и подтягивает линии к 5 V, а собственные резисторы модуля подтягивают их к 3,3 V. На практике это обычно работает, но микросхема оказывается на пределе допустимых условий. Самый надёжный вариант — двунаправленный преобразователь уровней I2C между Uno и модулем. Поскольку у пина INT открытый сток, подтягивающий резистор модуля удерживает на нём 3,3 V; Uno считывает это напряжение как HIGH, поэтому включать внутреннюю подтяжку INT на Uno не нужно. Работа I2C разобрана в руководстве «Что такое I2C».
SparkFun или Adafruit? Выбор библиотеки
| Характеристика | SparkFun APDS9960 | Adafruit APDS9960 |
|---|---|---|
| Направления жестов | Вверх, вниз, влево, вправо, а также приближение и удаление | Вверх, вниз, влево, вправо |
| Чтение приближения | readProximity(variable) | Возвращаемое значение readProximity() |
| Чтение цвета | Отдельные функции, например readRedLight() | Всё сразу через getColorData(), а также освещённость в люксах и цветовая температура |
| Настройки прерываний | Прерывания по жестам, приближению и освещённости | Прерывания по приближению и цвету, настройка порогов |
| Допустимый ID микросхемы | 0xAB и 0x9C | Только 0xAB |
| Дополнительная зависимость | Нет (только Wire) | Adafruit BusIO |
Обе библиотеки есть в «Менеджере библиотек» (Library Manager): ищи SparkFun APDS9960 RGB and Gesture Sensor и Adafruit APDS9960 Library. Для жестов алгоритм SparkFun немного стабильнее и также распознаёт приближение и удаление; для цвета функции расчёта освещённости в люксах и цветовой температуры в Adafruit упрощают работу. В этом руководстве используются обе библиотеки. Если устанавливаешь библиотеку впервые, загляни в руководство по добавлению библиотеки в Arduino.
Пошагово: первый тест жестов с пином INT
- Подключи модуль по таблице выше: VCC к 3.3V, SDA к A4, SCL к A5, INT к D2.
- Установи библиотеку SparkFun и загрузи приведённый ниже скетч в Uno.
- Открой монитор порта (Serial Monitor) на скорости 9600 бод и дождись сообщения «Jest sensoru hazir» (датчик жестов готов).
- Проведи рукой на высоте 5–10 см над датчиком от одного края к другому так, чтобы движение заняло примерно полсекунды.
- Должны появиться YUKARI (вверх), ASAGI (вниз), SOL (влево) или SAG (вправо); если направления перепутаны, поверни датчик на 90 или 180 градусов либо поменяй местами ветви case в коде.
1#include <Wire.h>
2#include <SparkFun_APDS9960.h>
3
4const int APDS_INT = 2; // kesme pini (Uno'da 2 ya da 3) / interrupt pin (2 or 3 on Uno)
5SparkFun_APDS9960 apds;
6volatile bool gestureFlag = false;
7
8void onGesture() { // INT LOW'a düşünce çalışır / runs when INT goes LOW
9 gestureFlag = true;
10}
11
12void handleGesture() {
13 if (!apds.isGestureAvailable()) return;
14 switch (apds.readGesture()) {
15 case DIR_UP: Serial.println("YUKARI / UP"); break;
16 case DIR_DOWN: Serial.println("ASAGI / DOWN"); break;
17 case DIR_LEFT: Serial.println("SOL / LEFT"); break;
18 case DIR_RIGHT: Serial.println("SAG / RIGHT"); break;
19 case DIR_NEAR: Serial.println("YAKIN / NEAR"); break;
20 case DIR_FAR: Serial.println("UZAK / FAR"); break;
21 default: Serial.println("BELIRSIZ / NONE");
22 }
23}
24
25void setup() {
26 Serial.begin(9600);
27 pinMode(APDS_INT, INPUT); // modüldeki pull-up 3,3 V'a çeker / module pull-up to 3.3 V
28 attachInterrupt(digitalPinToInterrupt(APDS_INT), onGesture, FALLING);
29
30 if (!apds.init()) { // Wire.begin() kütüphanenin içinde / Wire.begin() is inside
31 Serial.println("APDS-9960 bulunamadi / not found");
32 while (true);
33 }
34 if (apds.enableGestureSensor(true)) { // true = jest olunca INT LOW / true = INT goes LOW on a gesture
35 Serial.println("Jest sensoru hazir / gesture sensor ready");
36 }
37}
38
39void loop() {
40 if (gestureFlag) {
41 detachInterrupt(digitalPinToInterrupt(APDS_INT)); // okurken yeni kesme gelmesin / no new IRQ while reading
42 handleGesture();
43 gestureFlag = false;
44 attachInterrupt(digitalPinToInterrupt(APDS_INT), onGesture, FALLING);
45 }
46}Когда жест распознан, APDS-9960 переводит пин INT в LOW, вызывая прерывание на пине D2 платы Uno. Обработчик прерывания лишь устанавливает флаг; само чтение происходит в loop(), потому что readGesture() считывает десятки байтов по I2C, а использование I2C внутри прерывания приводит к зависаниям. Временное отключение прерывания на время чтения также предотвращает повторную обработку одного жеста. Логика прерываний подробно разобрана в руководстве по прерываниям Arduino.
Обнаружение приближения: светодиод становится ярче при приближении руки
Измерять только приближение, без жестов, гораздо проще и стабильнее. Скетч ниже напрямую передаёт значение приближения на светодиод с помощью ШИМ: чем ближе рука, тем ярче светодиод, а при удалении он тускнеет. Подключи светодиод к D9 через резистор 220 Ω; подобрать нужный номинал поможет калькулятор резистора для светодиода.
1#include <Wire.h>
2#include <SparkFun_APDS9960.h>
3
4SparkFun_APDS9960 apds;
5const int LED_PIN = 9; // PWM pini / PWM pin
6
7void setup() {
8 Serial.begin(9600);
9 pinMode(LED_PIN, OUTPUT);
10 if (!apds.init()) {
11 Serial.println("APDS-9960 bulunamadi / not found");
12 while (true);
13 }
14 apds.setProximityGain(PGAIN_2X); // kazanç: 1X, 2X, 4X, 8X / gain
15 apds.enableProximitySensor(false); // false = kesme yok / no interrupt
16}
17
18void loop() {
19 uint8_t prox = 0; // 0 = uzak, 255 = çok yakın / 0 far, 255 very close
20 if (apds.readProximity(prox)) {
21 analogWrite(LED_PIN, prox); // el yaklaştıkça LED parlar / LED gets brighter as the hand comes closer
22 Serial.println(prox);
23 }
24 delay(50);
25}Значение приближения — это не сантиметры, а интенсивность отражённого света. Лист белой бумаги может дать 40 на расстоянии 15 см, а чёрная ткань на том же расстоянии — меньше 10. Поэтому используй APDS-9960 для ответа на вопрос «что-то приблизилось?», а не как дальномер. Если нужно точное расстояние, ультразвуковой датчик HC-SR04 будет более точным выбором. Если значения очень низкие, установи усиление PGAIN_4X или PGAIN_8X; если они постоянно держатся на 255, снизь его до PGAIN_1X.
Измерение цвета RGB и окружающей освещённости
При измерении цвета APDS-9960 считывает четыре канала: красный (R), зелёный (G), синий (B) и суммарный свет без фильтра (C). Библиотека Adafruit также рассчитывает по этим сырым значениям приблизительную освещённость в люксах и цветовую температуру света (в кельвинах). Скетч ниже каждые полсекунды выводит четыре канала, значения в люксах и кельвинах и показывает, какой цвет преобладает.
1#include <Adafruit_APDS9960.h>
2
3Adafruit_APDS9960 apds;
4
5void setup() {
6 Serial.begin(9600);
7 if (!apds.begin()) { // kimlik 0xAB değilse false / false if the ID is not 0xAB
8 Serial.println("APDS-9960 bulunamadi / not found");
9 while (true);
10 }
11 apds.setADCIntegrationTime(100); // 100 ms ölçüm: daha hassas / 100 ms integration: more sensitive
12 apds.enableColor(true); // renk + ortam ışığı / colour + ambient light
13}
14
15void loop() {
16 uint16_t r, g, b, c;
17 while (!apds.colorDataReady()) delay(5); // ölçüm bitene kadar bekle / wait for a reading
18 apds.getColorData(&r, &g, &b, &c);
19 uint16_t lux = apds.calculateLux(r, g, b); // yaklaşık lüks / approximate lux
20 uint16_t cct = apds.calculateColorTemperature(r, g, b); // renk sıcaklığı (K) / colour temperature (K)
21
22 Serial.print("R:"); Serial.print(r);
23 Serial.print(" G:"); Serial.print(g);
24 Serial.print(" B:"); Serial.print(b);
25 Serial.print(" C:"); Serial.print(c);
26 Serial.print(" lux:"); Serial.print(lux);
27 Serial.print(" K:"); Serial.println(cct);
28
29 if (c > 100) { // yeterli ışık varsa baskın rengi söyle / name the dominant colour
30 if (r > g && r > b) Serial.println("Kirmizi / red");
31 else if (g > r && g > b) Serial.println("Yesil / green");
32 else Serial.println("Mavi / blue");
33 }
34 delay(500);
35}Сырые значения — это не абсолютные цвета, а количество света; одна и та же красная карточка даёт очень разные числа в тускло освещённой комнате и на солнце. Поэтому при сравнении цветов сравнивай отношения: отношение R к C остаётся более стабильным даже при изменении освещения. Чтобы считать цвет объекта, держи его в 1–2 см от датчика и перекрой внешний свет рукой или трубкой. Значение в люксах приблизительное: оно не заменит люксметр, но его более чем достаточно для ответа на вопрос «в комнате стало темно?». Для проектов, которым нужно более точное различение цветов, рассмотри специализированные датчики цвета, например датчик цвета TCS3200 или TCS34725.
Управление светодиодом жестами без пина INT
Подключать пин INT необязательно. Библиотека может узнавать о новом жесте, опрашивая по I2C регистр состояния блока распознавания жестов. Это экономит один пин и упрощает код, но loop() постоянно создаёт обмен по I2C. В скетче ниже жест вверх включает светодиод на полную яркость, вниз — выключает, а жесты вправо и влево повышают и понижают яркость с шагом в четверть диапазона.
1#include <Wire.h>
2#include <SparkFun_APDS9960.h>
3
4SparkFun_APDS9960 apds;
5const int LED_PIN = 9; // PWM pini / PWM pin
6int level = 0; // parlaklık 0-255 / brightness 0-255
7
8void setup() {
9 Serial.begin(9600);
10 pinMode(LED_PIN, OUTPUT);
11 if (!apds.init()) {
12 Serial.println("APDS-9960 bulunamadi / not found");
13 while (true);
14 }
15 apds.enableGestureSensor(false); // INT olmadan, sorgulayarak / polling, no INT pin
16}
17
18void loop() {
19 if (apds.isGestureAvailable()) {
20 switch (apds.readGesture()) {
21 case DIR_UP: level = 255; break; // tam aç / fully on
22 case DIR_DOWN: level = 0; break; // kapat / off
23 case DIR_RIGHT: level = min(level + 64, 255); break; // daha parlak / brighter
24 case DIR_LEFT: level = max(level - 64, 0); break; // daha sönük / dimmer
25 default: break;
26 }
27 analogWrite(LED_PIN, level);
28 Serial.print("Parlaklik / brightness: ");
29 Serial.println(level);
30 }
31}Управление музыкой жестами с DFPlayer Mini

Одно из самых интересных применений датчика жестов — бесконтактный музыкальный плеер. Подключи пин RX модуля DFPlayer Mini к D11 платы Uno через резистор 1 kΩ, а TX — к D10; подключи динамик к SPK_1 и SPK_2 и подай питание модуля от 5V. Скопируй песни на SD-карту с именами 0001.mp3, 0002.mp3 и так далее. Подробности о модуле есть в руководстве по DFPlayer Mini. Жест вправо включает следующую песню, влево — предыдущую; жесты вверх и вниз повышают и понижают громкость, а неподвижная рука над датчиком приостанавливает и возобновляет воспроизведение.
1#include <Wire.h>
2#include <SoftwareSerial.h>
3#include <SparkFun_APDS9960.h>
4#include <DFRobotDFPlayerMini.h>
5
6SoftwareSerial mp3Serial(10, 11); // RX, TX (TX hattına 1 kΩ / 1 kΩ on the TX line)
7DFRobotDFPlayerMini player;
8SparkFun_APDS9960 apds;
9bool playing = true;
10int volume = 18; // ses 0-30 / volume 0-30
11
12void setup() {
13 Serial.begin(9600);
14 mp3Serial.begin(9600);
15 if (!player.begin(mp3Serial)) { Serial.println("DFPlayer yok / not found"); while (true); }
16 if (!apds.init()) { Serial.println("APDS-9960 yok / not found"); while (true); }
17 apds.enableGestureSensor(false);
18 player.volume(volume);
19 player.play(1); // SD karttaki 0001.mp3 / 0001.mp3 on the SD card
20}
21
22void loop() {
23 if (!apds.isGestureAvailable()) return;
24 switch (apds.readGesture()) {
25 case DIR_RIGHT: player.next(); Serial.println("Sonraki / next"); break;
26 case DIR_LEFT: player.previous(); Serial.println("Onceki / previous"); break;
27 case DIR_UP: volume = min(volume + 3, 30); player.volume(volume); break;
28 case DIR_DOWN: volume = max(volume - 3, 0); player.volume(volume); break;
29 case DIR_NEAR: // eli sensör üzerinde sabit tut / hold the hand still
30 if (playing) player.pause(); else player.start();
31 playing = !playing;
32 break;
33 default: break;
34 }
35}Здесь нужно учитывать одну деталь: readGesture() не возвращает управление до завершения жеста и ждёт 30 мс между чтениями FIFO. Пока рука остаётся над датчиком, Arduino больше ничего не делает. Для музыкального плеера это не проблема, но если в том же скетче есть мотор или анимация на дисплее, которым нужна быстрая реакция, их работу придётся согласовать со считыванием жестов.
Пин INT и ESP32: обнаружение приближения по прерыванию
Пин INT служит не только для жестов: его можно использовать и для порогов приближения и освещённости. Ты задаёшь порог; когда показание его пересекает, APDS-9960 переводит INT в LOW и удерживает этот уровень до сброса прерывания. Благодаря этому микроконтроллеру не нужно постоянно опрашивать датчик. Скетч для ESP32 ниже использует библиотеку Adafruit, чтобы активировать INT, когда значение приближения превышает 150, и при каждом приближении руки переключает встроенный светодиод, как бесконтактный выключатель света.
1#include <Wire.h>
2#include <Adafruit_APDS9960.h>
3
4const int INT_PIN = 4; // APDS INT -> GPIO 4
5const int LED_PIN = 2; // karttaki LED / on-board LED
6Adafruit_APDS9960 apds;
7bool ledOn = false;
8
9void setup() {
10 Serial.begin(115200);
11 pinMode(INT_PIN, INPUT_PULLUP); // 3,3 V'a çekmek güvenli / pulling up to 3.3 V is safe
12 pinMode(LED_PIN, OUTPUT);
13 Wire.begin(21, 22); // SDA, SCL
14 if (!apds.begin()) {
15 Serial.println("APDS-9960 bulunamadi / not found");
16 while (true) delay(10);
17 }
18 apds.enableProximity(true);
19 apds.setProximityInterruptThreshold(0, 150); // 150'yi aşınca INT LOW / INT goes LOW above 150
20 apds.enableProximityInterrupt();
21}
22
23void loop() {
24 if (digitalRead(INT_PIN) == LOW) { // el yaklaştı / a hand came close
25 uint8_t p = apds.readProximity();
26 ledOn = !ledOn; // her yaklaşmada aç-kapa / toggle on every approach
27 digitalWrite(LED_PIN, ledOn);
28 Serial.printf("Yakinlik / proximity: %u LED: %s\n", p, ledOn ? "ON" : "OFF");
29 while (apds.readProximity() > 100) delay(20); // el çekilene kadar bekle / wait for the hand to leave
30 apds.clearInterrupt(); // INT'i serbest bırak / release INT
31 }
32}Третий параметр setProximityInterruptThreshold() (по умолчанию 4) задаёт устойчивость срабатывания: сколько последовательных измерений должны пересечь порог до вызова прерывания. Это отфильтровывает кратковременные помехи. Если не вызвать clearInterrupt(), INT останется в LOW и следующее приближение будет пропущено. Такая схема очень полезна в проектах с питанием от батареи: переведи ESP32 в глубокий сон и настрой пробуждение по пину INT с помощью esp_sleep_enable_ext0_wakeup(GPIO_NUM_4, 0), и плата будет просыпаться только при приближении руки. GPIO 4 — пин RTC, поэтому подходит для этой задачи.
APDS-9960 с Raspberry Pi Pico (MicroPython)
На Raspberry Pi Pico можно работать с APDS-9960 в MicroPython без библиотек, напрямую записывая значения в его регистры. Код ниже считывает ID микросхемы, включает измерение цвета и приближения и каждые 200 мс выводит четыре цветовых канала и значение приближения. Подключение использует шину I2C0: SDA к GP4, SCL к GP5, VCC к пину 3V3(OUT).
1from machine import Pin, I2C
2import time
3
4ADDR = 0x39 # APDS-9960 sabit adresi / fixed address
5i2c = I2C(0, sda=Pin(4), scl=Pin(5), freq=400000)
6
7def write(reg, val):
8 i2c.writeto_mem(ADDR, reg, bytes([val]))
9
10def read(reg, n=1):
11 return i2c.readfrom_mem(ADDR, reg, n)
12
13print("ID:", hex(read(0x92)[0])) # orijinalde 0xAB / 0xAB on a genuine chip
14
15write(0x80, 0x00) # ENABLE: her şeyi kapat / everything off
16write(0x81, 0xDB) # ATIME: 37 döngü, ~103 ms / 37 cycles, ~103 ms
17write(0x8E, 0x87) # PPULSE: 16 us, 8 darbe / 16 us, 8 pulses
18write(0x8F, 0x09) # CONTROL: LED 100 mA, PGAIN 4x, AGAIN 4x
19write(0x80, 0x07) # ENABLE: PON + AEN (renk/colour) + PEN (yakınlık/proximity)
20time.sleep_ms(150)
21
22while True:
23 if read(0x93)[0] & 0x01: # STATUS.AVALID: renk verisi hazır / colour data ready
24 d = read(0x94, 8) # C, R, G, B: ikişer bayt / two bytes each
25 c = d[0] | d[1] << 8
26 r = d[2] | d[3] << 8
27 g = d[4] | d[5] << 8
28 b = d[6] | d[7] << 8
29 prox = read(0x9C)[0] # PDATA: 0-255
30 print("C", c, "R", r, "G", g, "B", b, "yakinlik/prox", prox)
31 time.sleep_ms(200)Вот назначение регистров в коде: 0x80 (ENABLE) выбирает включённые блоки, 0x81 (ATIME) задаёт время интегрирования цвета (2,78 мс на шаг), 0x8F (CONTROL) задаёт ток ИК-светодиода и усиления, 0x93 (STATUS) сообщает о готовности данных, 0x94–0x9B хранят цветовые каналы, а 0x9C — значение приближения. Для жестов пришлось бы считывать FIFO и писать алгоритм определения направления, похожий на алгоритм SparkFun, а это более долгая работа. Если предпочитаешь Arduino IDE, установи ядро arduino-pico для Pico и используй библиотеку SparkFun без изменений; пины I2C по умолчанию — снова GP4 и GP5.
Ограничения дальности и правильное использование
APDS-9960 разрабатывался как датчик для телефона, поэтому его дальность невелика. На практике жесты надёжно распознаются на расстоянии от 5 до 15 см, а в лучшем случае — до 20 см. Показания приближения имеют смысл примерно до того же расстояния. Предел определяется мощностью ИК-светодиода и количеством света, отражённого рукой; увеличение тока светодиода до 100 mA и усиления до максимума немного повышает дальность, но добавляет шум.
| Фактор | Влияние | Что делать |
|---|---|---|
| Расстояние | Дальше 15 см жесты перестают распознаваться | Проводи рукой на расстоянии 5–10 см |
| Скорость движения | Слишком медленные или быстрые движения не распознаются | Плавное движение за полсекунды |
| Солнечный свет | ИК-излучение солнца насыщает фотодиоды | Используй в тени или в помещении |
| Стекло или прозрачная крышка | Крышка отражает ИК-излучение обратно, поэтому значение приближения постоянно высокое | Убери крышку или используй тонкий материал, прозрачный для ИК-излучения |
| Цвет поверхности | Чёрная перчатка отражает меньше света | Увеличь усиление |
| Ориентация датчика | Направления поворачиваются | Поменяй местами ветви направлений в коде |
Идеи проектов с APDS-9960
- Бесконтактная лампа: переключай модуль реле по прерыванию приближения; это очень удобно на кухне, когда руки испачканы.
- Цветная лампа с управлением жестами: переключай цвета RGB-светодиода или ленты WS2812B жестами вправо и влево.
- Меню в воздухе: выбирай пункты меню на OLED-дисплее жестами вверх и вниз и подтверждай выбор жестом NEAR.
- Крышка с управлением жестами: открывай крышку коробки жестом с помощью сервопривода.
- Автоматическая яркость дисплея: подстраивай экран или светодиодную ленту под окружающее освещение; по сравнению с фоторезистором (LDR) показания стабильнее и содержат информацию о цвете.
- Сортировщик по цвету: сортируй цветные конфеты или детали конструктора, спускающиеся по жёлобу, по значениям цветовых каналов.
Частые ошибки и их решения
| Симптом | Вероятная причина | Решение |
|---|---|---|
| «APDS-9960 bulunamadi» (не найден) | Ошибка подключения, нет 3,3 V или другой ID микросхемы | Найди 0x39 с помощью I2C-сканера, считай ID |
| Модуль найден, но init завершается ошибкой | Клон микросхемы с другим ID, например 0xA8 | Добавь это значение в проверку ID библиотеки |
| Жесты не распознаются | Рука слишком далеко или движется слишком медленно, на VL нет питания | Проведи рукой на расстоянии 5–10 см за полсекунды, проверь перемычку PS |
| Направления обратные или перепутаны | Ориентация установленного датчика | Поменяй местами ветви DIR в коде |
| Значение приближения постоянно высокое | Стекло, крышка или близкая поверхность перед датчиком | Убери крышку, уменьши усиление |
| Не работает на улице | Солнечный свет заглушает ИК-сигнал | Используй в тени |
| Случайные зависания на Uno | Несогласованные уровни I2C 5 V и 3,3 V, длинные провода | Преобразователь уровней и короткие провода |
| INT остаётся в LOW | Прерывание не сброшено | Вызывай clearInterrupt() после чтения |
Один небольшой модуль APDS-9960 добавляет в твой проект бесконтактное управление, обнаружение приближения и измерение цвета. Учитывай небольшую дальность и правило питания 3,3 V, и он станет надёжным элементом интерфейса. В приложении BlueGrays ты найдёшь проекты с RGB-светодиодами, измерением освещённости с LDR, датчиками движения и измерением расстояния, с пошаговыми схемами подключения и кодом. Добавив к ним APDS-9960, можно создать бесконтактные версии.
Частые вопросы
Работает ли APDS-9960 от 5 V?
Нет, микросхема APDS-9960 работает от 2,4–3,6 V, а 5 V могут её повредить. Питай модуль от пина 3.3V платы Arduino Uno и по возможности установи преобразователь уровней на линии SDA и SCL. С 5 V можно использовать только специальные версии, у которых явно указано наличие встроенного стабилизатора и преобразователя уровней.
Какой I2C-адрес у APDS-9960?
I2C-адрес APDS-9960 — 0x39, и изменить его нельзя. Поэтому два APDS-9960 нельзя подключить к одной шине I2C; если нужны два датчика, используй I2C-мультиплексор, например TCA9548A, или вторую шину I2C на ESP32 либо Pico.
Какова дальность распознавания жестов APDS-9960?
На практике жесты надёжно распознаются на расстоянии от 5 до 15 см, а в хороших условиях — до 20 см. Дальность зависит от того, сколько света отражает рука, тока ИК-светодиода и настройки усиления. Солнечный свет и стекло перед датчиком заметно уменьшают дальность.
Обязательно ли подключать пин INT у APDS-9960?
Нет. Библиотеки могут считывать жесты и приближение, опрашивая датчик по I2C; в библиотеке SparkFun для этого используется enableGestureSensor(false). Пин INT сразу сообщает о событии без постоянного опроса, снижая нагрузку на процессор, и может пробуждать ESP32 из глубокого сна.
Насколько точен датчик цвета APDS-9960?
APDS-9960 измеряет цветовые каналы с разрешением 16 бит, но выдаёт сырые значения, зависящие от окружающего освещения, а не абсолютные цвета. Если поднести объект близко и перекрыть внешний свет, он легко различает красную, зелёную и синюю карточки. Для более точного различения цветов лучше подходят специализированные датчики цвета, например TCS34725 или TCS3200.
Почему возникает ошибка APDS-9960 init failed?
Эта ошибка означает, что библиотека не смогла считать ID датчика или не получила ожидаемое значение. Проверь подключение, питание 3,3 V и не перепутаны ли SDA и SCL, затем найди адрес 0x39 с помощью I2C-сканера. Если адрес виден, микросхема может быть клоном; считай значение регистра ID и добавь его в список допустимых значений библиотеки.
Что собрать после прочтения
Все проекты
Измерение освещённости с LDR
Хочешь увидеть яркость своей комнаты в виде числа? LDR — маленькая деталь, реагирующая на свет, — измеряет освещённость вокруг, а Arduino каждые полсекунды выводит значение на экран компьютера.

Работа с RGB-светодиодом
В одном светодиоде прячутся три цвета: RGB-светодиод загорается красным, затем зелёным, затем синим, каждый цвет горит полсекунды и полсекунды не горит, а потом цикл начинается снова.

Плавная смена цвета RGB-светодиода
Один RGB-светодиод медленно переходит от красного к зелёному, от зелёного к синему и обратно к красному, без остановки прокручивая радугу.

Детектор движения на датчике движения
Простой охранник, который сообщает, что кто-то вошёл в комнату. Датчик движения улавливает тепло человеческого тела, а Arduino держит светодиод включённым, пока есть движение, и гасит его, когда…

Дверной звонок и свет с датчиком движения
Когда кто-то подходит к твоей двери, ты узнаёшь об этом ещё до звонка. Как только датчик движения замечает человека, загорается светодиод, а зуммер играет мелодию из трёх нот сверху вниз; когда…

Чтение отражения (приближения) с TCRT5000
С маленьким датчиком, который посылает невидимый свет и измеряет, сколько его отражается обратно, можно определить поверхность перед ним.

Управление RGB-светодиодом на ESP32
Бесконечное число цветов одним RGB-светодиодом вместо 3 отдельных. Как в Arduino, радужный переход получается заданием значений R/G/B через analogWrite(). Теория цвета (например, красный + зелёный = жёлтый) видна на практике.

Умное освещение на ESP32 (PIR + LDR + реле + OLED)
Сделай умное освещение для коридора, ванной или кладовки на ESP32! С PIR-датчиком движения, датчиком освещённости LDR и модулем реле собирается классический сценарий «свет включается при движении в темноте»: если вокруг уже светло, движение свет НЕ включает, и днём энергия экономится. Свет горит 30 секунд; если движение продолжается, таймер сбрасывается, и свет горит дольше. OLED SSD1306 крупно показывает состояние (ON / DAYTIME / WAITING) и обратный отсчёт.
Другие статьи
Приложение BlueGrays
Собери эту схему шаг за шагом в телефоне
Схема подключения, код и список деталей на одном экране. 500+ проектов на Arduino, ESP32 и Pico готовы к сборке.
Наведи камеру телефона
Наведи камеру на код — откроется магазин приложений на телефоне.
или открыть магазин

