bosch-shc-api-docs icon indicating copy to clipboard operation
bosch-shc-api-docs copied to clipboard

More information about the provided device data

Open coeing opened this issue 4 years ago • 2 comments

Hi there,

We are currently preparing a binding to integrate the Bosch devices into openHAB. The documented API at https://apidocs.bosch-smarthome.com/local was very helpful for the implementation, thanks for that! :)

But I am still missing more detailed information about the specific data chunks. E.g. "purity" in the state of the AirQualityLevelService. It is a number, but is a higher number better? What is the range (0-10, 0-100,...)? Is this detailed information already documented somewhere?

coeing avatar Nov 12 '20 13:11 coeing

Hi coeing,

you are right, a range should be given in the documentation.

Afaik the range is 500 .. 5500 ppm. The higher the value, the worse is the air quality, means more volatile organic components flying through the air.

Hope that helps!

hxmelab avatar Nov 12 '20 13:11 hxmelab

Hi @hxmelab,

Thanks for the quick answer! :) This helps already. So the unit is ppm (https://en.wikipedia.org/wiki/Parts-per_notation).

Adding the ranges and units of the other values (humidity, etc.) in the public documentation would be great. That way we could add a user-friendly description of provided values in our binding.

coeing avatar Nov 12 '20 18:11 coeing