From: srinivas.kandagatla@linaro.org
To: Mark Brown <broonie@kernel.org>,
Greg Kroah-Hartman <gregkh@linuxfoundation.org>,
alsa-devel@alsa-project.org
Cc: Mark Rutland <mark.rutland@arm.com>,
devicetree@vger.kernel.org, Jonathan Corbet <corbet@lwn.net>,
linux-arm-msm@vger.kernel.org, linux-doc@vger.kernel.org,
j.neuschaefer@gmx.net, linux-kernel@vger.kernel.org,
Rob Herring <robh+dt@kernel.org>,
Srinivas Kandagatla <srinivas.kandagatla@linaro.org>,
pombredanne@nexb.com, sdharia@codeaurora.org
Subject: [PATCH v10 02/13] dt-bindings: Add SLIMbus bindings
Date: Mon, 11 Dec 2017 23:42:56 +0000 [thread overview]
Message-ID: <20171211234307.14465-3-srinivas.kandagatla@linaro.org> (raw)
In-Reply-To: <20171211234307.14465-1-srinivas.kandagatla@linaro.org>
From: Sagar Dharia <sdharia@codeaurora.org>
SLIMbus (Serial Low Power Interchip Media Bus) is a specification
developed by MIPI (Mobile Industry Processor Interface) alliance.
SLIMbus is a 2-wire implementation, which is used to communicate with
peripheral components like audio-codec.
This patch adds device tree bindings for the slimbus.
Signed-off-by: Sagar Dharia <sdharia@codeaurora.org>
Signed-off-by: Srinivas Kandagatla <srinivas.kandagatla@linaro.org>
Reviewed-by: Rob Herring <robh@kernel.org>
---
Documentation/devicetree/bindings/slimbus/bus.txt | 50 +++++++++++++++++++++++
1 file changed, 50 insertions(+)
create mode 100644 Documentation/devicetree/bindings/slimbus/bus.txt
diff --git a/Documentation/devicetree/bindings/slimbus/bus.txt b/Documentation/devicetree/bindings/slimbus/bus.txt
new file mode 100644
index 000000000000..52fa6426388c
--- /dev/null
+++ b/Documentation/devicetree/bindings/slimbus/bus.txt
@@ -0,0 +1,50 @@
+SLIM(Serial Low Power Interchip Media Bus) bus
+
+SLIMbus is a 2-wire bus, and is used to communicate with peripheral
+components like audio-codec.
+
+Required property for SLIMbus controller node:
+- compatible - name of SLIMbus controller
+
+Child nodes:
+Every SLIMbus controller node can contain zero or more child nodes
+representing slave devices on the bus. Every SLIMbus slave device is
+uniquely determined by the enumeration address containing 4 fields:
+Manufacturer ID, Product code, Device index, and Instance value for
+the device.
+If child node is not present and it is instantiated after device
+discovery (slave device reporting itself present).
+
+In some cases it may be necessary to describe non-probeable device
+details such as non-standard ways of powering up a device. In
+such cases, child nodes for those devices will be present as
+slaves of the SLIMbus controller, as detailed below.
+
+Required property for SLIMbus child node if it is present:
+- reg - Should be ('Device index', 'Instance ID') from SLIMbus
+ Enumeration Address.
+ Device Index Uniquely identifies multiple Devices within
+ a single Component.
+ Instance ID Is for the cases where multiple Devices of the
+ same type or Class are attached to the bus.
+
+- compatible -"slimMID,PID". The textual representation of Manufacturer ID,
+ Product Code, shall be in lower case hexadecimal with leading
+ zeroes suppressed
+
+SLIMbus example for Qualcomm's slimbus manager component:
+
+ slim@28080000 {
+ compatible = "qcom,apq8064-slim", "qcom,slim";
+ reg = <0x28080000 0x2000>,
+ interrupts = <0 33 0>;
+ clocks = <&lcc SLIMBUS_SRC>, <&lcc AUDIO_SLIMBUS_CLK>;
+ clock-names = "iface", "core";
+ #address-cells = <2>;
+ #size-cell = <0>;
+
+ codec: wcd9310@1,0{
+ compatible = "slim217,60";
+ reg = <1 0>;
+ };
+ };
--
2.15.0
next prev parent reply other threads:[~2017-12-11 23:42 UTC|newest]
Thread overview: 25+ messages / expand[flat|nested] mbox.gz Atom feed top
2017-12-11 23:42 [PATCH v10 00/13] Introduce framework for SLIMbus device driver srinivas.kandagatla
2017-12-11 23:42 ` [PATCH v10 01/13] Documentation: Add SLIMbus summary srinivas.kandagatla
2017-12-11 23:42 ` srinivas.kandagatla [this message]
2017-12-11 23:42 ` [PATCH v10 03/13] slimbus: Add SLIMbus bus type srinivas.kandagatla
2017-12-11 23:42 ` [PATCH v10 04/13] slimbus: core: Add slim controllers support srinivas.kandagatla
2017-12-11 23:42 ` [PATCH v10 05/13] slimbus: core: add support to device tree helper srinivas.kandagatla
2017-12-11 23:43 ` [PATCH v10 06/13] slimbus: Add messaging APIs to slimbus framework srinivas.kandagatla
2017-12-11 23:43 ` [PATCH v10 07/13] slimbus: Add support for 'clock-pause' feature srinivas.kandagatla
2017-12-11 23:43 ` [PATCH v10 08/13] regmap: add SLIMbus support srinivas.kandagatla
2017-12-13 9:25 ` Greg Kroah-Hartman
2017-12-13 12:24 ` Mark Brown
2017-12-13 16:06 ` Mark Brown
2017-12-14 5:17 ` Vinod Koul
2017-12-14 8:19 ` [alsa-devel] " Takashi Iwai
2017-12-14 13:16 ` Srinivas Kandagatla
2017-12-14 17:27 ` Mark Brown
2017-12-11 23:43 ` [PATCH v10 09/13] slimbus: core: add common defines required for controllers srinivas.kandagatla
2017-12-11 23:43 ` [PATCH v10 10/13] dt-bindings: Add qcom slimbus controller bindings srinivas.kandagatla
2017-12-11 23:43 ` [PATCH v10 11/13] slimbus: qcom: Add Qualcomm Slimbus controller driver srinivas.kandagatla
2017-12-21 17:26 ` Arnd Bergmann
2017-12-11 23:43 ` [PATCH v10 12/13] slimbus: qcom: Add runtime-pm support using clock-pause srinivas.kandagatla
2017-12-11 23:43 ` [PATCH v10 13/13] MAINTAINERS: Add SLIMbus maintainer srinivas.kandagatla
[not found] ` <20171211234307.14465-1-srinivas.kandagatla-QSEj5FYQhm4dnm+yROfE0A@public.gmane.org>
2017-12-13 9:25 ` [PATCH v10 00/13] Introduce framework for SLIMbus device driver Greg Kroah-Hartman
2017-12-14 13:18 ` Srinivas Kandagatla
2017-12-14 17:25 ` Mark Brown
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=20171211234307.14465-3-srinivas.kandagatla@linaro.org \
--to=srinivas.kandagatla@linaro.org \
--cc=alsa-devel@alsa-project.org \
--cc=broonie@kernel.org \
--cc=corbet@lwn.net \
--cc=devicetree@vger.kernel.org \
--cc=gregkh@linuxfoundation.org \
--cc=j.neuschaefer@gmx.net \
--cc=linux-arm-msm@vger.kernel.org \
--cc=linux-doc@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=mark.rutland@arm.com \
--cc=pombredanne@nexb.com \
--cc=robh+dt@kernel.org \
--cc=sdharia@codeaurora.org \
/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;
as well as URLs for NNTP newsgroup(s).