Aqara PS-S04D in Home Assistant
Motion & presence · Zigbee · Presence sensor FP300
Zigbee device – see the note above on what ZHA needs for it.
Facts about this device
- Brand
- Aqara
- Model
- PS-S04D
- Device type
- Motion & presence
- Radio
- Zigbee
- Power
- Battery
- Reports itself as
- lumi.sensor_occupy.agl8
- Zigbee2MQTT
- Device page on zigbee2mqtt.io
How the device gets into Home Assistant
- official ZHA – with a Zigbee coordinator and the ZHA integration; for all its functions it needs a custom quirk, see above.
- official Aqara hub – paired with an Aqara hub that works as a Matter bridge (such as the M3 or M2), which shares supported devices with Home Assistant.
- add-on Zigbee2MQTT – Zigbee2MQTT runs as an add-on and passes the device on to Home Assistant over MQTT.
Known problems and fixes
Requests for ZHA support
- support requested Someone asked ZHA to support this device or one of its functions.
ZHA quirks for this device
Quirk proposed, not merged yet Recommended quirk
Proposed to ZHA and waiting for review – the maintainers check it before it becomes part of Home Assistant.
Adds: Occupancy PIR detection Target distance Battery voltage Track target distance Motion sensitivity Presence detection options Absence delay timer PIR detection interval AI interference identification +25
Source:
zha-device-handlers · pull request #4504 · by @cemizm · November 19, 2025 · 29 approvals
Signature: Aqara / lumi.sensor_occupy.agl8
2 more quirks for this device
-
Quirk proposed, not merged yet
Aqara/lumi.sensor_occupy.agl8zha-device-handlers · pull request #5259 · by @wiltodelta · August 17, 2026 · 3 approvals -
Custom quirk shared in an issue
Aqara/lumi.sensor_occupy.agl8zha-device-handlers · issue #4487 · by @Goblin-420 · November 15, 2025
Sources: Zigbee2MQTT, ZHA quirks, Z-Wave JS, the Matter certification database, Shelly, ESPHome, Tasmota, Tuya Local and the issue trackers on GitHub. Reports are assigned to a device by the identifiers they contain; the sentences come from the integration pages, where a language model writes them from the titles.
