zephyr/samples/sensor/mcp9808
Armando Visconti 87d6c50e47 sensors: Add separation between ambient and die temperature
Some device include a temperature sensor, usually used as a
companion for helping in drift compensation, that measure the
die temperature. This temperature IS NOT related to the the
ambient temperature, hence a clean separation between the two
is required.

This commit introduces a clean separation between the two
types of temperature leaving the old deprecated definition
still there.

The list of current drivers that read the die (and not the ambient)
temperature is the following:

 - adxl362
 - bma280
 - bmg160
 - bmi160
 - fxos8700
 - lis3mdl
 - lsm6ds0
 - lsm6dsl
 - lsm9ds0
 - mpu6050

Signed-off-by: Armando Visconti <armando.visconti@st.com>
2018-04-03 22:29:11 -04:00
..
src sensors: Add separation between ambient and die temperature 2018-04-03 22:29:11 -04:00
CMakeLists.txt Introduce cmake-based rewrite of KBuild 2017-11-08 20:00:22 -05:00
README.rst doc: change UTF-8 chars to sphinx inline replaces 2017-06-16 07:35:11 -05:00
prj.conf
sample.yaml samples: mcp9808: fix dependencies and test cleanup 2017-12-28 20:24:29 -05:00

README.rst

.. _mcp9808-sample:

MCP9808 Temperature Sensor
##########################

Overview
********

Sample application that periodically reads temperature from the MCP9808 sensor.


Requirements
************

The MCP9808 digital temperature sensor converts temperatures between -20 |deg|
C and +100 |deg| C to a digital word with |plusminus| 0.5 |deg| C (max.)
accuracy. It is I2C compatible and
supports up to 16 devices on the bus. We do not require pullup resistors on the
data or clock signals as they are already installed on the breakout board.

The MCP9808 is available in a discrete component form but it is much easier to
use it mounted on a breakout board. We used the Adafruit breakout board.

- `MCP9808 Sensor`_

This sample uses the sensor APIs and the provided driver for the MCP9808 sensor.

Wiring
*******

The MCP9808 requires 2 wires for the I2C bus plus power and ground. The power
can be either 5V or 3.3V.

We connect the Data and clock wires to Analog ports A4 and A5 which is the I2C
pins on Arduino compatible boards.

In this hookup we are only connecting one device to one of the supported boards.
It reads the temperature and displays it on the console.


References
***********

- http://www.microchip.com/wwwproducts/en/en556182


.. _`MCP9808 Sensor`: https://www.adafruit.com/product/1782