Component guide · Intermediate · 3 min read
APDS-9960 Gesture, Proximity and Colour Sensor

Pinout, Wiring and Code
By Geekobot Learning Team · Updated 29 Oct 2026
On this page
The APDS-9960 from Broadcom senses hand gestures (up, down, left, right), proximity, ambient light and RGB colour in one small module. It talks I2C at address 0x39 and is a 3.3 V part, so use a level shifter with a 5 V Uno. Use it for touch-free switches, gesture-controlled lamps and colour sorting.
Key specs at a glance
- Functions
- Gesture, proximity, ambient light, RGB colour
- Gesture range
- About 10 to 20 cm
- Interface
- I2C, address 0x39, up to 400 kHz
- Supply
- 2.4 to 3.6 V (3.3 V)
- Interrupt
- INT output for proximity and gesture events
- IR LED
- Built in, current set in software
Models in this guide
These are alternatives. Pick the one that fits your project; you only need one.
Option 1APDS9960 RGB Gesture Sensor Detection I2C Breakout Module for Arduino₹277
Option 2Adafruit APDS9960 Proximity, Light, RGB, and Gesture Sensor₹1,202
Option 3GY-9960 APDS9960 RGB & Gesture Sensor Module – Unsoldered Components₹369
Option 4GY-9960-3.3 APDS-9960 RGB & Gesture Sensor Module – I2C Interface₹239
What the APDS-9960 is
The APDS-9960 has four directional photodiodes and an infrared LED. When a hand passes over it, the order in which the photodiodes see the reflection tells the chip which way the hand moved. The same diodes measure proximity and, with colour filters, red, green, blue and clear light.
It is the sensor used for gesture control in several phones and in the Arduino Nano 33 BLE Sense.
APDS-9960 pinout
The pins on the APDS-9960 and what each one does.
| Pin | Function |
|---|---|
| VCC / VIN | 3.3 V supply (VIN on Adafruit boards accepts 3 to 5 V) |
| GND | Ground |
| SDA | I2C data |
| SCL | I2C clock |
| INT | Interrupt output, active low |
| VL | IR LED supply on some boards; join to VCC with the jumper |
- VCC / VIN
- 3.3 V supply (VIN on Adafruit boards accepts 3 to 5 V)
- GND
- Ground
- SDA
- I2C data
- SCL
- I2C clock
- INT
- Interrupt output, active low
- VL
- IR LED supply on some boards; join to VCC with the jumper
Wiring the APDS-9960
Generic GY-9960 boards are 3.3 V only, including their I2C lines. The Adafruit board has a regulator and level shifting and can connect to 5 V boards directly.
| APDS-9960 pin | Arduino Uno | ESP32 |
|---|---|---|
| VCC | 3.3V | 3V3 |
| GND | GND | GND |
| SDA | A4 via level shifter | GPIO 21 |
| SCL | A5 via level shifter | GPIO 22 |
| INT | D2 (optional) | GPIO 4 (optional) |
- VCC
- Arduino Uno:
- 3.3V
- ESP32:
- 3V3
- GND
- Arduino Uno:
- GND
- ESP32:
- GND
- SDA
- Arduino Uno:
- A4 via level shifter
- ESP32:
- GPIO 21
- SCL
- Arduino Uno:
- A5 via level shifter
- ESP32:
- GPIO 22
- INT
- Arduino Uno:
- D2 (optional)
- ESP32:
- GPIO 4 (optional)
Example code
Move your hand across the sensor 5 to 15 cm above it, at a steady speed. The directions depend on how the board is mounted, so swap them in code if needed.
#include "Adafruit_APDS9960.h"
Adafruit_APDS9960 apds;
void setup() {
Serial.begin(115200);
if (!apds.begin()) { Serial.println("No APDS-9960 found"); while (1); }
apds.enableProximity(true);
apds.enableGesture(true);
}
void loop() {
uint8_t g = apds.readGesture();
if (g == APDS9960_UP) Serial.println("up");
if (g == APDS9960_DOWN) Serial.println("down");
if (g == APDS9960_LEFT) Serial.println("left");
if (g == APDS9960_RIGHT) Serial.println("right");
}Setup and tuning
a hand swipe of about half a second works best.
strong sunlight or IR sources reduce gesture range.
behind a window, use IR-transparent material and test the range.
enable colour mode and compare the R, G and B counts to the clear count.
What you need
Shop this list6 of 7 found in our store · ₹2,268
- APDS9960 gesture sensor breakout: the low-cost 3.3 V boardFind this part
Adafruit APDS9960 sensor: has a regulator and level shifting for 5 V boardsAdafruit APDS9960 Proximity, Light, RGB, and Gesture Sensor₹1,202Closest match, check the specs
Generic GY-9960 APDS9960 RGB & Gesture Sensor Module – Unsoldered Components: another version this guide coversGY-9960 APDS9960 RGB & Gesture Sensor Module – Unsoldered Components₹369
GY-9960-3.3 APDS-9960 RGB & Gesture Sensor Module – I2C Interface: another version this guide coversGY-9960-3.3 APDS-9960 RGB & Gesture Sensor Module – I2C Interface₹239
ESP32-WROOM-32 38-pin development board: for Wi-Fi logging and dashboardsESP32-WROOM-32 38-Pin Development Board₹389
4-channel logic level converter (BSS138): to connect 5 V and 3.3 V signals safely4-Channel Logic Level Converter (BSS138)₹20
Dupont jumper wires: for the connectionsDupont Jumper Wires (40 pcs)₹49Closest match, check the specs
Alternatives and when to choose them
- TCS34725: more accurate colour measurement.
- IR obstacle sensor module: simple proximity on or off.
- Touch sensors: when the user can touch the surface.
Try it: I2c pullup calculator
Change the values and the diagram and results update as you type.
Common mistakes to avoid
- Connecting a 3.3 V GY-9960 board straight to 5 V.
- Swiping too fast or too close to the sensor.
- Leaving the VL jumper open, so the IR LED gets no power.
- Testing in bright sunlight.
Frequently asked questions
What is the APDS-9960's I2C address?
0x39, fixed.
How far does gesture detection work?
About 10 to 20 cm, less in bright light.
Can I use it with Arduino Uno?
Yes with a level shifter, or use a board with a regulator and level shifting.
Can it read colour?
Yes, it gives red, green, blue and clear values; for accurate colour a TCS34725 is better.
Does it work behind glass?
Often, if the glass passes infrared; test before you build an enclosure.
Parts for this guide
Calculators
Terms in this guide
Projects that use it
Put this into practice: 10 step-by-step builds in our project library use parts from this guide.
Keep learning
Sources
- APDS-9960 digital proximity, ambient light, RGB and gesture sensor datasheet (Broadcom)
- Adafruit APDS9960 library
Written by the Geekobot team from manufacturer datasheets. Always check the datasheet for the exact part and variant you buy.
