Hi Rob, On Tue, Sep 29, 2020 at 03:17:01PM -0500, Rob Herring wrote: > On Mon, Sep 28, 2020 at 10:13:54AM -0700, Matthias Kaehlcke wrote: > > Discrete onboard USB hubs (an example for such a hub is the Realtek > > RTS5411) need to be powered and may require initialization of other > > resources (like GPIOs or clocks) to work properly. This adds a device > > tree binding for these hubs. > > > > Signed-off-by: Matthias Kaehlcke <mka@xxxxxxxxxxxx> > > --- > > > > (no changes since v3) > > > > Changes in v3: > > - updated commit message > > - removed recursive reference to $self > > - adjusted 'compatible' definition to support multiple entries > > - changed USB controller phandle to be a node > > > > Changes in v2: > > - removed 'wakeup-source' and 'power-off-in-suspend' properties > > - consistently use spaces for indentation in example > > > > .../bindings/usb/onboard_usb_hub.yaml | 54 +++++++++++++++++++ > > 1 file changed, 54 insertions(+) > > create mode 100644 Documentation/devicetree/bindings/usb/onboard_usb_hub.yaml > > > > diff --git a/Documentation/devicetree/bindings/usb/onboard_usb_hub.yaml b/Documentation/devicetree/bindings/usb/onboard_usb_hub.yaml > > new file mode 100644 > > index 000000000000..c9783da3e75c > > --- /dev/null > > +++ b/Documentation/devicetree/bindings/usb/onboard_usb_hub.yaml > > @@ -0,0 +1,54 @@ > > +# SPDX-License-Identifier: GPL-2.0-only or BSD-2-Clause > > +%YAML 1.2 > > +--- > > +$id: http://devicetree.org/schemas/usb/onboard_usb_hub.yaml# > > +$schema: http://devicetree.org/meta-schemas/core.yaml# > > + > > +title: Binding for onboard USB hubs > > + > > +maintainers: > > + - Matthias Kaehlcke <mka@xxxxxxxxxxxx> > > + > > +properties: > > + compatible: > > + items: > > + - enum: > > + - realtek,rts5411 > > + - const: onboard-usb-hub > > + > > + vdd-supply: > > + description: > > + phandle to the regulator that provides power to the hub. > > + > > +required: > > + - compatible > > + - vdd-supply > > + > > +examples: > > + - | > > + usb_hub: usb-hub { > > + compatible = "realtek,rts5411", "onboard-usb-hub"; > > + vdd-supply = <&pp3300_hub>; > > + }; > > As I said in prior version, this separate node and 'hub' phandle is not > going to work. You are doing this because you want a platform driver for > "realtek,rts5411". That may be convenient for Linux, but doesn't reflect > the h/w. I agree that the hardware representation isn't totally straightforward, however the description isn't limited to Linux: - there is a single IC (like the Realtek RTS5411) - the IC may require several resources to be initialized in a certain way - this may require executing hardware specific code by some driver, which isn't a USB device driver - the IC can 'contain' multiple USB hub devices, which can be connected to separate USB busses - the IC doesn't have a control bus, which somewhat resembles the 'simple-audio-amplifier' driver, which also registers a platform device to initialize its resources - to provide the functionality of powering down the hub conditionally during system suspend the driver (whether it's a platform driver or something else) needs know which USB (hub) devices correspond to it. This is a real world problem, on hardware that might see wide distribution. There were several attempts to solve this problem in the past, but none of them was accepted. So far Alan Stern seems to think the driver (not necessarily the binding as is) is a suitable solution, Greg KH also spent time reviewing it, without raising conceptual concerns. So it seems we have solution that would be generally landable from the USB side. I understand that your goal is to keep the device tree sane, which I'm sure can be challenging. If you really can't be convinced that the binding might be acceptable in its current or similiar form then please offer guidance on possible alternatives which allow to achieve the same functionality. Thanks Matthias
