Skip to content

Updated DDF for IKEA STARKVIND Air Purifier #7248

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
Sep 26, 2023
Merged

Updated DDF for IKEA STARKVIND Air Purifier #7248

merged 4 commits into from
Sep 26, 2023

Conversation

ebaauw
Copy link
Collaborator

@ebaauw ebaauw commented Sep 17, 2023

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