Add DDF for Aqara FP300 Presence Multi Sensor #8425

Didier3L · December 27, 2025, 1:28pm

Hello,

I managed to purchase the Aqara FP300 Presence Multi Sensor.

I saw that a pull request has been submitted for this device.

github.com/dresden-elektronik/deconz-rest-plugin

Add DDF for Aqara FP300 Presence Multi Sensor

master ← SwoopX:fp300

opened 10:37PM - 01 Dec 25 UTC

SwoopX

+696 -1

Alright, this is the initial DDF for the Presence Multi Sensor currently running… fine in my environment. Worth to note: - When in PIR only mode, there is no sensitivity setting available (based on native Gateway) - When in PIR only mode, the delay for motion to go back to false is on attribute 0x014F, which is currently not exposed. Ho could that be done best? - Customization of light detection frequency (attribute 0x0192 with values 0=off, 1=low, 2=medium, 3=high, 4=custom) as well as temp./hum. detection frequency (attribute 0x0170 with values 0=off, 1=low, 2=medium, 3=high, 4=custom) is not implemented due to a lack of resource items. - Setting/reporting detection range is currently not correctly implemented yet (attributes 0x0198 and 0x019a). - <s>LED indication setting missing.</s> - The added resource items will also be applied to the Aqara FP1E. Xiaomi specific reporting on attribute 00F7 as follows: 04 21 0000 (Parent) 05 21 5700 0A 21 083D 0C 20 0A 0D 23 22340000 (Firmware) 13 20 00 17 21 BA0B (Battery voltage) 18 20 64 64 20 00 65 20 02 67 20 00 Remaining questions would be: how to simultaneously expose mmwave presence and PIR occupancy and their respective delay settings?

I’m using Deconz with a Docker container named deconz-community.
I mapped the directory to:
- /volume1/docker/deconz-community:/opt/deCONZ

The PR contains:

devices/generic/items/config_restart_device_item.json
devices/generic/items/config_spatial_learning_item.json
devices/xiaomi/xiaomi_fp300_presence_multi_sensor.json

Do I need to create the directories in /volume1/docker/deconz-community/ ?
/volume1/docker/deconz-community/xiaomi/
/volume1/docker/deconz-community/items/

Because I’m missing some information by the sensor:
“battery”: 0
“lightlevel”: 0,
“lux”: 0
“name”: “config/restart_device”,
“name”: “config/sensitivity”,
“name”: “config/spatial_learning”,

{
    "149": {
        "capabilities": {
            "sleeper": true
        },
        "config": {
            "battery": 0,
            "offset": 0,
            "on": false,
            "reachable": true
        },
        "ep": 1,
        "etag": "cdf9941e1992ed28aeeb33d783572fa1",
        "lastannounced": "2025-12-21T16:52:16Z",
        "lastseen": "2025-12-27T13:33Z",
        "manufacturername": "Aqara",
        "modelid": "lumi.sensor_occupy.agl8",
        "name": "DDM Aqara",
        "nwkaddress": "0xBDE6",
        "state": {
            "lastupdated": "2025-12-27T13:30:13.816",
            "temperature": 2355
        },
        "swversion": "0.0.0_0034",
        "type": "ZHATemperature",
        "uniqueid": "54:ef:44:10:01:52:cb:c0-01-0402"
    },
    "150": {
        "capabilities": {
            "sleeper": true
        },
        "config": {
            "battery": 0,
            "offset": 0,
            "on": false,
            "reachable": true
        },
        "ep": 1,
        "etag": "10f71a04a5e28ab98e87b07ac3cd224f",
        "lastannounced": "2025-12-21T16:52:16Z",
        "lastseen": "2025-12-27T13:33Z",
        "manufacturername": "Aqara",
        "modelid": "lumi.sensor_occupy.agl8",
        "name": "DDM Aqara",
        "nwkaddress": "0xBDE6",
        "state": {
            "humidity": 4099,
            "lastupdated": "2025-12-27T13:30:14.007"
        },
        "swversion": "0.0.0_0034",
        "type": "ZHAHumidity",
        "uniqueid": "54:ef:44:10:01:52:cb:c0-01-0405"
    },
    "151": {
        "capabilities": {
            "sleeper": true
        },
        "config": {
            "battery": 0,
            "on": false,
            "reachable": true,
            "tholddark": 12000,
            "tholdoffset": 7000
        },
        "ep": 1,
        "etag": "cdf9941e1992ed28aeeb33d783572fa1",
        "lastannounced": "2025-12-21T16:52:16Z",
        "lastseen": "2025-12-27T13:33Z",
        "manufacturername": "Aqara",
        "modelid": "lumi.sensor_occupy.agl8",
        "name": "DDM Aqara",
        "nwkaddress": "0xBDE6",
        "state": {
            "dark": false,
            "daylight": false,
            "lastupdated": "none",
            "lightlevel": 0,
            "lux": 0
        },
        "swversion": "0.0.0_0034",
        "type": "ZHALightLevel",
        "uniqueid": "54:ef:44:10:01:52:cb:c0-01-0400"
    },
    "152": {
        "capabilities": {
            "sleeper": true
        },
        "config": {
            "battery": 0,
            "delay": 30,
            "detectionrange": 600,
            "devicemode": "combined",
            "ledindication": true,
            "on": true,
            "reachable": true,
            "sensitivity": 2
        },
        "ep": 1,
        "etag": "4eac5cc97c74d1a314a98d5358725439",
        "lastannounced": "2025-12-21T16:52:16Z",
        "lastseen": "2025-12-27T13:33Z",
        "manufacturername": "Aqara",
        "modelid": "lumi.sensor_occupy.agl8",
        "name": "DDM Aqara",
        "nwkaddress": "0xBDE6",
        "state": {
            "distance": 0,
            "lastupdated": "2025-12-27T13:31:36.055",
            "presence": false
        },
        "swversion": "0.0.0_0034",
        "type": "ZHAPresence",
        "uniqueid": "54:ef:44:10:01:52:cb:c0-01-fcc0"
    }
}

Smanar · December 28, 2025, 9:11am

You can forget.
It will be better to use Deconz Toolbox
Because there is the DDF that go in the folder you are talking about, but you have 2 json file that need to be in the system folder.
And you need too c++ code edition, so this part is not possible on docker.

Didier3L · December 28, 2025, 4:59pm

Hello,
When I download the xiaomi_fp300_presence_multi_sensor.json file from the PR, there’s an error… in red.
I tried with another DDF, no problem.

J’ai mis également les fichiers demandés
config_spatial_learning_item.json
config_restart_device_item.json
xiaomi_battery.js
sml_light_level.js

Smanar · December 28, 2025, 6:58pm

If there is an active PR, you can use it to direclty install the ddb, I never tried on my side probably here Deconz Toolbox or it’s what you have just tried ?

It’s easier to install the complete DDB (with already all files), instead remaking again the “package” file by file, but without the c++ modification you will miss features.

Didier3L · December 28, 2025, 8:04pm

Where can I find this DDB file?

Using Deconz Toolbox, it tells me that the file xiaomi_fp300_presence_multi_sensor.json is invalid.

Smanar · December 29, 2025, 2:38pm

The import from the PR don’t work too, probably because of c++ files.

Cadkey · January 1, 2026, 5:48pm

Hello,
The folders devices/generic/items/ and devices/Xiaomi/ already exist in Docker; you simply need to add the files to the folders if they don’t already exist. During the next container update, if the files aren’t included in container deconz-community, they will be deleted. You’ll have to re-add them. This happens to me regularly with personal xxx_item.json files used to enhance the Lixee module, for example. I had to write a PHP routine for this. There might also be one or more lines to add to general.xml file.