zephyr/samples/drivers/i2c_scanner
Anas Nashif da5f185e06 samples: add test identifier
Add unique identifier instead of just 'test' for samples.

Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2019-03-29 17:44:11 -04:00
..
src
CMakeLists.txt
overlay-nrf52.conf
prj.conf
README.rst
sample.yaml samples: add test identifier 2019-03-29 17:44:11 -04:00

.. _i2c_scanner:

I2C Scanner sample
##################

Overview
********
This sample sends I2C messages without any data (i.e. stop condition
after sending just the address). If there is an ACK for the
address, it prints the address as ``FOUND``.

.. warning:: As  there  is  no  standard I2C detection command, this sample
   uses arbitrary SMBus commands (namely SMBus quick write and SMBus
   receive byte) to probe for devices.  This sample program can confuse
   your I2C bus, cause data loss, and is known to corrupt
   the Atmel AT24RF08 EEPROM found on many IBM Thinkpad laptops.
   See also the `i2cdetect man page
   <http://manpages.ubuntu.com/manpages/bionic/man8/i2cdetect.8.html>`_

Building and Running
********************
.. zephyr-app-commands::
   :zephyr-app: samples/drivers/i2c_scanner
   :board: nrf52840_blip
   :conf: "prj.conf overlay-nrf52.conf"
   :goals: build flash