跳转到内容

超声波距离传感器

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

该传感器平台需要一个能够在特定引脚上发送触发脉冲并在测量进行时发出回波脉冲的传感器。由于有时(例如没有检测到物体时)回波不会返回,该传感器提供了超时选项,用于指定要等待的最大距离。如果您将其设置得太长,传感器本身会超时,并看起来好像有一个有效测量值。

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

  • echo_pin (必选, Pin Schema): 用于等待回波的输入引脚。

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

  • Sensor 的所有其他选项。

高级选项:

  • timeout (可选, float): 超时的米数。大多数传感器只能感测 2 米以内的距离。默认为 2 米。

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

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