Skip to content

Foobot Binding ​

This binding fetches the Indoor Air Quality data of each of your Foobot devices from the Foobot cloud service.

To use this binding, you first need to register and get your API key. The api is rate limited to 200 calls per day. If you need a higher rate limit please contact Foobot.

Supported Things ​

The binding supports the following things:

Thing typeName
accountThe bridge with connection configuration
deviceThe sensor thing

Discovery ​

The binding requires you to have a Foobot account and an API key. The discovery process is able to automatically discover all devices associated with your Foobot account.

Bridge Configuration ​

Bridge has the following configuration parameters:

ParameterDescriptionRequired
apikeyAPI Key from https://api.foobot.io/apidoc/index.htmlMandatory
usernameThe e-mail address used to log into the Foobot AppMandatory
refreshIntervalRefresh interval in minutes, minimal 5 minutesOptional, the default value is 8 minutes.

The minimal refresh rate is 5 minutes because the device only sends data every 5 minutes. The default is 8 minutes. This will get you through the day with the default rate limit of 200 calls per day.

Channels ​

The bridge has one channel:

Channel IDItem TypeDescription
apiKeyLimitRemainingNumberThe remaining number of API requests for today

The AirQuality sensors information that is retrieved is available as these channels:

Channel IDItem TypeDescription
timeDateTimeLast time the sensor data was send to Foobot
pmNumber:DensityParticulate Matter level (ug/m3)
temperatureNumber:TemperatureTemperature in Celsius or Fahrenheit
humidityNumber:DimensionlessHumidity level (%)
co2Number:DimensionlessCarbon diOxide level (ppm)
vocNumber:DimensionlessVolatile Organic Compounds level (ppb)
gpiNumber:DimensionlessGlobal Pollution index (%)

Full Example ​

demo.things:

dsl
// Bridge configuration:
Bridge foobot:account:myfoobotaccount "Foobot Account" [apiKey="XXXXXX", username="XXXXXX", refreshInterval=8] {
  Things:
    device myfoobot "Foobot sensor" [uuid="XXXXXXXXXXXXXXXX"]

demo.items:

dsl
Number:Temperature Temperature "Temperature" <temperature> { channel="foobot:myfoobotaccount:device:myfoobot:temperature" }