zephyr

History

Gerard Marull-Paretas 79e6b0e0f6 includes: prefer <zephyr/kernel.h> over <zephyr/zephyr.h> As of today <zephyr/zephyr.h> is 100% equivalent to <zephyr/kernel.h>. This patch proposes to then include <zephyr/kernel.h> instead of <zephyr/zephyr.h> since it is more clear that you are including the Kernel APIs and (probably) nothing else. <zephyr/zephyr.h> sounds like a catch-all header that may be confusing. Most applications need to include a bunch of other things to compile, e.g. driver headers or subsystem headers like BT, logging, etc. The idea of a catch-all header in Zephyr is probably not feasible anyway. Reason is that Zephyr is not a library, like it could be for example `libpython`. Zephyr provides many utilities nowadays: a kernel, drivers, subsystems, etc and things will likely grow. A catch-all header would be massive, difficult to keep up-to-date. It is also likely that an application will only build a small subset. Note that subsystem-level headers may use a catch-all approach to make things easier, though. NOTE: This patch is NOT removing the header, just removing its usage in-tree. I'd advocate for its deprecation (add a #warning on it), but I understand many people will have concerns. Signed-off-by: Gerard Marull-Paretas <gerard.marull@nordicsemi.no>		2022-09-05 16:31:47 +02:00
..
boards
src	includes: prefer <zephyr/kernel.h> over <zephyr/zephyr.h>	2022-09-05 16:31:47 +02:00
arduino_serial.overlay
CMakeLists.txt
prj.conf	sensors: Remove unnecessary Kconfig setting of sensors	2022-07-25 15:18:56 +02:00
README.rst
sample.yaml

README.rst

.. _ds18b20_sample:

DS18B20 1-Wire Temperature Sensor
#################################

Overview
********

This sample shows how to use the Zephyr :ref:`sensor_api` API driver for the
`Maxim DS18B20`_ temperature sensor.

.. _Maxim DS18B20:
   https://www.maximintegrated.com/en/products/sensors/DS18B20.html`

The sample periodically reads temperature data from the
first available DS18B20 device discovered in the system. The sample checks the
sensor in polling mode (without interrupt trigger).

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

The devicetree must have an enabled node with ``compatible = "maxim,ds18b20";``.
See below for examples and common configurations.

If the sensor is not built into your board, start by wiring the sensor pins
as shown in the Figure Hardware Configuration of the `DS18B20 datasheet`_ at
page 10.

.. _DS18B20 datasheet:
   https://datasheets.maximintegrated.com/en/ds/DS18B20.pdf

Boards with a built-in DS18B20 or a board-specific overlay
==========================================================

Your board may have a DS18B20 node configured in its devicetree by default,
or a board specific overlay file with an DS18B20 node is available.
Make sure this node has ``status = "okay";``, then build and run with:

.. zephyr-app-commands::
   :zephyr-app: samples/sensor/ds18b20
   :goals: build flash
   :board: nucleo_g0b1re

DS18B20 via Arduino Serial pins
===============================

Make sure that you have an external circuit to provide an open-drain interface
for the 1-Wire bus.
Once you have wired the sensor and the serial peripheral on the Arduino header
to the 1-Wire bus, build and flash with:

.. zephyr-app-commands::
   :zephyr-app: samples/sensor/ds18b20
   :goals: build flash
   :gen-args: -DDTC_OVERLAY_FILE=arduino_serial.overlay

The devicetree overlay :zephyr_file:`samples/sensor/ds18b20/arduino_serial.overlay`
should work on any board with a properly configured Arduino pin-compatible Serial
peripheral.

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

The sample prints output to the serial console. DS18B20 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 DS18B20 sensor is connected to the standard Arduino Serial pins:

.. code-block:: none

   *** Booting Zephyr OS build zephyr-v2.6.0-1929-gf7abe4a6689e  ***
   Found device "DS18B20", getting sensor data
   [00:00:00.000,039] <dbg> w1_serial: w1_serial_init: w1-serial initialized, with 1 devices
   [00:00:00.015,140] <dbg> DS18B20: ds18b20_init: Using external power supply: 1
   [00:00:00.021,213] <dbg> DS18B20: ds18b20_init: Init DS18B20: ROM=28b1bb3f070000b9

   Temp: 25.040000
   Temp: 25.030000