跳转到内容

超声波距离传感器

超声波距离传感器允许您在 ESPHome 中使用简单的超声波传感器,如 HC-SR04 (数据手册, SparkFun) 来测量距离。这些传感器通常只能测量约两米以内的距离,有时可能会发出一些恼人的咔嗒声。

此传感器平台期望一个可以在特定引脚上发送 触发脉冲 并在测量时发出 回波脉冲 的传感器。因为有时(例如如果没有检测到物体)回波永远不会返回,此传感器有一个超时选项,指定等待的最大距离。如果设置得太长,传感器本身会超时,看起来就像是有效的测量。

HC-SR04 超声波距离传感器。
# 示例配置条目
sensor:
- platform: ultrasonic
trigger_pin: GPIOXX
echo_pin: GPIOXX
name: "超声波传感器"
  • trigger_pin (必需, 引脚模式): 用于周期性发送触发脉冲的输出引脚。

  • echo_pin (必需, 引脚模式): 用于等待回波的输入引脚。

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

  • 传感器的所有其他选项。

高级选项:

  • timeout (可选, 浮点数): 超时的米数。大多数传感器只能感应到 2 米。默认为 2 米。

  • pulse_time (可选, 时间): 触发引脚处于活动状态的持续时间。默认为 10us

  • id (可选, ID): 手动指定用于代码生成的 ID。