跳转到内容

Qwiic PIR 运动二进制传感器

Qwiic PIR 运动二进制传感器允许你将 SparkFun 的 Qwiic PIR(基于 EKMC4607112K、基于 EKMB1107112、固件文档) 传感器与 ESPHome 一起使用。

SparkFun Qwiic PIR 传感器。(图片来源:Sparkfun,图片已裁剪并压缩)

SparkFun Qwiic PIR 运动二进制传感器使用 PIR 传感器检测运动。它通过 I²C 进行通信。目前有两种型号可用。一种使用 Panasonic EKMC4607112K 传感器,另一种使用 Panasonic EKMB1107112 传感器。

你可以配置消抖模式以减少噪声和误检。有关可用选项,参见 消抖模式。

要使用传感器,请首先设置一个 I²C 总线 并将传感器连接到指定引脚。

# 示例配置条目
binary_sensor:
- platform: qwiic_pir
name: "Qwiic PIR Motion Sensor"
  • debounce_mode(可选,enum):组件如何对运动传感器信号进行消抖。必须是 HYBRID、NATIVE 或 RAW 之一。详细信息参见 消抖模式。默认为 HYBRID。

  • debounce(可选,Time):仅在使用 NATIVE 消抖模式时有效。配置传感器上的消抖时间以减少噪声和误检。默认为 1ms。

  • 来自 Binary Sensor 的所有其他选项。

debounce_mode 有三个选项。

  • HYBRID :

    • 结合使用原始传感器读数和传感器的本机事件检测来确定状态。
    • 对于检测物体被检测到以及不再被检测都非常可靠。
    • 使用二进制传感器过滤器以减少噪声和误检。
  • NATIVE :

    • 使用传感器的本机事件检测对信号进行消抖。
    • 逻辑遵循 SparkFun 的参考示例实现。
    • 在检测物体被移除时可能不可靠,尤其是在高消抖率下。
    • 不需要二进制传感器过滤器来减少噪声和误检。
  • RAW :

    • 使用固件报告的 PIR 传感器原始状态。
    • 如果 ESPHome 的循环时间较慢,可能会错过非常短暂的运动检测事件。
    • 使用二进制传感器过滤器以减少噪声和误检。