All of lore.kernel.org
 help / color / mirror / Atom feed
From: Joel Holdsworth <joel@airwebreathe.org.uk>
To: atull@opensource.altera.com, moritz.fischer@ettus.com,
	robh@kernel.org, devicetree@vger.kernel.org,
	linux-kernel@vger.kernel.org, linux-spi@vger.kernel.org,
	marex@denx.de, linux-fpga@vger.kernel.org
Cc: Joel Holdsworth <joel@airwebreathe.org.uk>
Subject: [PATCH v10 2/3] Documentation: Add binding document for Lattice iCE40 FPGA manager
Date: Sat, 17 Dec 2016 22:33:53 -0700	[thread overview]
Message-ID: <1482039234-21335-2-git-send-email-joel@airwebreathe.org.uk> (raw)
In-Reply-To: <1482039234-21335-1-git-send-email-joel@airwebreathe.org.uk>

This adds documentation of the device tree bindings of the Lattice iCE40
FPGA driver for the FPGA manager framework.

Signed-off-by: Joel Holdsworth <joel@airwebreathe.org.uk>
Acked-by: Rob Herring <robh@kernel.org>
Acked-by: Alan Tull <atull@opensource.altera.com>
Acked-by: Moritz Fischer <moritz.fischer@ettus.com>
Acked-by: Marek Vasut <marex@denx.de>
---
 .../bindings/fpga/lattice-ice40-fpga-mgr.txt        | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/fpga/lattice-ice40-fpga-mgr.txt

diff --git a/Documentation/devicetree/bindings/fpga/lattice-ice40-fpga-mgr.txt b/Documentation/devicetree/bindings/fpga/lattice-ice40-fpga-mgr.txt
new file mode 100644
index 0000000..7e7a78b
--- /dev/null
+++ b/Documentation/devicetree/bindings/fpga/lattice-ice40-fpga-mgr.txt
@@ -0,0 +1,21 @@
+Lattice iCE40 FPGA Manager
+
+Required properties:
+- compatible:		Should contain "lattice,ice40-fpga-mgr"
+- reg:			SPI chip select
+- spi-max-frequency:	Maximum SPI frequency (>=1000000, <=25000000)
+- cdone-gpios:		GPIO input connected to CDONE pin
+- reset-gpios:		Active-low GPIO output connected to CRESET_B pin. Note
+			that unless the GPIO is held low during startup, the
+			FPGA will enter Master SPI mode and drive SCK with a
+			clock signal potentially jamming other devices on the
+			bus until the firmware is loaded.
+
+Example:
+	ice40: ice40@0 {
+		compatible = "lattice,ice40-fpga-mgr";
+		reg = <0>;
+		spi-max-frequency = <1000000>;
+		cdone-gpios = <&gpio 24 GPIO_ACTIVE_HIGH>;
+		reset-gpios = <&gpio 22 GPIO_ACTIVE_LOW>;
+	};
-- 
2.7.4

  reply	other threads:[~2016-12-18  5:34 UTC|newest]

Thread overview: 8+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2016-12-18  5:33 [PATCH v10 1/3] of: Add vendor prefix for Lattice Semiconductor Joel Holdsworth
2016-12-18  5:33 ` Joel Holdsworth [this message]
2016-12-19 11:16   ` [PATCH v10 2/3] Documentation: Add binding document for Lattice iCE40 FPGA manager Geert Uytterhoeven
2016-12-18  5:33 ` [PATCH v10 3/3] fpga: Add support for Lattice iCE40 FPGAs Joel Holdsworth
2016-12-18  5:33   ` Joel Holdsworth
2016-12-18 19:18   ` Vladimir Zapolskiy
2016-12-18 19:18     ` Vladimir Zapolskiy
2016-12-18 19:18     ` Vladimir Zapolskiy

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=1482039234-21335-2-git-send-email-joel@airwebreathe.org.uk \
    --to=joel@airwebreathe.org.uk \
    --cc=atull@opensource.altera.com \
    --cc=devicetree@vger.kernel.org \
    --cc=linux-fpga@vger.kernel.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=linux-spi@vger.kernel.org \
    --cc=marex@denx.de \
    --cc=moritz.fischer@ettus.com \
    --cc=robh@kernel.org \
    --subject='Re: [PATCH v10 2/3] Documentation: Add binding document for Lattice iCE40 FPGA manager' \
    /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

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.