Unit TMOS PIR Home Assistant Integration

This tutorial shows how to use the Unit TMOS PIR presence sensor with an AtomS3R controller and integrate it into Home Assistant to monitor human presence and motion status in real time.

1. Preparation

1. Hardware

• 1 x Unit TMOS PIR
• 1 x AtomS3R
• 1 x HY2.0-4P Grove Cable (20cm)
• 1 x Home Assistant host (server, mini PC, NAS, etc.)

2. Software & versions

• Home Assistant 2026.2.0 or later
• ESPHome Device Builder 2026.2.2 or later

2. Create Device

1. Open ESPHome Dashboard. If the initial wizard appears, click CONTINUE.

2. Click the green + button in the bottom right to create a new device.

3. Click New Device Setup to enter the device creation wizard.

4. Enter a device name and click NEXT.

5. Select the device type and click ESP32S3.

6. Click SKIP to skip the encryption key setup.

7. Click EDIT to open the YAML editor and customize the device configuration.

3. Device Configuration

3.1 External components

Add an External Components block in the YAML file to load the STHS34PF80 sensor driver.

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

3.2 I2C bus configuration

Add the I2C component to configure the communication pins between Unit TMOS PIR and AtomS3R.

i2c:
  sda: GPIO2
  scl: GPIO1
  scan: true

3.3 Sensor configuration

Add the Sensor component to enable presence and motion detection.

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 

Main parameter description:

4. Build and Flash Firmware

4.1 Build firmware

1. After editing the YAML configuration, click SAVE in the top right, then click INSTALL.

2. In the popup dialog, select Manual Download.

3. Wait for the firmware to compile, then click Download and choose Factory format (Previously Modern) to save the firmware file locally.

4.2 Flash firmware

4. Connect AtomS3R to your computer using a USB Type-C cable. Open ESPHome Web and click CONNECT.

5. In the serial port selection dialog, select the correct port.

6. Click INSTALL.

7. Select the firmware file downloaded in step 3 and start flashing.

5. Start Using in Home Assistant

1. In Home Assistant, go to Settings > Devices & Services to open the integration management page.

2. In the Discovered section, find the Unit TMOS PIR device, click CONFIGURE, and follow the wizard to complete the setup.

3. After the device is added, you will see two sensor entities on the device page: pres_flag (presence detection) and mot_flag (motion detection), along with their real-time states.

4. Finally, add these sensor entities to a dashboard so you can monitor human presence and motion status in real time.