AirTouch AT581x 雷达

AirTouch AT581x 雷达 （又称 AT581x）是一系列 5.8GHz 雷达，可用于人体存在检测。它可以检测微小动作，与 PIR 传感器相比，它可以持续检测存在。这在以下场景非常有用：当您进入房间时打开灯光，只要您在那里就保持开启（无需向传感器挥手），并在您离开房间后几乎立即关闭灯光。

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

可以仅使用单个 GPIO 引脚来使用此传感器；但是，如果您希望更改其设置，则需要在设备配置中添加 I2C 组件（及其所需的 GPIO 引脚）。

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

# 示例配置条目
at581x:
  id: "Radar"
  i2c_id: bus_a

组件/集线器

您需要定义集线器组件（at581x: 条目）才能更改传感器的设置、将其列为运动实体或能够开启/关闭射频发射。如果您只想确定存在/占用情况，单独使用 GPIO 就足够了。当您定义 at581x: 时，您需要在配置中添加 i2c: 条目，并定义 SDA 和 SCL 引脚。

如果有多个 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: "前方有人"
    pin: GPIOXX

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

开关

开关组件 用于启用/禁用射频硬件。

switch:
  - platform: at581x
    at581x_id: Radar
    name: "启用雷达"

配置变量

• at581x_id (可选, ID)：上面定义的 AT581x 组件的 ID。当定义了多个 at581x 组件实例时，此选项为必需。

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

动作

at581x.settings 动作

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 值越高增益越小
      power_consumption: 70µA

配置变量

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

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

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

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

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

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

• trigger_base (可选, int)：检测必须保持活动状态才能更改传感器状态的延迟。最大 65535ms

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

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

• power_consumption (可选, int)：任何可能的功耗配置（48、56、63、70、77、91、105、115、40、44、47、51、54、61、68、78）单位 µA

at581x.reset 动作

重启传感器。

on_...:
  at581x.reset:

配置变量

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

另请参阅

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