Qwiic PIR 运动二进制传感器

Qwiic PIR 运动二进制传感器允许您在 ESPHome 中使用 SparkFun 的 Qwiic PIR 传感器（基于 EKMC4607112K、基于 EKMB1107112、固件文档）。

SparkFun Qwiic PIR 传感器。（来源：Sparkfun，图片已裁剪和压缩）

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

您可以配置去抖模式以减少噪声和误检测。请参阅 去抖模式 了解可用选项。

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

# 示例配置条目
binary_sensor:
  - platform: qwiic_pir
    name: "Qwiic PIR 运动传感器"

配置变量

• debounce_mode (可选, 枚举): 组件如何对运动传感器信号进行去抖。必须是 HYBRID、NATIVE 或 RAW 之一。请参阅 去抖模式 了解详情。默认为 HYBRID。

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

• 所有其他选项来自 二进制传感器。

去抖模式

debounce_mode 有三个选项。

• HYBRID:

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

• NATIVE:

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

• RAW:

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

另见

• 二进制传感器组件
• SparkFun 的 Qwiic PIR 库
• API Reference: qwiic_pir.h