APDS-9960 Proximity RGB Gesture Sensor Arduino Library Kurulumu ve Kullanımı - Turkish Tutorial

This is a Turkish tutorial of an open source Arduino library, which allows the user to integrate “APDS-9960 Proximity RGB Gesture Sensor” to Arduino. I will show you how to install the library to Arduino IDE and make an example project with the library, throughout this tutorial while giving information about what proximity sensors are and their working principles.

Merhaba, bu yazıda Arduino mikrokontrolörünüze “APDS-9960 Proximity RGB Gesture Sensor” adlı sensörü eklemenize ve bu sensör ile projeler yapmanıza olanak sağlayan, açık kaynak kütüphaneden bahsedeceğim. Yazı boyunca proximity (yakınlık) sensörlerinin ne olduğunu ve nasıl çalıştığını, APDS-9960 Proximity Gesture Sensor kütüphanesinin kurulumunu ve bu sensör ile yapacağımız örnek bir proje kodlarını görebilirsiniz.

Proximity sensör ile yapılmış bir Arduino projesi.

---

Proximity (Yakınlık) Sensörü Nedir ve Nasıl Çalışır?

Proximity yani yakınlık sensörü yakınındaki objelerin varlığını fiziksel bir temas olmaksızın algılayan sensörlere denir. Proximity sensörler elektromanyetik, elektrostatik veya kızılötesi alanlar oluşturarak ve bu alanlardaki değişimleri gözleyerek objeleri algılarlar. Algılanması istenen değişik objeler için değişik türde proximity sensörleri kullanılır. Örneğin plastik bir nesne algılanmak isteniyorsa kapasitif veya fotoelektrik bir proximity sensörü, metal bir nesne algılanmak isteniyorsa endüktif proximity sensörü kullanılması gerekmektedir.

Çeşitli endüstriyel proximity sensörleri.

Proximity sensörler bir çok endüstriyel alanda kullanılır. Konveyor bantlarda cisim algılanması, titreşim algılayan sistemler, araba park sensörleri buna örnek verilebilir. Proximity sensörlerinin en bilinen uygulamalarından biri de akıllı telefonlarda arama yapıldığında yüzün yakınlığına göre ekranın kapanmasıdır.

Proximity sensörün endüstriyel olarak kullanım örnekleri.

Akıllı telefonlarda proximity sensörün işlevi.

---

APDS-9960 Proximity Gesture Sensor Kütüphanesinin Arduino IDE’sine Kurulumu

1. https://github.com/sparkfun/APDS-9960_RGB_and_Gesture_Sensor adresinden kütüphaneyi indirin.

2. Arduino programını açıp sırasıyla Sketch->Include Library->Add .ZIP Library seçeneklerini seçin.

3. APDS-9960_RGB_and_Gesture_Sensor-master.zip dosyasını seçin ve Open'a tıklayın.

---

APDS-9960 Proximity Gesture Sensor Kütüphanesinin Kullanımı

Aşağıda APDS-9960 Proximity Gesture Sensor kütüphanesinin kullanımını öğrenmek adına basit bir el hareketi algılayıcı yapılmıştır. APDS-9960 Proximity sensörünüzün Arduino’nuza bağlamak için aşağıdaki şemadan yardım alabilirsiniz. Dikkat etmeniz gereken nokta, sensörün 3.3V gerilim ile beslenmesi gerektiğidir.

APDS-9960 Proximity sensörünün Arduino'ya bağlantı şeması.

1. Yeni bir sketch açın ve "Proximity_Sensor_Deneme" olarak kaydedin.

2. Öncelikle kütüphanelerimizi sketch’imize eklemek için, kodun en başına, #include <SparkFun_APDS9960.h> ve #include <Wire.h> yazın.

3. Kütüphaneyi ekledikten sonra kullanacağınız APDS-9960 Proximity Gesture sensörünün interrupt bağlantı pinini tanımlayın.

4. APDS-9960 sensörünün değişkenini atayın ve tanımlayın. Ardından Interrupt Service Routine (ISR) işlemi için bir değişken tanımlayın ve değerini sıfır yapın.

5. void setup() fonksiyonunun içine, 9600 baud rate’inde seri haberleşmeyi başlatacak komutu yazın. Ardından sensör interrupt pinini “Input” olarak atayın. Interrupt Service Routine işlemini başlatacak komutu “Falling” yani düşen kenar olacak şekilde başlatın. Daha sonra kullanım kolaylığı açısından önce sensörün I2C protokolü üzerinden konfigürasyonunun yapılıp, yapılmadığını belirten, ardından sensörün devrede olup olmadığını ekrana yansıtan kodları yazın.

6. void loop() fonksiyonunun içine, bir if koşulu atayın. Bu if koşulunu sensörde interrupt olduğu durumda el hareketini başlatacak komutlar yazın. Yani sensör el hareketi algıladığında interrupt olmalı.

7. void interruptIslemi() adında bir fonksiyon oluşturun ve bu fonksiyona sensör el hareketi algıladığında, Interrupt Service Routine işlemini tamamlayacak komutu yazın.

8. elHareketi() adında, el hareketlerini ve el hareketlerinin ekran çıktılarını tanımlayacak bir fonksiyon oluşturun. Bu fonksiyonun içine bir if koşulu ekleyin. If koşulu sensör çalıştığında çalışmalı. Biri default olmak üzere 7 adet case tanımlayın. Bu caseler sırasıyla, “Yukarı”, “Aşağı”, “Sol”, “Sağ”, “Yakın” ve “Uzak” el hareketlerini tanımlasın. Case’lere el hareketlerini kütüphane fonksiyonu ile tanımlayın. Default olan duruma el hareketinin olmadığı ekran çıktısını yazın.

---

Bu yazımda Arduino mikrokontrolörü için "sparkfun" adlı GitHub kullanıcısı tarafından yazılmış " APDS-9960 RGB and Gesture Sensor" kütüphanesinin kurulumu, proximity (yakınlık) sensörleri hakkında bilgi vererek, basit bir el yakınlık ve hareket algılayıcı yaparak kütüphanenin kullanımını gösterdim. Umuyorum ki vermiş olduğum bilgileri beğenirsiniz, okuduğunuz için teşekkürler. Başka yazılarda görüşmek dileğiyle.

Kütüphane hakkında daha fazla bilgi ve kaynak için aşağıdaki linki kullanabilirsiniz.

GitHub: https://github.com/sparkfun/APDS-9960_RGB_and_Gesture_Sensor

Örnek projenin kaynak kodu:

#include <Wire.h>
#include <SparkFun_APDS9960.h>

#define sensorInterrupt 2 // Sensörün interrupt bağlantı pinini atıyoruz.

SparkFun_APDS9960 apds = SparkFun_APDS9960(); // APDS-9960 sensörünün değişkenini yazıp atıyoruz.
int interruptSR = 0;                          // Interrupt Service Routine (ISR) için tanımladığımız değişken.

void setup() {

  Serial.begin(9600);                  // 9600 baud rate'de seri haberleşmeyi başlatır.
  pinMode(sensorInterrupt, INPUT);     // Sensör interrupt pinini input olarak atar.
  
  attachInterrupt(0, interruptIslemi, FALLING); // "Interrupt service routine" işlemini başlatır.


  if ( apds.init() ) {                       // APDS-9960 Proximity sensörünün konfigürasyon (I2C üzerinden) durumunu ekrana yansıtır.
    Serial.println("Konfigürasyon tamamlandı.");
  } else {
    Serial.println("Hata! Konfigürasyon tamamlanamadı.");
  }
  
 
  if ( apds.enableGesturesensorInterrupt(true) ) {    // APDS-9960 Proximity sensörün çalışıp-çalışmadığını ekrana yazdırır.
    Serial.println("Proximity sensörü devrede.");
  } else {
    Serial.println("Hata! Proximity sensörü devreye alınamadı.");
  }
}


void loop() {
  
  if( interruptSR == 1 ) {      // Sensöre interrupt geldiği durumda 
    detachInterrupt(0);         // el hareketini algılama işlemini başlatır.
    elHareketi();
    interruptSR = 0;
    attachInterrupt(0, interruptIslemi, FALLING);
  }
}

void interruptIslemi() {    // Sensör el hareketi algıladığında, ISR'i tamamlar.
  interruptSR = 1;
}

void elHareketi() {        // El hareketlerini ve ekran çıktılarını tanımlayan fonksiyon.
  
  >   if ( apds.isGestureAvailable() ) {
    switch ( apds.readGesture() ) {
      case DIR_UP:
        Serial.println("Yukarı");
        break;
      case DIR_DOWN:
        Serial.println("Aşağı");
        break;
      case DIR_LEFT:
        Serial.println("Sol");
        break;
      case DIR_RIGHT:
        Serial.println("Sağ");
        break;
      case DIR_NEAR:
        Serial.println("Yakın");
        break;
      case DIR_FAR:
        Serial.println("Uzak");
        break;
      default:
        Serial.println("El hareketi algılanamadı");
    }
  }
}

---

Posted on Utopian.io - Rewarding Open Source Contributors

---