Компоненты · 10 мин чтения

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: распознавание жестов, приближения, цвета RGB и окружающей освещённости в одной микросхеме; подключается по I2C и требует 3,3 V.

Что такое 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Выход прерывания (открытый сток)Цифровой пин с поддержкой прерываний
Микросхема APDS-9960 допускает максимум 3,6 V; подключение VCC к пину 5V на Arduino может безвозвратно вывести её из строя. За исключением специальных версий со встроенным стабилизатором и преобразователем уровней, всегда подавай на модуль 3,3 V. На некоторых дешёвых модулях не указана их версия; если есть сомнения, используй 3,3 V.

Подключение: Arduino Uno, ESP32 и Raspberry Pi Pico

APDS-9960Arduino UnoESP32Raspberry Pi Pico
VCC3.3V3V33V3 (OUT)
GNDGNDGNDGND
SDAA4 (через преобразователь уровней)GPIO 21GP4
SCLA5 (через преобразователь уровней)GPIO 22GP5
INTD2GPIO 4GP15
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 APDS9960Adafruit 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

  1. Подключи модуль по таблице выше: VCC к 3.3V, SDA к A4, SCL к A5, INT к D2.
  2. Установи библиотеку SparkFun и загрузи приведённый ниже скетч в Uno.
  3. Открой монитор порта (Serial Monitor) на скорости 9600 бод и дождись сообщения «Jest sensoru hazir» (датчик жестов готов).
  4. Проведи рукой на высоте 5–10 см над датчиком от одного края к другому так, чтобы движение заняло примерно полсекунды.
  5. Должны появиться YUKARI (вверх), ASAGI (вниз), SOL (влево) или SAG (вправо); если направления перепутаны, поверни датчик на 90 или 180 градусов либо поменяй местами ветви case в коде.
C++ (Arduino IDE)
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.

Для лучшего результата держи ладонь раскрытой и ровной и проводи ею на высоте 5–10 см над датчиком за полсекунды. Если двигаться слишком медленно, блок распознавания жестов выключится до завершения движения; если слишком быстро, в FIFO не накопится достаточно данных. Если опустить руку прямо над датчиком и ненадолго задержать её неподвижно, распознаётся NEAR; если задержать её, а затем медленно поднять, распознаётся FAR. Эти два движения распознаются менее надёжно, чем четыре направления.

Обнаружение приближения: светодиод становится ярче при приближении руки

Измерять только приближение, без жестов, гораздо проще и стабильнее. Скетч ниже напрямую передаёт значение приближения на светодиод с помощью ШИМ: чем ближе рука, тем ярче светодиод, а при удалении он тускнеет. Подключи светодиод к D9 через резистор 220 Ω; подобрать нужный номинал поможет калькулятор резистора для светодиода.

C++ (Arduino IDE)
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 также рассчитывает по этим сырым значениям приблизительную освещённость в люксах и цветовую температуру света (в кельвинах). Скетч ниже каждые полсекунды выводит четыре канала, значения в люксах и кельвинах и показывает, какой цвет преобладает.

C++ (Arduino IDE)
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. В скетче ниже жест вверх включает светодиод на полную яркость, вниз — выключает, а жесты вправо и влево повышают и понижают яркость с шагом в четверть диапазона.

C++ (Arduino IDE)
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

Модуль MP3-плеера DFPlayer Mini
DFPlayer Mini: воспроизводит MP3-файлы с SD-карты и принимает команды по последовательной линии.

Одно из самых интересных применений датчика жестов — бесконтактный музыкальный плеер. Подключи пин RX модуля DFPlayer Mini к D11 платы Uno через резистор 1 kΩ, а TX — к D10; подключи динамик к SPK_1 и SPK_2 и подай питание модуля от 5V. Скопируй песни на SD-карту с именами 0001.mp3, 0002.mp3 и так далее. Подробности о модуле есть в руководстве по DFPlayer Mini. Жест вправо включает следующую песню, влево — предыдущую; жесты вверх и вниз повышают и понижают громкость, а неподвижная рука над датчиком приостанавливает и возобновляет воспроизведение.

C++ (Arduino IDE)
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, и при каждом приближении руки переключает встроенный светодиод, как бесконтактный выключатель света.

C++ (Arduino IDE)
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).

MicroPython
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() после чтения
Если возникли проблемы, сначала убедись с помощью скетча I2C-сканера, что виден адрес 0x39, затем запусти простой код, который измеряет только приближение. Если при приближении руки значение растёт от 0 до более чем 200, аппаратная часть исправна, а проблема в настройках жестов или движении руки.

Один небольшой модуль 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
AR-11Новичок

Измерение освещённости с LDR

Хочешь увидеть яркость своей комнаты в виде числа? LDR — маленькая деталь, реагирующая на свет, — измеряет освещённость вокруг, а Arduino каждые полсекунды выводит значение на экран компьютера.

4.6(83)
143
Работа с RGB-светодиодом
AR-39Новичок
Premium

Работа с RGB-светодиодом

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

4.9(73)
100
Плавная смена цвета RGB-светодиода
AR-40Новичок
Premium

Плавная смена цвета RGB-светодиода

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

4.8(58)
78
Детектор движения на датчике движения
AR-24Новичок
Premium

Детектор движения на датчике движения

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

4.6(47)
67
Дверной звонок и свет с датчиком движения
AR-25Средний
Premium

Дверной звонок и свет с датчиком движения

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

4.7(54)
72
Чтение отражения (приближения) с TCRT5000
AR-77Средний
Premium

Чтение отражения (приближения) с TCRT5000

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

4.6(33)
43
Управление RGB-светодиодом на ESP32
ES-9Новичок

Управление RGB-светодиодом на ESP32

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

4.6(29)
52
Умное освещение на ESP32 (PIR + LDR + реле + OLED)
ES-37Продвинутый
Premium

Умное освещение на ESP32 (PIR + LDR + реле + OLED)

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

4.3(6)
11