APDS9960 Arduino: Panduan Sensor Gestur, Kedekatan, dan Warna
Panduan APDS9960 Arduino: pengkabelan I2C dan 3,3 V, gestur kiri-kanan-atas-bawah, pembacaan kedekatan dan RGB, kode SparkFun dan Adafruit, pin INT, ESP32, dan Pico.
Proyek APDS9960 Arduino memungkinkan satu chip mungil menjalankan empat tugas: mendeteksi tanganmu yang bergerak ke kanan, kiri, atas, dan bawah, mengukur kedekatan objek, serta membaca cahaya sekitar dan warna yang dipisahkan menjadi kanal merah, hijau, dan biru. Sensor ini masih satu keluarga dengan sensor ponsel yang mematikan layar ketika kamu mendekatkannya ke telinga dan menyesuaikan kecerahan dengan kondisi ruangan. Ini titik awal yang ideal untuk menyalakan lampu, mengganti lagu, atau menelusuri menu dengan lambaian tangan, tanpa menyentuh apa pun.
Dalam panduan ini kamu akan melihat isi APDS-9960, cara sensor mendeteksi gestur, alasan sensor harus bekerja pada 3,3 V, serta cara menghubungkannya ke Arduino Uno, ESP32, dan Raspberry Pi Pico. Dengan library SparkFun dan Adafruit, kamu akan membuat uji gestur, LED yang makin terang ketika tanganmu mendekat, pengukuran warna dan lux, serta kendali LED dan musik melalui gestur. Kamu juga akan mempelajari cara menggunakan pin INT sebagai interrupt dan batas jangkauan sebenarnya.

Apa itu APDS-9960 dan bagaimana cara kerjanya?
APDS-9960 adalah sensor buatan Broadcom (sebelumnya Avago) yang menggabungkan LED inframerah (IR) dan beberapa detektor cahaya dalam kemasan berukuran sekitar 4 × 2,4 mm. Untuk mendeteksi kedekatan, LED IR memancarkan pulsa pendek, cahaya yang dipantulkan objek di depannya kembali ke fotodioda, dan makin kuat pantulannya, makin dekat objeknya. Hasilnya berupa angka antara 0 dan 255. Pengukuran warna tidak menggunakan LED: cahaya sekitar mengenai empat fotodioda terpisah dengan lapisan merah, hijau, biru, dan tanpa filter (clear), dan masing-masing menghasilkan angka 16-bit.
Deteksi gestur adalah bagian yang paling cerdas. Di dalam chip terdapat empat fotodioda yang menghadap ke atas (U), bawah (D), kiri (L), dan kanan (R). Ketika tanganmu melintas di atas sensor, satu dioda melihat pantulan lebih dulu dan dioda di sisi berlawanan melihatnya kemudian. Ketika nilai kedekatan melewati ambang awal (40 pada library SparkFun), mesin gestur mulai bekerja, menulis pembacaan keempat dioda ke buffer FIFO berkapasitas 32 entri, lalu berhenti ketika tangan menjauh. Arduino membaca entri ini dan melihat perubahan selisih antara U dan D, serta antara L dan R, seiring waktu: jika U lebih besar lebih dulu lalu D menjadi lebih besar, tangan bergerak ke bawah.
| Fitur | Nilai |
|---|---|
| Produsen | Broadcom (sebelumnya Avago) |
| Catu daya chip (VDD) | 2,4–3,6 V |
| Catu daya LED IR (VL) | 3,0–4,5 V |
| Antarmuka | I2C, hingga 400 kHz |
| Alamat I2C | 0x39 (tetap, tidak bisa diubah) |
| Kedekatan | 8-bit (0–255) |
| Warna dan cahaya | 4 kanal (clear, merah, hijau, biru), 16 bit per kanal |
| Gestur | 4 fotodioda berarah (U, D, L, R), FIFO 32 entri |
| LED IR | 950 nm, arus bisa diatur dari 12,5 hingga 100 mA |
| Jangkauan gestur dalam praktik | Sekitar 10–20 cm |
| Output interrupt | INT, open-drain, menjadi LOW ketika ada kejadian |
Pin modul dan persoalan 3,3 V
Board yang paling umum adalah breakout SparkFun dan klon berwarna ungunya, GY-9960. Keduanya memiliki enam pin. Sebagian besar modul memiliki jumper solder bernama PS di bagian belakang; selama jumper ini terhubung, catu daya LED IR (VL) terhubung langsung ke VCC dan pin VL dibiarkan tidak terhubung.
| Pin | Fungsi | Hubungkan ke |
|---|---|---|
| VL | Input catu daya LED IR | Biarkan tidak terhubung jika jumper PS terhubung |
| GND | Ground | GND |
| VCC | Catu daya chip | 3,3 V |
| SDA | Jalur data I2C | Pin SDA board |
| SCL | Jalur clock I2C | Pin SCL board |
| INT | Output interrupt (open-drain) | Pin digital yang mendukung interrupt |
Pengkabelan: Arduino Uno, ESP32, dan Raspberry Pi Pico
| APDS-9960 | Arduino Uno | ESP32 | Raspberry Pi Pico |
|---|---|---|---|
| VCC | 3.3V | 3V3 | 3V3 (OUT) |
| GND | GND | GND | GND |
| SDA | A4 (melalui level shifter) | GPIO 21 | GP4 |
| SCL | A5 (melalui level shifter) | GPIO 22 | GP5 |
| INT | D2 | GPIO 4 | GP15 |
| VL | Tidak terhubung (PS terhubung) | Tidak terhubung (PS terhubung) | Tidak terhubung (PS terhubung) |
ESP32 dan Pico sudah memiliki pin 3,3 V, jadi keduanya bisa dihubungkan langsung. Pada Uno, kondisinya sedikit lebih rumit: library Wire Uno mengaktifkan resistor pull-up internal pada SDA dan SCL dan menarik jalur ke arah 5 V, sementara resistor pada modul menariknya ke 3,3 V. Dalam praktiknya biasanya berfungsi, tetapi ini mendesak batas kemampuan chip. Pilihan terbaik adalah memasang level shifter I2C dua arah di antara Uno dan modul. Karena pin INT bersifat open-drain, resistor pull-up modul menjaganya pada 3,3 V; Uno membaca tegangan itu sebagai HIGH, jadi kamu tidak memerlukan pull-up internal untuk INT pada Uno. Cara kerja I2C dijelaskan dalam panduan apa itu I2C.
SparkFun atau Adafruit? Memilih library
| Fitur | SparkFun APDS9960 | Adafruit APDS9960 |
|---|---|---|
| Arah gestur | Atas, bawah, kiri, kanan, serta mendekat dan menjauh | Atas, bawah, kiri, kanan |
| Pembacaan kedekatan | readProximity(variable) | Nilai kembalian readProximity() |
| Pembacaan warna | Fungsi terpisah seperti readRedLight() | Sekaligus dengan getColorData(), ditambah lux dan suhu warna |
| Pengaturan interrupt | Interrupt gestur, kedekatan, dan cahaya | Interrupt kedekatan dan warna, pengaturan ambang |
| ID chip yang diterima | 0xAB dan 0x9C | Hanya 0xAB |
| Dependensi tambahan | Tidak ada (hanya Wire) | Adafruit BusIO |
Kedua library tersedia di Library Manager: cari SparkFun APDS9960 RGB and Gesture Sensor dan Adafruit APDS9960 Library. Untuk gestur, algoritma SparkFun sedikit lebih stabil dan juga mengenali gerakan mendekat dan menjauh; untuk warna, fungsi lux dan suhu warna Adafruit memudahkan pekerjaan. Kita akan menggunakan keduanya dalam panduan ini. Jika ini pertama kalinya kamu menginstal library, lihat panduan Cara Instal Library Arduino.
Langkah demi langkah: uji gestur pertamamu (dengan pin INT)
- Hubungkan modul sesuai tabel di atas: VCC ke 3.3V, SDA ke A4, SCL ke A5, INT ke D2.
- Instal library SparkFun dan upload sketch di bawah ke Uno.
- Buka Serial Monitor pada 9600 baud dan cari pesan “Jest sensoru hazir” (sensor gestur siap).
- Gerakkan tangan 5–10 cm di atas sensor dari satu sisi ke sisi lain, dengan kecepatan yang membuat gerakan selesai dalam sekitar setengah detik.
- Kamu seharusnya melihat YUKARI (atas), ASAGI (bawah), SOL (kiri), atau SAG (kanan); jika arahnya terbalik, putar sensor 90 atau 180 derajat atau tukar case dalam kode.
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}Ketika gestur siap dibaca, APDS-9960 menarik pin INT ke LOW, sehingga memicu interrupt pada pin D2 Uno. Fungsi interrupt hanya mengaktifkan sebuah flag; pembacaan sebenarnya berlangsung di loop(), karena readGesture() membaca puluhan byte melalui I2C dan penggunaan I2C di dalam interrupt menyebabkan sistem macet. Menonaktifkan interrupt sementara selama pembacaan juga mencegah gestur yang sama diproses dua kali. Logika interrupt dijelaskan secara terperinci dalam panduan interrupt Arduino.
Deteksi kedekatan: LED yang makin terang ketika tanganmu mendekat
Mengukur kedekatan saja, alih-alih gestur, jauh lebih sederhana dan stabil. Sketch di bawah mengirim nilai kedekatan langsung ke LED melalui PWM: makin dekat tanganmu, makin terang LED, dan cahayanya meredup ketika tanganmu menjauh. Hubungkan LED ke D9 melalui resistor 220 Ω; kamu bisa mencari nilai yang tepat dengan kalkulator resistor LED.
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}Nilai kedekatan bukan sentimeter; nilainya menunjukkan kekuatan cahaya pantulan. Selembar kertas putih mungkin menghasilkan 40 pada jarak 15 cm, sedangkan kain hitam pada jarak yang sama tetap di bawah 10. Jadi gunakan APDS-9960 untuk menjawab “apakah ada sesuatu yang mendekat?”, bukan sebagai pengukur jarak. Jika kamu memerlukan jarak yang tepat, sensor ultrasonik HC-SR04 adalah pilihan yang lebih akurat. Jika nilainya sangat rendah, atur penguatan ke PGAIN_4X atau PGAIN_8X; jika nilainya selalu 255, turunkan ke PGAIN_1X.
Mengukur warna RGB dan cahaya sekitar
Untuk warna, APDS-9960 membaca empat kanal: merah (R), hijau (G), biru (B), dan cahaya total tanpa filter (C). Library Adafruit juga menghitung perkiraan nilai lux dan suhu warna cahaya (dalam Kelvin) dari angka mentah ini. Sketch di bawah mencetak keempat kanal, nilai lux dan Kelvin setiap setengah detik, serta memberi tahu warna yang dominan.
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}Nilai mentah bukan warna absolut, melainkan jumlah cahaya; kartu merah yang sama menghasilkan angka yang sangat berbeda di ruangan redup dan di bawah sinar matahari. Jadi bandingkan rasio ketika kamu membandingkan warna: rasio R terhadap C tetap lebih stabil meskipun cahaya berubah. Jika ingin membaca warna suatu objek, pegang objek pada jarak 1–2 cm dari sensor dan halangi cahaya luar dengan tangan atau tabung. Nilai lux merupakan perkiraan; ini tidak menggantikan lux meter, tetapi lebih dari cukup untuk menjawab “apakah ruangan sudah gelap?”. Untuk proyek yang memerlukan pembedaan warna lebih teliti, pertimbangkan sensor khusus warna seperti sensor warna TCS3200 atau TCS34725.
Mengendalikan LED dengan gestur (tanpa pin INT)
Kamu tidak harus menghubungkan pin INT. Library juga bisa mengetahui adanya gestur baru dengan melakukan polling register status mesin gestur melalui I2C. Ini menghemat satu pin dan membuat kode tetap sederhana; konsekuensinya, loop() menghasilkan lalu lintas I2C terus-menerus. Pada sketch di bawah, gestur ke atas menyalakan LED dengan kecerahan penuh, gestur ke bawah mematikannya, dan gestur ke kanan serta kiri menaikkan dan menurunkan kecerahan per seperempat tingkat penuh.
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}Mengendalikan musik dengan gestur: memakai DFPlayer Mini

Penggunaan sensor gestur yang paling menyenangkan adalah pemutar musik tanpa sentuhan. Hubungkan pin RX DFPlayer Mini ke D11 Uno melalui resistor 1 kΩ dan pin TX-nya ke D10; hubungkan speaker ke SPK_1 dan SPK_2, lalu beri daya modul dari 5V. Salin lagu ke kartu SD dengan nama 0001.mp3, 0002.mp3, dan seterusnya. Detail modul tersedia dalam panduan DFPlayer Mini. Gestur ke kanan berpindah ke lagu berikutnya dan gestur ke kiri ke lagu sebelumnya; gestur ke atas dan bawah menaikkan dan menurunkan volume, sedangkan menahan tangan diam di atas sensor menjeda dan melanjutkan pemutaran.
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}Ada satu detail yang perlu kamu ketahui: readGesture() tidak kembali sampai gestur selesai, dan fungsi ini menunggu 30 ms di antara pembacaan FIFO. Selama tanganmu tetap berada di atas sensor, Arduino tidak melakukan apa pun yang lain. Ini bukan masalah untuk pemutar musik, tetapi jika sketch yang sama memiliki motor atau animasi layar yang membutuhkan respons cepat, kamu harus mengatur kerjanya dengan memperhitungkan pembacaan gestur.
Pin INT dan ESP32: deteksi kedekatan berbasis interrupt
Pin INT tidak hanya untuk gestur; pin ini juga bisa digunakan untuk ambang kedekatan dan cahaya. Kamu menetapkan ambang; ketika pembacaan melewatinya, APDS-9960 menarik INT ke LOW dan mempertahankannya sampai kamu menghapus status interrupt. Dengan begitu, mikrokontroler tidak perlu terus melakukan polling sensor. Sketch ESP32 di bawah menggunakan library Adafruit untuk memicu INT ketika kedekatan melebihi 150 dan mengubah status nyala/mati LED pada board setiap kali tangan mendekat, seperti sakelar lampu tanpa sentuhan.
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}Parameter ketiga setProximityInterruptThreshold() (default 4) adalah persistensi: parameter ini menentukan berapa banyak pembacaan berturut-turut yang harus melewati ambang sebelum interrupt dipicu, sehingga menyaring derau singkat. Jika kamu tidak memanggil clearInterrupt(), INT tetap LOW dan pendekatan berikutnya akan terlewat. Pengaturan ini sangat berguna dalam proyek bertenaga baterai: masukkan ESP32 ke deep sleep dan bangunkan dari pin INT dengan esp_sleep_enable_ext0_wakeup(GPIO_NUM_4, 0), sehingga board hanya bangun ketika seseorang mendekatkan tangan. GPIO 4 adalah pin RTC, jadi cocok untuk keperluan ini.
APDS-9960 dengan Raspberry Pi Pico (MicroPython)
Pada Raspberry Pi Pico, kamu bisa menjalankan APDS-9960 menggunakan MicroPython tanpa library apa pun dengan menulis langsung ke registernya. Kode di bawah membaca ID chip, mengaktifkan pengukuran warna dan kedekatan, serta mencetak keempat kanal warna dan nilai kedekatan setiap 200 ms. Pengkabelannya menggunakan bus I2C0: SDA ke GP4, SCL ke GP5, dan VCC ke pin 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)Berikut fungsi register dalam kode: 0x80 (ENABLE) memilih blok yang aktif, 0x81 (ATIME) mengatur waktu integrasi warna (2,78 ms per langkah), 0x8F (CONTROL) mengatur arus LED IR dan penguatan, 0x93 (STATUS) memberi tahu apakah data sudah siap, 0x94–0x9B menyimpan kanal warna, dan 0x9C menyimpan nilai kedekatan. Untuk gestur, kamu harus membaca FIFO dan menulis algoritma arah seperti milik SparkFun, yang membutuhkan pekerjaan lebih panjang. Jika kamu lebih suka Arduino IDE, instal core arduino-pico pada Pico dan gunakan library SparkFun apa adanya; pin I2C default-nya juga GP4 dan GP5.
Batas jangkauan dan penggunaan yang benar
APDS-9960 dirancang sebagai sensor ponsel dan jangkauannya pendek. Dalam praktiknya, gestur terdeteksi dengan andal antara 5 dan 15 cm dan paling jauh mencapai 20 cm. Pembacaan kedekatan bermakna hingga jarak yang serupa. Batas ini ditentukan oleh daya LED IR dan banyaknya cahaya yang dipantulkan tanganmu; menaikkan arus LED ke 100 mA dan penguatan ke maksimum menambah sedikit jangkauan, tetapi juga menambah derau.
| Faktor | Pengaruh | Tindakan |
|---|---|---|
| Jarak | Gestur tidak terbaca di atas 15 cm | Gerakkan tangan pada jarak 5–10 cm |
| Kecepatan gerakan | Gerakan terlalu lambat atau terlalu cepat tidak terdeteksi | Gerakan mulus selama setengah detik |
| Sinar matahari | IR dalam sinar matahari membuat fotodioda jenuh | Gunakan di tempat teduh atau di dalam ruangan |
| Kaca atau penutup bening | Penutup memantulkan IR kembali, sehingga kedekatan selalu terbaca tinggi | Lepaskan penutup atau gunakan bahan tipis yang tembus IR |
| Warna permukaan | Sarung tangan hitam memantulkan lebih sedikit cahaya | Naikkan penguatan |
| Orientasi sensor | Arah ikut berputar | Tukar case arah dalam kode |
Ide proyek APDS-9960
- Lampu tanpa sentuhan: Ubah status nyala/mati modul relay melalui interrupt kedekatan; sangat praktis di dapur ketika tanganmu kotor.
- Lampu warna dengan gestur: Gunakan gestur kanan dan kiri untuk berganti warna pada LED RGB atau LED strip WS2812B.
- Menu di udara: Pilih item menu pada layar OLED dengan gestur atas dan bawah, lalu konfirmasikan dengan NEAR.
- Tutup servo dengan gestur: Buka tutup kotak menggunakan gestur dan motor servo.
- Kecerahan layar otomatis: Sesuaikan layar atau LED strip dengan cahaya sekitar; dibandingkan dengan LDR, kamu mendapat pembacaan yang lebih stabil beserta informasi warna.
- Pemilah warna: Pilah permen atau balok berwarna yang meluncur di saluran berdasarkan kanal warnanya.
Kesalahan umum dan solusinya
| Gejala | Kemungkinan penyebab | Solusi |
|---|---|---|
| “APDS-9960 bulunamadi” (tidak ditemukan) | Kesalahan pengkabelan, tidak ada 3,3 V, atau ID chip berbeda | Cari 0x39 dengan scanner I2C, baca ID-nya |
| Modul ditemukan tetapi init gagal | Chip klon dengan ID berbeda seperti 0xA8 | Tambahkan nilai itu ke pemeriksaan ID library |
| Tidak ada gestur yang terdeteksi | Tangan terlalu jauh atau terlalu lambat, VL tidak mendapat daya | Gerakkan pada jarak 5–10 cm dalam setengah detik, periksa jumper PS |
| Arah terbalik atau tertukar | Orientasi pemasangan sensor | Tukar case DIR dalam kode |
| Kedekatan selalu tinggi | Kaca, penutup, atau permukaan dekat di depan sensor | Lepaskan penutup, turunkan penguatan |
| Tidak berfungsi di luar ruangan | Sinar matahari menenggelamkan IR | Gunakan di tempat teduh |
| Uno macet secara acak | Ketidakcocokan I2C 5 V dan 3,3 V, kabel panjang | Level shifter dan kabel pendek |
| INT tetap LOW | Status interrupt belum dihapus | Panggil clearInterrupt() setelah pembacaan |
Dengan satu modul kecil, APDS-9960 menambahkan kendali tanpa sentuhan, deteksi kedekatan, dan pengukuran warna ke proyekmu. Ingat jangkauannya yang pendek dan aturan 3,3 V agar sensor ini menjadi elemen antarmuka yang andal. Dalam aplikasi BlueGrays, kamu akan menemukan proyek LED RGB, pengukuran cahaya LDR, sensor gerak, dan pengukuran jarak dengan skema rangkaian serta kode langkah demi langkah, lalu kamu bisa menambahkan APDS-9960 untuk membuat versi tanpa sentuhan.
Pertanyaan umum
Apakah APDS-9960 bekerja dengan 5 V?
Tidak, chip APDS-9960 bekerja pada 2,4–3,6 V dan 5 V bisa merusaknya. Beri daya modul dari pin 3.3V Arduino Uno dan, jika memungkinkan, pasang level shifter pada jalur SDA dan SCL. Hanya versi khusus yang dengan jelas menyatakan memiliki regulator dan level shifter pada board yang bisa digunakan dengan 5 V.
Berapa alamat I2C APDS-9960?
Alamat I2C APDS-9960 adalah 0x39 dan tidak bisa diubah. Karena itu, kamu tidak bisa memasang dua APDS-9960 pada bus I2C yang sama; jika memerlukan dua sensor, gunakan multiplexer I2C seperti TCA9548A atau bus I2C kedua pada ESP32 atau Pico.
Berapa jangkauan gestur APDS-9960?
Dalam praktiknya, gestur terdeteksi dengan andal antara 5 dan 15 cm dan bisa mencapai 20 cm dalam kondisi baik. Jangkauannya bergantung pada banyaknya cahaya yang dipantulkan tanganmu, arus LED IR, dan pengaturan penguatan. Sinar matahari dan kaca di depan sensor mengurangi jangkauan secara nyata.
Apakah pin INT APDS-9960 harus dihubungkan?
Tidak. Library juga bisa membaca gestur dan kedekatan dengan polling melalui I2C; pada library SparkFun, enableGestureSensor(false) melakukan hal ini. Pin INT melaporkan kejadian secara langsung tanpa polling terus-menerus, sehingga mengurangi beban prosesor dan bisa membangunkan ESP32 dari deep sleep.
Seberapa akurat sensor warna APDS-9960?
APDS-9960 mengukur kanal warnanya dengan resolusi 16-bit, tetapi menghasilkan nilai mentah yang bergantung pada cahaya sekitar, bukan warna absolut. Jika kamu mendekatkan objek dan menghalangi cahaya luar, sensor ini dengan mudah membedakan kartu merah, hijau, dan biru. Untuk pembedaan warna yang lebih teliti, sensor khusus warna seperti TCS34725 atau TCS3200 adalah pilihan yang lebih baik.
Mengapa muncul error APDS-9960 init failed?
Error ini berarti library tidak bisa membaca ID sensor atau tidak menemukan nilai yang diharapkan. Periksa pengkabelan, catu daya 3,3 V, dan pastikan SDA serta SCL tidak tertukar, lalu cari alamat 0x39 dengan scanner I2C. Jika alamatnya muncul, chip mungkin merupakan klon; baca nilai pada register ID dan tambahkan ke daftar yang diterima library.
Proyek untuk dibuat setelah membaca ini
Lihat semua proyek
Mengukur Intensitas Cahaya dengan LDR
Ingin melihat seberapa terang kamarmu dalam bentuk angka? LDR, komponen kecil yang bereaksi terhadap cahaya, mengukur cahaya di sekitarnya, dan Arduino menulis nilainya ke layar komputermu setiap…

Menggunakan LED RGB
Tiga warna tersembunyi di dalam satu LED: LED RGB menyala merah, lalu hijau, lalu biru, setiap warna menyala setengah detik dan mati setengah detik, sebelum siklusnya dimulai lagi.

Transisi Warna Halus dengan LED RGB
Satu LED RGB perlahan bergeser dari merah ke hijau, hijau ke biru, lalu kembali ke merah, berputar melewati warna pelangi tanpa pernah berhenti.

Pendeteksi Gerakan dengan Sensor Gerak
Penjaga sederhana yang memberi tahu ketika ada orang masuk ke ruangan. Sensor gerak menangkap panas yang dipancarkan tubuh manusia, dan Arduino menjaga LED tetap menyala selama ada gerakan lalu…

Bel Pintu dan Lampu dengan Sensor Gerak
Ketika ada orang datang ke pintumu, kamu sudah tahu bahkan sebelum ia membunyikan bel.

Membaca Pantulan (Kedekatan) dengan TCRT5000
Dengan sensor kecil yang memancarkan cahaya tak terlihat dan mengukur berapa banyak yang terpantul kembali, kamu bisa mendeteksi permukaan di depannya.

Kendali LED RGB ESP32
Menghasilkan warna tanpa batas dengan satu LED RGB alih-alih 3 LED terpisah. Seperti di Arduino, kita membuat transisi pelangi dengan mengatur nilai R/G/B lewat analogWrite(). Teori warna (seperti merah+hijau=kuning) terlihat secara praktis.

Lampu Pintar ESP32 (PIR + LDR + Relay + OLED)
Ubah lorong, kamar mandi, atau gudangmu menjadi lampu pintar dengan ESP32! Dengan sensor gerak PIR, sensor cahaya LDR, dan modul relay, kita membuat skenario klasik "lampu menyala ketika ada gerakan dalam gelap"; jika sudah terang, gerakan TIDAK menyalakan lampu, jadi energi hemat di siang hari. Lampu menyala 30 detik; jika gerakan berlanjut, timer diulang. OLED SSD1306 menampilkan status dengan font besar (NYALA / SIANG / MENUNGGU) dan hitung mundur.
Artikel lainnya
Aplikasi BlueGrays
Rakit rangkaian ini langkah demi langkah di ponselmu
Skema pengkabelan, kode, dan daftar komponen dalam satu layar. 500+ proyek Arduino, ESP32, dan Pico siap dibuat.
Pindai dengan ponselmu
Arahkan kamera ke kode ini dan toko aplikasi di ponselmu akan terbuka.
atau buka toko aplikasi

