Unit TMOS PIR Home Assistant 集成

本教程将使用 Unit TMOS PIR 传感器搭配 AtomS3R 主控，并将其集成到 Home Assistant 中，实现人体存在与活动状态的实时监测与显示。

准备工作

1. 硬件清单。

• 1 x Unit TMOS PIR。
• 1 x AtomS3R。
• 1 x HY2.0-4P Grove 连接线 (20cm)。
• 1 x Home Assistant 主机。

2. 软件与版本。

• Home Assistant 2026.2.0 及以上。
• ESPHome Device Builder 2026.2.2 及以上。

创建设备

1. 打开 ESPHome Dashboard，若出现初始引导界面，点击 CONTINUE。

   

2. 点击右下角的绿色 + 按钮，开始创建新设备。

   

3. 点击 New Device Setup，进入设备创建向导。

   

4. 输入设备名称，点击 NEXT。

   

5. 选择设备类型，点击 ESP32S3。

   

6. 点击 SKIP，跳过加密密钥设置。

   

7. 点击 EDIT，进入 YAML 配置页面，自定义设备功能。

   

设备配置

外部组件配置

在 YAML 文件中添加 External Components 配置，加载 STHS34PF80 传感器驱动。

external_components:
  - source: github://m5stack/esphome-yaml/components
    components: sths34pf80
    refresh: 0s

I2C 总线配置

• 添加 I2C 组件，配置 Unit TMOS PIR 与 AtomS3R 之间的通信引脚。

i2c:
  sda: GPIO2
  scl: GPIO1
  scan: true

Sensor 传感器配置

• 添加 Sensor 组件，配置存在检测与运动检测功能。

sensor:
  - platform: sths34pf80
    pres_flag:
      name: "TMOS Presence Detected"
    mot_flag:
      name: "TMOS Motion Detected"
    presence_threshold: 200
    presence_hysteresis: 50
    motion_hysteresis: 50
    odr: 8
    update_interval: 1s

主要参数说明：

下载和烧录固件

编译固件

1. 完成 YAML 修改后，点击右上角的 SAVE 保存配置，再点击 INSTALL。

   

2. 在弹出窗口中选择 Manual Download。

   

3. 等待固件编译完成，点击 Download 并选择 Factory format (Previously Modern)，将固件保存到本地。

   
   提示

   点击 Unit TMOS 查看完整的示例配置。首次构建可能需要一段时间，具体取决于 Home Assistant 主机的性能和网络质量。

烧录固件

4. 通过 USB Type-C 线缆将 AtomS3R 连接到电脑。打开 ESPHome Web 并点击 CONNECT。

   

5. 在弹出的串口选择窗口中，找到对应的串口号并选择。

   

6. 点击 INSTALL。

   

7. 选择步骤 3 中下载的固件文件进行上传。

   

开始使用

1. 在 Home Assistant 中依次点击 Settings > Devices & Services，进入集成管理页面。

   

2. 在 Discovered 区域找到已上线的 Unit TMOS PIR 设备，点击 CONFIGURE 并按照提示完成添加。

   

3. 添加成功后，设备页面将显示 pres_flag（存在检测）和 mot_flag（运动检测）两个传感器实体及其实时状态。

   

4. 最后，将传感器实体添加到仪表板，即可实时查看人体存在与运动状态。