Skip to content

Updated DDF for IKEA STARKVIND Air Purifier - #7248

Merged
manup merged 4 commits into
dresden-elektronik:masterfrom
ebaauw:starkvind
Sep 26, 2023
Merged

Updated DDF for IKEA STARKVIND Air Purifier#7248
manup merged 4 commits into
dresden-elektronik:masterfrom
ebaauw:starkvind

Conversation

@ebaauw

@ebaauw ebaauw commented Sep 17, 2023

Copy link
Copy Markdown
Collaborator

The air purifier uses the IKEA-specific 0xFC7D cluster for both the Air Purifier and PM2.5 density sensor features. We expose the latter as a separate resource, faking a standard 0x042A cluster.

This PR makes the following changes:

ZHAAirPurifier

  • Add productid;
  • Adjust change values in bindings to match data type.
{
  "config": {
    "filterlifetime": 259200,
    "ledindication": true,
    "locked": false,
    "mode": "auto",
    "on": true,
    "reachable": true
  },
  "ep": 1,
  "etag": "d21eaa7d4c887ebfd431ef2a85d7203a",
  "lastannounced": null,
  "lastseen": "2023-09-23T14:07Z",
  "manufacturername": "IKEA of Sweden",
  "modelid": "STARKVIND Air purifier",
  "name": "AirPurifier 141",
  "productid": "E2007",
  "state": {
    "deviceruntime": 858341,
    "filterruntime": 21843,
    "lastupdated": "2023-09-23T14:07:42.513",
    "replacefilter": false,
    "speed": 20
  },
  "swversion": "1.1.001",
  "type": "ZHAAirPurifier",
  "uniqueid": "cc:86:ec:ff:fe:6d:30:11-01-fc7d"
}

ZHAParticulateMatter

  • Change type to ZHAParticulateMatter (was ZHAAirQuality);
  • Don't read attr items, as they're already read from the ZHAAirPurifier;
  • Add productid
  • Add state/measured_value, as float value in µg/m³. Unfortunately, the sensor's granularity is limited to integer values;
  • Add corresponding cap/measured_value items. All are defined in the DDF. The min and max values are taken from the VINDSTYRKA;
  • Derive state/airquality from state/measured_value, using numtostr;
  • Deprecate state/pm2_5;
  • Delete script file starkvind_parse_pm2_5.js.
{
  "capabilities": {
    "measured_value": {
      "max": 999,
      "min": 0,
      "quantity": "density",
      "substance": "PM2.5",
      "unit": "ug/m^3"
    }
  },
  "config": {
    "on": true,
    "reachable": true
  },
  "ep": 1,
  "etag": "bbbe4c0a08efaea80d9edb22e0adc97e",
  "lastannounced": null,
  "lastseen": "2023-09-23T14:09Z",
  "manufacturername": "IKEA of Sweden",
  "modelid": "STARKVIND Air purifier",
  "name": "ParticulateMatter 142",
  "productid": "E2007",
  "state": {
    "airquality": "excellent",
    "lastupdated": "2023-09-23T14:10:00.054",
    "measured_value": 6,
    "pm2_5": 6
  },
  "swversion": "1.1.001",
  "type": "ZHAParticulateMatter",
  "uniqueid": "cc:86:ec:ff:fe:6d:30:11-01-042a"
}

@ebaauw
ebaauw marked this pull request as draft September 17, 2023 13:28
@ebaauw ebaauw added the Device Improvement Additional tag to attach to a existing issue. label Sep 17, 2023
@ebaauw ebaauw changed the title Updated DDF for IKEA STARVIND Air Purifier Updated DDF for IKEA STARKVIND Air Purifier Sep 23, 2023
@ebaauw
ebaauw requested a review from manup September 23, 2023 14:13
@ebaauw ebaauw added this to the v2.24.1-beta milestone Sep 23, 2023
@ebaauw
ebaauw marked this pull request as ready for review September 23, 2023 14:14
ebaauw added a commit to ebaauw/homebridge-deconz that referenced this pull request Sep 23, 2023
@manup
manup merged commit 7381276 into dresden-elektronik:master Sep 26, 2023
@ebaauw
ebaauw deleted the starkvind branch September 26, 2023 22:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Device Improvement Additional tag to attach to a existing issue.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants