AirTouch AT581x 雷达

AirTouch AT581x 雷达 （又名 AT581x）是一系列 5.8GHz 雷达，可用于人体存在检测。它可以检测微小的动作，与 PIR 传感器相比，它可以持续检测存在。例如，这可能很有用，可以在您进入房间时开灯，在您在场时保持灯亮着（无需朝传感器挥手），并在您离开房间后几乎立即关灯。

它们功耗极低（电流消耗低至 40µA），使用极其简单，并且可以通过 I2C 进行设置。它安装在许多低成本的设备中，例如 ESP32S3-BOX-3，并且可以由许多不同的制造商或参考编号找到，例如 MoreSense MS58-3909S68U4。

只需一个 GPIO 引脚即可使用此传感器；但是，如果您想更改其设置，则需要在设备的配置中配置一个 I2C 组件（以及其所需的 GPIO 引脚）。

AirTouch AT581x 雷达 / 存在检测传感器

# Example configuration entry
at581x:
  id: "Radar"
  i2c_id: bus_a

组件/中心

您需要定义 hub 组件（at581x: 条目）才能更改传感器的设置、将其列为运动实体或打开/关闭射频发射。如果您只需要判断存在/占用状态，单独的 Gpio 可能就足够了。定义 at581x: 时，您的配置中需要有一个同时定义 SDA 和 SCL 引脚的 i2c: 条目。

如果可用的 I2C 组件有多个，则可以定义此组件的多个实例：

at581x:
  - id: mmWave_1
    i2c_id: bus_a
    address: 0x28
  - id: mmWave_2
    i2c_id: bus_a
    address: 0x29
  ...

配置变量

• id (可选, ID)：手动指定用于代码生成的 ID。如果您想定义此组件的多个实例，则是必需的。

• i2c_id (可选, ID)：如果使用多个 I2C 总线，请手动指定 I2C 的 ID。

二进制传感器（GPIO）

雷达检测的状态可通过其 GPIO 引脚获取。需要使用 GPIO 二进制传感器来监视运动状态

binary_sensor:
  - platform: gpio
    name: "Human in front"
    pin: GPIOXX

• 请参阅来自二进制传感器和GPIO 二进制传感器的其他选项。

开关

Switch 组件用于启用/禁用射频硬件。

switch:
  - platform: at581x
    at581x_id: Radar
    name: "Enable Radar"

配置变量

• at581x_id (可选, ID)：上面定义的 AT581x 组件的 ID。当定义 at581x 组件的多个实例时需要。

• 来自开关的所有其他选项。

Actions

at581x.settings Action

WARNING

硬件前端重置选项仅在发送新配置之前前端被卡住时重置前端时才需要。但是，更改设置后总会执行一次前端重置。

雷达有几个可以更改的设置。这些设置不保存在非易失性存储器中，需要在每次启动时设置。

设置操作允许更改雷达内部参数/设置中的任意个数。使用此操作时，任何未指定的参数将保持不变。

on_...:
  - at581x.settings:
      id: "Waveradar"
      hw_frontend_reset: false
      frequency: 5800MHz
      sensing_distance: 200 # 0-1023
      poweron_selfcheck_time: 2000ms
      protect_time: 1s
      trigger_base: 500ms
      trigger_keep: 10s
      stage_gain: 3 # 0-12 the higher the value the smaller the gain
      power_consumption: 70µA

配置变量

• id (可选, ID)：手动指定应更改其设置的传感器的 ID。如果只定义了一个雷达，这是可选的。

• hw_frontend_reset (可选, boolean, templatable)：如果设置为 true，则在更改其他选项之前将执行模拟前端的重置。如果未设置或设置为 false，则忽略。应用设置时无论如何都会执行前端重置，此选项仅在传感器无响应或卡住时才有用。

• frequency (可选, enum, templatable)：可能的频率（5696、5715、5730、5748、5765、5784、5800、5819、5836、5851、5869、5888）中的任意一个，单位为 MHz。默认为 5800MHz。

• sensing_distance (可选, int, templatable)：一个无量纲数字，范围 0-1023，指定检测运动的最大距离

• poweron_selfcheck_time (可选, int, templatable)：开机时执行自检和校准的延迟。建议不要更改此值

• protect_time (可选, int, templatable)：触发事件结束后检测不再触发的延迟。最大 65535ms

• trigger_base (可选, int, templatable)：检测必须持续激活以改变传感器状态的延迟。最大 65535ms

• trigger_keep (可选, int, templatable)：检测事件后输出保持高电平的延迟。这通常是您想要更改的值。

• stage_gain (可选, int, templatable)：用于阈值测试的模拟增益。范围为 0-12 的任意值，12 是最低增益，0 是最高增益

• power_consumption (可选, int, templatable)：可能的功耗配置文件（48、56、63、70、77、91、105、115、40、44、47、51、54、61、68、78）中的任意一个，单位为 µA

at581x.reset Action

重启传感器。

on_...:
  at581x.reset:

配置变量

• id (可选, ID)：手动指定 AT581x 组件的 ID。当定义此组件的多个实例时很有用。

另请参阅

• I2C 总线
• 二进制传感器组件
• GPIO 二进制传感器
• ID