APDS9960 Arduino: jest, yaxınlıq və rəng sensorunun istifadəsi
APDS9960 Arduino bələdçisi: I2C və 3,3 V qoşulma, sağ-sol-yuxarı-aşağı jest, yaxınlıq və RGB ölçümü, SparkFun və Adafruit kodu, INT pini, ESP32 və Pico.
APDS9960 Arduino layihələri bircə kiçik çiplə dörd iş görməyə imkan verir: əlinin sağa, sola, yuxarı və aşağı hərəkətini aşkar edir, cismin nə qədər yaxın olduğunu ölçür, mühitdəki işığı və rəngi qırmızı, yaşıl və göy kanallara ayıraraq oxuyur. Bu, smartfonlarda ekranı qulağına yaxınlaşdıranda söndürən və parlaqlığı mühitə görə tənzimləyən sensorun qohumudur. Heç nəyə toxunmadan əlini yelləyərək lampa yandırmaq, mahnı dəyişmək və ya menyuda gəzmək üçün ideal başlanğıcdır.
Bu bələdçidə APDS-9960-ın içində nələr olduğunu, jestləri necə aşkar etdiyini, niyə 3,3 V ilə işləməli olduğunu və onu Arduino Uno, ESP32 və Raspberry Pi Pico-ya necə qoşacağını görəcəksən. SparkFun və Adafruit kitabxanaları ilə jest testi, əl yaxınlaşdıqca parlayan LED, rəng və lyuks ölçümü, jestlə LED və musiqi idarəsi quracaq, INT pinini kəsmə kimi istifadə etməyi və real məsafə hədlərini öyrənəcəksən.

APDS-9960 nədir, necə işləyir?
APDS-9960 Broadcom-un (əvvəlki adı Avago) istehsal etdiyi, 4 × 2,4 mm-lik korpusun içinə bir infraqırmızı (IR) LED və bir neçə işıq qəbuledicisi yerləşdirən sensordur. Yaxınlıq ölçümündə IR LED qısa impulslarla yanır, qarşıdakı cisimdən əks olunan işıq fotodiodlara qayıdır və əks olunma nə qədər güclüdürsə, cisim bir o qədər yaxındır. Nəticə 0 ilə 255 arasında bir ədəddir. Rəng ölçümündə isə LED istifadə olunmur; mühitdən gələn işıq üzərində qırmızı, yaşıl, göy və filtrsiz (clear) örtüklər olan dörd ayrı fotodioda düşür və hər biri 16 bitlik bir ədəd yaradır.
Jest aşkarlama işin ən ağıllı hissəsidir. Çipin içində yuxarı (U), aşağı (D), sol (L) və sağ (R) istiqamətlərə baxan dörd fotodiod var. Əl sensorun üstündən keçəndə əks olunmanı əvvəl bir tərəfdəki diod, sonra qarşıdakı diod görür. Yaxınlıq dəyəri giriş həddini (SparkFun kitabxanasında 40) aşanda jest mühərriki işləməyə başlayır, dörd diodun ölçmələrini 32 qeydlik FIFO buferinə yazır və əl uzaqlaşanda dayanır. Arduino bu qeydləri oxuyub U ilə D-nin, L ilə R-in fərqinin zamanla necə dəyişdiyinə baxır: əvvəl U böyükdürsə, sonra D böyükdürsə, əl aşağı doğru keçib.
| Xüsusiyyət | Dəyər |
|---|---|
| İstehsalçı | Broadcom (əvvəlki adı Avago) |
| Çipin qidalanması (VDD) | 2,4–3,6 V |
| IR LED-in qidalanması (VL) | 3,0–4,5 V |
| Rabitə | I2C, 400 kHz-ə qədər |
| I2C ünvanı | 0x39 (sabit, dəyişdirilə bilməz) |
| Yaxınlıq | 8 bit (0–255) |
| Rəng və işıq | 4 kanal (clear, qırmızı, yaşıl, göy), kanal başına 16 bit |
| Jest | 4 istiqamətli fotodiod (U, D, L, R), 32 qeydlik FIFO |
| IR LED | 950 nm, cərəyanı 12,5–100 mA arasında tənzimlənir |
| Praktik jest məsafəsi | Təxminən 10–20 sm |
| Kəsmə çıxışı | INT, açıq-drenaj, hadisə olanda LOW |
Modulun pinləri və 3,3 V məsələsi
Bazarda ən çox SparkFun platası və onun surəti olan bənövşəyi GY-9960 modulları tapılır. Hər ikisində altı pin var. Modulların çoxunun arxasında PS adlı lehim körpüsü olur; bu körpü qapalı olanda IR LED-in qidalanması (VL) birbaşa VCC-yə qoşulur və VL pinini boş saxlayırsan.
| Pin | Vəzifəsi | Hara? |
|---|---|---|
| VL | IR LED-in qida girişi | PS körpüsü qapalıdırsa boş burax |
| GND | Torpaq | GND |
| VCC | Çipin qidalanması | 3,3 V |
| SDA | I2C data xətti | Platanın SDA pini |
| SCL | I2C saat xətti | Platanın SCL pini |
| INT | Kəsmə çıxışı (açıq-drenaj) | Kəsməni dəstəkləyən rəqəmsal pin |
Qoşulma: Arduino Uno, ESP32 və Raspberry Pi Pico
| APDS-9960 | Arduino Uno | ESP32 | Raspberry Pi Pico |
|---|---|---|---|
| VCC | 3.3V | 3V3 | 3V3 (OUT) |
| GND | GND | GND | GND |
| SDA | A4 (səviyyə çeviricisi ilə) | GPIO 21 | GP4 |
| SCL | A5 (səviyyə çeviricisi ilə) | GPIO 22 | GP5 |
| INT | D2 | GPIO 4 | GP15 |
| VL | Boş (PS qapalı) | Boş (PS qapalı) | Boş (PS qapalı) |
ESP32 və Pico-nun pinləri onsuz da 3,3 V olduğu üçün birbaşa qoşulur. Uno-da vəziyyət bir az qarışıqdır: Uno-nun Wire kitabxanası SDA və SCL-də daxili pull-up rezistorlarını açır və xətləri 5 V-a doğru çəkir, modulun öz rezistorları isə 3,3 V-a çəkir. Praktikada çox vaxt işləsə də, çipin hədlərini zorlayır. Ən sağlam yol Uno ilə modul arasına ikitərəfli I2C səviyyə çeviricisi qoymaqdır. INT pini açıq-drenaj olduğu üçün modulun pull-up rezistoru onu 3,3 V-da saxlayır; Uno bu gərginliyi HIGH kimi oxuyur, buna görə Uno-da INT üçün daxili pull-up açmaq lazım deyil. I2C-nin necə işlədiyini I2C nədir yazısında izah etmişik.
SparkFun, yoxsa Adafruit? Kitabxana seçimi
| Xüsusiyyət | SparkFun APDS9960 | Adafruit APDS9960 |
|---|---|---|
| Jest istiqamətləri | Yuxarı, aşağı, sol, sağ və yaxın, uzaq | Yuxarı, aşağı, sol, sağ |
| Yaxınlığın oxunması | readProximity(dəyişən) | readProximity() funksiyasının qaytardığı dəyər |
| Rəngin oxunması | readRedLight() kimi ayrı-ayrı funksiyalar | getColorData() ilə bir dəfəyə, lyuks və rəng temperaturu hesabı |
| Kəsmə ayarları | Jest, yaxınlıq və işıq kəsməsi | Yaxınlıq və rəng kəsməsi, hədd ayarı |
| Qəbul etdiyi çip kimliyi | 0xAB və 0x9C | Yalnız 0xAB |
| Əlavə asılılıq | Yoxdur (yalnız Wire) | Adafruit BusIO |
Hər iki kitabxana Library Manager-də var: SparkFun APDS9960 RGB and Gesture Sensor və Adafruit APDS9960 Library yazıb axtar. Jestlər üçün SparkFun-un alqoritmi bir az daha sabitdir və yaxın-uzaq hərəkətlərini də tanıyır; rəng üçün Adafruit-in lyuks və rəng temperaturu funksiyaları işi asanlaşdırır. Bu yazıda ikisindən də istifadə edəcəyik. Kitabxananı ilk dəfə quraşdırırsansa, Arduino kitabxanası əlavə etmək yazısına bax.
Addım-addım: ilk jest testi (INT pini ilə)
- Modulu yuxarıdakı cədvələ görə qoş: VCC 3.3V-a, SDA A4-ə, SCL A5-ə, INT D2-yə.
- SparkFun kitabxanasını quraşdır və aşağıdakı kodu Uno-ya yüklə.
- Serial Monitor-u 9600 baud-da aç; "Jest sensoru hazir" (jest sensoru hazırdır) yazısını gör.
- Əlini sensorun 5–10 sm üstündən, təxminən yarım saniyə çəkəcək sürətlə bir kənardan o biri kənara keçir.
- Ekranda YUKARI (yuxarı), ASAGI (aşağı), SOL (sol) və ya SAG (sağ) yazısını gör; istiqamətlər tərsdirsə, sensoru 90 və ya 180 dərəcə döndər və ya koddakı case-ləri dəyiş.
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}Kodda jest hazır olanda APDS-9960 INT pinini LOW-a çəkir, bu da Uno-nun D2 pinindəki kəsməni işə salır. Kəsmə funksiyası yalnız bir bayrağı qaldırır; əsl oxuma loop() daxilində aparılır, çünki readGesture() I2C üzərindən onlarla bayt oxuyur və kəsmənin içində I2C istifadə etmək donmalara səbəb olur. Oxuma zamanı kəsməni müvəqqəti söndürmək də eyni jestin iki dəfə emalının qarşısını alır. Kəsmələrin məntiqini Arduino interrupt yazısında ətraflı tapa bilərsən.
Yaxınlığın aşkarlanması: əlini yaxınlaşdıranda parlayan LED
Jest əvəzinə yalnız yaxınlığı ölçmək daha sadə və sabitdir. Aşağıdakı kod yaxınlıq dəyərini birbaşa PWM ilə LED-ə ötürür: əlini yaxınlaşdırdıqca LED parlayır, uzaqlaşdırdıqca sönür. LED-i D9-a 220 Ω-luq rezistorla qoş; uyğun rezistor dəyərini LED rezistoru hesablama aləti ilə tapa bilərsən.
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}Yaxınlıq dəyəri santimetr deyil; əks olunan işığın şiddətidir. Ağ kağız 15 sm-dən 40 verərkən qara parça eyni məsafədə 10-dan aşağı qala bilər. Buna görə APDS-9960-ı məsafəölçən kimi yox, "bir şey yaxınlaşdımı?" sualının cavabı kimi istifadə et. Dəqiq məsafə lazımdırsa, HC-SR04 ultrasəs sensoru daha düzgün seçimdir. Dəyərlər çox aşağıdırsa, gücləndirməni PGAIN_4X və ya PGAIN_8X et, daim 255-də qalırsa, PGAIN_1X-ə endir.
RGB rəng və mühit işığının ölçülməsi
Rəng tərəfində APDS-9960 dörd kanal oxuyur: qırmızı (R), yaşıl (G), göy (B) və filtrsiz ümumi işıq (C). Adafruit kitabxanası bu xam ədədlərdən təxmini lyuks dəyərini və işığın rəng temperaturunu (Kelvin) də hesablayır. Aşağıdakı kod hər yarım saniyədən bir dörd kanalı, lyuks və Kelvin dəyərini yazır və hansı rəngin üstün olduğunu bildirir.
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}Xam dəyərlər mütləq rəng deyil, işıq miqdarıdır; eyni qırmızı kart yarıqaranlıq otaqda və günəşdə çox fərqli ədədlər verir. Buna görə rəngləri müqayisə edəndə nisbətlərə bax: R-in C-yə nisbəti işıq dəyişsə də daha sabitdir. Cismin rəngini oxumaq istəyirsənsə, onu sensora 1–2 sm yaxınlaşdır və kənardan gələn işığı əlinlə və ya borucuqla ört. Lyuks dəyəri təxmini hesabdır; lyuksmetri əvəz etmir, amma "otaq qaraldımı?" sualı üçün lap kifayətdir. Daha həssas rəng fərqləndirməsi lazım olan layihələrdə TCS3200 rəng sensoru və ya TCS34725 kimi yalnız rəng üçün nəzərdə tutulmuş sensorları düşünə bilərsən.
Jestlə LED idarəsi (INT pini olmadan)
INT pinini qoşmaq məcburiyyətində deyilsən. Kitabxana jest mühərrikinin status reyestrini I2C üzərindən sorğulayaraq da yeni jestin olub-olmadığını bilə bilər. Bu üsul bir pinə qənaət edir və kodu sadələşdirir; əvəzində loop() daim I2C trafiki yaradır. Aşağıdakı kodda yuxarı jest LED-i tam yandırır, aşağı jest söndürür, sağ və sol jestlər isə parlaqlığı dörddə bir addımlarla artırıb azaldır.
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}Jestlə musiqi idarəsi: DFPlayer Mini ilə

Jest sensorunun ən əyləncəli istifadəsi toxunmadan musiqi çalmaqdır. DFPlayer Mini-nin RX pinini 1 kΩ-luq rezistorla Uno-nun D11 pininə, TX pinini D10-a qoş; dinamiki SPK_1 və SPK_2 uclarına tax, modulu 5V-dan qidalandır. SD karta mahnıları 0001.mp3, 0002.mp3 adlandıraraq köçür. Modulun təfərrüatları DFPlayer Mini yazısındadır. Sağ jest növbəti mahnıya, sol jest əvvəlkinə keçir; yuxarı və aşağı jestlər səsi artırır və azaldır, əlini sensorun üstündə sabit saxlamaq isə dayandırıb davam etdirir.
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}Burada bilməli olduğun bir təfərrüat var: readGesture() funksiyası jest bitənə qədər geri qayıtmır və hər FIFO oxuması arasında 30 ms gözləyir. Əlini sensorun üstündə saxladığın müddətdə Arduino başqa iş görmür. Musiqi pleyeri üçün bu problem deyil, amma eyni kodda sürətli reaksiya tələb edən mühərrik və ya ekran animasiyası varsa, onları jest oxuması ilə birlikdə planlamalısan.
INT pini və ESP32: kəsmə ilə yaxınlıq aşkarlama
INT pini yalnız jestlər üçün deyil, yaxınlıq və işıq hədləri üçün də istifadə oluna bilər. Bir hədd təyin edirsən; ölçmə bu həddi aşanda APDS-9960 INT-i LOW-a çəkir və sən təmizləyənə qədər orada saxlayır. Beləliklə, mikrokontroller sensoru daim sorğulamaq məcburiyyətində qalmır. Aşağıdakı ESP32 kodu Adafruit kitabxanası ilə yaxınlıq 150-ni aşanda INT-i işə salır və əl hər yaxınlaşanda platadakı LED-i yandırıb-söndürür; toxunmadan işləyən lampa açarı kimi.
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() funksiyasının üçüncü parametri (susmaya görə 4) davamlılıqdır: kəsmənin işə düşməsi üçün həddin ardıcıl neçə ölçmədə aşılmalı olduğunu bildirir və ani maneələri süzür. clearInterrupt() çağırılmasa, INT LOW-da qalır və növbəti yaxınlaşmanı qaçırarsan. Bu qurğu batareya ilə işləyən layihələrdə çox faydalıdır: ESP32-ni dərin yuxu rejiminə salıb esp_sleep_enable_ext0_wakeup(GPIO_NUM_4, 0) ilə INT pinindən oyatsan, plata yalnız kimsə əlini yaxınlaşdıranda oyanır. GPIO 4 RTC pini olduğu üçün bu iş üçün uyğundur.
Raspberry Pi Pico ilə APDS-9960 (MicroPython)
Raspberry Pi Pico üçün MicroPython-da APDS-9960-ı heç bir kitabxana istifadə etmədən, reyestrlərinə birbaşa yazaraq işlədə bilərsən. Aşağıdakı kod çipin kimliyini oxuyur, rəng və yaxınlıq ölçümünü açır və hər 200 ms-dən bir dörd rəng kanalını və yaxınlıq dəyərini yazır. Qoşulma I2C0 xəttidir: SDA GP4-ə, SCL GP5-ə, VCC 3V3(OUT) pininə.
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)Koddakı reyestrlərin mənası belədir: 0x80 (ENABLE) hansı bloklarının açıq olduğunu seçir, 0x81 (ATIME) rəng ölçmə müddətini tənzimləyir (hər addım 2,78 ms), 0x8F (CONTROL) IR LED cərəyanını və gücləndirmələri müəyyən edir, 0x93 (STATUS) datanın hazır olub-olmadığını bildirir, 0x94–0x9B rəng kanallarını, 0x9C isə yaxınlıq dəyərini saxlayır. Jest aşkarlama üçün FIFO-nu oxuyub SparkFun-un etdiyi kimi istiqamət alqoritmi yazmalısan; bu daha uzun işdir. Arduino IDE-ni sevirsənsə, Pico-ya arduino-pico nüvəsini quraşdırıb SparkFun kitabxanasını olduğu kimi istifadə edə bilərsən; susmaya görə I2C pinləri yenə GP4 və GP5-dir.
Məsafə həddi və düzgün istifadə
APDS-9960 telefon sensoru kimi hazırlanıb və məsafəsi qısadır. Jestlər praktikada 5 ilə 15 sm arasında etibarlıdır, ən yaxşı şəraitdə 20 sm-ə qədər çatır. Yaxınlıq ölçümü də oxşar məsafəyə qədər mənalı dəyər verir. Bu həddi IR LED-in gücü və əlinin nə qədər işıq əks etdirməsi müəyyən edir; LED cərəyanını 100 mA-ə, gücləndirməni maksimuma çəkmək məsafəni bir az artırır, amma küyü də artırır.
| Amil | Təsiri | Nə etməli? |
|---|---|---|
| Məsafə | 15 sm-dən uzaqda jestlər itir | Əlini 5–10 sm-dən keçir |
| Hərəkət sürəti | Çox yavaş və ya çox sürətli keçid aşkar olunmur | Yarım saniyəlik axıcı hərəkət |
| Günəş işığı | Günəşdəki IR fotodiodları doydurur | Kölgədə və ya qapalı məkanda istifadə et |
| Şüşə və ya şəffaf qapaq | Qapaq IR-ni geri əks etdirir, yaxınlıq həmişə yüksək görünür | Qapağı götür və ya IR keçirən nazik material istifadə et |
| Səthin rəngi | Qara əlcək daha az əks etdirir | Gücləndirməni artır |
| Sensorun istiqaməti | İstiqamətlər dönür | Koddakı istiqamət case-lərini dəyiş |
APDS-9960 ilə layihə ideyaları
- Toxunmadan lampa: Yaxınlıq kəsməsi ilə rele modulunu yandırıb-söndür; mətbəxdə əllərin batanda çox işə yarayır.
- Jestlə rəng seçən lampa: Sağ və sol jestlərlə RGB LED və ya WS2812B lentdə rənglər arasında gəz.
- Havada idarə olunan menyu: Yuxarı və aşağı jestlərlə OLED ekranda menyu seç, NEAR ilə təsdiqlə.
- Jestli servo qapaq: Qutunun qapağını servo mühərriklə jestlə aç.
- Avtomatik ekran parlaqlığı: Mühit işığına görə ekranın və ya LED lentin parlaqlığını tənzimlə; LDR əvəzinə daha sabit və rəng məlumatlı ölçmə alırsan.
- Rəng ayıran qurğu: Lentlə gələn rəngli şirniyyatları və ya lego hissələrini rəng kanallarına görə ayır.
Tez-tez edilən xətalar və həlləri
| Əlamət | Mümkün səbəb | Həll |
|---|---|---|
| "APDS-9960 bulunamadi" (tapılmadı) | Naqil xətası, 3,3 V yoxdur və ya çip kimliyi fərqlidir | I2C skanerində 0x39-u axtar, ID-ni oxu |
| Modul tapılır, amma init uğursuz olur | Klon çipdə kimlik 0xA8 kimi fərqli dəyərdir | Bu dəyəri kitabxanadakı kimlik yoxlamasına əlavə et |
| Jest heç aşkar olunmur | Əl çox uzaqdır və ya çox yavaşdır, VL qidalanmır | 5–10 sm-dən yarım saniyəyə keç, PS körpüsünü yoxla |
| İstiqamətlər tərsdir və ya qarışıqdır | Sensorun montaj istiqaməti | Koddakı DIR case-lərinin yerini dəyiş |
| Yaxınlıq həmişə yüksəkdir | Qarşıda şüşə, qapaq və ya yaxın səth var | Qapağı götür, gücləndirməni azalt |
| Çöldə işləmir | Günəş işığı IR-ni basdırır | Kölgədə istifadə et |
| Uno-da təsadüfi donmalar | 5 V və 3,3 V I2C uyğunsuzluğu, uzun naqil | Səviyyə çeviricisi və qısa naqil |
| INT həmişə LOW qalır | Kəsmə təmizlənməyib | Oxumadan sonra clearInterrupt() çağır |
APDS-9960 bircə kiçik modulla layihənə toxunmasız idarəetmə, yaxınlıq aşkarlama və rəng ölçümü qazandırır. Qısa məsafəsini və 3,3 V qaydasını yadda saxlasan, etibarlı interfeys elementi olur. BlueGrays tətbiqində RGB LED, LDR ilə işıq ölçümü, hərəkət sensoru və məsafə ölçmə layihələrini addım-addım dövrə sxemi və kodları ilə tapa bilər, APDS-9960-ı bu layihələrə əlavə edərək toxunmadan işləyən versiyalarını hazırlaya bilərsən.
Tez-tez verilən suallar
APDS-9960 5 V ilə işləyirmi?
Xeyr, APDS-9960 çipi 2,4–3,6 V arasında işləyir və 5 V onu sıradan çıxara bilər. Modulu Arduino Uno-nun 3.3V pinindən qidalandır, mümkünsə SDA və SCL xətlərinə səviyyə çeviricisi qoy. Üzərində stabilizator və səviyyə çeviricisi olduğu açıq yazılan xüsusi versiyalar 5 V ilə istifadə oluna bilər.
APDS-9960-ın I2C ünvanı nədir?
APDS-9960-ın I2C ünvanı 0x39-dur və dəyişdirilə bilməz. Buna görə eyni I2C xəttinə iki APDS-9960 qoşa bilməzsən; iki sensor lazımdırsa, TCA9548A kimi I2C multipleksoru və ya ESP32 və Pico-dakı ikinci I2C xətti istifadə olunur.
APDS-9960 neçə sm-dən jest aşkar edir?
Jestlər praktikada 5–15 sm arasında etibarlı aşkar olunur, yaxşı şəraitdə 20 sm-ə qədər çıxa bilər. Məsafə əlinin nə qədər işıq əks etdirməsindən, IR LED cərəyanından və gücləndirmə ayarından asılıdır. Günəş işığı və sensorun qarşısındakı şüşə məsafəni nəzərəçarpacaq dərəcədə azaldır.
APDS-9960 INT pini qoşulmalıdırmı?
Xeyr. Kitabxanalar jestləri və yaxınlığı I2C üzərindən sorğulayaraq da oxuya bilər; SparkFun-da enableGestureSensor(false) bunu təmin edir. INT pini isə sensoru daim sorğulamadan hadisəni dərhal bildirdiyi üçün prosessoru yüngülləşdirir və ESP32-ni dərin yuxudan oyatmaq üçün istifadə oluna bilər.
APDS-9960 rəngləri nə qədər dəqiq ölçür?
APDS-9960 rəng kanallarını 16 bit ayırdetmə ilə ölçür, amma mütləq rəng yox, mühit işığından asılı xam dəyərlər verir. Cismi sensora yaxınlaşdırıb kənar işığı örtsən, qırmızı, yaşıl və göy kartları rahatlıqla ayırır. Daha həssas rəng fərqləndirməsi üçün TCS34725 və ya TCS3200 kimi yalnız rəngə yönəlmiş sensorlar üstün tutulur.
APDS-9960 init failed xətası niyə baş verir?
Bu xəta kitabxananın sensorun kimliyini oxuya bilmədiyini və ya gözlənilən dəyəri tapmadığını göstərir. Naqil qoşulmasını, 3,3 V qidalanmanı və SDA ilə SCL-in yerini yoxla, sonra I2C skaneri ilə 0x39 ünvanını axtar. Ünvan görünürsə, çip klon ola bilər; kimlik reyestrindəki dəyəri oxuyub kitabxananın qəbul etdiyi siyahıya əlavə et.
Bu yazıdan sonra edə biləcəyin layihələr
Bütün layihələrə bax
LDR ilə işıq intensivliyinin oxunması
Otağın nə qədər işıqlı olduğunu rəqəmlə görmək istəyirsən? İşığa həssas kiçik hissə olan LDR ətraf işığı ölçür, Arduino isə bu dəyəri yarım saniyədən bir kompüter ekranına yazır.

RGB LED-dən istifadə
Tək LED-in içində üç rəng gizlənib: RGB LED əvvəl qırmızı, sonra yaşıl, sonra göy yanır; hər rəng yarım saniyə yanıb yarım saniyə sönür və sıra yenidən başlayır.

RGB LED ilə yumşaq rəng keçidi
Tək RGB LED qırmızıdan yaşıla, yaşıldan göyə, göydən yenidən qırmızıya yavaşca keçir və bu göy qurşağı dövrü heç dayanmır.

Hərəkət sensoru ilə hərəkət aşkarlayıcı
Kimsə otağa girəndə xəbər verən sadə gözətçi. Hərəkət sensoru insan bədəninin yaydığı istiliyi hiss edir; Arduino hərəkət olduqca LED-i yandırır, hərəkət bitəndə söndürür.

Hərəkət sensoru ilə qapı zəngi və işıq
Qapına kimsə yaxınlaşanda zəngə basmamış xəbər tutursan. Hərəkət sensoru kimisə hiss edən kimi LED yanır və buzzer incədən qalına üç notluq zəng səsi çalır; melodiya bitəndə işıq sönür və sensor…

TCRT5000 ilə əksolunma (yaxınlıq) oxumaq
Görünməz işıq göndərib əksini ölçən kiçik sensorla qarşındakı səthi aşkar edirsən.

ESP32 RGB LED idarəsi
3 ayrı LED əvəzinə tək RGB LED ilə qeyri-məhdud rəng yaratmaq. Arduino-dakı kimi analogWrite() ilə R/G/B dəyərlərini tənzimləyərək göy qurşağı keçidi edirik. Rəng nəzəriyyəsi (red+green=yellow kimi) praktik olaraq görünür.

ESP32 ağıllı işıqlandırma (PIR + LDR + Rele + OLED)
ESP32, PIR hərəkət sensoru, LDR işıq sensoru və rele modulu ilə evinin dəhlizini, tualetini və ya kilerini ağıllı işıqlandırmaya çeviririk. Mühit işıqlıdırsa, hərəkət olsa belə işıq yanmır; beləliklə gündüz boş yerə enerji sərf olunmur. İşıq 30 saniyə açıq qalır; hərəkət davam edərsə, müddət avtomatik uzanır.
Digər yazılar
BlueGrays tətbiqi
Bu dövrəni telefonunda addım-addım qur
Dövrə sxemi, kod və hissə siyahısı bir ekranda. 500-dən çox Arduino, ESP32 və Pico layihəsi səni gözləyir.
Telefonunla skan et
Kameranı koda tut; telefonunun tətbiq mağazası açılır.
ya da mağazada aç

