[Device support] IKEA STARKVIND

[smartmatic]

Please use the template and fill in all the data requested below!

Describe the bug
I've installed the latest zigbee2mqtt release 1.22.1 and with this release the IKEA STARKVIND Air Purifier is fully supported and can fully controlled within zigbee2mqtt.

https://www.zigbee2mqtt.io/devices/E2007.html#ikea-e2007

It is is not possible to switch the Air Purifier on or off or change the fan mode as only the Air Quality information is displayed in Homebridge

Related devices
https://www.zigbee2mqtt.io/devices/E2007.html#ikea-e2007

To Reproduce
Add device to zigbee2mqtt and try to control the device via Homebridge

Expected behavior
My expectation was to get at least two Homebridge Devices. One for the Air Purifier and one for the Air Quality but Homebridge shows only the Air Quality Sensor. Therefore it is is not possible to switch the Air Purifier on or off or change the fan mode.

MQTT messages
If possible (and applicable), please provide the following:

Versions used
Please provide the version of the following pieces of software:

• Plugin version: v1.6.1
• Homebridge: 1.3.8
• Homebridge Config UI X: v4.41.3

[itavero]

This is not a bug. Fans are not supported at the moment. Even on the page for this device it only shows the Air Quality Sensor.
I do wonder if the PM10 is correct though. I thought it had a PM2.5 sensor.

Based on the issue template for Device support, please provide the following:

• device model (also known as exposes information) for this particular device, as published to zigbee2mqtt/bridge/devices by Zigbee2MQTT.
• describe the features/functionality of this device that are currently not exposed to HomeKit via this plugin.

For each of the missing features, please mention to which HomeKit Services and Characteristics it should be mapped.
The Homebridge Plugin Development documentation provides a nice overview of the standard HomeKit services and characteristics.
Note that some manufacturers also use custom services and characteristics (the Elgato Eve products for instance), which could also be mimicked if they have been reverse engineered.

[smartmatic]

page for this device

I am a bit confused about your answer. What do you exactly mean with Fans are not supported a the moment?
Not supported through this plugin?

My current understanding from this plugin is that all devices listed here https://zigbee.blakadder.com and marked with zigbee2mqtt should be available through this plugin here.
Please correct me if this expectation and common understanding is wrong?

The current zigbee2mqtt integration fully supports all functionalities which the IKEA STARKVIND offers. The full integration is described here: https://www.zigbee2mqtt.io/devices/E2007.html#ikea-e2007

I observed that it is currently not possible to activate and deactivate the device and also not to control the fan with this plugin. But with FHEM in the background and appropriate homebridge mappings i am able to nearly fully control the STARKVIND except the Child Lock. But i can switch on and off the device and i change the fan speed with Apple Home App.

I used the following Homekit services and characteristics
Homekit Service: Air Purifier
Active
Current Air Purifier State
Target Air Purifier State
Rotation Speed

Homekit Service: AirQualitySensor
Air Quality

The IKEA STARKVIND provides PM2.5 density

Hope that helps in a first step?

[itavero]

Not all devices that are supported by Zigbee2MQTT, are supported homebridge-z2m.
That site only shows compatibility with Zigbee2MQTT.

Can you also add the exposes info for the device?

[itavero]

Generated exposes info:

[
  {
    "type": "fan",
    "features": [
      {
        "type": "binary",
        "name": "state",
        "property": "fan_state",
        "access": 7,
        "value_on": "ON",
        "value_off": "OFF",
        "description": "On/off state of this fan"
      },
      {
        "type": "enum",
        "name": "mode",
        "property": "fan_mode",
        "access": 7,
        "values": [
          "off",
          "auto",
          "1",
          "2",
          "3",
          "4",
          "5",
          "6",
          "7",
          "8",
          "9"
        ],
        "description": "Mode of this fan"
      }
    ]
  },
  {
    "type": "numeric",
    "name": "fan_speed",
    "property": "fan_speed",
    "access": 5,
    "value_min": 0,
    "value_max": 9,
    "description": "Current fan speed"
  },
  {
    "type": "numeric",
    "name": "pm25",
    "property": "pm25",
    "access": 5,
    "unit": "µg/m³",
    "description": "Measured PM2.5 (particulate matter) concentration"
  },
  {
    "type": "enum",
    "name": "air_quality",
    "property": "air_quality",
    "access": 5,
    "values": [
      "excellent",
      "good",
      "moderate",
      "poor",
      "unhealthy",
      "hazardous",
      "out_of_range",
      "unknown"
    ],
    "description": "Measured air quality"
  },
  {
    "type": "binary",
    "name": "led_enable",
    "property": "led_enable",
    "access": 7,
    "value_on": true,
    "value_off": false,
    "description": "Enabled LED"
  },
  {
    "type": "binary",
    "name": "child_lock",
    "property": "child_lock",
    "access": 7,
    "value_on": "LOCK",
    "value_off": "UNLOCK",
    "description": "Enables/disables physical input on the device"
  },
  {
    "type": "binary",
    "name": "replace_filter",
    "property": "replace_filter",
    "access": 5,
    "value_on": true,
    "value_off": false,
    "description": "Filter is older than 6 months and needs replacing"
  },
  {
    "type": "numeric",
    "name": "linkquality",
    "property": "linkquality",
    "access": 1,
    "unit": "lqi",
    "description": "Link quality (signal strength)",
    "value_min": 0,
    "value_max": 255
  }
]

[itavero]

Looking at the exposes information, there's no way to "see" that this is an air purifier. It exposes itself as a fan.

Unfortunately the fan_modes are slightly different than other fans supported by Zigbee2MQTT, but I guess I can work around that.

[itavero]

replace_filter can be exposed as a Filter Maintenance service.

[stale]

It appears that this issue did not have an update in quite some time. Please check if you can provide any additional information to help resolve this issue. If there isn't any activity in the next two weeks, this issue will be closed automatically. Thank you for your contributions!