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.

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.
| Eigenschap | Waarde |
|---|---|
| Fabrikant | Broadcom (voorheen Avago) |
| Voeding van de chip (VDD) | 2,4–3,6 V |
| Voeding van de IR-led (VL) | 3,0–4,5 V |
| Interface | I2C, tot 400 kHz |
| I2C-adres | 0x39 (vast, niet te wijzigen) |
| Nabijheid | 8 bit (0–255) |
| Kleur en licht | 4 kanalen (clear, rood, groen, blauw), 16 bit per kanaal |
| Gebaren | 4 richtingsfotodiodes (U, D, L, R), FIFO van 32 posities |
| IR LED | 950 nm, stroom instelbaar van 12,5 tot 100 mA |
| Praktisch gebarenbereik | Ongeveer 10–20 cm |
| Interrupt-uitgang | INT, 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.
| Pin | Functie | Aansluiten op |
|---|---|---|
| VL | Voedingsingang van de IR-led | Niet aansluiten als de PS-brug gesloten is |
| GND | Massa | GND |
| VCC | Voeding van de chip | 3,3 V |
| SDA | I2C-datalijn | De SDA-pin van het board |
| SCL | I2C-klokline | De SCL-pin van het board |
| INT | Interrupt-uitgang (open-drain) | Een digitale pin die interrupts ondersteunt |
Bedrading: Arduino Uno, ESP32 en Raspberry Pi Pico
| APDS-9960 | Arduino Uno | ESP32 | Raspberry Pi Pico |
|---|---|---|---|
| VCC | 3.3V | 3V3 | 3V3 (OUT) |
| GND | GND | GND | GND |
| SDA | A4 (via een niveauconverter) | GPIO 21 | GP4 |
| SCL | A5 (via een niveauconverter) | GPIO 22 | GP5 |
| INT | D2 | GPIO 4 | GP15 |
| VL | Niet 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
| Eigenschap | SparkFun APDS9960 | Adafruit APDS9960 |
|---|---|---|
| Gebarenrichtingen | Omhoog, omlaag, links, rechts plus dichtbij en veraf | Omhoog, omlaag, links, rechts |
| Nabijheid lezen | readProximity(variable) | Returnwaarde van readProximity() |
| Kleur lezen | Aparte functies zoals readRedLight() | Alles tegelijk met getColorData(), plus lux en kleurtemperatuur |
| Interrupt-instellingen | Interrupts voor gebaren, nabijheid en licht | Interrupts voor nabijheid en kleur, drempelinstelling |
| Geaccepteerde chip-ID | 0xAB en 0x9C | Alleen 0xAB |
| Extra afhankelijkheid | Geen (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)
- Sluit de module aan volgens de tabel hierboven: VCC op 3.3V, SDA op A4, SCL op A5, INT op D2.
- Installeer de SparkFun-bibliotheek en upload de onderstaande sketch naar de Uno.
- Open de Serial Monitor op 9600 baud en wacht op de melding "Jest sensoru hazir" (gebarensensor klaar).
- Beweeg je hand 5–10 cm boven de sensor van de ene rand naar de andere, in een tempo van ongeveer een halve seconde.
- 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.
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.
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.
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.
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.
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

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.
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.
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.
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.
| Factor | Effect | Wat te doen |
|---|---|---|
| Afstand | Gebaren verdwijnen voorbij 15 cm | Beweeg je hand op 5–10 cm |
| Bewegingssnelheid | Heel langzame of heel snelle bewegingen worden niet herkend | Een vloeiende beweging van een halve seconde |
| Zonlicht | IR in zonlicht verzadigt de fotodiodes | Gebruik hem in de schaduw of binnen |
| Glas of een doorzichtige afdekking | De afdekking kaatst IR terug, waardoor nabijheid altijd hoog leest | Haal de afdekking weg of gebruik een dun IR-doorlatend materiaal |
| Kleur van het oppervlak | Een zwarte handschoen reflecteert minder | Verhoog de gain |
| Oriëntatie van de sensor | De richtingen draaien mee | Wissel 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
| Symptoom | Waarschijnlijke oorzaak | Oplossing |
|---|---|---|
| "APDS-9960 bulunamadi" (niet gevonden) | Bedradingsfout, geen 3,3 V of een andere chip-ID | Zoek 0x39 met een I2C-scanner, lees de ID uit |
| Module gevonden maar init mislukt | Een kloonchip met een andere ID, zoals 0xA8 | Voeg die waarde toe aan de ID-controle van de bibliotheek |
| Geen gebaren gedetecteerd | Hand te ver of te langzaam, VL niet gevoed | Beweeg op 5–10 cm in een halve seconde, controleer de PS-brug |
| Richtingen omgekeerd of door elkaar | De montagerichting van de sensor | Wissel de DIR-cases in de code om |
| Nabijheid altijd hoog | Glas, een afdekking of een oppervlak vlak ervoor | Haal de afdekking weg, verlaag de gain |
| Werkt niet buiten | Zonlicht overstemt het IR | Gebruik hem in de schaduw |
| Willekeurige vastlopers op de Uno | 5V- en 3,3V-I2C komen niet overeen, lange draden | Niveauconverter en korte draden |
| INT blijft LOW | Interrupt niet gewist | Roep clearInterrupt() aan na het lezen |
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.
Projecten om hierna te bouwen
Alle projecten bekijken
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.

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.

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.

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…

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…

Reflectie (nabijheid) meten met de TCRT5000
Met een kleine sensor die onzichtbaar licht uitzendt en meet hoeveel er terugkaatst, detecteer je het oppervlak ervoor.

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.

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.
Meer artikelen
BlueGrays-app
Bouw deze schakeling stap voor stap op je telefoon
Schakelschema, code en onderdelenlijst op één scherm. Meer dan 500 Arduino-, ESP32- en Pico-projecten om te bouwen.
Scan met je telefoon
Richt je camera op de code en de appstore van je telefoon opent.
of open de store

