zephyr/samples/sensor/bme680
Anas Nashif 70758c4374 tests: fix test identifiers
The seasonal overhaul of test identifiers aligning the terms being used
and creating a structure. This is hopefully the last time we do this,
plan is to document the identifiers and enforce syntax.

The end-goal is to be able to generate a testsuite description from the
existing tests and sync it frequently with the testsuite in Testrail.

Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2019-12-09 15:53:44 -05:00
..
src coccinelle: standardize k_sleep calls with integer timeouts 2019-10-09 08:38:10 -04:00
CMakeLists.txt
README.rst doc: fix broken file and zephyr-app refs 2019-10-08 15:42:32 -05:00
prj.conf
sample.yaml tests: fix test identifiers 2019-12-09 15:53:44 -05:00

README.rst

.. _bme680:

BME680: Integrated environmental sensor
#####################################################

Description
***********

This sample application periodically (every 3s) measures the ambient temperature
in degrees Celsius, atmospheric pressure in kilopascal, relative humidity in percentage,
and gas sensor resistance in ohms. The result is written to the console.

References
**********

 - BME680: https://www.bosch-sensortec.com/bst/products/all_products/bme680

Wiring
*******

This sample uses the BME680 sensor controlled using the I2C interface.
Connect Supply: **VDD**, **VDDIO**, **GND** and Interface: **SDA**, **SCL**.
The supply voltage can be in the 1.8V to 3.6V range.
Depending on the baseboard used, the **SDA** and **SCL** lines require Pull-Up
resistors.

Building and Running
********************

This project outputs sensor data to the console. It requires a BME680
sensor. It should work with any platform featuring a I2C peripheral interface.
It does not work on QEMU.
In this example below the :ref:`nrf52_pca10040` board is used.


.. zephyr-app-commands::
   :zephyr-app: samples/sensor/bme680
   :board: nrf52_pca10040
   :goals: build flash

Sample Output
=============

.. code-block:: console

   Device 0x20002b74 name is BME680
   T: 23.988877; P: 97.648568; H: 53.689533; G: 1035.211466
   T: 24.168500; P: 97.648866; H: 53.565966; G: 1046.677896
   T: 24.336533; P: 97.648596; H: 53.353663; G: 1058.656533
   T: 24.589696; P: 97.648366; H: 53.958864; G: 1072.155863
   T: 24.856631; P: 97.648322; H: 53.553669; G: 1096.448788

   <repeats endlessly>