homebridge-philips-airplus-cloud 0.0.0-stage → 0.3.0

package/CHANGELOG.md

@@ -0,0 +1,23 @@
+# Changelog — Homebridge plugin
+
+The Home Assistant integration in `custom_components/` is unchanged from upstream and keeps its own history.
+
+## 0.3.0 — 2026-10-11
+
+- Published on npm as `homebridge-philips-airplus-cloud` (the name `homebridge-philips-airplus` belongs to an unrelated humidifier plugin). Installs from the earlier `.tgz` or git builds were named `homebridge-philips-airplus`: uninstall that first.
+- Option `sleepSwitchStyle: "purifier"`: Sleep shown as a second air purifier (purifier icon in Home), linked to the main one.
+- Diagnostics option `logDeviceData`: logs every port and the cloud shadow the purifier publishes.
+- Display light also detected on `D03104` (0/115/123); manual override with `displayLightProperty`.
+- Sleep, Display, Air Quality and filter services are linked to the purifier with short labels, so Home shows them as labelled controls inside the purifier.
+
+## 0.2.0 — 2026-10-11
+
+- Sleep mode switch.
+- Display light as a dimmable light when the purifier reports it.
+- Speed slider back to 0–100 %, one band per manual mode (the Home app always shows it as a percentage).
+
+## 0.1.0 — 2026-10-10
+
+- First version: email + code login (Homebridge UI panel or `philips-airplus-login`), automatic token refresh, MQTT over the Philips/Versuni cloud.
+- HomeKit Air Purifier (power, Auto/Manual, speed), Air Quality Sensor (PM2.5), Filter Maintenance for filter and pre-filter with reset.
+- Device definitions read from the shared `models.yaml`.

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025-2026 ShorMeneses (https://github.com/ShorMeneses/philips-airplus-homeassistant)
+Portions copyright (c) 2026 Markus Stephany
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,127 @@
-# Temporary Holding Version
+# homebridge-philips-airplus-cloud
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Homebridge plugin for **Philips Air+** air purifiers (AC0650, AC0651, AC1715, PureProtect 3200i and others in the same family). It brings them into Apple Home through the Philips/Versuni **cloud**, with the same MQTT protocol used by the official Air+ app and Google Home. No local connection, IP address or port forwarding is needed.
+
+## A Homebridge port of a Home Assistant integration
+
+This repository is a fork of [NikGro/philips-air-plus-homeassistant](https://github.com/NikGro/philips-air-plus-homeassistant), a Home Assistant integration that is itself based on [ShorMeneses/philips-airplus-homeassistant](https://github.com/ShorMeneses/philips-airplus-homeassistant). The fork ports that integration to Homebridge:
+
+- the cloud protocol (email + code login, token refresh, MQTT over WebSocket with the AWS custom authorizer) is re-implemented in Node.js in `src/`;
+- device definitions are **not** duplicated: the plugin reads the same `custom_components/philips_airplus/models.yaml` as the Home Assistant integration, so modes and property keys stay in sync with upstream;
+- the Home Assistant integration in `custom_components/` is kept unchanged from upstream so the two can be merged easily. If you use Home Assistant, install it from [the upstream repository](https://github.com/NikGro/philips-air-plus-homeassistant) instead.
+
+## What you get in HomeKit
+
+One accessory per purifier with:
+
+- **Air Purifier** — on/off, Auto/Manual, and a speed slider split into one band per manual mode of your model (e.g. 0–33% Sleep, 34–66% Medium, 67–100% Turbo on the AC0651/10); it snaps to the band after each change. Switching back to Manual restores the last manual speed.
+- **Sleep switch** — turns Sleep mode on; turning it off returns to Auto.
+- **Display light** — the purifier's display/LED as a dimmable light. It appears after the purifier first reports its light setting (property `D03104`, `D03105` or `D0312D`); devices with three light levels are detected automatically.
+- **Air Quality Sensor** — PM2.5 (µg/m³) and a HomeKit air-quality level derived from it.
+- **Filter Maintenance** — main filter and pre-filter (cleaning), with life level, change alert (below 10% by default) and reset from the Home app. The reset writes the same value the official app does.
+
+State changes arrive in real time over MQTT; a status poll runs every 120 s as a safety net.
+
+## Install
+
+Search for **Philips Air+ cloud** in Homebridge UI → Plugins and install it, or from a terminal:
+
+```bash
+# Homebridge Raspberry Pi image / hb-service (Homebridge UI → ⋮ → Terminal)
+cd /var/lib/homebridge
+npm install homebridge-philips-airplus-cloud
+
+# global npm install of Homebridge
+sudo npm install -g homebridge-philips-airplus-cloud
+```
+
+Then restart Homebridge. Node 18.17 or newer and Homebridge 1.6+ (including 2.0 betas) are supported.
+
+To try the latest unreleased code, install from GitHub instead: `npm install git+https://github.com/Micheledipaola/homebridge-philips-airplus.git`.
+
+Homebridge does not need to be on the same network as the purifier: everything goes through the Philips cloud.
+
+> The npm package is called `homebridge-philips-airplus-cloud` because `homebridge-philips-airplus` is an unrelated plugin for Philips Air+ humidifiers.
+
+## Log in
+
+1. Homebridge UI → Plugins → **Philips Air+** → Settings.
+2. Enter the email of your Philips account (Air+ or HomeID app) and press **Send code**.
+3. Type the code from the email and press **Log in**. The panel lists the purifiers it found and saves the login.
+4. Restart Homebridge.
+
+Every purifier in the account is added. To pick only some, or to rename them, fill in **Devices** with the UUIDs shown after login.
+
+Without Homebridge UI, run the login from a shell and paste the printed block into the `platforms` array of `config.json`:
+
+```bash
+philips-airplus-login you@example.com
+```
+
+```json
+{
+  "platform": "PhilipsAirPlus",
+  "name": "Philips Air+",
+  "email": "you@example.com",
+  "refreshToken": "…",
+  "clientId": "-XsK7O6iEkLml77yDGDUi0ku",
+  "userId": "…"
+}
+```
+
+The refresh token rotates on every use; the plugin keeps the current one in `<homebridge storage>/philips-airplus/`. If the Philips login ever expires, the log says so: log in again from the settings panel and restart.
+
+## Options
+
+| Key | Default | Meaning |
+|---|---|---|
+| `devices` | all | `[{ "uuid": "…", "name": "…", "model": "AC0651/10" }]` — pick/rename devices; `model` is only needed if auto-detection fails |
+| `airQualitySensor` | `true` | Show the PM2.5 sensor |
+| `filterSensors` | `true` | Show filter and pre-filter status |
+| `sleepSwitch` | `true` | Show the Sleep mode switch |
+| `sleepSwitchStyle` | `switch` | `purifier` shows the Sleep control as a second air purifier (purifier icon in Home) that only turns Sleep on/off |
+| `displayLight` | `true` | Show the display light |
+| `displayLightProperty` | — | Property key of the display light, if it is not detected (see the `Status properties reported by the device` log line) |
+| `logDeviceData` | `false` | Diagnostics: at startup, log every port and the cloud shadow the purifier publishes |
+| `filterChangeThreshold` | `10` | Filter life (%) at or below which HomeKit shows "replace filter" |
+| `pollInterval` | `120` | Seconds between safety-net status polls |
+
+## Running alongside Home Assistant or the app
+
+Each client uses its own MQTT client id (`…_hb` for Homebridge, `…_ha` for Home Assistant), so the Air+ app, Home Assistant and Homebridge can all stay connected at the same time.
+
+## Notes
+
+- Tested on an AC0651/10. The other models in `models.yaml` use the same protocol but have not been tried with Homebridge yet — reports are welcome.
+- The AC0651/10 does not expose its display brightness through the cloud (the Philips app has no control for it either; the display turns off by itself in Sleep), so no Display control appears for it.
+- Models not in `models.yaml` still get on/off, PM2.5 and filters, and a warning in the log; modes need a `models.yaml` entry.
+- The AC3221 (PureProtect 3200i) mapping is unverified (see below), and so is its speed order in HomeKit.
+- `npm test` runs the plugin tests (protocol, HomeKit mapping, login flow with a mocked cloud).
+
+## Models
+
+Model support comes from `models.yaml`:
+
+| Model | Modes | Air quality |
+|-------|-------|-------------|
+| AC0650/10 | Auto, Sleep, Turbo | PM2.5 |
+| AC0651/10 | Auto, Medium, Sleep, Turbo | PM2.5 (allergen index not shown in HomeKit) |
+| AC1715/11 | Auto, Medium, Sleep, Fast, Turbo | PM2.5 |
+| AC1715/70 | Auto, Medium, Sleep, Fast, Turbo | PM2.5 |
+| AC3221 (PureProtect 3200i) | Auto, Speed 1–5, Sleep, Medium, Turbo | PM2.5 (mapping unverified upstream) |
+
+New models are added with an entry in `models.yaml`, with no code changes, and then work in both Homebridge and Home Assistant. The cloud property keys (`D03xxx`/`D05xxx`) follow the same scheme as the local CoAP API documented by [kongo09/philips-airpurifier-coap](https://github.com/kongo09/philips-airpurifier-coap).
+
+## Credits
+
+The protocol work comes from the Home Assistant integration this plugin is ported from. Thanks to:
+- @ShorMeneses — original cloud/MQTT integration this fork is based on
+- @vkostakos
+- @markusstephany
+- @renaudallard — the email OTP authentication flow is adapted from the [Philips HomeID integration](https://github.com/renaudallard/homeassistant_philips_homeid)
+- @rgpublic — AC1715/11 model configuration
+- @NikGro — PureProtect 3200i (AC3221) mapping and the email + code onboarding
+
+## License
+
+Released under the MIT License, like the integration it is based on. See LICENSE.

package/bin/philips-airplus-login.js

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+'use strict';
+
+// Command-line login for setups without Homebridge UI: asks for the email and
+// the verification code, then prints the platform block for config.json.
+
+const readline = require('node:readline/promises');
+const { LoginSession } = require('../src/cloud');
+
+(async () => {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stderr });
+  try {
+    const email = (process.argv[2] || (await rl.question('Philips account email: '))).trim();
+    const s = new LoginSession({ log: (m) => console.error(`  ${m}`) });
+    await s.sendCode(email);
+    const code = await rl.question(`Code sent to ${email}. Enter it: `);
+    await s.verifyCode(code);
+    const r = await s.completeLogin();
+
+    console.error(`\nLogged in. Purifiers in the account:`);
+    for (const d of r.devices) console.error(`  - ${d.name} [${d.model || '?'}] ${d.uuid}`);
+    if (!r.devices.length) console.error('  (none found — add "devices": [{ "uuid": "..." }] by hand)');
+
+    console.error('\nAdd this to the "platforms" array of your Homebridge config.json:\n');
+    console.log(
+      JSON.stringify(
+        { platform: 'PhilipsAirPlus', name: 'Philips Air+', email, refreshToken: r.refreshToken, clientId: r.clientId, userId: r.userId },
+        null,
+        2,
+      ),
+    );
+  } catch (e) {
+    console.error(`\nLogin failed: ${e.message}`);
+    process.exitCode = 1;
+  } finally {
+    rl.close();
+  }
+})();

package/config.schema.json

@@ -0,0 +1,172 @@
+{
+  "pluginAlias": "PhilipsAirPlus",
+  "pluginType": "platform",
+  "singular": true,
+  "customUi": true,
+  "headerDisplay": "Philips Air+ purifiers through the Philips cloud (same protocol as the Air+ app and Google Home). Log in with the email of your Philips account; a verification code will be sent there.",
+  "schema": {
+    "type": "object",
+    "properties": {
+      "name": {
+        "title": "Name",
+        "type": "string",
+        "default": "Philips Air+",
+        "required": true
+      },
+      "email": {
+        "title": "Philips account email",
+        "type": "string",
+        "description": "For reference only — log in from the panel above."
+      },
+      "refreshToken": {
+        "title": "Refresh token",
+        "type": "string",
+        "description": "Filled in automatically by the login panel (or by the philips-airplus-login command)."
+      },
+      "clientId": {
+        "title": "OAuth client id",
+        "type": "string",
+        "description": "Filled in automatically. Air+ app client unless your account only works with the HomeID app."
+      },
+      "userId": {
+        "title": "User id",
+        "type": "string"
+      },
+      "devices": {
+        "title": "Devices",
+        "description": "Leave empty to add every purifier in the account. Add entries to pick devices or rename them.",
+        "type": "array",
+        "items": {
+          "type": "object",
+          "properties": {
+            "uuid": {
+              "title": "Device UUID",
+              "type": "string",
+              "required": true
+            },
+            "name": {
+              "title": "Name in HomeKit",
+              "type": "string"
+            },
+            "model": {
+              "title": "Model (optional)",
+              "type": "string",
+              "description": "e.g. AC0651/10. Normally detected automatically."
+            }
+          }
+        }
+      },
+      "airQualitySensor": {
+        "title": "Show air quality sensor (PM2.5)",
+        "type": "boolean",
+        "default": true
+      },
+      "filterSensors": {
+        "title": "Show filter and pre-filter status",
+        "type": "boolean",
+        "default": true
+      },
+      "sleepSwitch": {
+        "title": "Show a Sleep mode switch",
+        "type": "boolean",
+        "default": true
+      },
+      "sleepSwitchStyle": {
+        "title": "Sleep control style",
+        "type": "string",
+        "default": "switch",
+        "oneOf": [
+          {
+            "title": "Switch",
+            "enum": [
+              "switch"
+            ]
+          },
+          {
+            "title": "Air purifier (purifier icon)",
+            "enum": [
+              "purifier"
+            ]
+          }
+        ],
+        "description": "'Air purifier' shows Sleep with the purifier icon in the Home app; it only turns Sleep mode on and off."
+      },
+      "displayLight": {
+        "title": "Show the display light as a dimmable light",
+        "type": "boolean",
+        "default": true,
+        "description": "Appears once the purifier reports its light setting."
+      },
+      "displayLightProperty": {
+        "title": "Display light property (advanced)",
+        "type": "string",
+        "placeholder": "D03105",
+        "description": "Only if the light does not appear: the property key that holds the light setting, as shown in the log line 'Status properties reported by the device'."
+      },
+      "filterChangeThreshold": {
+        "title": "Filter change alert below (%)",
+        "type": "integer",
+        "default": 10,
+        "minimum": 0,
+        "maximum": 50
+      },
+      "pollInterval": {
+        "title": "Status refresh interval (seconds)",
+        "type": "integer",
+        "default": 120,
+        "minimum": 30,
+        "description": "The device also pushes changes in real time; this is only a safety net."
+      },
+      "logDeviceData": {
+        "title": "Log all device data (diagnostics)",
+        "type": "boolean",
+        "default": false,
+        "description": "At startup, ask the purifier for all its ports and cloud shadow and write them to the log. Turn off again afterwards."
+      }
+    }
+  },
+  "layout": [
+    "name",
+    {
+      "type": "fieldset",
+      "title": "Account",
+      "expandable": true,
+      "expanded": false,
+      "items": [
+        "email",
+        "refreshToken",
+        "clientId",
+        "userId"
+      ]
+    },
+    {
+      "key": "devices",
+      "type": "array",
+      "title": "Devices",
+      "expandable": true,
+      "expanded": false,
+      "items": [
+        "devices[].uuid",
+        "devices[].name",
+        "devices[].model"
+      ]
+    },
+    {
+      "type": "fieldset",
+      "title": "Options",
+      "expandable": true,
+      "expanded": false,
+      "items": [
+        "airQualitySensor",
+        "filterSensors",
+        "sleepSwitch",
+        "sleepSwitchStyle",
+        "displayLight",
+        "displayLightProperty",
+        "filterChangeThreshold",
+        "pollInterval",
+        "logDeviceData"
+      ]
+    }
+  ]
+}

package/custom_components/philips_airplus/models.yaml

@@ -0,0 +1,228 @@
+# Philips Air+ Device Models Configuration
+
+models:
+  "AC0650/10":
+    name: "Philips Air+ AC0650/10"
+    modes:
+      Auto: 1
+      Sleep: 17
+      Turbo: 18
+    ports:
+      status: "Status"
+      control: "Control"
+      config: "Config"
+      filter_read: "filtRd"
+      filter_write: "filtWr"
+    properties:
+      fan_speed: "D0310C"
+      mode: "D0310C"
+      power: "D0310D"
+      filter_replace_nominal: "D05408"
+      filter_replace_remaining: "D0540E"
+      filter_clean_nominal: "D05207"
+      filter_clean_remaining: "D0520D"
+      filter_clean_reset_raw: "D0520D"
+      filter_clean_reset_value: 720      # hours written back when resetting clean-filter timer
+      filter_replace_reset_raw: "D0540E"
+      filter_replace_reset_value: 4800   # hours written back when resetting replace-filter timer
+      device_model: "ctn"
+      device_brand: "D01S04"
+      pm25: "D03221"            # PM2.5 concentration (µg/m³)
+      fan_level: "D0310D"      # Actual fan speed level (0=off, 1=slow … 18=turbo)
+    sensors:
+      - filter_replace_percentage
+      - filter_replace_hours_remaining
+      - filter_clean_percentage
+      - filter_clean_hours_remaining
+      - pm25
+      - fan_level
+    buttons:
+      - reset_filter_clean
+      - reset_filter_replace
+
+  "AC0651/10":
+    name: "Philips Air+ AC0651/10"
+    modes:
+      Auto: 0
+      Medium: 1
+      Sleep: 17
+      Turbo: 18
+    ports:
+      status: "Status"
+      control: "Control"
+      config: "Config"
+      filter_read: "filtRd"
+      filter_write: "filtWr"
+    properties:
+      fan_speed: "D0310C"
+      mode: "D0310C"
+      power: "D0310D"
+      filter_replace_nominal: "D05408"
+      filter_replace_remaining: "D0540E"
+      filter_clean_nominal: "D05207"
+      filter_clean_remaining: "D0520D"
+      filter_clean_reset_raw: "D0520D"
+      filter_clean_reset_value: 720      # hours written back when resetting clean-filter timer
+      filter_replace_reset_raw: "D0540E"
+      filter_replace_reset_value: 4800   # hours written back when resetting replace-filter timer
+      device_model: "ctn"
+      device_brand: "D01S04"
+      pm25: "D03221"            # PM2.5 concentration (µg/m³)
+      allergen_index: "D03120"  # Allergen index
+      standby_monitor: "D03134" # Sensor standby monitor (diagnostic)
+      diag_D0312C: "D0312C"    # Unknown diagnostic property (always 4 on AC0651/10)
+      fan_level: "D0310D"      # Actual fan speed level (0=off, 1=slow … 18=turbo)
+    sensors:
+      - filter_replace_percentage
+      - filter_replace_hours_remaining
+      - filter_clean_percentage
+      - filter_clean_hours_remaining
+      - pm25
+      - allergen_index
+      - fan_level
+      - diag_D0312C
+    switches:
+      - standby_monitor
+    buttons:
+      - reset_filter_clean
+      - reset_filter_replace
+
+  "AC1715/70":
+    name: "Philips Air+ AC1715/70"
+    modes:
+      Auto: 0
+      Sleep: 17
+      Medium: 1
+      Fast: 2
+      Turbo: 18
+    ports:
+      status: "Status"
+      control: "Control"
+      config: "Config"
+      filter_read: "filtRd"
+      filter_write: "filtWr"
+    properties:
+      fan_speed: "D0310C"
+      mode: "D0310C"
+      power: "D0310D"
+      filter_replace_nominal: "D05408"
+      filter_replace_remaining: "D0540E"
+      filter_clean_nominal: "D05207"
+      filter_clean_remaining: "D0520D"
+      filter_clean_reset_raw: "D0520D"
+      filter_clean_reset_value: 720
+      filter_replace_reset_raw: "D0540E"
+      filter_replace_reset_value: 4800
+      device_model: "ctn"
+      device_brand: "D01S04"
+      pm25: "D03221"
+      fan_level: "D0310D"
+    sensors:
+      - filter_replace_percentage
+      - filter_replace_hours_remaining
+      - filter_clean_percentage
+      - filter_clean_hours_remaining
+      - pm25
+      - fan_level
+    buttons:
+      - reset_filter_clean
+      - reset_filter_replace
+
+  "AC1715/11":
+    name: "Philips Air+ AC1715/11"
+    modes:
+      Auto: 0
+      Sleep: 17
+      Medium: 1
+      Fast: 2
+      Turbo: 18
+    ports:
+      status: "Status"
+      control: "Control"
+      config: "Config"
+      filter_read: "filtRd"
+      filter_write: "filtWr"
+    properties:
+      fan_speed: "D0310C"
+      mode: "D0310C"
+      power: "D0310D"
+      filter_replace_nominal: "D05408"
+      filter_replace_remaining: "D0540E"
+      filter_clean_nominal: "D05207"
+      filter_clean_remaining: "D0520D"
+      filter_clean_reset_raw: "D0520D"
+      filter_clean_reset_value: 720
+      filter_replace_reset_raw: "D0540E"
+      filter_replace_reset_value: 4800
+      device_model: "ctn"
+      device_brand: "D01S04"
+      pm25: "D03221"
+      allergen_index: "D03120"
+      fan_level: "D0310D"
+    sensors:
+      - filter_replace_percentage
+      - filter_replace_hours_remaining
+      - filter_clean_percentage
+      - filter_clean_hours_remaining
+      - pm25
+      - fan_level
+      - allergen_index
+    buttons:
+      - reset_filter_clean
+      - reset_filter_replace
+
+  "AC3221":
+    # PureProtect 3200i. Property keys are unverified against real device
+    # traffic (mapped from the equivalent CoAP "D03/D05" property scheme
+    # shared with kongo09/philips-airpurifier-coap's AC32xx family, which
+    # uses the identical D03xxx/D05xxx addressing for fan mode, PM2.5,
+    # allergen index and filter properties as the already-confirmed
+    # AC1715/AC0650 entries above). Model matching is by prefix, so any
+    # reported ctn starting with "AC3221" (e.g. "AC3221/10") picks this up.
+    # Please open an issue with debug logs if any entity reports an
+    # incorrect value so this can be corrected.
+    name: "Philips PureProtect 3200i (AC3221)"
+    modes:
+      Auto: 0
+      Speed1: 1
+      Speed2: 2
+      Speed3: 3
+      Speed4: 4
+      Speed5: 5
+      Sleep: 17
+      Turbo: 18
+      Medium: 19
+    ports:
+      status: "Status"
+      control: "Control"
+      config: "Config"
+      filter_read: "filtRd"
+      filter_write: "filtWr"
+    properties:
+      fan_speed: "D0310C"
+      mode: "D0310C"
+      power: "D0310D"
+      filter_replace_nominal: "D05408"
+      filter_replace_remaining: "D0540E"
+      filter_clean_nominal: "D05207"
+      filter_clean_remaining: "D0520D"
+      filter_clean_reset_raw: "D0520D"
+      filter_clean_reset_value: 720
+      filter_replace_reset_raw: "D0540E"
+      filter_replace_reset_value: 4800
+      device_model: "ctn"
+      device_brand: "D01S04"
+      pm25: "D03221"
+      allergen_index: "D03120"
+      fan_level: "D0310D"
+    sensors:
+      - filter_replace_percentage
+      - filter_replace_hours_remaining
+      - filter_clean_percentage
+      - filter_clean_hours_remaining
+      - pm25
+      - allergen_index
+      - fan_level
+    buttons:
+      - reset_filter_clean
+      - reset_filter_replace