APDS-9960手势接近光感模块接Arduino实战

2026-11-12 07:13:35 72阅读

给机器人加"感知手势"这件事,听起来玄,其实是一片小芯片就能干成的活。APDS-9960 这颗料,Adafruit 和 SparkFun 的 breakouts 板都在用,手机上早期的隔空翻页也用过同款方案:手势、接近、环境光、RGB 四色,一颗芯片全包了,走 I2C 总线。这篇把接线、供电坑、库安装和手势示例一次理顺,参数全部对着两家官方教程页和数据手册核过。

APDS-9960手势接近光感模块实物图

这颗芯片是什么来头

APDS-9960 出自 Avago(现属 Broadcom),内部集成了一颗红外 LED 和四个方向性光电二极管。接近检测靠红外反射:物体离传感器正面越近,反射回来的红外能量越强,以 8 位分辨率输出,有效距离就几个厘米的量级。

手势识别是这套方案的亮点:四个方向排布的光电二极管各自记录红外反射随时间的变化,芯片内部做差分判断滑动方向。官方库支持上、下、左、右四个方向手势,另外还能识别 NEAR(由远及近)和 FAR(由近及远)两种动作。理论上之字形、画圈这类复杂手势也能扩展,只是要自己写更多判断逻辑。

顺带说一句它的另外两个身份:RGB 颜色传感器和环境光传感器,返回红、绿、蓝、clear 四通道数值,可以拿来做简单颜色识别。一片顶四片用,单价又不贵,这就是它常年躺在创客购物清单里的原因。

注意 SparkFun 这块板(产品号 SEN-12787)官方页面已标 Retired,市面流通的多是兼容版块,芯片方案一致,接线逻辑通用。

引脚定义与供电红线

模块一共 6 个引脚,规格如下:

引脚功能要求
VCC传感器供电2.4–3.6V
GND接地—
SDAI2C 数据—
SCLI2C 时钟—
INT中断输出低电平有效
VL红外 LED 可选供电3.0–4.5V

红线只有一条:芯片本体只能吃 3.3V。直接接 5V 或挂在 5V 的 I2C 总线上会烧。Uno、RedBoard 这类 5V 板要么加双向电平转换器(SparkFun 官方教程推荐的就是这个方案),要么干脆换 3.3V 逻辑的板子。Adafruit 的 breakout 板上带 3.3V 稳压器和电平转换,5V 板可以直连,买板时留意这个区别。

板上有两组跳线:PS 跳线默认闭合,红外 LED 和传感器共用 VCC 供电,VL 可以不接;I2C PU 跳线默认闭合,板上自带 SDA/SCL 上拉,总线里已有其他上拉时可以断开它。

接线:四根线搞定

以 3.3V 的 Arduino Pro 为例,官方教程的接法是:

APDS-9960Arduino Pro 3.3V
VCCVCC (3.3V)
GNDGND
SDAA4
SCLA5
INTD2
VL不接

APDS-9960与Arduino接线图

Uno 同样是 A4=SDA、A5=SCL,这是 AVR 系的固定映射。INT 接 D2 是因为示例代码用了外部中断,AVR 的 interrupt 0 就在 D2 上。Adafruit 新版板子加了 STEMMA QT / Qwiic 插头,用 QT 线一插就连好 I2C,连焊排针都省了。

装库与示例代码

SparkFun 的库在 GitHub 仓库 APDS-9960_RGB_and_Gesture_Sensor,下载 zip 解压后,把 Libraries 目录下的 SparkFun_APDS9960 文件夹按常规方式装进 Arduino IDE,然后在 File → Examples 里打开 GestureTest 示例。Adafruit 那套则是库管理器里搜 Adafruit APDS9960 直接装。

GestureTest 的代码如下,原样贴出(仅按平台要求把尖括号头文件写成等价的引号形式,两种写法在库搜索路径上等价):

/****************************************************************
GestureTest.ino
APDS-9960 RGB and Gesture Sensor
Shawn Hymel @ SparkFun Electronics
May 30, 2014
https://github.com/sparkfun/APDS-9960_RGB_and_Gesture_Sensor

Tests the gesture sensing abilities of the APDS-9960. Configures
APDS-9960 over I2C and waits for gesture events. Calculates the
direction of the swipe (up, down, left, right) and displays it
on a serial console. 

To perform a NEAR gesture, hold your hand
far above the sensor and move it close to the sensor (within 2
inches). Hold your hand there for at least 1 second and move it
away.

To perform a FAR gesture, hold your hand within 2 inches of the
sensor for at least 1 second and then move it above (out of
range) of the sensor.

Hardware Connections:

IMPORTANT: The APDS-9960 can only accept 3.3V!

 Arduino Pin  APDS-9960 Board  Function

 3.3V         VCC              Power
 GND          GND              Ground
 A4           SDA              I2C Data
 A5           SCL              I2C Clock
 2            INT              Interrupt

Resources:
Include Wire.h and SparkFun_APDS-9960.h

Development environment specifics:
Written in Arduino 1.0.5
Tested with SparkFun Arduino Pro Mini 3.3V

This code is beerware; if you see me (or any other SparkFun 
employee) at the local, and you've found our code helpful, please
buy us a round!

Distributed as-is; no warranty is given.
****************************************************************/

#include "Wire.h"
#include "SparkFun_APDS9960.h"

// Pins
#define APDS9960_INT    2 // Needs to be an interrupt pin

// Constants

// Global Variables
SparkFun_APDS9960 apds = SparkFun_APDS9960();
int isr_flag = 0;

void setup() {

  // Initialize Serial port
  Serial.begin(9600);
  Serial.println();
  Serial.println(F("--------------------------------"));
  Serial.println(F("SparkFun APDS-9960 - GestureTest"));
  Serial.println(F("--------------------------------"));

  // Initialize interrupt service routine
  attachInterrupt(0, interruptRoutine, FALLING);

  // Initialize APDS-9960 (configure I2C and initial values)
  if ( apds.init() ) {
    Serial.println(F("APDS-9960 initialization complete"));
  } else {
    Serial.println(F("Something went wrong during APDS-9960 init!"));
  }

  // Start running the APDS-9960 gesture sensor engine
  if ( apds.enableGestureSensor(true) ) {
    Serial.println(F("Gesture sensor is now running"));
  } else {
    Serial.println(F("Something went wrong during gesture sensor init!"));
  }
}

void loop() {
  if( isr_flag == 1 ) {
    detachInterrupt(0);
    handleGesture();
    isr_flag = 0;
    attachInterrupt(0, interruptRoutine, FALLING);
  }
}

void interruptRoutine() {
  isr_flag = 1;
}

void handleGesture() {
    if ( apds.isGestureAvailable() ) {
    switch ( apds.readGesture() ) {
      case DIR_UP:
        Serial.println("UP");
        break;
      case DIR_DOWN:
        Serial.println("DOWN");
        break;
      case DIR_LEFT:
        Serial.println("LEFT");
        break;
      case DIR_RIGHT:
        Serial.println("RIGHT");
        break;
      case DIR_NEAR:
        Serial.println("NEAR");
        break;
      case DIR_FAR:
        Serial.println("FAR");
        break;
      default:
        Serial.println("NONE");
    }
  }
}

代码逻辑不复杂:setup 里初始化串口 9600 波特率,把 INT 引脚配成下降沿中断,然后 init() 配置 I2C、enableGestureSensor(true) 打开手势引擎;传感器检测到手势事件时拉低 INT,中断服务程序只置标志位,真正的 readGesture() 放回主循环里做,避免在中断里干重活,这是值得抄的标准写法。

手势怎么挥才灵

官方教程给的操作高度是 4–8 英寸,也就是 10–20 厘米,滑太快会识别失败。动作要从传感器感应范围外起手、进入范围、再移出范围才算一次完整手势,手腕别停在感应区里。NEAR 动作是手从约 25 厘米外移近到 5 厘米左右悬停至少 1 秒再移开;FAR 反过来,先在 5 厘米处悬停 1 秒再上移出范围。

APDS-9960滑动手势演示

APDS-9960手势方向示意

烧录后打开串口监视器,波特率 9600,能看到初始化完成的提示;挥手时 UP/DOWN/LEFT/RIGHT/NEAR/FAR 会逐行刷出来。库里的其他示例还覆盖颜色读取、接近中断、环境光中断,功能都在同一颗芯片上,换示例就能玩。

几个容易踩的坑

第一还是供电,5V 板不转电平直接接是最常见的翻车原因,烧之前串口都读不到 init 成功。第二是环境干扰:强日光和某些光源里的红外成分会干扰接近和手势判断,尽量在室内常规照明下用。第三是手势距离,隔太远或贴太近都不行,10–20 厘米是官方给的甜区。

选型角度做个小结:给小车加"挥手换挡"、给桌面机器人加"隔空翻页",APDS-9960 是目前成本最低的四向手势方案;只要接近检测的话它也顺手,但需要远距离测距就该去看 VL53L0X 那类激光 ToF 了。一颗 I2C 器件、六根线、一个库,下午就能把 demo 跑起来,值得放在器件盒里常备。


作者:电机传感器师
链接:https://www.aiddithome.com/p/1ea9212462191.html
本作版权归作者所有,未经允许请勿转载。若存在违规行为,您可以点击 “举报”。


登录 后发表评论
4条评论
第三次终于亮了
1楼 · 2026-11-12 07:13:58

挥手高度 10-20cm 这个甜区说得很准,实测隔远一点基本没反应。

刷着刷着入坑了
2楼 · 2026-11-12 07:13:58

一颗芯片顶四个用,颜色识别那个示例还没玩过,回头试试。

修啥都行二哥
3楼 · 2026-11-12 07:13:58

配合小车做个挥手切换模式,比再接个模块省事多了。

拆机党
4楼 · 2026-11-12 07:13:57

这个传感器我去年买过一块,当时就是没注意 5V 的事,直接怼 Uno 上结果 init 一直失败,后来加了电平转换才跑通。文章里把 2.4-3.6V 这条标成红线很到位,新手最容易栽在这。另外 INT 挂 D2 用中断置标志位、主循环里 readGesture 的写法确实值得学,比在中断里干活稳多了。