From: Pantelis Antoniou <pantelis.antoniou@konsulko.com>
To: Rob Herring <robh+dt@kernel.org>, Mark Rutland <mark.rutland@arm.com>
Cc: Frank Rowand <frowand.list@gmail.com>,
Greg Kroah-Hartman <gregkh@linuxfoundation.org>,
Alon Ronen <aronen@juniper.net>,
Debjit Ghosh <dghosh@juniper.net>,
Dhruva Diveneni <ddevineni@juniper.net>,
Georgi Vlaev <gvlaev@juniper.net>,
Guenter Roeck <linux@roeck-us.net>, Yu-Lin Lu <ylu@juniper.net>,
Pantelis Antoniou <pantelis.antoniou@konsulko.com>,
devicetree@vger.kernel.org, linux-kernel@vger.kernel.org,
devel@driverdev.osuosl.org
Subject: [RFC 2/2] staging: jnx-connector: add device tree binding
Date: Fri, 7 Oct 2016 18:16:12 +0300 [thread overview]
Message-ID: <1475853372-21997-3-git-send-email-pantelis.antoniou@konsulko.com> (raw)
In-Reply-To: <1475853372-21997-1-git-send-email-pantelis.antoniou@konsulko.com>
From: Guenter Roeck <groeck@juniper.net>
Add documentation for the Juniper connector driver.
Signed-off-by: Alon Ronen <aronen@juniper.net>
Signed-off-by: Guenter Roeck <groeck@juniper.net>
[Ported from Juniper kernel]
Signed-off-by: Pantelis Antoniou <pantelis.antoniou@konsulko.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
next prev parent reply other threads:[~2016-10-07 15:20 UTC|newest]
Thread overview: 9+ messages / expand[flat|nested] mbox.gz Atom feed top
2016-10-07 15:16 [RFC 0/2] Juniper DT based connector driver Pantelis Antoniou
2016-10-07 15:16 ` [RFC 1/2] staging: jnx: Add Juniper " Pantelis Antoniou
2016-10-07 16:25 ` Joe Perches
2016-10-07 18:57 ` Pantelis Antoniou
2016-10-07 15:16 ` Pantelis Antoniou [this message]
2016-10-08 16:05 ` [RFC 2/2] staging: jnx-connector: add device tree binding Rob Herring
2016-10-07 15:30 ` [RFC 0/2] Juniper DT based connector driver Greg Kroah-Hartman
2016-10-08 16:10 ` Rob Herring
2016-10-08 16:11 ` Pantelis Antoniou
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=1475853372-21997-3-git-send-email-pantelis.antoniou@konsulko.com \
--to=pantelis.antoniou@konsulko.com \
--cc=aronen@juniper.net \
--cc=ddevineni@juniper.net \
--cc=devel@driverdev.osuosl.org \
--cc=devicetree@vger.kernel.org \
--cc=dghosh@juniper.net \
--cc=frowand.list@gmail.com \
--cc=gregkh@linuxfoundation.org \
--cc=gvlaev@juniper.net \
--cc=linux-kernel@vger.kernel.org \
--cc=linux@roeck-us.net \
--cc=mark.rutland@arm.com \
--cc=robh+dt@kernel.org \
--cc=ylu@juniper.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;
as well as URLs for NNTP newsgroup(s).