From: Rob Herring <robh@kernel.org>
To: Sergio Prado <sergio.prado@e-labworks.com>
Cc: gregkh@linuxfoundation.org, mark.rutland@arm.com,
balbi@kernel.org, linux-usb@vger.kernel.org,
devicetree@vger.kernel.org, linux-kernel@vger.kernel.org
Subject: Re: [PATCH v2 1/2] dt-bindings: usb: add DT binding for s3c2410 USB device controller
Date: Wed, 18 Jan 2017 14:08:45 -0600 [thread overview]
Message-ID: <20170118200845.qj4qzgav4ffcz5pa@rob-hp-laptop> (raw)
In-Reply-To: <1484172150-32075-2-git-send-email-sergio.prado@e-labworks.com>
On Wed, Jan 11, 2017 at 08:02:29PM -0200, Sergio Prado wrote:
> Adds the device tree bindings description for Samsung S3C2410 and
> compatible USB device controller.
>
> Signed-off-by: Sergio Prado <sergio.prado@e-labworks.com>
> ---
> .../devicetree/bindings/usb/s3c2410-usb.txt | 28 ++++++++++++++++++++++
> 1 file changed, 28 insertions(+)
>
> diff --git a/Documentation/devicetree/bindings/usb/s3c2410-usb.txt b/Documentation/devicetree/bindings/usb/s3c2410-usb.txt
> index e45b38ce2986..28353eea31fd 100644
> --- a/Documentation/devicetree/bindings/usb/s3c2410-usb.txt
> +++ b/Documentation/devicetree/bindings/usb/s3c2410-usb.txt
> @@ -20,3 +20,31 @@ usb0: ohci@49000000 {
> clocks = <&clocks UCLK>, <&clocks HCLK_USBH>;
> clock-names = "usb-bus-host", "usb-host";
> };
> +
> +Samsung S3C2410 and compatible USB device controller
> +
> +Required properties:
> + - compatible: Should be one of the following
> + "samsung,s3c2410-udc"
> + "samsung,s3c2440-udc"
> + - reg: address and length of the controller memory mapped region
> + - interrupts: interrupt number for the USB device controller
> + - clocks: Should reference the bus and host clocks
> + - clock-names: Should contain two strings
> + "uclk" for the USB bus clock
> + "usb-device" for the USB device clock
Perhaps just "bus" and "device".
> +
> +Optional properties:
> + - samsung,vbus-gpio: specifies a gpio that allows to detect whether
> + vbus is present - USB is connected (active high, input).
> + - samsung,pullup-gpio: If present, specifies a gpio to control the
> + USB D+ pullup (active high, output).
"-gpios", not "-gpio" is preferred.
These should be common property names if we're going to have them. The
problem with just "vbus-gpios" is does that mean an enable control or
status as you have. I guess in the former case, that should always be
modeled as a regulator.
Also, these should all be part of a connector node as these controls are
more related to the USB connector than the controller. And I don't mean
extcon here because those bindings are a mess.
Rob
next prev parent reply other threads:[~2017-01-18 20:09 UTC|newest]
Thread overview: 6+ messages / expand[flat|nested] mbox.gz Atom feed top
2017-01-11 22:02 [PATCH v2 0/2] usb: gadget: s3c2410: add device tree support Sergio Prado
2017-01-11 22:02 ` [PATCH v2 1/2] dt-bindings: usb: add DT binding for s3c2410 USB device controller Sergio Prado
2017-01-16 10:34 ` Felipe Balbi
2017-01-18 20:08 ` Rob Herring [this message]
2017-01-24 18:21 ` Sergio Prado
2017-01-11 22:02 ` [PATCH v2 2/2] usb: gadget: s3c2410: allow probing from device tree Sergio Prado
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=20170118200845.qj4qzgav4ffcz5pa@rob-hp-laptop \
--to=robh@kernel.org \
--cc=balbi@kernel.org \
--cc=devicetree@vger.kernel.org \
--cc=gregkh@linuxfoundation.org \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-usb@vger.kernel.org \
--cc=mark.rutland@arm.com \
--cc=sergio.prado@e-labworks.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).