linux-kernel - [RFC 2/2] staging: jnx-connector: add device tree binding

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-Id: <1475853372-21997-3-git-send-email-pantelis.antoniou@konsulko.com>
Date:   Fri,  7 Oct 2016 18:16:12 +0300
From:   Pantelis Antoniou <pantelis.antoniou@...sulko.com>
To:     Rob Herring <robh+dt@...nel.org>,
        Mark Rutland <mark.rutland@....com>
Cc:     Frank Rowand <frowand.list@...il.com>,
        Greg Kroah-Hartman <gregkh@...uxfoundation.org>,
        Alon Ronen <aronen@...iper.net>,
        Debjit Ghosh <dghosh@...iper.net>,
        Dhruva Diveneni <ddevineni@...iper.net>,
        Georgi Vlaev <gvlaev@...iper.net>,
        Guenter Roeck <linux@...ck-us.net>,
        Yu-Lin Lu <ylu@...iper.net>,
        Pantelis Antoniou <pantelis.antoniou@...sulko.com>,
        devicetree@...r.kernel.org, linux-kernel@...r.kernel.org,
        devel@...verdev.osuosl.org
Subject: [RFC 2/2] staging: jnx-connector: add device tree binding

From: Guenter Roeck <groeck@...iper.net>

Add documentation for the Juniper connector driver.

Signed-off-by: Alon Ronen <aronen@...iper.net>
Signed-off-by: Guenter Roeck <groeck@...iper.net>
[Ported from Juniper kernel]
Signed-off-by: Pantelis Antoniou <pantelis.antoniou@...sulko.com>
---
 .../devicetree/bindings/jnx/jnx-connector          | 59 ++++++++++++++++++++++
 1 file changed, 59 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/jnx/jnx-connector

diff --git a/Documentation/devicetree/bindings/jnx/jnx-connector b/Documentation/devicetree/bindings/jnx/jnx-connector
new file mode 100644
index 0000000..9262752
--- /dev/null
+++ b/Documentation/devicetree/bindings/jnx/jnx-connector
@@ -0,0 +1,59 @@
+Device-Tree bindings for Juniper connector driver
+
+Required properties:
+	- compatible - Must be one of
+	  - "jnx,pic-connector"
+	  - "jnx,sib-connector"
+	  - "jnx,fpc-connector"
+	  - "jnx,cb-connector"
+	  - "jnx,psm-connector"
+	  - "jnx,fan-connector"
+	  - "jnx,mp-connector"
+	  - "jnx,fpm-connector"
+	  - "jnx,spmb-connector"
+	  "simple-bus" must also be specified to facilitate instantiation.
+	- slot - slot number
+
+Optional properties:
+	- assembly-id - Static assembly ID to be used for all adapters.
+			If specified, it is assumed that no ID eeprom is
+			present, and the provided assembly ID will always be
+			used to identify the adapter and the devicetree overlay
+			to load.
+	- presence-detect-gpios - presence detect gpio pin
+				  If not provided, card is assumed
+				  to be always present.
+	- attention-button-gpios - request button gpio pin
+	- attention-button-ignore - set if kernel shall ignore
+				    attention button events
+	- attention-button-holdtime - button hold time in milli-seconds
+				      (3s default)
+	- activation-timeout - activation timeout in milli-seconds (10s default)
+	- debounce-interval - debounce interval in milli-seconds
+				(applies to presence detect pin).
+	- power-enable-gpios - power enable gpio pin
+	- power-status-gpios - power status gpio pin (mandatory if
+			       power-enable-gpios is provided)
+	- power-enable-timeout - power enable timeout in ms (1s default)
+	- poweron-reset-delay - delay to be applied after poweron in
+				milli-seconds (default none)
+	- reset-gpios - board reset gpio pin
+	- led-green - phandle pointing to green LED
+	- led-red - phandle pointing to red LED
+	- sysfs-linkname - name to be user for the symbolic link under jnx/card
+
+Example node:
+
+	pic0 {
+		compatible = "jnx,pic-connector", "simple-bus";
+		slot = <0>;
+		presence-detect-gpios = <&gpio1 148 0x10013>;
+		attention-button-gpios = <&gpio20 150 0x10013>;
+		power-enable-gpios = <&gpio1 154 0x0>;
+		power-status-gpios = <&gpio1 151 0x3>;
+		reset-gpios = <&gpio1 153 0x10000>;
+		power-enable-timeout = <2000>;
+		debounce-interval = <1>;
+		led-green = <&pic0_green>;
+		led-red = <&pic0_red>;
+	};
-- 
1.9.1