APDS-9960 e Arduino. Rilevamento di gesture con modulo economico

Ciao!

Questa è la mia guida per utilizzare il sensore APDS-9960, nello specifico affronterò la modalità "rilevamento gesture".
Questo componente infatti permette di rilevare la prossimità, il colore e le gesture fatte muovendo una mano sopra di esso ("UP", "DOWN", "RIGHT", "LEFT", "NEAR" e "FAR").

Il sensore viene montato su moduli da vari produttori,
Sparkfun e Adafruit quelli più noti, ma si trovano (su eBay ad esempio) vari moduli più economici.
Io ho acquistato su eBay un modulo simile a questo.

Vediamo subito come utilizzare il modulo con il nostro Arduino.
Per prima cosa collegate il modulo come mostrato in questo schema:

La libreria più popolare per utilizzare questi moduli è quella fornita da Sparkfun (la trovate qui), ovviamente questa libreria è sviluppata per i moduli forniti dallo stesso produttore dove ne garantisce la compatibilità.

Nel mio caso, con il modulo preso su eBay, ho avuto problemi ad utilizzare le gesture.
Infatti ho notato che caricando l'esempio "GestureTest" dalla libreria di Sparkfun, non appariva nessuna gesture.

Cercando un po' su internet non ho trovato granchè, quindi ho deciso di provare a capire quale fosse il problema.
Ho fatto alcune modifiche alla libreria di Sparkfun, ho abilitato il debug, ridotto la potenza del led ed ho aggiunto alcune funzioni.

Per procedere scaricate ed installate la libreria modificata che trovate qui.
Avendo abilitato il debug, ora sul serial monitor appariranno delle informazioni simile a quelle che vedete qui sotto

Il sensore, per capire il movimento della mano, necessita che i suoi 4 fotodiodi si comportino nello stesso modo.
Per provare il comportamento dei fotodiodi, ho messo un pezzo di cartoncino fermo davanti al modulo, in modo da far leggere ai 4 fotodiodi lo stesso valore.
Come potete vedere dai dati cerchiati il valore non è simile a tutti e 4, ma il Left è molto diverso dal Right, questo comporta degli errori nell'analisi della gesture.

Per correggere questo squilibrio, decommentate una delle righe dalla 90 alla 93 del codice qui sotto in base ad i valori letti sul vostro serial monitor, il valore tra parentesi è l'offset, il valore che inserite andrà a ridurre il valore letto.
Quindi se volete che il valore di Left sia simile a Right, dovete scrivere apds.setGestureOffset_R(5); Dove "5" è un valore con cui andrete a ridurre il valore di R. Purtroppo non andrete a togliere esattamente "5" ad "R" quindi dovete procedere per tentativi prima di trovare il valore corretto.

1. /****************************************************************
2. GestureTest.ino
3. APDS-9960 RGB and Gesture Sensor
4. Shawn Hymel @ SparkFun Electronics
5. May 30, 2014
6. https://github.com/sparkfun/APDS-9960_RGB_and_Gesture_Sensor
8. Tests the gesture sensing abilities of the APDS-9960. Configures
9. APDS-9960 over I2C and waits for gesture events. Calculates the
10. direction of the swipe (up, down, left, right) and displays it
11. on a serial console.
13. To perform a NEAR gesture, hold your hand
14. far above the sensor and move it close to the sensor (within 2
15. inches). Hold your hand there for at least 1 second and move it
16. away.
18. To perform a FAR gesture, hold your hand within 2 inches of the
19. sensor for at least 1 second and then move it above (out of
20. range) of the sensor.
22. Hardware Connections:
24. IMPORTANT: The APDS-9960 can only accept 3.3V!
26.  Arduino Pin  APDS-9960 Board  Function
28.  3.3V         VCC              Power
29.  GND          GND              Ground
30.  A4           SDA              I2C Data
31.  A5           SCL              I2C Clock
32.  2            INT              Interrupt
34. Resources:
35. Include Wire.h and SparkFun_APDS-9960.h
37. Development environment specifics:
38. Written in Arduino 1.0.5
39. Tested with SparkFun Arduino Pro Mini 3.3V
41. This code is beerware; if you see me (or any other SparkFun
42. employee) at the local, and you've found our code helpful, please
43. buy us a round!
45. Distributed as-is; no warranty is given.
46. ****************************************************************/
48. #include <Wire.h>
49. #include <SparkFun_APDS9960.h>
51. // Pins
52. #define APDS9960_INT    2 // Needs to be an interrupt pin
54. // Constants
56. // Global Variables
57. SparkFun_APDS9960 apds = SparkFun_APDS9960();
58. int isr_flag = 0;
60. void setup() {
62.   // Set interrupt pin as input
63.   pinMode(APDS9960_INT, INPUT);
65.   // Initialize Serial port
66.   Serial.begin(9600);
67.   Serial.println();
68.   Serial.println(F("--------------------------------"));
69.   Serial.println(F("SparkFun APDS-9960 - GestureTest"));
70.   Serial.println(F("--------------------------------"));
72.   // Initialize interrupt service routine
73.   attachInterrupt(0, interruptRoutine, FALLING);
75.   // Initialize APDS-9960 (configure I2C and initial values)
76.   if ( apds.init() ) {
77.     Serial.println(F("APDS-9960 initialization complete"));
78.   } else {
79.     Serial.println(F("Something went wrong during APDS-9960 init!"));
80.   }
82.   // Start running the APDS-9960 gesture sensor engine
83.   if ( apds.enableGestureSensor(true) ) {
84.     Serial.println(F("Gesture sensor is now running"));
85.   } else {
86.     Serial.println(F("Something went wrong during gesture sensor init!"));
87.   }
89.   //Correzione dell'offset dei sensori. aumentando l'offset il valore letto si riduce
90.   //apds.setGestureOffset_U(0);
91.   //apds.setGestureOffset_D(0);
92.   //apds.setGestureOffset_L(0);
93.   //apds.setGestureOffset_R(0);
94. }
96. void loop() {
97.   if( isr_flag == 1 ) {
98.     detachInterrupt(0);
99.     handleGesture();
100.     isr_flag = 0;
101.     attachInterrupt(0, interruptRoutine, FALLING);
102.   }
103. }
105. void interruptRoutine() {
106.   isr_flag = 1;
107. }
109. void handleGesture() {
110.     if ( apds.isGestureAvailable() ) {
111.     switch ( apds.readGesture() ) {
112.       case DIR_UP:
113.         Serial.println("UP");
114.         break;
115.       case DIR_DOWN:
116.         Serial.println("DOWN");
117.         break;
118.       case DIR_LEFT:
119.         Serial.println("LEFT");
120.         break;
121.       case DIR_RIGHT:
122.         Serial.println("RIGHT");
123.         break;
124.       case DIR_NEAR:
125.         Serial.println("NEAR");
126.         break;
127.       case DIR_FAR:
128.         Serial.println("FAR");
129.         break;
130.       default:
131.         Serial.println("NONE");
132.     }
133.   }
134. }

A questo punto, il modulo "funziona", ma devo dire che pensavo fosse più rapido nel rilevamento delle gesture, la mano deve fare un movimento molto lento per permettere una corretta interpretazione della gesture.

Questo è tutto!

Seguimi sulle mie pagine per rimanere sempre aggiornato sui nuovi post!