Seeed Studio MR24HPC1 毫米波（套件）

组件/Hub

seeed_mr24hpc1 平台允许你在 ESPHome 中使用 Seeed Studio 24GHz 毫米波传感器 - 人体静态存在模块 Lite（产品页面）和 Seeed Studio 毫米波人体检测传感器套件（产品页面）。

要使此传感器工作，需要在你的配置中设置 UART，parity 和 stop_bits 必须分别为 NONE 和 1。你可以使用 ESP32 软件或硬件串行来使用此 MR24HPC1，其默认波特率为 115200。

# 示例配置条目
seeed_mr24hpc1:

配置变量

uart_id (可选, ID): 如果你想使用多个 UART 总线，请手动指定 UART 组件的 ID。
id (可选, ID): 如果你需要多个组件，请手动指定此 Seeed Mr24Hpc1 组件的 ID。

二进制传感器

seeed_mr24hpc1 二进制传感器允许你进行不同的测量。

binary_sensor:
  - platform: seeed_mr24hpc1
    has_target:
      name: "Presence Information"

配置变量

has_target (可选): 如果为 true，则检测到静止或移动的目标。 Binary Sensor 的所有选项。

传感器

seeed_mr24hpc1 传感器允许你进行不同的测量。

sensor:
  - platform: seeed_mr24hpc1
    custom_presence_of_detection:
      name: "Static Distance"
    movement_signs:
      name: "Body Movement Parameter"
    custom_motion_distance:
      name: "Motion Distance"
    custom_spatial_static_value:
      name: "Existence Energy"
    custom_spatial_motion_value:
      name: "Motion Energy"
    custom_motion_speed:
      name: "Motion Speed"
    custom_mode_num:
      name: "Current Custom Mode"

配置变量

custom_presence_of_detection (可选, float): 仅在底层开放功能下有效。雷达检测人在直线距离上的呼吸，通常不超过 3 米。 Sensor 的所有选项。
movement_signs (可选, int): 由内置算法计算的值，用于确定当前环境中是否有人在移动。当值为 0 时，雷达判定环境中没有人。当值为 1 时，雷达判定环境中有人且处于静止状态。当值大于 1 时，雷达判定环境中有人且在移动。值越大，移动越强。 Sensor 的所有选项。
custom_motion_distance (可选, float): 仅在底层开放功能下有效。检测到的移动目标的距离（米）。 Sensor 的所有选项。
custom_spatial_static_value (可选, int): 仅在底层开放功能下有效。环境中存在电磁波，当没有人时频率变化很小。当空间中有人的呼吸（胸部呼吸微动）时，整体空间电磁波反射值会轻微浮动。此值的输出范围为 0-250。 Sensor 的所有选项。
custom_spatial_motion_value (可选, int): 仅在底层开放功能下有效。运动幅度值，不同的运动幅度会引起不同的电磁波频率变化。此值的输出范围为 0-250。 Sensor 的所有选项。
custom_motion_speed (可选, float): 仅在底层开放功能下有效。实时确定目标运动速度的大小。接近雷达的方向为正，远离为负。当没有运动速度时，值为 0，速度档位以 0.5m/s 递增。 Sensor 的所有选项。
custom_mode_num (可选, int): 雷达当前所处的自定义模式编号。如果不在自定义模式下，则值为 0。 Sensor 的所有选项。

开关

seeed_mr24hpc1 开关允许你控制你的设备。

switch:
  - platform: seeed_mr24hpc1
    underlying_open_function:
      name: Underlying Open Function Info Output Switch

配置变量

underlying_open_function (可选): 启用/禁用底层开放功能。当此开关关闭时，表示当前处于标准模式。默认为关闭（标准模式）。打开此功能允许你观察更多关于环境的信息，并且建议在基本功能不足的复杂环境中再次使用它。当此功能打开时，基本功能的静止/移动和接近/远离判断将被禁用。请注意，这需要更多资源，不建议在非必要时启用。 Switch 的所有选项。

数字

seeed_mr24hpc1 数字允许你控制配置。

number:
  - platform: seeed_mr24hpc1
    sensitivity:
      name: "Sensitivity"
    custom_mode:
      name: "Custom Mode"
    existence_threshold:
      name: "Existence Energy Threshold"
    motion_threshold:
      name: "Motion Energy Threshold"
    motion_trigger:
      name: "Motion Trigger Time"
    motion_to_rest:
      name: "Motion To Rest Time"
    custom_unman_time:
      name: "Time For Entering No Person State (Custom Mode)"

配置变量

sensitivity (可选, int): 仅在标准模式下有效。用于调整雷达的灵敏度。灵敏度设置调整传感器对静止状态人体的检测距离。灵敏度设置共有 3 个级别，默认级别为灵敏度 3。 Number 的所有选项。

灵敏度

灵敏度	检测半径（m）
1	2.5m
2	3m
3	4m

custom_mode (可选, int): 设置并进入自定义模式选项。某些功能模块只能在自定义模式下设置。自定义模式有四个存储区域。当你完成设置并点击 Setup End（设置结束）按钮后，雷达将应用你所设置的自定义模式选项。 Number 的所有选项。
existence_threshold (可选, int): 仅在自定义模式设置下有效。这对应于 custom_spatial_static_value。当 custom_spatial_static_value 的值大于设定值时，雷达将判定有人静止，否则将判定没有人。默认值为 33。 Number 的所有选项。
motion_threshold (可选, int): 仅在自定义模式设置下有效。这对应于 custom_spatial_motion_value。当 custom_spatial_motion_value 的值大于设定值时，雷达将判定有人在移动，否则将判定有人静止。默认值为 4。 Number 的所有选项。
motion_trigger (可选, int): 仅在自定义模式设置下有效。用于运动触发的时间累加，多点判断触发以减少误报。可以与 motion_threshold 和 motion_boundary 一起使用以限制性能。默认值为 150ms。 Number 的所有选项。
motion_to_rest (可选, int): 仅在自定义模式设置下有效。设置雷达从人体运动到人体静止的判断时间。可以与 existence_threshold 和 motion_threshold 一起使用以限制性能。默认值为 3000ms。 Number 的所有选项。
custom_unman_time (可选, int): 仅在自定义模式设置下有效。设置雷达从有人状态到无人状态的判断时间。可以与 existence_threshold 和 existence_boundary 一起使用以限制性能。默认值为 30s。 Number 的所有选项。

按钮

seeed_mr24hpc1 按钮允许你执行操作。

button:
  - platform: seeed_mr24hpc1
    restart:
      name: "Module Restart"
    custom_set_end:
      name: "End Of Custom Mode Settings"

配置变量

restart (可选): 重启设备。Button 的所有选项。
custom_set_end (可选): 仅在自定义模式设置下有效。此按钮用于结束当前的自定义模式设置并启用该自定义模式。 Button 的所有选项。

文本传感器

seeed_mr24hpc1 文本传感器允许你获取有关设备的信息。

text_sensor:
  - platform: seeed_mr24hpc1
    heart_beat:
      name: "Heartbeat"
    product_model:
      name: "Product Model"
    product_id:
      name: "Product ID"
    hardware_model:
      name: "Hardware Model"
    hardware_version:
      name: "Hardware Version"
    keep_away:
      name: "Active Reporting Of Proximity"
    motion_status:
      name: "Motion Information"
    custom_mode_end:
      name: "Custom Mode Status"

配置变量

heart_beat (可选): 传感器运行状态指示器。 Text Sensor 的所有选项。
product_model (可选): 产品型号。 Text Sensor 的所有选项。
product_id (可选): 产品 ID。 Text Sensor 的所有选项。
hardware_model (可选): 硬件型号。 Text Sensor 的所有选项。
hardware_version (可选): 硬件版本。 Text Sensor 的所有选项。
keep_away (可选): 检测物体接近或远离的指示器。 Text Sensor 的所有选项。
motion_status (可选): 检测物体移动或静止的指示器。 Text Sensor 的所有选项。
custom_mode_end (可选): 用于指示当前雷达在设置功能中是否处于自定义模式。主要有三种状态：“Not in custom mode”（不在自定义模式）、“Setup in progress…”（正在进行设置…）和 “Set Success!”（设置成功！）。 Text Sensor 的所有选项。

选择器

seeed_mr24hpc1 选择器允许你控制配置。

select:
  - platform: seeed_mr24hpc1
    scene_mode:
      name: "Scene"
    unman_time:
      name: "Time For Entering No Person State (Standard Function)"
    existence_boundary:
      name: "Existence Boundary"
    motion_boundary:
      name: "Motion Boundary"

配置变量

scene_mode (可选): 仅在标准模式下有效。用于在标准模式下选择预设场景。场景模式的功能是调整传感器识别人体运动的最大检测范围（传感器的最大检测距离）。场景模式共有 4 种模式，默认模式为客厅模式。各场景模式的检测范围值见下表。 Select 的所有选项。

场景模式

场景模式	检测半径（m）
Living room（客厅）	4m - 4.5m
Bedroom（卧室）	3.5m - 4m
Bathroom（浴室）	2.5m - 3m
Area detection（区域检测）	3m - 3.5m

unman_time: 仅在标准模式下有效。与 custom_unman_time 相同，但此设置仅在标准模式下有效。 Select 的所有选项。
existence_boundary: 仅在自定义模式设置下有效。雷达检测到的最远静止目标的距离。用于减少雷达误报。减少检测范围外的干扰。默认值为 5m。 Select 的所有选项。
motion_boundary: 仅在自定义模式设置下有效。雷达检测到的最远移动目标的距离。用于减少雷达误报。减少超出范围的房门、门外移动物体的玻璃干扰的检测范围。默认值为 5m。 Select 的所有选项。

Home Assistant 卡片

为了更直观地查看传感器数据，你可以使用下面的自定义卡片。

- type: horizontal-stack
  cards:
    - type: entities
      entities:
        - entity: button.{$DEVICE}_module_restart
          name: Module Restart
        - entity: sensor.{$DEVICE}_hardware_model
          name: Hardware Model
        - entity: sensor.{$DEVICE}_hardware_version
          name: Hardware Version
        - entity: sensor.{$DEVICE}_heartbeat
          name: Heartbeat
        - entity: sensor.{$DEVICE}_product_id
          name: Product ID
        - entity: sensor.{$DEVICE}_product_model
          name: Product Model
      title: {$DEVICE} Information
- type: vertical-stack
  cards:
    - type: entities
      entities:
        - entity: select.{$DEVICE}_scene
          name: Scene
        - entity: number.{$DEVICE}_sensitivity
          name: Sensitivity
        - entity: select.{$DEVICE}_time_for_entering_no_person_state_standard_function
          name: Time For Entering No Person State Setting (Standard Function)
        - entity: binary_sensor.{$DEVICE}_presence_information
          name: Presence Information
        - entity: sensor.{$DEVICE}_motion_information
          name: Motion Information
        - entity: sensor.{$DEVICE}_body_movement_parameter
          name: Body Movement Parameter
        - entity: sensor.{$DEVICE}_active_reporting_of_proximity
          name: Active Reporting Of Proximity
      title: Unsolicited Information
- type: horizontal-stack
  cards:
    - type: entities
      entities:
        - entity: switch.{$DEVICE}_underlying_open_function_info_output_switch
          name: Underlying Open Function Info Output Switch
        - entity: sensor.{$DEVICE}_existence_energy
          name: Existence Energy
        - entity: sensor.{$DEVICE}_motion_energy
          name: Motion Energy
        - entity: sensor.{$DEVICE}_static_distance
          name: Static Distance
        - entity: sensor.{$DEVICE}_motion_distance
          name: Motion Distance
        - entity: sensor.{$DEVICE}_motion_speed
          name: Motion Speed
      title: Underlying Open Function
- type: horizontal-stack
  cards:
    - type: entities
      entities:
        - entity: sensor.{$DEVICE}_custom_mode_status
          name: Custom Mode Status
        - entity: number.{$DEVICE}_custom_mode
          name: Custom Mode
        - entity: sensor.{$DEVICE}_current_custom_mode
          name: Current Custom Mode
        - entity: button.{$DEVICE}_end_of_custom_mode_settings
          name: End Of Custom Mode Settings
        - entity: select.{$DEVICE}_existence_boundary
          name: Existence Boundary
        - entity: select.{$DEVICE}_motion_boundary
          name: Motion Boundary
        - entity: number.{$DEVICE}_existence_energy_threshold
          name: Existence Energy Threshold
        - entity: number.{$DEVICE}_motion_energy_threshold
          name: Motion Energy Threshold
        - entity: number.{$DEVICE}_motion_trigger_time
          name: Motion Trigger Time
        - entity: number.{$DEVICE}_motion_to_rest_time
          name: Motion To Rest Time
        - entity: number.{$DEVICE}_time_for_entering_no_person_state_custom_mode
          name: Time For Entering No Person State (Custom Mode)
      title: Custom Settings

然后用你的设备名称替换所有 {$DEVICE} 的实例

结果：

Seeed Studio MR24HPC1 毫米波（套件）

组件/Hub

配置变量

二进制传感器

配置变量

传感器

配置变量

开关

配置变量

数字

配置变量

灵敏度

按钮

配置变量

文本传感器

配置变量

选择器

配置变量

场景模式

Home Assistant 卡片

另请参阅