IKEA VINDSTYRKA Zigbee Air quality sensor

jurgen2005 · April 14, 2023, 6:54pm

To get more frequent updates, install zha_toolkit

alias: Update vindstyrka
description: fijnstof update
trigger:
  - platform: time_pattern
    seconds: "30"
condition: []
action:
  - service: zha_toolkit.attr_read
    data:
      ieee: sensor.ikea_of_sweden_vindstyrka_particulate_matter
      use_cache: false
      force_update: true
      endpoint: 1
      cluster: 1066
      attribute: 0
mode: single

pachi · April 15, 2023, 4:37pm

Hi!
This is working great!
Do you think that there‘s any chance to use zha_toolkit for accessing the tVOC measurement cluster?
This could be a workaround until ZHA implements the pull request…

donny007x · April 15, 2023, 8:08pm

Unfortunately it’s turning out to be a bit more complicated to implement this into ZHA. The VOC attribute is not actively reported by the device and thus needs to be actively polled by ZHA, which complicates stuff.

Also there seems to be some issue with the unit, the SensorDeviceClass.VOLATILE_ORGANIC_COMPOUNDS expects a specific unit, but since this “VOC index” is some manufacturer specific thing it doesn’t really have one.

Figuring out how ZHA actually works and how this stuff is all integrated into HA is going to take some more time. The developer documentation for HA core is OK, but figuring out how ZHA works with the quirks stuff and zigpy library is pretty much a reverse-engineering effort

dyczek · April 17, 2023, 10:29am

Hi
This is great news!
How often the device sends data to HA?
How about accuracy for temperature? According to your screenshots, it doesn’t look like it is decimal.

Thank you.

diplix · April 18, 2023, 7:56am

thats not accurate, the VOC index cluster pushes values just as the PM2.5 cluster does. working great for me with zigbee2mqtt since over 2 months,

the VOC values are indeed no real VOC values, but a „VOC index“ that is sensirion specific (the manufacturer of the build in sensor). it shows values between 0 and 500; you can read about it here: https://sensirion.com/media/documents/02232963/6294E043/Info_Note_VOC_Index.pdf

donny007x · April 18, 2023, 3:41pm

The value not updating is a ZHA specific issue, other Zigbee libraries/brokers indeed have no problem seeing it. You can read up on the discussion in the pull request: Add support for IKEA VINDSTYRKA Air quality Sensor by just-oblivious · Pull Request #2315 · zigpy/zha-device-handlers · GitHub

As for the unit: I currently have the sensor defined as class SensorDeviceClass.VOLATILE_ORGANIC_COMPOUNDS without a unit specified; this causes HA to log a warning about missing units. It’s a minor hurdle to overcome, but one that needs to be addressed.

BikingViking · April 22, 2023, 1:33pm

Indeed, I was set on buying one until I noticed this. I was hoping it could replace the simple room temperature sensor I have for my radiators, but it really should have 0.1° resolution to work well for that, at least for the data reported over Zigbee. (I could live with whole numbers on the display.) I’m not so optimistic it’s possible, but if there’s a way to change it to 0.1° resolution, I’d love to hear about it!

Mitch92666 · April 23, 2023, 7:10pm

I’m hoping for the same!

BrotherEstapol · April 24, 2023, 12:05pm

I’m just using the ZHA integration, and all I can get from it is the Temp and Humidity.

Am I reading the comments right that the only way to get the VOC and PM2.5 readings in HA at the moment is via Deconz or Zigbee2mqtt?

hneel · April 29, 2023, 8:53am

Does this work with the old Trådfri hub?
(As I have no other zigbee devices at the moment (yet))

jonixx · May 15, 2023, 10:05am

I got this to kind of work for my purposes with the help given in this thread.

There most certainly is a better way to do this. Perhaps someone more experienced could help to improve this method. I’m a beginner with YAML and HA

Install ZHA toolkit from HACS
Create a template sensor

    #template for the IKEA TVOC kitchen
  - platform: template
    sensors:
      keittio_ilmanlaatu_tvoc:
        friendly_name: "Keittiö ilmanlaatu TVOC"
        unit_of_measurement: "TVOC index"
        icon_template: mdi:weather-dust
        value_template: ""

Create a automation that calls ZHA Toolkit: attr_read service once a minute and set it to write the value to state_id previously created

alias: Read keittiö TVOC
description: Use ZHA_toolkit
trigger:
  - platform: time_pattern
    seconds: "0"
    minutes: "/1"
condition: []
action:
  - service: zha_toolkit.attr_read
    data:
      ieee: <censored>
      endpoint: 1
      cluster: 64638
      attribute: 0
      manf: 4476
      state_id: sensor.keittio_ilmanlaatu_tvoc
mode: single

With this method I’m able to get some values to HA. I’m really not sure how the template sensor should be created for this use case where ZHA toolkit writes the value Without the state_id

I’ve edited this post to correct some of my original mistakes

Digitalhour · May 16, 2023, 1:27pm

works like a charm…

donny007x · June 18, 2023, 10:53am

I started reversing the way IKEA implements the SEN54 sensor in VINDSTYRKA, as they seem to be doing some funky processing on raw and undocumented values…

The way ESPHome implements this sensor yields different (inaccurate!) results for temperature/humidity when compared to the values reported by VINDSTYRKA (as reported here: IKEA Vindstyrka & ESPHome Integration - #4 by Laess3r).

I hope to come up with some sort of compensation value/slope that can be used to correct the sensor output.

Docs:

Cnecne59 · June 28, 2023, 8:18pm

I am a bit confused. Where have i to put this code?
I am a bloody newby, so perhaps i ask something ridiculous
Greatings
Christoph

Fuzzysteve · June 30, 2023, 12:34pm

It’s an automation.

if you have zha toolkit installed GitHub - mdeweerd/zha-toolkit: 🧰 Zigbee Home Assistant Toolkit - service for "rare" Zigbee operations using ZHA on Home Assistant then you can go to automations and create it.
Or you can add it to the appropriate yaml file.

fossorial · July 7, 2023, 7:50pm

Has anyone had any luck contacting IKEA about technical specs of this device beyond those in the ‘assembly’ document? Specifically, I am trying to figure out what type of PM2.5 sensor is being used–I am most familiar with Plantower laser sensors but this one appears to be different.

donny007x · July 12, 2023, 8:28pm

As mentioned before, IKEA VINDSTYRKA contains a Sensirion SEN54 sensor module. There is plenty of documentation available on the website of the manufacturer: Smart sensor solutions.

digittante · August 20, 2023, 11:55pm

Great post, thank you.

I’m new to IKEA smart home products, and wondering if I can add a Vindstyrka to my HA ecosystem by itself, or must I also add their Dirigera hub?

Thanks again.

johnehowe · August 31, 2023, 4:23pm

You can add it as a Zigbee device either with ZHA or Zigbee2MQTT. You will obtain Temp, Humidity and PM2.5 data from the unit into HA. However, as this thread defines, there is an issue with obtaining the VOC index in ZHA which is an issue that I have. Apparently it works with Z2MQTT but I have not gone there. I am a ZHA user.

I am hoping for a resolution in the VOC index as my intention is to use my IKEA unit in a 3D Print Enclosure to control carbon filtration blowers installed in the enclosure.

chendo · September 10, 2023, 7:57am

This is my automation to poll for updates every 15 seconds from multiple sensors, and does not require modifying quirks or patching HASS. Hope this is useful!

Edited to add allow_create: true and removed duplicate attr_read.
Edit: Turns out manf is critical when quirks aren’t set.

alias: "Climate: Fetch AQI data"
mode: single
description: poll for AQI data
trigger:
  - platform: time_pattern
    seconds: "/15"
condition: []
action:
  - parallel:
      - repeat:
          for_each: # list your sensors here
            - lounge_aqi
            - office_aqi
            - balcony_aqi
            - bathroom_aqi
          sequence:
            - service: zha_toolkit.attr_read
              data:
                ieee: sensor.{{ repeat.item }}_particulate_matter
                endpoint: 1
                manf: 4476
                cluster: 1066
                attribute: 0
                state_id: sensor.{{ repeat.item }}_particulate_matter
                allow_create: true
            - service: zha_toolkit.attr_read
              data:
                ieee: sensor.{{ repeat.item }}_particulate_matter # Intentional, because the VOC index parameter may not exist
                endpoint: 1
                manf: 4476
                cluster: 64638
                attribute: 0
                state_id: sensor.{{ repeat.item }}_voc_index
                allow_create: true