Update Bme280 sensor component configuration (#7406)

This commit is contained in:
Klaas Schoute 2018-11-07 08:42:18 +01:00 committed by Fabian Affolter
parent 05c58e6fee
commit f7499b966f

View File

@ -13,7 +13,6 @@ ha_release: 0.48
ha_iot_class: "Local Push" ha_iot_class: "Local Push"
--- ---
The `bme280` sensor platform allows you to read temperature, humidity and pressure values of a [Bosch BME280 Environmental sensor](https://cdn-shop.adafruit.com/datasheets/BST-BME280_DS001-10.pdf) connected via [I2c](https://en.wikipedia.org/wiki/I²C) bus (SDA, SCL pins). It allows you to use all the operation modes of the sensor described in its datasheet. The `bme280` sensor platform allows you to read temperature, humidity and pressure values of a [Bosch BME280 Environmental sensor](https://cdn-shop.adafruit.com/datasheets/BST-BME280_DS001-10.pdf) connected via [I2c](https://en.wikipedia.org/wiki/I²C) bus (SDA, SCL pins). It allows you to use all the operation modes of the sensor described in its datasheet.
Tested devices: Tested devices:
@ -30,19 +29,63 @@ sensor:
- platform: bme280 - platform: bme280
``` ```
Configuration variables: {% configuration %}
name:
- **name** (*Optional*): The name of the sensor description: The name of the sensor.
- **i2c_address** (*Optional*): I2c address of the sensor. It is 0x76 or 0x77. required: false
- **i2c_bus** (*Optional*): I2c bus where the sensor is. Defaults to 1, for Raspberry Pi 2 and 3. default: BME280 Sensor
- **operation_mode** (*Optional*): Power mode for the sensor. Use 2 for forced mode or 3 for normal mode. Defaults to normal mode. type: string
- **time_standby** (*Optional*): Standby time in ms for normal mode of operation as described in the sensor datasheet. Defaults to 5 ms. i2c_address:
- **oversampling_temperature** (*Optional*): Oversampling multiplier as described in the sensor datasheet. Can be 0 (no sampling), 1, 2, 4, 8, or 16. Default is 1. description: I2c address of the sensor. It is 0x76 or 0x77.
- **oversampling_pressure** (*Optional*): Oversampling multiplier as described in the sensor datasheet. Can be 0 (no sampling), 1, 2, 4, 8, or 16. Default is 1. required: false
- **oversampling_humidity** (*Optional*): Oversampling multiplier as described in the sensor datasheet. Can be 0 (no sampling), 1, 2, 4, 8, or 16. Default is 1. default: 0x76
- **filter_mode** (*Optional*): IIR filter coeficient as described in the sensor datasheet. Default is 0, for filter off. type: string
- **delta_temperature** (*Optional*): Absolute delta for temperature correction. i2c_bus:
- **monitored_conditions** array (*Optional*): Conditions to monitor. Available conditions are *temperature*, *humidity* and *pressure*. By default all three are displayed. description: I2c bus where the sensor is.
required: false
default: 1, for Raspberry Pi 2 and 3.
type: integer
operation_mode:
description: Power mode for the sensor. Use 2 for forced mode or 3 for normal mode.
required: false
default: 3
type: integer
time_standby:
description: Standby time in ms for normal mode of operation as described in the sensor datasheet.
required: false
default: 5
type: integer
oversampling_temperature:
description: Oversampling multiplier as described in the sensor datasheet. Can be 0 (no sampling), 1, 2, 4, 8, or 16.
required: false
default: 1
type: integer
oversampling_pressure:
description: Oversampling multiplier as described in the sensor datasheet. Can be 0 (no sampling), 1, 2, 4, 8, or 16.
required: false
default: 1
type: integer
oversampling_humidity:
description: Oversampling multiplier as described in the sensor datasheet. Can be 0 (no sampling), 1, 2, 4, 8, or 16.
required: false
default: 1
type: integer
filter_mode:
description: IIR filter coeficient as described in the sensor datasheet.
required: false
default: 0
type: integer
delta_temperature:
description: Absolute delta for temperature correction.
required: false
default: 0
type: float
monitored_conditions:
description: Conditions to monitor. Available conditions are *temperature*, *humidity* and *pressure*.
required: false
default: All three conditions
type: list
{% endconfiguration %}
## {% linkable_title Full Examples %} ## {% linkable_title Full Examples %}