[rtems-docs commit] Document I2C framework

[Sebastian Huber]

Module:    rtems-docs
Branch:    master
Commit:    7351405fe6841705d8fab2abbd080552e5290ff8
Changeset: http://git.rtems.org/rtems-docs/commit/?id=7351405fe6841705d8fab2abbd080552e5290ff8

Author:    Sebastian Huber <sebastian.huber at embedded-brains.de>
Date:      Tue Dec 20 11:18:06 2016 +0100

Document I2C framework

Update #2845.

---

 bsp-howto/i2c.rst   | 19 +++++++++++++++++++
 bsp-howto/index.rst |  1 +
 2 files changed, 20 insertions(+)

diff --git a/bsp-howto/i2c.rst b/bsp-howto/i2c.rst
new file mode 100644
index 0000000..caa78e1
--- /dev/null
+++ b/bsp-howto/i2c.rst
@@ -0,0 +1,19 @@
+.. comment SPDX-License-Identifier: CC-BY-SA-4.0
+
+.. COMMENT: Copyright (c) 2016 embedded brains GmbH <rtems at embedded-brains.de>
+.. COMMENT: All rights reserved.
+
+I2C Driver
+**********
+
+The Inter-Integrated Circuit (I2C, I²C, IIC) bus drivers should use the
+`I2C bus framework <https://git.rtems.org/rtems/tree/cpukit/dev/include/dev/i2c/i2c.h>`_.
+For example drivers see the
+`Cadence I2C driver <https://git.rtems.org/rtems/tree/c/src/lib/libbsp/arm/xilinx-zynq/i2c/cadence-i2c.c>`_,
+the
+`Atmel SAM I2C driver <https://git.rtems.org/rtems/tree/c/src/lib/libbsp/arm/atsam/i2c/atsam_i2c_bus.c>`_
+and the
+`I2C framework test <https://git.rtems.org/rtems/tree/testsuites/libtests/i2c01/init.c>`_.
+
+The user API is compatible to the
+`Linux I2C user-space API <https://www.kernel.org/doc/Documentation/i2c/dev-interface>`_.
diff --git a/bsp-howto/index.rst b/bsp-howto/index.rst
index f1c3a4e..649e335 100644
--- a/bsp-howto/index.rst
+++ b/bsp-howto/index.rst
@@ -47,6 +47,7 @@ to the Community Project hosted at http://www.rtems.org.
 	initilization_code
 	console
 	clock
+	i2c
 	spi
 	timer
 	real_time_clock