From: Wolfram Sang <wsa@the-dreams.de>
To: linux-i2c@vger.kernel.org
Cc: Wolfram Sang <wsa@the-dreams.de>,
devicetree@vger.kernel.org, linux-arm-kernel@lists.infradead.org,
Rob Landley <rob@landley.net>,
linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org
Subject: [PATCH 01/17] Documentation: i2c: describe devicetree method for instantiating devices
Date: Mon, 10 Feb 2014 11:03:55 +0100 [thread overview]
Message-ID: <1392026654-5343-2-git-send-email-wsa@the-dreams.de> (raw)
In-Reply-To: <1392026654-5343-1-git-send-email-wsa@the-dreams.de>
Signed-off-by: Wolfram Sang <wsa@the-dreams.de>
Cc: devicetree@vger.kernel.org
Cc: linux-arm-kernel@lists.infradead.org
---
Documentation/i2c/instantiating-devices | 34 +++++++++++++++++++++++++++++++--
1 file changed, 32 insertions(+), 2 deletions(-)
diff --git a/Documentation/i2c/instantiating-devices b/Documentation/i2c/instantiating-devices
index c70e7a7..6df095a 100644
--- a/Documentation/i2c/instantiating-devices
+++ b/Documentation/i2c/instantiating-devices
@@ -8,8 +8,8 @@ reason, the kernel code must instantiate I2C devices explicitly. There are
several ways to achieve this, depending on the context and requirements.
-Method 1: Declare the I2C devices by bus number
------------------------------------------------
+Method 1a: Declare the I2C devices by bus number
+------------------------------------------------
This method is appropriate when the I2C bus is a system bus as is the case
for many embedded systems. On such systems, each I2C bus has a number
@@ -51,6 +51,36 @@ The devices will be automatically unbound and destroyed when the I2C bus
they sit on goes away (if ever.)
+Method 1b: Declare the I2C devices via devicetree
+-------------------------------------------------
+
+This method has the same implications as method 1a. The declaration of I2C
+devices is here done via devicetree as subnodes of the master controller.
+
+Example:
+
+ i2c1: i2c@400a0000 {
+ /* ... master properties skipped ... */
+ clock-frequency = <100000>;
+
+ flash@50 {
+ compatible = "atmel,24c256";
+ reg = <0x50>;
+ };
+
+ pca9532: gpio@60 {
+ compatible = "nxp,pca9532";
+ gpio-controller;
+ #gpio-cells = <2>;
+ reg = <0x60>;
+ };
+ };
+
+Here, two devices are attached to the bus using a speed of 100kHz. For
+additional properties which might be needed to set up the device, please refer
+to its devicetree documentation in Documentation/devicetree/bindings/.
+
+
Method 2: Instantiate the devices explicitly
--------------------------------------------
--
1.8.5.1
next prev parent reply other threads:[~2014-02-10 10:04 UTC|newest]
Thread overview: 28+ messages / expand[flat|nested] mbox.gz Atom feed top
2014-02-10 10:03 [PATCH 00/17] i2c: deprecate class based instantiation for embedded I2C drivers Wolfram Sang
2014-02-10 10:03 ` Wolfram Sang [this message]
2014-02-10 18:21 ` [PATCH 01/17] Documentation: i2c: describe devicetree method for instantiating devices linux
2014-02-12 15:15 ` Wolfram Sang
2014-02-15 14:48 ` Wolfram Sang
2014-02-10 10:03 ` [PATCH 02/17] i2c: add deprecation warning for class based instantiation Wolfram Sang
2014-02-10 10:03 ` [PATCH 03/17] i2c: i2c-omap: deprecate " Wolfram Sang
2014-02-10 10:03 ` [PATCH 04/17] i2c: i2c-at91: " Wolfram Sang
2014-02-11 13:33 ` Ludovic Desroches
2014-02-10 10:03 ` [PATCH 05/17] i2c: i2c-bcm2835: " Wolfram Sang
2014-02-10 10:04 ` [PATCH 06/17] i2c: i2c-bfin-twi: " Wolfram Sang
2014-02-11 9:02 ` Sonic Zhang
2014-02-10 10:04 ` [PATCH 07/17] i2c: i2c-davinci: " Wolfram Sang
2014-02-10 10:04 ` [PATCH 08/17] i2c: i2c-designware-platdrv: " Wolfram Sang
2014-02-10 10:04 ` [PATCH 09/17] i2c: i2c-mv64xxx: " Wolfram Sang
2014-02-10 10:04 ` [PATCH 10/17] i2c: i2c-nomadik: " Wolfram Sang
2014-02-12 16:24 ` Linus Walleij
2014-02-10 10:04 ` [PATCH 11/17] i2c: i2c-ocores: " Wolfram Sang
2014-02-10 10:14 ` Peter Korsgaard
2014-02-10 10:04 ` [PATCH 12/17] i2c: i2c-rcar: " Wolfram Sang
2014-02-10 10:04 ` [PATCH 13/17] i2c: i2c-s3c2410: " Wolfram Sang
2014-02-10 10:04 ` [PATCH 14/17] i2c: i2c-sirf: " Wolfram Sang
2014-02-10 10:04 ` [PATCH 15/17] i2c: i2c-stu300: " Wolfram Sang
2014-02-12 16:22 ` Linus Walleij
2014-02-10 10:04 ` [PATCH 16/17] i2c: i2c-tegra: " Wolfram Sang
2014-02-10 16:46 ` Stephen Warren
2014-02-10 10:04 ` [PATCH 17/17] i2c: i2c-xiic: " Wolfram Sang
2014-03-28 7:55 ` [PATCH 00/17] i2c: deprecate class based instantiation for embedded I2C drivers Wolfram Sang
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=1392026654-5343-2-git-send-email-wsa@the-dreams.de \
--to=wsa@the-dreams.de \
--cc=devicetree@vger.kernel.org \
--cc=linux-arm-kernel@lists.infradead.org \
--cc=linux-doc@vger.kernel.org \
--cc=linux-i2c@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=rob@landley.net \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox
all inboxes | Powered by JetHome®