From: Adrian Fiergolski <adrian.fiergolski@fastree3d.com>
To: unlisted-recipients:; (no To-header on input)
Cc: geert@linux-m68k.org, lukas@wunner.de,
Adrian Fiergolski <adrian.fiergolski@fastree3d.com>,
Mark Brown <broonie@kernel.org>, Rob Herring <robh+dt@kernel.org>,
linux-spi@vger.kernel.org, devicetree@vger.kernel.org,
linux-kernel@vger.kernel.org
Subject: [PATCH v2 2/2] dt-bindings: Add documentation for SPI daisy chain driver.
Date: Mon, 6 Jul 2020 11:22:44 +0200 [thread overview]
Message-ID: <20200706092247.20740-2-adrian.fiergolski@fastree3d.com> (raw)
In-Reply-To: <20200706092247.20740-1-adrian.fiergolski@fastree3d.com>
Add documentation for SPI daisy chain driver.
Signed-off-by: Adrian Fiergolski <adrian.fiergolski@fastree3d.com>
---
.../bindings/spi/spi-daisy_chain.txt | 56 +++++++++++++++++++
1 file changed, 56 insertions(+)
create mode 100644 Documentation/devicetree/bindings/spi/spi-daisy_chain.txt
diff --git a/Documentation/devicetree/bindings/spi/spi-daisy_chain.txt b/Documentation/devicetree/bindings/spi/spi-daisy_chain.txt
new file mode 100644
index 000000000000..1e5b046dda83
--- /dev/null
+++ b/Documentation/devicetree/bindings/spi/spi-daisy_chain.txt
@@ -0,0 +1,56 @@
+spi-daisy_chain : The driver handling SPI daisy chains.
+-----------------------------------------------------------
+
+Required properties:
+- compatible : Should be "spi,daisy_chain"
+- reg : Chip select assigned to the chain
+
+ For the SPI devices on a common SPI chain - nodes of daisy_chain):
+- spi-daisy-chain-len : Length (in bytes) of the SPI transfer,
+ when the SPI device is part of a device chain.
+- spi-daisy-chain-noop : Byte string of no-operation command which should
+ be send when device is not addressed during the
+ given SPI transfer
+
+Optional properties:
+ (for the SPI devices on a common SPI chain (nodes of daisy_chain):
+- spi-daisy-chain-bits_per_word : no-operation transfers involve
+ one or more words; word sizes like
+ eight or 12 bits are common.
+ In-memory wordsizes are powers of two
+ bytes (e.g. 20 bit samples use 32 bits).
+ If not defined, it is assumed to be 8.
+
+The daisy chain is a virtual device represented as a regular SPI device. Its
+nodes define physical devices available on the chain. The order of the nodes
+defines the order of the physical devices on the chain: MOSI pin of a device
+represented by the first node is the last one on the MOSI daisy chain. The
+daisy-chain functionality is transparent to the drivers of the physical devices
+on the chain. All nodes share SPI mode, chip select and a max speed of the
+virtual daisy chain device. Once one of the physical devices is being accessed,
+the spi-daisy_chain driver combines this data with no-operation commands of all
+other devices on the chain.
+
+Example:
+
+ daisy_chain0: daisy_chain@0 {
+ compatible = "spi,daisy_chain";
+ spi-max-frequency = <10000000>;
+ reg = <0>;
+
+ dac0: ltc2632@0 {
+ compatible = "lltc,ltc2634-l12";
+ spi-daisy-chain-len = <4>;
+ spi-daisy-chain-noop = [00 F0 00 00];
+ };
+ dac1: ltc2632@1 {
+ compatible = "lltc,ltc2634-l12";
+ spi-daisy-chain-len = <4>;
+ spi-daisy-chain-noop = [00 F0 00 00];
+ };
+ dac2: ltc2632@2 {
+ compatible = "lltc,ltc2634-l12";
+ spi-daisy-chain-len = <4>;
+ spi-daisy-chain-noop = [00 F0 00 00];
+ };
+ };
--
2.27.0
next prev parent reply other threads:[~2020-07-06 9:23 UTC|newest]
Thread overview: 17+ messages / expand[flat|nested] mbox.gz Atom feed top
2020-07-03 14:12 [PATCH 1/2] spi: Add the SPI daisy chain support Adrian Fiergolski
2020-07-03 14:12 ` [PATCH 2/2] dt-bindings: Add documentation for SPI daisy chain driver Adrian Fiergolski
2020-07-03 22:32 ` [PATCH 1/2] spi: Add the SPI daisy chain support kernel test robot
2020-07-04 0:18 ` kernel test robot
2020-07-06 9:22 ` [PATCH v2 " Adrian Fiergolski
2020-07-06 9:22 ` Adrian Fiergolski [this message]
2020-07-06 15:10 ` [PATCH v2 2/2] dt-bindings: Add documentation for SPI daisy chain driver Geert Uytterhoeven
2020-07-06 15:19 ` Adrian Fiergolski
2020-07-06 15:32 ` Geert Uytterhoeven
2020-07-06 16:22 ` Mark Brown
2020-07-07 9:55 ` Adrian Fiergolski
2020-07-06 16:18 ` [PATCH v2 1/2] spi: Add the SPI daisy chain support Mark Brown
2020-07-06 19:57 ` Geert Uytterhoeven
2020-07-07 10:25 ` Mark Brown
2020-07-07 11:06 ` Adrian Fiergolski
2020-07-07 10:53 ` Adrian Fiergolski
2020-07-07 11:21 ` 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=20200706092247.20740-2-adrian.fiergolski@fastree3d.com \
--to=adrian.fiergolski@fastree3d.com \
--cc=broonie@kernel.org \
--cc=devicetree@vger.kernel.org \
--cc=geert@linux-m68k.org \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-spi@vger.kernel.org \
--cc=lukas@wunner.de \
--cc=robh+dt@kernel.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).