Re: [PATCH v2 1/2] dt-bindings: usb: add DT binding for s3c2410 USB device controller

From: Sergio Prado
Date: Tue Jan 24 2017 - 13:22:01 EST


On Wed, Jan 18, 2017 at 02:08:45PM -0600, Rob Herring wrote:
> On Wed, Jan 11, 2017 at 08:02:29PM -0200, Sergio Prado wrote:
> > + - 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".

OK, I'll rename.

> > +
> > +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.

There are other bindings that are doing the same thing I did, like the
property "atmel,vbus-gpio" in atmel-usb.txt and "samsung,vbus-gpio" in
exynos-usb.txt. Also, I did not find any example of a connector node doing
this. Can you point me out to an example, or should I just rename to
"-gpios" in this case?

>
> Rob

--
Sergio Prado
Embedded Labworks
Office: +55 11 2628-3461
Mobile: +55 11 97123-3420