跳转到内容

APDS9960 传感器

apds9960 传感器平台允许您在 ESPHome 中使用 APDS9960 RGB 和手势传感器 (数据手册, SparkFun)。 需要在您的配置中设置 I²C 才能使此传感器正常工作。

图片由 SparkFun 提供。
# Example configuration entry
apds9960:
address: 0x39
update_interval: 60s
sensor:
- platform: apds9960
type: CLEAR
name: "APDS9960 Clear Channel"
binary_sensor:
- platform: apds9960
direction: UP
name: "APDS960 Up Movement"
# Repeat for each direction

配置由三部分组成:中心组件、单独传感器 和方向型二值传感器。

基础配置:

  • address (可选, int): 传感器的 I²C 地址。默认为 0x39。

  • update_interval (可选, Time): 检查传感器的时间间隔。默认为 60s。

  • led_drive (可选, int): LED 驱动电流,单位为 mA。可选值为 100mA、50mA、25mA、12.5mA。默认为 100mA。

  • proximity_gain (可选, int): 接近度增益级别。可选值为 1x、2x、4x、8x。默认为 4x。

  • ambient_light_gain (可选, int): 环境光增益级别。可选值为 1x、4x、16x、64x。默认为 4x。

  • gesture_led_drive (可选, int): 手势 LED 驱动电流,单位为 mA。可选值为 100mA、50mA、25mA、12.5mA。默认为 100mA。

  • gesture_gain (可选, int): 接近度增益级别。可选值为 1x、2x、4x、8x。默认为 4x。

  • gesture_wait_time (可选, int): 手势等待时间,单位为 ms。可选值为 0ms、2.8ms、5.6ms、8.4ms、14ms、22.4ms、30.8ms、39.2ms。默认为 2.8ms。

apds9960 传感器允许您使用 Apds9960 进行不同 类型的测量。

配置变量:

  • type (必选, string): 传感器测量类型。可选值为:

    • CLEAR
    • RED
    • GREEN
    • BLUE
    • PROXIMITY
  • 来自 Sensor 的所有其他选项。

apds9960 二值传感器允许您使用 Apds9960 进行不同 类型的测量。

配置变量:

  • direction (必选, string): 要测量的方向。可选值为:

    • UP
    • DOWN
    • LEFT
    • RIGHT
  • 来自 Binary Sensor 的所有其他选项。

某些 APDS9960 模块的 VL 引脚需要 3.3V 供电才能进行手势感应。VL 引脚为用于检测手势的红外 LED 提供电源。模块上可能有两个焊盘,如果通过焊点短路,会使主 VCC 电源引脚也为红外 LED 供电。但是,通过 VL 引脚单独供电可能有助于将电路其余部分与脉冲红外 LED 在较高功率下产生的噪声隔离开来。