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)，将固件保存到本地。

烧录固件

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. 最后，将传感器实体添加到仪表板，即可实时查看人体存在与运动状态。