[ST Edge] Aqara FP300 (Zigbee)

Devices & Integrations Community Created Drivers
1

Hi everyone,
this is my Aqara FP300 Zigbee Edge Driver — the most complete FP300 integration available today.

This version supports most LUMI manufacturer-specific attributes that the FP300 exposes.

:rocket: What’s included?

Screen_Recording_20251118_124835_SmartThings-ezgif.com-video-to-webp-converter

:check_mark: True mmWave presence

Attribute 0x0142 → SmartThings presenceSensor

:check_mark: PIR motion

Attribute 0x014D → SmartThings motionSensor

:check_mark: Environment sensors

  • Temperature

  • Humidity

  • Illuminance (raw lux)

:check_mark: Preferences

All fully working:

  • Absence delay

  • PIR interval

  • Detection range

  • Debug logging

:hammer_and_wrench: Technical Highlights

The FP300 is one of the weirdest Zigbee devices in the consumer space: it dumps half of its functionality into a manufacturer-specific mega-cluster (0xFCC0), mixes data types at will (UInt8, UInt16, UInt32, OctetString-buffer hybrids). This driver solves these issues cleanly and safely.

The FP300 uses binary-packed values for certain attributes (e.g. detection range):

  • 0x019A → sometimes UInt32, sometimes OctetString buffer

:package: Get the Driver

Install the Aqara FP300 Presence Sensor driver from this channel.

:wrench: Debug Mode

Enable Debug Logging in preferences to see:

  • All raw LUMI attributes

  • Conversion values

  • Distance decode

  • Movement state decode

10 Likes
2

nice! good to see a driver for this.

3 Likes
3

Now I can run the device over Zigbee for a while, observe how it behaves, configure it, and collect logs. I can then compare this with Matter/Thread, and afterward we’ll be able to determine whether there are any fundamental issues.

The Zigbee2MQTT guys are also actively exploring the device, and I’ll be following their progress and making the appropriate adjustments.

6 Likes