Componenten · 11 min leestijd

APDS9960 Arduino: gids voor de gebaren-, nabijheids- en kleurensensor

APDS9960 Arduino-gids: I2C- en 3,3V-bedrading, gebaren links-rechts-omhoog-omlaag, nabijheid en RGB-metingen, SparkFun- en Adafruit-code, de INT-pin, ESP32 en Pico.

Met APDS9960 Arduino-projecten doet één piepkleine chip vier dingen: hij detecteert je hand die naar rechts, links, omhoog en omlaag beweegt, meet hoe dichtbij een voorwerp is en leest omgevingslicht en kleur uit, verdeeld over rood, groen en blauw. Hij is verwant aan de sensor in je telefoon die het scherm uitzet als je hem tegen je oor houdt en de helderheid aan de ruimte aanpast. Hij is een ideaal beginpunt om met een zwaai van je hand een lamp aan te zetten, een nummer over te slaan of door een menu te bladeren, zonder iets aan te raken.

In deze gids zie je wat er in de APDS-9960 zit, hoe hij gebaren detecteert, waarom hij op 3,3 V moet draaien en hoe je hem aansluit op een Arduino Uno, ESP32 en Raspberry Pi Pico. Met de SparkFun- en Adafruit-bibliotheken bouw je een gebarentest, een led die feller wordt naarmate je hand dichterbij komt, kleur- en luxmetingen, led's en muziek die je met gebaren bedient, en leer je hoe je de INT-pin als interrupt gebruikt en wat de echte bereikgrenzen zijn.

APDS-9960-module voor kleur, nabijheid en gebaren
APDS-9960-module: gebaren, nabijheid, RGB-kleur en omgevingslicht in één chip; hij wordt via I2C aangesloten en heeft 3,3 V nodig.

Wat is de APDS-9960 en hoe werkt hij?

De APDS-9960 is een sensor van Broadcom (voorheen Avago) die een infrarood (IR) led en meerdere lichtdetectoren in een behuizing van ongeveer 4 × 2,4 mm stopt. Voor nabijheid stuurt de IR-led korte pulsen uit, het licht dat door het voorwerp ervoor wordt teruggekaatst komt terug op de fotodiodes, en hoe sterker de reflectie, hoe dichterbij het voorwerp. Het resultaat is een getal tussen 0 en 255. Kleurmeting gebruikt de led niet: omgevingslicht valt op vier aparte fotodiodes met een rode, groene, blauwe en ongefilterde (clear) coating, en elk levert een getal van 16 bit.

Gebarendetectie is het slimste onderdeel. In de chip zitten vier fotodiodes die omhoog (U), omlaag (D), links (L) en rechts (R) kijken. Als je hand over de sensor gaat, ziet de ene diode de reflectie eerst en de tegenoverliggende later. Zodra de nabijheidswaarde een instapdrempel overschrijdt (40 in de SparkFun-bibliotheek), start de gebarenengine, schrijft de metingen van de vier diodes in een FIFO-buffer van 32 posities en stopt als de hand zich verwijdert. De Arduino leest deze posities uit en kijkt hoe het verschil tussen U en D, en tussen L en R, in de tijd verandert: als U eerst groter is en D later, is de hand omlaag bewogen.

EigenschapWaarde
FabrikantBroadcom (voorheen Avago)
Voeding van de chip (VDD)2,4–3,6 V
Voeding van de IR-led (VL)3,0–4,5 V
InterfaceI2C, tot 400 kHz
I2C-adres0x39 (vast, niet te wijzigen)
Nabijheid8 bit (0–255)
Kleur en licht4 kanalen (clear, rood, groen, blauw), 16 bit per kanaal
Gebaren4 richtingsfotodiodes (U, D, L, R), FIFO van 32 posities
IR LED950 nm, stroom instelbaar van 12,5 tot 100 mA
Praktisch gebarenbereikOngeveer 10–20 cm
Interrupt-uitgangINT, open-drain, gaat LOW bij een gebeurtenis

Modulepins en de 3,3V-kwestie

De meest voorkomende boards zijn de SparkFun-breakout en de paarse kloon, de GY-9960. Beide hebben zes pins. De meeste modules hebben achterop een soldeerbrug met de naam PS; zolang die gesloten is, is de voeding van de IR-led (VL) direct met VCC verbonden en laat je de VL-pin onaangesloten.

PinFunctieAansluiten op
VLVoedingsingang van de IR-ledNiet aansluiten als de PS-brug gesloten is
GNDMassaGND
VCCVoeding van de chip3,3 V
SDAI2C-datalijnDe SDA-pin van het board
SCLI2C-kloklineDe SCL-pin van het board
INTInterrupt-uitgang (open-drain)Een digitale pin die interrupts ondersteunt
De APDS-9960-chip verdraagt maximaal 3,6 V; als je VCC op de 5V-pin van de Arduino aansluit, kan hij blijvend kapotgaan. Behalve bij speciale versies met een ingebouwde spanningsregelaar en niveauconverter voed je de module altijd met 3,3 V. Sommige goedkope modules vermelden niet welk type ze zijn; weet je het niet zeker, gebruik dan 3,3 V.

Bedrading: Arduino Uno, ESP32 en Raspberry Pi Pico

APDS-9960Arduino UnoESP32Raspberry Pi Pico
VCC3.3V3V33V3 (OUT)
GNDGNDGNDGND
SDAA4 (via een niveauconverter)GPIO 21GP4
SCLA5 (via een niveauconverter)GPIO 22GP5
INTD2GPIO 4GP15
VLNiet aangesloten (PS gesloten)Niet aangesloten (PS gesloten)Niet aangesloten (PS gesloten)

De ESP32 en de Pico hebben al 3,3V-pins, dus die sluit je direct aan. Op de Uno is het wat rommeliger: de Wire-bibliotheek van de Uno zet interne pull-upweerstanden op SDA en SCL aan en trekt de lijnen richting 5 V, terwijl de weerstanden van de module zelf ze naar 3,3 V trekken. In de praktijk werkt het meestal, maar het gaat tegen de grenzen van de chip aan. De veiligste optie is een bidirectionele I2C-niveauconverter tussen de Uno en de module. Omdat de INT-pin open-drain is, houdt de pull-upweerstand van de module hem op 3,3 V; de Uno leest die spanning als HIGH, dus op de Uno heb je de interne pull-up voor INT niet nodig. Hoe I2C werkt leggen we uit in de gids wat is I2C.

SparkFun of Adafruit? Een bibliotheek kiezen

EigenschapSparkFun APDS9960Adafruit APDS9960
GebarenrichtingenOmhoog, omlaag, links, rechts plus dichtbij en verafOmhoog, omlaag, links, rechts
Nabijheid lezenreadProximity(variable)Returnwaarde van readProximity()
Kleur lezenAparte functies zoals readRedLight()Alles tegelijk met getColorData(), plus lux en kleurtemperatuur
Interrupt-instellingenInterrupts voor gebaren, nabijheid en lichtInterrupts voor nabijheid en kleur, drempelinstelling
Geaccepteerde chip-ID0xAB en 0x9CAlleen 0xAB
Extra afhankelijkheidGeen (alleen Wire)Adafruit BusIO

Beide bibliotheken staan in de Library Manager: zoek naar SparkFun APDS9960 RGB and Gesture Sensor en Adafruit APDS9960 Library. Voor gebaren is het algoritme van SparkFun iets stabieler en herkent het ook bewegingen dichtbij en veraf; voor kleur maken de lux- en kleurtemperatuurfuncties van Adafruit het leven makkelijker. In deze gids gebruiken we beide. Installeer je voor het eerst een bibliotheek, bekijk dan de gids een Arduino-bibliotheek toevoegen.

Stap voor stap: je eerste gebarentest (met de INT-pin)

  1. Sluit de module aan volgens de tabel hierboven: VCC op 3.3V, SDA op A4, SCL op A5, INT op D2.
  2. Installeer de SparkFun-bibliotheek en upload de onderstaande sketch naar de Uno.
  3. Open de Serial Monitor op 9600 baud en wacht op de melding "Jest sensoru hazir" (gebarensensor klaar).
  4. Beweeg je hand 5–10 cm boven de sensor van de ene rand naar de andere, in een tempo van ongeveer een halve seconde.
  5. Je zou YUKARI (omhoog), ASAGI (omlaag), SOL (links) of SAG (rechts) moeten zien; zijn de richtingen omgekeerd, draai de sensor dan 90 of 180 graden of wissel de cases in de code om.
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}

Als een gebaar klaar is, trekt de APDS-9960 de INT-pin LOW, wat de interrupt op pin D2 van de Uno activeert. De interruptfunctie zet alleen een vlag; het echte uitlezen gebeurt in loop(), want readGesture() leest tientallen bytes via I2C en I2C gebruiken binnen een interrupt veroorzaakt vastlopers. De interrupt tijdelijk uitzetten tijdens het lezen voorkomt ook dat hetzelfde gebaar twee keer wordt verwerkt. De werking van interrupts vind je uitgebreid in de gids Arduino-interrupt.

Voor het beste resultaat houd je je hand plat en open en beweeg je hem in een halve seconde 5–10 cm boven de sensor langs. Ga je te langzaam, dan schakelt de gebarenengine uit voordat de beweging klaar is; te snel en er verzamelt zich te weinig data in de FIFO. Als je je hand recht boven de sensor laat zakken en even stilhoudt, wordt dat als NEAR herkend; houd je hem er even boven en til je hem dan langzaam op, dan wordt het FAR. Deze twee bewegingen zijn minder betrouwbaar dan de vier richtingen.

Nabijheidsdetectie: een led die feller wordt als je hand dichterbij komt

Alleen nabijheid meten, in plaats van gebaren, is veel eenvoudiger en stabieler. De onderstaande sketch stuurt de nabijheidswaarde met PWM rechtstreeks naar een led: hoe dichter je hand, hoe feller de led, en hij dooft weg als je terugtrekt. Sluit de led via een weerstand van 220 Ω aan op D9; de juiste waarde vind je met de ledweerstandcalculator.

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}

De nabijheidswaarde is geen centimeters; het is de sterkte van het gereflecteerde licht. Een vel wit papier kan op 15 cm 40 geven, terwijl een zwarte doek op dezelfde afstand onder de 10 blijft. Gebruik de APDS-9960 dus niet als afstandsmeter, maar als antwoord op de vraag "is er iets dichtbij gekomen?". Heb je een exacte afstand nodig, dan is de HC-SR04-ultrasoonsensor een nauwkeuriger keuze. Zijn de waarden erg laag, zet de gain dan op PGAIN_4X of PGAIN_8X; blijven ze steeds op 255 staan, ga dan terug naar PGAIN_1X.

RGB-kleur en omgevingslicht meten

Aan de kleurzijde leest de APDS-9960 vier kanalen: rood (R), groen (G), blauw (B) en ongefilterd totaal licht (C). De Adafruit-bibliotheek berekent uit deze ruwe getallen ook een benaderde lux-waarde en de kleurtemperatuur van het licht (in Kelvin). De onderstaande sketch print elke halve seconde de vier kanalen, de lux- en Kelvin-waarden en laat zien welke kleur overheerst.

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}

De ruwe waarden zijn geen absolute kleuren maar hoeveelheden licht; dezelfde rode kaart geeft in een schemerige kamer heel andere getallen dan in zonlicht. Vergelijk bij kleuren dus verhoudingen: de verhouding van R tot C blijft stabieler, ook als het licht verandert. Wil je de kleur van een voorwerp lezen, houd het dan 1–2 cm van de sensor en schermt het buitenlicht af met je hand of een buisje. De luxwaarde is een benadering; hij vervangt geen luxmeter, maar is ruim voldoende voor "is het donker geworden in de kamer?". Voor projecten die fijnere kleuronderscheiding nodig hebben, kun je sensoren overwegen die alleen voor kleur zijn gemaakt, zoals de TCS3200-kleursensor of de TCS34725.

Een led met gebaren bedienen (zonder de INT-pin)

Je hoeft de INT-pin niet aan te sluiten. De bibliotheek kan ook via I2C het statusregister van de gebarenengine pollen om te zien of er een nieuw gebaar is. Dat bespaart een pin en houdt de code simpel; de prijs is dat loop() constant I2C-verkeer veroorzaakt. In de onderstaande sketch zet een gebaar omhoog de led volledig aan, een gebaar omlaag zet hem uit, en gebaren naar rechts en links verhogen en verlagen de helderheid in stappen van een kwart.

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}

Muziek bedienen met gebaren: met de DFPlayer Mini

DFPlayer Mini mp3-spelermodule
DFPlayer Mini: hij speelt mp3-bestanden af van een SD-kaart en neemt commando's aan via een seriële lijn.

Het leukste gebruik van een gebarensensor is een muziekspeler die je zonder aanraking bedient. Sluit de RX-pin van de DFPlayer Mini via een weerstand van 1 kΩ aan op D11 van de Uno en de TX-pin op D10; verbind de luidspreker met SPK_1 en SPK_2 en voed de module met 5V. Kopieer je nummers naar de SD-kaart met de namen 0001.mp3, 0002.mp3 enzovoort. Details over de module staan in de gids DFPlayer Mini. Een gebaar naar rechts slaat naar het volgende nummer over en een gebaar naar links naar het vorige; gebaren omhoog en omlaag zetten het volume harder en zachter, en je hand stilhouden boven de sensor pauzeert en hervat het afspelen.

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}

Er is hier één detail dat je moet weten: readGesture() keert pas terug als het gebaar voorbij is en wacht 30 ms tussen FIFO-uitlezingen. Zolang je hand boven de sensor blijft, doet de Arduino niets anders. Voor een muziekspeler is dat geen probleem, maar heeft dezelfde sketch ook een motor of een displayanimatie die snel moet reageren, dan moet je die rond het uitlezen van het gebaar plannen.

De INT-pin en de ESP32: nabijheidsdetectie met interrupts

De INT-pin is niet alleen voor gebaren; je kunt hem ook gebruiken voor drempels van nabijheid en licht. Je stelt een drempel in; zodra een meting die overschrijdt, trekt de APDS-9960 INT LOW en houdt hem daar tot je hem wist. Zo hoeft de microcontroller de sensor niet steeds te pollen. De onderstaande ESP32-sketch gebruikt de Adafruit-bibliotheek om INT te activeren als de nabijheid boven 150 komt en schakelt elke keer dat een hand nadert de ingebouwde led om, als een lichtschakelaar zonder aanraking.

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}

De derde parameter van setProximityInterruptThreshold() (standaard 4) is de persistence: die bepaalt hoeveel opeenvolgende metingen de drempel moeten overschrijden voordat de interrupt afgaat, waardoor kortstondige ruis wordt weggefilterd. Roep je clearInterrupt() niet aan, dan blijft INT LOW en mis je de volgende nadering. Deze opzet is erg nuttig in projecten op batterijen: zet de ESP32 in deep sleep en maak hem wakker via de INT-pin met esp_sleep_enable_ext0_wakeup(GPIO_NUM_4, 0), en het board wordt alleen wakker als iemand een hand dichtbij brengt. GPIO 4 is een RTC-pin, dus die is hiervoor geschikt.

APDS-9960 met de Raspberry Pi Pico (MicroPython)

Op de Raspberry Pi Pico kun je de APDS-9960 in MicroPython zonder bibliotheek gebruiken door rechtstreeks naar zijn registers te schrijven. De onderstaande code leest de chip-ID, schakelt kleur- en nabijheidsmeting in en print elke 200 ms de vier kleurkanalen en de nabijheidswaarde. De bedrading gebruikt de I2C0-bus: SDA op GP4, SCL op GP5 en VCC op de 3V3(OUT)-pin.

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)

Dit doen de registers in de code: 0x80 (ENABLE) bepaalt welke blokken aanstaan, 0x81 (ATIME) stelt de integratietijd voor kleur in (2,78 ms per stap), 0x8F (CONTROL) stelt de stroom van de IR-led en de gains in, 0x93 (STATUS) vertelt of er data klaarstaat, 0x94–0x9B bevatten de kleurkanalen en 0x9C bevat de nabijheidswaarde. Voor gebaren zou je de FIFO moeten lezen en een richtingsalgoritme schrijven zoals dat van SparkFun, wat meer werk is. Geef je de voorkeur aan de Arduino IDE, installeer dan de arduino-pico-core voor de Pico en gebruik de SparkFun-bibliotheek zoals die is; de standaard I2C-pins zijn dan opnieuw GP4 en GP5.

Bereikgrenzen en juist gebruik

De APDS-9960 is ontworpen als telefoonsensor en heeft een klein bereik. In de praktijk zijn gebaren betrouwbaar tussen 5 en 15 cm en halen ze op zijn best 20 cm. Nabijheidsmetingen zijn tot een vergelijkbare afstand zinvol. Wat deze grens bepaalt, is het vermogen van de IR-led en hoeveel licht je hand terugkaatst; de ledstroom verhogen naar 100 mA en de gain naar het maximum geeft wat extra bereik, maar ook meer ruis.

FactorEffectWat te doen
AfstandGebaren verdwijnen voorbij 15 cmBeweeg je hand op 5–10 cm
BewegingssnelheidHeel langzame of heel snelle bewegingen worden niet herkendEen vloeiende beweging van een halve seconde
ZonlichtIR in zonlicht verzadigt de fotodiodesGebruik hem in de schaduw of binnen
Glas of een doorzichtige afdekkingDe afdekking kaatst IR terug, waardoor nabijheid altijd hoog leestHaal de afdekking weg of gebruik een dun IR-doorlatend materiaal
Kleur van het oppervlakEen zwarte handschoen reflecteert minderVerhoog de gain
Oriëntatie van de sensorDe richtingen draaien meeWissel de richtingscases in de code om

Projectideeën met de APDS-9960

  • Aanraakvrije lamp: Schakel met de nabijheidsinterrupt een relaismodule; erg handig in de keuken als je handen vies zijn.
  • Kleurenlamp met gebaren: Blader met gebaren naar rechts en links door kleuren op een RGB-led of een WS2812B-strip.
  • Menu in de lucht: Kies menu-items op een OLED-display met gebaren omhoog en omlaag en bevestig met NEAR.
  • Servodeksel met gebaren: Open het deksel van een doos met een gebaar en een servomotor.
  • Automatische displayhelderheid: Pas een scherm of ledstrip aan op het omgevingslicht; vergeleken met een LDR krijg je een stabielere meting met kleurinformatie.
  • Kleurensorteerder: Sorteer gekleurd snoep of blokjes die langs een goot naar beneden komen op hun kleurkanalen.

Veelgemaakte fouten en oplossingen

SymptoomWaarschijnlijke oorzaakOplossing
"APDS-9960 bulunamadi" (niet gevonden)Bedradingsfout, geen 3,3 V of een andere chip-IDZoek 0x39 met een I2C-scanner, lees de ID uit
Module gevonden maar init misluktEen kloonchip met een andere ID, zoals 0xA8Voeg die waarde toe aan de ID-controle van de bibliotheek
Geen gebaren gedetecteerdHand te ver of te langzaam, VL niet gevoedBeweeg op 5–10 cm in een halve seconde, controleer de PS-brug
Richtingen omgekeerd of door elkaarDe montagerichting van de sensorWissel de DIR-cases in de code om
Nabijheid altijd hoogGlas, een afdekking of een oppervlak vlak ervoorHaal de afdekking weg, verlaag de gain
Werkt niet buitenZonlicht overstemt het IRGebruik hem in de schaduw
Willekeurige vastlopers op de Uno5V- en 3,3V-I2C komen niet overeen, lange dradenNiveauconverter en korte draden
INT blijft LOWInterrupt niet gewistRoep clearInterrupt() aan na het lezen
Loop je tegen problemen aan, controleer dan eerst met een I2C-scannersketch of adres 0x39 verschijnt en draai daarna de eenvoudige code met alleen nabijheid. Stijgt de nabijheidswaarde van 0 naar boven 200 als je je hand dichtbij brengt, dan is de hardware in orde en ligt het probleem bij de gebarenelementen of je handbeweging.

Met één kleine module voegt de APDS-9960 aanraakvrije bediening, nabijheidsdetectie en kleurmeting toe aan je project. Houd rekening met het kleine bereik en de 3,3V-regel en hij wordt een betrouwbaar bedieningselement. In de BlueGrays-app vind je projecten met RGB-led, LDR-lichtmeting, bewegingssensor en afstandsmeting met stap-voor-stap schakelschema's en code, en je kunt de APDS-9960 eraan toevoegen om aanraakvrije versies te bouwen.

Veelgestelde vragen

Werkt de APDS-9960 op 5 V?

Nee, de APDS-9960-chip draait op 2,4–3,6 V en 5 V kan hem beschadigen. Voed de module via de 3.3V-pin van de Arduino Uno en zet, als het kan, een niveauconverter op de SDA- en SCL-lijnen. Alleen speciale versies die duidelijk vermelden dat ze een ingebouwde spanningsregelaar en niveauconverter hebben, kun je met 5 V gebruiken.

Wat is het I2C-adres van de APDS-9960?

Het I2C-adres van de APDS-9960 is 0x39 en kan niet worden gewijzigd. Daarom kun je geen twee APDS-9960's op dezelfde I2C-bus zetten; heb je twee sensoren nodig, gebruik dan een I2C-multiplexer zoals de TCA9548A of de tweede I2C-bus van de ESP32 of Pico.

Wat is het gebarenbereik van de APDS-9960?

In de praktijk worden gebaren betrouwbaar gedetecteerd tussen 5 en 15 cm en kunnen ze onder goede omstandigheden 20 cm halen. Het bereik hangt af van hoeveel licht je hand terugkaatst, de stroom van de IR-led en de gain-instelling. Zonlicht en glas voor de sensor verkleinen het bereik merkbaar.

Moet ik de INT-pin van de APDS-9960 aansluiten?

Nee. De bibliotheken kunnen gebaren en nabijheid ook via I2C pollen; in de SparkFun-bibliotheek doet enableGestureSensor(false) dat. De INT-pin meldt een gebeurtenis direct zonder constant pollen, wat de processor ontlast en een ESP32 uit deep sleep kan wekken.

Hoe nauwkeurig is de kleursensor van de APDS-9960?

De APDS-9960 meet zijn kleurkanalen met een resolutie van 16 bit, maar geeft ruwe waarden die afhangen van het omgevingslicht in plaats van absolute kleuren. Houd je een voorwerp dichtbij en schermt je buitenlicht af, dan onderscheidt hij rode, groene en blauwe kaarten makkelijk. Voor fijnere kleuronderscheiding zijn sensoren die alleen op kleur zijn gericht, zoals de TCS34725 of TCS3200, een betere keuze.

Waarom krijg ik de foutmelding APDS-9960 init failed?

Deze fout betekent dat de bibliotheek de ID van de sensor niet kon lezen of de verwachte waarde niet vond. Controleer de bedrading, de 3,3V-voeding en of SDA en SCL niet zijn verwisseld, en zoek daarna met een I2C-scanner naar adres 0x39. Verschijnt het adres, dan is de chip misschien een kloon; lees de waarde in het ID-register uit en voeg die toe aan de lijst die de bibliotheek accepteert.

Alle projecten bekijken
Lichtsterkte meten met een LDR
AR-11Beginner

Lichtsterkte meten met een LDR

Wil je zien hoe licht je kamer is, als getal? De LDR, een klein onderdeel dat op licht reageert, meet het licht om je heen en de Arduino schrijft de waarde elke halve seconde naar je computerscherm.

4.6(83)
143
Een RGB-led gebruiken
AR-39Beginner
Premium

Een RGB-led gebruiken

In één enkele led zitten drie kleuren verstopt: de RGB-led licht eerst rood op, dan groen, dan blauw, elke kleur een halve seconde aan en een halve seconde uit, waarna de cyclus opnieuw begint.

4.9(73)
100
Vloeiende kleurovergang met een RGB-led
AR-40Beginner
Premium

Vloeiende kleurovergang met een RGB-led

Een enkele RGB-led gaat langzaam van rood naar groen, van groen naar blauw en weer terug naar rood, en doorloopt zo zonder te stoppen de regenboog.

4.8(58)
78
Bewegingsmelder met bewegingssensor
AR-24Beginner
Premium

Bewegingsmelder met bewegingssensor

Een eenvoudige bewaker die laat weten wanneer iemand de kamer binnenkomt. De bewegingssensor merkt de warmte op die het menselijk lichaam afgeeft; de Arduino houdt de led aan zolang er beweging is en…

4.6(47)
67
Deurbel en licht met bewegingssensor
AR-25Gemiddeld
Premium

Deurbel en licht met bewegingssensor

Als iemand naar je deur loopt, weet je het al voordat er wordt aangebeld. Zodra de bewegingssensor iemand opmerkt, gaat de led branden en speelt de buzzer een beltoon van drie noten van hoog naar…

4.7(54)
72
Reflectie (nabijheid) meten met de TCRT5000
AR-77Gemiddeld
Premium

Reflectie (nabijheid) meten met de TCRT5000

Met een kleine sensor die onzichtbaar licht uitzendt en meet hoeveel er terugkaatst, detecteer je het oppervlak ervoor.

4.6(33)
43
ESP32 RGB-led aansturen
ES-9Beginner

ESP32 RGB-led aansturen

Onbeperkt kleuren maken met één RGB-led in plaats van 3 aparte leds. Net als op Arduino stel je met analogWrite() de R/G/B-waarden in en maak je een regenboogovergang. Kleurtheorie (zoals red+green=yellow) zie je in de praktijk.

4.6(29)
51
ESP32 slimme verlichting (PIR + LDR + relais + OLED)
ES-37Gevorderd
Premium

ESP32 slimme verlichting (PIR + LDR + relais + OLED)

Met een ESP32, een PIR-bewegingssensor, een LDR-lichtsensor en een relaismodule maak je van je gang, toilet of bijkeuken slimme verlichting. Is het al licht in de ruimte, dan blijft het licht uit, ook bij beweging, zodat overdag geen energie wordt verspild. Het licht blijft 30 seconden aan en de tijd verlengt automatisch zolang er beweging is.

4.3(6)
11