Support for AirVisual's Outdoor Unit?

Was wondering if there was any support for the AirVisual Outdoor unit? AirVisual Series I don’t see that the current integration pulls any other information from the Pro unit that the indoor information, and I don’t see an option to include more than the one unit.


It would would be great to see integration of the Outdoor unit.
At the moment I’m trying to get the info from the published data via API, but that’s also not yet working for me.

edit 12-12-2022: via online API is working. But I only get Air Quality Index. I really would love to get the temperature/humidity/pressure data.
I reached out to AirVisual, but it seems not possible to acquire this data from the unit directly.

just ordered Outdoor unit, so there is no way to get the particulate value in HA ?

It seems so. I really hope some one can reverse engineer the Outdoor unit so the data can be acquired by HA.
It’s a shame that the Outdoor unit cannot be reached like the indoor unit…

The outdoor unit seems perfect, PoE powered and hardwired for data! Does anyone know if the new AirVisual Pro integration would pick up the data if we used the Pro+Outdoor combo? Maybe @bachya knows as the author of the integration? :pray:

(My hope is that the samba data on the Pro unit includes data from the Outdoor one…)

1 Like

Not sure how I missed that thread, thank you! Doesn’t seem clear if outdoor unit has Samba or not, so maybe I will take the chance.

Hi All - Did anyone ever get this to work? I have an outdoor unit, but not an indoor pro unit.

It is my understanding that the indoor pro unit has the ability to show on its LCD screen the outdoor unit’s values. If this is correct - then does it mean that if you setup the HA integration with the Indoor Pro unit AND you have an outdoor unit, that you can then show the outdoor unit’s data in HA?

If I buy an indoor unit too will it fix my problem?

Is the SAMBA password for the outdoor unit printed somewhere on the unit itself?

The Indoor unit reads the Outdoor unit and makes some of the information available in its own history files. That means that if someone owns both units, they can read the AQI from the outside unit with the inside one.

Once I figured out that was possible I made a pull request to add support to the integration for using this, and that PR was merged in today. The good news is that this sensor will show up for people with both units after the next release.

The bad news is that this is only a subset of data, and not everyone owns both units. The only way to get all of the data off of the outdoor unit is via the SMB share, but there’s no way to get that password. Everyone who owns one of these units should contact IQAir and ask them to make this password retrievable from their app.


Thanks for doing this! I managed to get the Outdoor AQI from the updated integration. But… yeah, it would be nice to get the other data.

There is an integration to access the rest API, AirVisual Cloud - Home Assistant, and I have installed that. But among other issues you have to get a new key annually. It also does not give detailed data, just the AQI, the pollution “level” (e.g. Good) and the main pollutant (but not the amount), so not much more than the above.

For local access to raw data I see two possibilities: 1. get a SAMBA key for direct access to the device (or whatever, it may or may not be using SAMBA) e.g. from the app or from the Pro’s display 2. ask AirIQ to mirror all the data on the Pro.

I think 2 would be a straightforward extension and would work fine, but AirIQ has to do it (I have done my duty by sending a request, for either of these options; 2 would also not require exposing a second password). As for 1: We just need the password. SAMBA is not an especially secure protocol… but that seems like a last resort.

There is another “device” API with share codes etc. available via the AirIQ dashboard. Unlike the API used by the above “cloud” integration, this does seem to give actual device data. The dashboard is here:

Update: device API apparently available to corporate or enterprise plans only. Ugh. It’s my device, I should be able to access my own data…