From: Robert Baldyga <r.baldyga@samsung.com>
To: cw00.choi@samsung.com
Cc: myungjoo.ham@samsung.com, rogerq@ti.com,
linux-usb@vger.kernel.org, devicetree@vger.kernel.org,
linux-kernel@vger.kernel.org, m.szyprowski@samsung.com,
Robert Baldyga <r.baldyga@samsung.com>
Subject: [PATCH v3 4/4] Documentation: extcon: usb-gpio: update usb-gpio binding description
Date: Thu, 02 Apr 2015 15:13:05 +0200 [thread overview]
Message-ID: <1427980385-21285-5-git-send-email-r.baldyga@samsung.com> (raw)
In-Reply-To: <1427980385-21285-1-git-send-email-r.baldyga@samsung.com>
Add information about VBUS pin detection support, 'debounce' property
and some other details.
Signed-off-by: Robert Baldyga <r.baldyga@samsung.com>
Acked-by: Roger Quadros <rogerq@ti.com>
---
.../devicetree/bindings/extcon/extcon-usb-gpio.txt | 28 ++++++++++++++++++++--
1 file changed, 26 insertions(+), 2 deletions(-)
diff --git a/Documentation/devicetree/bindings/extcon/extcon-usb-gpio.txt b/Documentation/devicetree/bindings/extcon/extcon-usb-gpio.txt
index af0b903..7096f39 100644
--- a/Documentation/devicetree/bindings/extcon/extcon-usb-gpio.txt
+++ b/Documentation/devicetree/bindings/extcon/extcon-usb-gpio.txt
@@ -1,16 +1,40 @@
USB GPIO Extcon device
-This is a virtual device used to generate USB cable states from the USB ID pin
-connected to a GPIO pin.
+This is a virtual device used to generate USB cable states from the USB
+ID and VBUS signals connected to GPIO pins.
+
+The extcon cable states USB and USB_HOST are actually VBUS and !ID
+pin states and do not indicate what mode the USB needs to operate in.
+That decision is done by the USB stack.
+
+Some devices have only one of these GPIO pins, so we support cases when
+only one of them is present. Hence properties 'id-gpio' and 'vbus-gpio'
+are described as optional, but at least one of them has to be present
+in extcon-usb-gpio node.
+
+In general we have three cases:
+1. If VBUS and ID gpios are present we pass them as is
+ USB-HOST = !ID, USB = VBUS
+2. If only VBUS gpio is present we assume that ID pin is always High.
+ USB-HOST = false, USB = VBUS.
+3. If only ID pin is available we infer the VBUS pin states based on ID.
+ USB-HOST = !ID, USB = ID
Required properties:
- compatible: Should be "linux,extcon-usb-gpio"
+
+Optional properties
- id-gpio: gpio for USB ID pin. See gpio binding.
+- vbus-gpio: gpio for USB VBUS pin. See gpio binding.
+- debounce: gpio debounce time in milliseconds (u32).
+
Example: Examples of extcon-usb-gpio node in dra7-evm.dts as listed below:
extcon_usb1 {
compatible = "linux,extcon-usb-gpio";
id-gpio = <&gpio6 1 GPIO_ACTIVE_HIGH>;
+ vbus-gpio = <&gpio6 2 GPIO_ACTIVE_HIGH>;
+ debounce = <25>;
}
&omap_dwc3_1 {
--
1.9.1
prev parent reply other threads:[~2015-04-02 13:13 UTC|newest]
Thread overview: 39+ messages / expand[flat|nested] mbox.gz Atom feed top
2015-04-02 13:13 [PATCH v3 0/4] extcon: usb-gpio: fixes and improvements Robert Baldyga
2015-04-02 13:13 ` [PATCH v3 1/4] extcon: usb-gpio: register extcon device before IRQ registration Robert Baldyga
2015-04-03 0:09 ` Chanwoo Choi
2015-04-02 13:13 ` [PATCH v3 2/4] extcon: usb-gpio: add support for VBUS detection Robert Baldyga
2015-04-02 14:02 ` Roger Quadros
2015-04-09 2:12 ` Chanwoo Choi
2015-04-09 7:57 ` Robert Baldyga
2015-04-09 9:07 ` Chanwoo Choi
2015-04-09 9:24 ` Robert Baldyga
2015-04-09 9:59 ` Roger Quadros
2015-04-09 10:18 ` Robert Baldyga
2015-04-10 7:39 ` Chanwoo Choi
2015-04-10 7:17 ` Chanwoo Choi
2015-04-10 7:45 ` Robert Baldyga
2015-04-10 8:10 ` Chanwoo Choi
2015-04-10 8:46 ` Robert Baldyga
2015-04-10 9:18 ` Chanwoo Choi
2015-04-10 9:42 ` Robert Baldyga
2015-04-14 10:01 ` Roger Quadros
2015-04-14 10:02 ` Roger Quadros
2015-04-14 10:31 ` Chanwoo Choi
2015-04-14 10:38 ` Roger Quadros
2015-04-14 11:29 ` Chanwoo Choi
2015-04-15 3:27 ` Peter Chen
2015-04-15 7:50 ` Roger Quadros
2015-04-15 9:26 ` Chanwoo Choi
2015-04-16 1:59 ` Peter Chen
2015-04-16 7:00 ` Chanwoo Choi
2015-04-16 7:13 ` Ivan T. Ivanov
2015-04-16 7:59 ` Chanwoo Choi
2015-04-16 8:01 ` Peter Chen
2015-04-16 8:26 ` Chanwoo Choi
2015-04-30 7:32 ` Roger Quadros
2015-04-30 7:55 ` Chanwoo Choi
2015-04-30 8:04 ` Roger Quadros
2015-04-16 7:59 ` Peter Chen
2015-04-16 7:16 ` Roger Quadros
2015-04-02 13:13 ` [PATCH v3 3/4] extcon: usb-gpio: make debounce value configurable in devicetree Robert Baldyga
2015-04-02 13:13 ` Robert Baldyga [this message]
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=1427980385-21285-5-git-send-email-r.baldyga@samsung.com \
--to=r.baldyga@samsung.com \
--cc=cw00.choi@samsung.com \
--cc=devicetree@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-usb@vger.kernel.org \
--cc=m.szyprowski@samsung.com \
--cc=myungjoo.ham@samsung.com \
--cc=rogerq@ti.com \
/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).