跳转到内容

APDS9960 传感器

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

图片来自 SparkFun
# 示例配置条目
apds9960:
address: 0x39
update_interval: 60s
sensor:
- platform: apds9960
type: CLEAR
name: "APDS9960 清除通道"
binary_sensor:
- platform: apds9960
direction: UP
name: "APDS960 向上移动"
# 对每个方向重复

配置由三部分组成:中心组件、各个传感器和方向二元传感器。

基础配置:

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

  • update_interval (可选, 时间): 检查传感器的时间间隔。 默认为 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
  • 来自 二元传感器 的所有其他选项。

对于某些 APDS9960 模块,需要为 VL 引脚提供 3.3V 电压才能使手势感应工作。VL 引脚为用于检测手势的红外 LED 供电。模块上可能有两个焊盘,如果用焊锡短接,会使主 VCC 电源引脚也为红外 LED 供电。然而,通过 VL 引脚提供独立电源可能有助于将电路的其余部分与以相对较高功率脉冲红外 LED 时产生的噪声隔离开来。