Skip to content
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

[Device support] IKEA STARKVIND #333

Closed
smartmatic opened this issue Dec 3, 2021 · 15 comments
Closed

[Device support] IKEA STARKVIND #333

smartmatic opened this issue Dec 3, 2021 · 15 comments
Labels
enhancement New feature or request stale

Comments

@smartmatic
Copy link

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
@smartmatic smartmatic added the bug Something isn't working label Dec 3, 2021
@itavero
Copy link
Owner

itavero commented Dec 5, 2021

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.

@itavero itavero changed the title [Bug] IKEA STARKVIND Air Purifier only displayed as Air Quality Sensor [Devie support] IKEA STARKVIND Dec 5, 2021
@itavero itavero added enhancement New feature or request and removed bug Something isn't working labels Dec 5, 2021
@smartmatic
Copy link
Author

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
Copy link
Owner

itavero commented Dec 5, 2021

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
Copy link
Owner

itavero commented Dec 6, 2021

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 itavero changed the title [Devie support] IKEA STARKVIND [Device support] IKEA STARKVIND Dec 6, 2021
@itavero
Copy link
Owner

itavero commented Dec 6, 2021

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
Copy link
Owner

itavero commented Dec 6, 2021

replace_filter can be exposed as a Filter Maintenance service.

@itavero itavero mentioned this issue Dec 20, 2021
4 tasks
@stale
Copy link

stale bot commented Jan 11, 2022

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!

@itavero
Copy link
Owner

itavero commented Dec 15, 2022

Reopened due to duplicate issue #592 by @ComicBit.

@itavero itavero reopened this Dec 15, 2022
@itavero itavero removed the stale label Dec 15, 2022
@ComicBit
Copy link

Is it anyone gonna look trough this?

@itavero
Copy link
Owner

itavero commented Dec 20, 2022

Is it anyone gonna look trough this?

Not sure what you mean. I look through the open issues when I have time to see if there's stuff I can do with the time I think I have available. Unfortunately I don't have that much spare time on my hands currently (still need to earn a living and spend time with my family).

Main reason I reopened this one is to keep all information on one location.

@ComicBit
Copy link

Is it anyone gonna look trough this?

Not sure what you mean. I look through the open issues when I have time to see if there's stuff I can do with the time I think I have available. Unfortunately I don't have that much spare time on my hands currently (still need to earn a living and spend time with my family).

Main reason I reopened this one is to keep all information on one location.

I totally get what you mean, I just wanted to understand if it makes sense to keep it open or there are no chances of developing the integration further

@stale
Copy link

stale bot commented Feb 18, 2023

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!

@stale stale bot added the stale label Feb 18, 2023
@stale stale bot closed this as completed Mar 12, 2023
@JeanMertz
Copy link

Came here looking for this as well. Is there any way to keep "feature request" issues open, to make it easier to find them?

@ComicBit
Copy link

ComicBit commented Apr 28, 2023

Came here looking for this as well. Is there any way to keep "feature request" issues open, to make it easier to find them?

I tried to implement it myself but it's very hard and the documentation it's pretty complicated to grasp. I would love to have the full support, because as right now it's just sitting there being barely used

@JayJay-Master
Copy link

I would also be interested in being able to address the other properties via homebridge-z2m.
Maybe someone can take pity on it again and realize full support for homebridge.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request stale
Projects
None yet
Development

No branches or pull requests

5 participants