Hissələr · 9 dəq oxu

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 rəng, yaxınlıq və jest sensoru modulu
APDS-9960 modulu: bir çipdə jest, yaxınlıq, RGB rəng və mühit işığı sensoru; I2C ilə qoşulur və 3,3 V tələb edir.

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ətDə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ıq8 bit (0–255)
Rəng və işıq4 kanal (clear, qırmızı, yaşıl, göy), kanal başına 16 bit
Jest4 istiqamətli fotodiod (U, D, L, R), 32 qeydlik FIFO
IR LED950 nm, cərəyanı 12,5–100 mA arasında tənzimlənir
Praktik jest məsafəsiTə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.

PinVəzifəsiHara?
VLIR LED-in qida girişiPS körpüsü qapalıdırsa boş burax
GNDTorpaqGND
VCCÇipin qidalanması3,3 V
SDAI2C data xəttiPlatanın SDA pini
SCLI2C saat xəttiPlatanın SCL pini
INTKəsmə çıxışı (açıq-drenaj)Kəsməni dəstəkləyən rəqəmsal pin
APDS-9960 çipi ən çoxu 3,6 V ilə qidalanır; VCC-ni Arduino-nun 5V pininə qoşmaq çipi həmişəlik sıradan çıxara bilər. Üzərində stabilizator və səviyyə çeviricisi olan xüsusi versiyalardan başqa, modulu həmişə 3,3 V-dan qidalandır. Bəzi ucuz modullarda bu məlumat yazılmır; əmin deyilsənsə, 3,3 V istifadə et.

Qoşulma: Arduino Uno, ESP32 və Raspberry Pi Pico

APDS-9960Arduino UnoESP32Raspberry Pi Pico
VCC3.3V3V33V3 (OUT)
GNDGNDGNDGND
SDAA4 (səviyyə çeviricisi ilə)GPIO 21GP4
SCLA5 (səviyyə çeviricisi ilə)GPIO 22GP5
INTD2GPIO 4GP15
VLBoş (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ətSparkFun APDS9960Adafruit APDS9960
Jest istiqamətləriYuxarı, aşağı, sol, sağ və yaxın, uzaqYuxarı, 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ı funksiyalargetColorData() ilə bir dəfəyə, lyuks və rəng temperaturu hesabı
Kəsmə ayarlarıJest, yaxınlıq və işıq kəsməsiYaxınlıq və rəng kəsməsi, hədd ayarı
Qəbul etdiyi çip kimliyi0xAB və 0x9CYalnız 0xAB
Əlavə asılılıqYoxdur (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ə)

  1. Modulu yuxarıdakı cədvələ görə qoş: VCC 3.3V-a, SDA A4-ə, SCL A5-ə, INT D2-yə.
  2. SparkFun kitabxanasını quraşdır və aşağıdakı kodu Uno-ya yüklə.
  3. Serial Monitor-u 9600 baud-da aç; "Jest sensoru hazir" (jest sensoru hazırdır) yazısını gör.
  4. Ə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.
  5. 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ş.
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}

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.

Ən yaxşı nəticə üçün əlini düz və açıq saxla, sensorun 5–10 sm üstündən yarım saniyəyə keçir. Çox yavaş keçsən, hərəkət tamamlanmamış jest mühərriki bağlanır, çox sürətli keçsən FIFO-da kifayət qədər data yığılmır. Əlini sensorun düz üstünə endirib bir müddət sabit saxlasan YAKIN (NEAR), sabit saxladıqdan sonra yavaşca qaldırsan UZAK (FAR) kimi aşkar olunur; bu iki hərəkət dörd istiqamətdən daha az sabitdir.

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.

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}

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.

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}

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.

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}

Jestlə musiqi idarəsi: DFPlayer Mini ilə

DFPlayer Mini MP3 pleyer modulu
DFPlayer Mini: SD kartdakı MP3 fayllarını çalır və serial xətt üzərindən komanda qəbul edir.

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.

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}

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.

C++ (Arduino IDE)
1#include <Wire.h>
2#include <Adafruit_APDS9960.h>
3
4const int INT_PIN = 4;                  // APDS INT -> GPIO 4
5const int LED_PIN = 2;                  // karttaki LED / on-board LED
6Adafruit_APDS9960 apds;
7bool ledOn = false;
8
9void setup() {
10  Serial.begin(115200);
11  pinMode(INT_PIN, INPUT_PULLUP);       // 3,3 V'a çekmek güvenli / pulling up to 3.3 V is safe
12  pinMode(LED_PIN, OUTPUT);
13  Wire.begin(21, 22);                   // SDA, SCL
14  if (!apds.begin()) {
15    Serial.println("APDS-9960 bulunamadi / not found");
16    while (true) delay(10);
17  }
18  apds.enableProximity(true);
19  apds.setProximityInterruptThreshold(0, 150);  // 150'yi aşınca INT LOW / INT goes LOW above 150
20  apds.enableProximityInterrupt();
21}
22
23void loop() {
24  if (digitalRead(INT_PIN) == LOW) {    // el yaklaştı / a hand came close
25    uint8_t p = apds.readProximity();
26    ledOn = !ledOn;                     // her yaklaşmada aç-kapa / toggle on every approach
27    digitalWrite(LED_PIN, ledOn);
28    Serial.printf("Yakinlik / proximity: %u  LED: %s\n", p, ledOn ? "ON" : "OFF");
29    while (apds.readProximity() > 100) delay(20);  // el çekilene kadar bekle / wait for the hand to leave
30    apds.clearInterrupt();              // INT'i serbest bırak / release INT
31  }
32}

setProximityInterruptThreshold() 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ə.

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)

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.

AmilTəsiriNə 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 olunmurYarım saniyəlik axıcı hərəkət
Günəş işığıGünəşdəki IR fotodiodları doydururKölgədə və ya qapalı məkanda istifadə et
Şüşə və ya şəffaf qapaqQapaq IR-ni geri əks etdirir, yaxınlıq həmişə yüksək görünürQapağı götür və ya IR keçirən nazik material istifadə et
Səthin rəngiQara əlcək daha az əks etdirirGücləndirməni artır
Sensorun istiqamətiİstiqamətlər dönürKoddakı 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ətMümkün səbəbHəll
"APDS-9960 bulunamadi" (tapılmadı)Naqil xətası, 3,3 V yoxdur və ya çip kimliyi fərqlidirI2C skanerində 0x39-u axtar, ID-ni oxu
Modul tapılır, amma init uğursuz olurKlon çipdə kimlik 0xA8 kimi fərqli dəyərdirBu 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ır5–10 sm-dən yarım saniyəyə keç, PS körpüsünü yoxla
İstiqamətlər tərsdir və ya qarışıqdırSensorun montaj istiqamətiKoddakı DIR case-lərinin yerini dəyiş
Yaxınlıq həmişə yüksəkdirQarşıda şüşə, qapaq və ya yaxın səth varQapağı götür, gücləndirməni azalt
Çöldə işləmirGünəş işığı IR-ni basdırırKölgədə istifadə et
Uno-da təsadüfi donmalar5 V və 3,3 V I2C uyğunsuzluğu, uzun naqilSəviyyə çeviricisi və qısa naqil
INT həmişə LOW qalırKəsmə təmizlənməyibOxumadan sonra clearInterrupt() çağır
Problem yaşayırsansa, əvvəl I2C skaner kodu ilə 0x39 ünvanının göründüyünə əmin ol, sonra yalnız yaxınlıq oxuyan sadə kodu işlət. Əlini yaxınlaşdıranda yaxınlıq dəyəri 0-dan 200-ün üzərinə çıxırsa, avadanlıq sağlamdır və problem jest ayarlarında və ya əl hərəkətindədir.

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.

Bütün layihələrə bax
LDR ilə işıq intensivliyinin oxunması
AR-11Başlanğıc

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.

4.6(83)
143
RGB LED-dən istifadə
AR-39Başlanğıc
Premium

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.

4.9(73)
100
RGB LED ilə yumşaq rəng keçidi
AR-40Başlanğıc
Premium

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.

4.8(58)
78
Hərəkət sensoru ilə hərəkət aşkarlayıcı
AR-24Başlanğıc
Premium

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.

4.6(47)
67
Hərəkət sensoru ilə qapı zəngi və işıq
AR-25Orta
Premium

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…

4.7(54)
72
TCRT5000 ilə əksolunma (yaxınlıq) oxumaq
AR-77Orta
Premium

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.

4.6(33)
43
ESP32 RGB LED idarəsi
ES-9Başlanğıc

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.

4.6(29)
51
ESP32 ağıllı işıqlandırma (PIR + LDR + Rele + OLED)
ES-37Qabaqcıl
Premium

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.

4.3(6)
11