165 lines
6.1 KiB
ReStructuredText
165 lines
6.1 KiB
ReStructuredText
.. _bme280:
|
|
|
|
BME280 Humidity and Pressure Sensor
|
|
###################################
|
|
|
|
Overview
|
|
********
|
|
|
|
This sample shows how to use the Zephyr :ref:`sensor_api` API driver for the
|
|
`Bosch BME280`_ environmental sensor.
|
|
|
|
.. _Bosch BME280:
|
|
https://www.bosch-sensortec.com/products/environmental-sensors/humidity-sensors-bme280/
|
|
|
|
The sample periodically reads temperature, pressure and humidity data from the
|
|
first available BME280 device discovered in the system. The sample checks the
|
|
sensor in polling mode (without interrupt trigger).
|
|
|
|
Building and Running
|
|
********************
|
|
|
|
The sample can be configured to support BME280 sensors connected via either I2C
|
|
or SPI. Configuration is done via :ref:`devicetree <dt-guide>`. The devicetree
|
|
must have an enabled node with ``compatible = "bosch,bme280";``. See
|
|
:dtcompatible:`bosch,bme280` for the devicetree binding and see below for
|
|
examples and common configurations.
|
|
|
|
If the sensor is not built into your board, start by wiring the sensor pins
|
|
according to the connection diagram given in the `BME280 datasheet`_ at
|
|
page 38.
|
|
|
|
.. _BME280 datasheet:
|
|
https://www.bosch-sensortec.com/media/boschsensortec/downloads/datasheets/bst-bme280-ds002.pdf
|
|
|
|
Boards with a built-in BME280
|
|
=============================
|
|
|
|
Your board may have a BME280 node configured in its devicetree by default. Make
|
|
sure this node has ``status = "okay";``, then build and run with:
|
|
|
|
.. zephyr-app-commands::
|
|
:zephyr-app: samples/sensor/bme280
|
|
:goals: build flash
|
|
:board: adafruit_feather_m0_basic_proto
|
|
|
|
BME280 via Arduino SPI pins
|
|
===========================
|
|
|
|
If you wired the sensor to a SPI peripheral on an Arduino header, build and
|
|
flash with:
|
|
|
|
.. zephyr-app-commands::
|
|
:zephyr-app: samples/sensor/bme280
|
|
:goals: build flash
|
|
:gen-args: -DDTC_OVERLAY_FILE=arduino_spi.overlay
|
|
|
|
The devicetree overlay :zephyr_file:`samples/sensor/bme280/arduino_spi.overlay`
|
|
works on any board with a properly configured Arduino pin-compatible SPI
|
|
peripheral.
|
|
|
|
BME280 via Arduino I2C pins
|
|
===========================
|
|
|
|
If you wired the sensor to an I2C peripheral on an Arduino header, build and
|
|
flash with:
|
|
|
|
.. zephyr-app-commands::
|
|
:zephyr-app: samples/sensor/bme280
|
|
:goals: build flash
|
|
:gen-args: -DDTC_OVERLAY_FILE=arduino_i2c.overlay
|
|
|
|
The devicetree overlay :zephyr_file:`samples/sensor/bme280/arduino_i2c.overlay`
|
|
works on any board with a properly configured Arduino pin-compatible I2C
|
|
peripheral.
|
|
|
|
BME280 via Raspberry Pi Pico
|
|
============================
|
|
|
|
The default assignment of the built-in spi0 device on the :ref:`rpi_pico` is
|
|
to GPIO16 through GPIO19. With the sensor wired to those lines, build and
|
|
flash with:
|
|
|
|
.. zephyr-app-commands::
|
|
:zephyr-app: samples/sensor/bme280
|
|
:goals: build flash
|
|
:board: rpi_pico
|
|
|
|
An alternative is to use PIO serving as an SPI device. The devicetree
|
|
overlay :zephyr_file:`samples/sensor/bme280/rpi_pico_spi_pio.overlay`
|
|
demonstrates using PIO SPI with the sensor wired to arbitrary GPIO pins.
|
|
Build and flash with:
|
|
|
|
.. zephyr-app-commands::
|
|
:zephyr-app: samples/sensor/bme280
|
|
:goals: build flash
|
|
:board: rpi_pico
|
|
:gen-args: -DDTC_OVERLAY_FILE=rpi_pico_spi_pio.overlay
|
|
|
|
Note that miso-gpios, mosi-gpios, and clk-gpios need to be assigned to the
|
|
selected PIO device in pinctrl, while cs-gpios should not; chip select is
|
|
controlled by the SPI context and must operate as a conventional GPIO pin,
|
|
not under control of PIO.
|
|
|
|
Board-specific overlays
|
|
=======================
|
|
|
|
If your board's devicetree does not have a BME280 node already, you can create
|
|
a board-specific devicetree overlay adding one in the :file:`boards` directory.
|
|
See existing overlays for examples.
|
|
|
|
The build system uses these overlays by default when targeting those boards, so
|
|
no ``DTC_OVERLAY_FILE`` setting is needed when building and running.
|
|
|
|
For example, to build for the :ref:`adafruit_feather_m0_basic_proto` using the
|
|
:zephyr_file:`samples/sensor/bme280/boards/adafruit_feather_m0_basic_proto.overlay`
|
|
overlay provided with this sample:
|
|
|
|
.. zephyr-app-commands::
|
|
:zephyr-app: samples/sensor/bme280
|
|
:goals: build flash
|
|
:board: adafruit_feather_m0_basic_proto
|
|
|
|
Sample Output
|
|
=============
|
|
|
|
The sample prints output to the serial console. BME280 device driver messages
|
|
are also logged. Refer to your board's documentation for information on
|
|
connecting to its serial console.
|
|
|
|
Here is example output for the default application settings, assuming that only
|
|
one BME280 sensor is connected to the standard Arduino I2C pins:
|
|
|
|
.. code-block:: none
|
|
|
|
[00:00:00.379,760] <dbg> BME280.bme280_init: initializing "BME280_SPI" on bus "SPI_3"
|
|
[00:00:00.379,821] <dbg> BME280.bme280_init: bad chip id 0xff
|
|
[00:00:00.379,821] <dbg> BME280.bme280_init: initializing "BME280_I2C" on bus "I2C_0"
|
|
[00:00:00.380,340] <dbg> BME280.bme280_init: ID OK
|
|
[00:00:00.385,559] <dbg> BME280.bme280_init: BME280_I2C OK
|
|
*** Booting Zephyr OS build zephyr-v2.4.0-2940-gbb732ada394f ***
|
|
Found device BME280_I2C, getting sensor data
|
|
temp: 20.260000; press: 99.789019; humidity: 46.458984
|
|
temp: 20.260000; press: 99.789480; humidity: 46.424804
|
|
temp: 20.250000; press: 99.789246; humidity: 46.423828
|
|
|
|
Here is example output for the default application settings, assuming that two
|
|
different BME280 sensors are connected to the standard Arduino I2C and SPI pins:
|
|
|
|
.. code-block:: none
|
|
|
|
[00:00:00.377,777] <dbg> BME280.bme280_init: initializing "BME280_SPI" on bus "SPI_3"
|
|
[00:00:00.377,838] <dbg> BME280.bme280_init: ID OK
|
|
[00:00:00.379,608] <dbg> BME280.bme280_init: BME280_SPI OK
|
|
[00:00:00.379,638] <dbg> BME280.bme280_init: initializing "BME280_I2C" on bus "I2C_0"
|
|
[00:00:00.380,126] <dbg> BME280.bme280_init: ID OK
|
|
[00:00:00.385,345] <dbg> BME280.bme280_init: BME280_I2C OK
|
|
*** Booting Zephyr OS build zephyr-v2.4.0-2940-gbb732ada394f ***
|
|
Found device BME280_I2C, getting sensor data
|
|
temp: 20.150000; press: 99.857675; humidity: 46.447265
|
|
temp: 20.150000; press: 99.859121; humidity: 46.458984
|
|
temp: 20.150000; press: 99.859234; humidity: 46.469726
|
|
|
|
That the driver logs include a line saying ``BME280_I2C OK`` in both cases, but
|
|
``BME280_SPI OK`` is missing when that device is not connected.
|