Aqara PS-S04D in Home Assistant
Motion & presence · Zigbee · Presence sensor FP300
This device is known to both Zigbee integrations: Zigbee2MQTT has a definition for it, and ZHA has a quirk that adapts 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; the quirk the device needs is part of ZHA.
- 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 The Aqara FP300 occupancy sensor is not working with ZHA, so it cannot detect motion. Support would enable the sensor to trigger automations based on occupancy.
ZHA quirks for this device
Quirk included in ZHA Recommended quirk
Part of ZHA – Home Assistant uses it on its own, nothing to install.
Adds: Occupancy Motion
Source:
zha-device-handlers · since zha-quirks 2.4.0
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 · 4 approvals -
Custom quirk shared in an issue
Aqara/lumi.sensor_occupy.agl8zha-device-handlers · issue #4487 · by @Goblin-420 · November 15, 2025
Alternatives
The same job from other makers – devices of the same type and radio that work with Home Assistant too.
-
SONOFF SNZB-06P
Motion & presence · Zigbee · Zigbee occupancy sensor
Zigbee2MQTT
ZHA quirk
4 open reports
Review · from 20.45 €
-
HOBEIAN ZG-204ZL Motion & presence · Zigbee · Luminance motion sensor Zigbee2MQTT ZHA quirk 1 open report Review
-
Philips 9290030675
Motion & presence · Zigbee · Hue motion sensor
Zigbee2MQTT
ZHA quirk
1 open report
Review · from 40.16 €
-
EGLO 99106
Motion & presence · Zigbee · Connect-Z motion (PIR) sensor
Zigbee2MQTT
Review · from 32.05 €
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.
