search

BoschSmartHome / bosch-shc-api-docs

Bosch Smart Home Controller Local REST API
Other
208 stars 44 forks source link

More information about the provided device data #40

Open coeing opened 3 years ago

coeing commented 3 years ago

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?

hxmelab commented 3 years ago

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!

coeing commented 3 years ago

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.