Homebridge Dreame FP10

Homebridge 2.0 dynamic platform plugin for the Dreame FP10 / Furcatch Air Purifier FP10.

The plugin talks to Dreame Cloud with the same MiOT command path used by the Home Assistant integration, then exposes the purifier through:

• HomeKit/HAP services:
  • AirPurifier
  • AirQualitySensor
  • TemperatureSensor
  • HumiditySensor
  • FilterMaintenance
• Homebridge 2 Matter API when Matter is enabled for the bridge.

Requirements

• Homebridge >= 2.0.0
• Node.js 22 or 24, matching Homebridge 2's supported runtime range
• A Dreame account with a bound FP10 purifier

Configuration

{
  "platform": "DreameFP10",
  "name": "Dreame FP10",
  "username": "[email protected]",
  "password": "your-password",
  "country": "eu",
  "scanInterval": 10,
  "enableHap": true,
  "enableMatter": true,
  "devices": []
}

devices is optional. Leave it empty to expose all supported FP10 purifiers on the account, or add specific Dreame did values to limit discovery.

Matter

Homebridge 2 Matter support is opt-in at the bridge level. This plugin only registers Matter accessories when:

1. enableMatter is not set to false.
2. Homebridge reports that Matter is enabled for this bridge through api.isMatterEnabled().

For a child bridge, enable Matter in the platform _bridge config. For the main bridge, enable it in the top-level bridge config. Homebridge publishes the Matter pairing code/QR during startup.

The Matter accessory is registered as AirPurifier when Homebridge exposes that Matter device type, with a fallback to Fan. It publishes clusters for on/off, fan control, air quality, PM2.5, TVOC, temperature, humidity, HEPA filter and activated carbon filter monitoring.

HAP Mapping

| FP10 feature | HomeKit/HAP service | | --- | --- | | Power | AirPurifier.Active | | Auto/manual target | AirPurifier.TargetAirPurifierState | | Manual speed 1-10 | AirPurifier.RotationSpeed in 10% steps | | Child lock | AirPurifier.LockPhysicalControls | | PM2.5 / TVOC / quality | AirQualitySensor | | Temperature | TemperatureSensor | | Humidity | HumiditySensor | | HEPA life | FilterMaintenance |

Setting rotation speed immediately switches the FP10 to manual mode locally, then the next poll reconciles with the purifier's real cloud state.

Development

npm install
npm run build
npm link
homebridge -D

To use a separate dev Homebridge directory:

homebridge -D -U ~/.homebridge-dev