Re: [PATCH v2 2/5] usb: DT binding documentation for qoriq usb 2.0 controller
On Sat, Jul 09, 2016 at 10:00:53AM +0530, Rajesh Bhagat wrote:
> Describes the qoriq usb 2.0 controller driver binding, currently used
> for LS1021A and LS1012A platform.
>
> Signed-off-by: Rajesh Bhagat
> ---
> Changes in v2:
> - Adds DT binding documentation for qoriq usb 2.0 controller
> - Changed the compatible string to fsl,ci-qoriq-usb2
>
> .../devicetree/bindings/usb/ci-hdrc-qoriq.txt | 34
> ++
> 1 file changed, 34 insertions(+)
> create mode 100644 Documentation/devicetree/bindings/usb/ci-hdrc-qoriq.txt
>
> diff --git a/Documentation/devicetree/bindings/usb/ci-hdrc-qoriq.txt
> b/Documentation/devicetree/bindings/usb/ci-hdrc-qoriq.txt
> new file mode 100644
> index 000..8ad7306
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/usb/ci-hdrc-qoriq.txt
> @@ -0,0 +1,34 @@
> +* Freescale QorIQ SoC USB 2.0 Controllers
> +
> +Required properties:
> +- compatible: Should be "fsl,ci-qoriq-usb2"
> + Wherever applicable, the IP version of the USB controller should
> + also be mentioned (for eg. fsl,ci-qoriq-usb2-vX.Y).
> + where, X.Y is IP version of USB controller.
Please document known IP versions.
> +- reg: Should contain registers location and length
> +- interrupts: Should contain controller interrupt
> +- phy-names: from the *Generic PHY* bindings
> +- phys: from the *Generic PHY* bindings
> +- clocks: clock provider specifier
> +- clock-names: shall be "usb2-clock"
clock-names is kind of pointless for a single clock and '-clock' is
redundant.
> +Refer to clk/clock-bindings.txt for generic clock consumer properties
> +
> +Recommended properties:
> +- dr_mode: One of "host" or "peripheral".
> +- phy_type: the type of the phy connected to the core. Should be one
> + of "utmi", "utmi_wide", "ulpi", "serial" or "hsic". Without this
> + property the PORTSC register won't be touched
> +
> +Examples:
> +usb@860 {
> + compatible = "fsl,ci-qoriq-usb2",
> + "fsl,ci-qoriq-usb2-v2.5";
Order should be most specific to least specific.
> + reg = <0x0 0x860 0x0 0x1000>;
> + interrupts = <0 139 0x4>;
> + phy-names = "usb2-phy";
> + phys = <&usbphy0>;
> + clock-names = "usb2-clock";
> + clocks = <&clockgen 4 3>;
> + dr_mode = "host";
> + phy_type = "ulpi";
> +};
> --
> 2.6.2.198.g614a2ac
>
RE: [PATCH v2 2/5] usb: DT binding documentation for qoriq usb 2.0 controller
> -Original Message- > From: Peter Chen [mailto:hzpeterc...@gmail.com] > Sent: Friday, July 15, 2016 12:45 PM > To: Rajesh Bhagat > Cc: linux-...@vger.kernel.org; linux-kernel@vger.kernel.org; > devicet...@vger.kernel.org; Peter Chen ; > gre...@linuxfoundation.org; kis...@ti.com; robh...@kernel.org; > shawn...@kernel.org; linux-arm-ker...@lists.infradead.org > Subject: Re: [PATCH v2 2/5] usb: DT binding documentation for qoriq usb 2.0 > controller > > On Tue, Jul 12, 2016 at 03:59:14AM +, Rajesh Bhagat wrote: > > > > > > > -Original Message- > > > From: Peter Chen [mailto:hzpeterc...@gmail.com] > > > Sent: Monday, July 11, 2016 12:19 PM > > > To: Rajesh Bhagat > > > Cc: linux-...@vger.kernel.org; linux-kernel@vger.kernel.org; > > > devicet...@vger.kernel.org; Peter Chen ; > > > gre...@linuxfoundation.org; kis...@ti.com; robh...@kernel.org; > > > shawn...@kernel.org; linux-arm-ker...@lists.infradead.org > > > Subject: Re: [PATCH v2 2/5] usb: DT binding documentation for qoriq > > > usb 2.0 controller > > > > > > On Sat, Jul 09, 2016 at 10:00:53AM +0530, Rajesh Bhagat wrote: > > > > Describes the qoriq usb 2.0 controller driver binding, currently > > > > used for LS1021A and LS1012A platform. > > > > > > > > Signed-off-by: Rajesh Bhagat > > > > --- > > > > Changes in v2: > > > > - Adds DT binding documentation for qoriq usb 2.0 controller > > > > - Changed the compatible string to fsl,ci-qoriq-usb2 > > > > > > > > .../devicetree/bindings/usb/ci-hdrc-qoriq.txt | 34 > > > ++ > > > > 1 file changed, 34 insertions(+) > > > > create mode 100644 > > > > Documentation/devicetree/bindings/usb/ci-hdrc-qoriq.txt > > > > > > > > diff --git > > > > a/Documentation/devicetree/bindings/usb/ci-hdrc-qoriq.txt > > > > b/Documentation/devicetree/bindings/usb/ci-hdrc-qoriq.txt > > > > new file mode 100644 > > > > index 000..8ad7306 > > > > --- /dev/null > > > > +++ b/Documentation/devicetree/bindings/usb/ci-hdrc-qoriq.txt > > > > @@ -0,0 +1,34 @@ > > > > +* Freescale QorIQ SoC USB 2.0 Controllers > > > > + > > > > +Required properties: > > > > +- compatible: Should be "fsl,ci-qoriq-usb2" > > > > + Wherever applicable, the IP version of the USB controller > > > > +should > > > > + also be mentioned (for eg. fsl,ci-qoriq-usb2-vX.Y). > > > > + where, X.Y is IP version of USB controller. > > > > Hello Peter, > > > > > > > > Why you need to add IP version at compatible string? > > > Does it can't be read out from ID register of Identification Registers. > > > > > > > I agree. Will drop this controller version thing in DTS in v3. > > > > > > +- reg: Should contain registers location and length > > > > +- interrupts: Should contain controller interrupt > > > > +- phy-names: from the *Generic PHY* bindings > > > > +- phys: from the *Generic PHY* bindings > > > > +- clocks: clock provider specifier > > > > +- clock-names: shall be "usb2-clock" > > > > +Refer to clk/clock-bindings.txt for generic clock consumer > > > > +properties > > > > + > > > > +Recommended properties: > > > > +- dr_mode: One of "host" or "peripheral". > > > > > > Do you support dual-role? > > > > > > > Yes. We do support both host/peripheral mode. > > > Hello Peter, > I mean dual-role switch. If you support that, the dr_mode should be "otg". > For now, we don't support otg mode. Best Regards, Rajesh Bhagat > -- > > Best Regards, > Peter Chen
Re: [PATCH v2 2/5] usb: DT binding documentation for qoriq usb 2.0 controller
On Tue, Jul 12, 2016 at 03:59:14AM +, Rajesh Bhagat wrote: > > > > -Original Message- > > From: Peter Chen [mailto:hzpeterc...@gmail.com] > > Sent: Monday, July 11, 2016 12:19 PM > > To: Rajesh Bhagat > > Cc: linux-...@vger.kernel.org; linux-kernel@vger.kernel.org; > > devicet...@vger.kernel.org; Peter Chen ; > > gre...@linuxfoundation.org; kis...@ti.com; robh...@kernel.org; > > shawn...@kernel.org; linux-arm-ker...@lists.infradead.org > > Subject: Re: [PATCH v2 2/5] usb: DT binding documentation for qoriq usb 2.0 > > controller > > > > On Sat, Jul 09, 2016 at 10:00:53AM +0530, Rajesh Bhagat wrote: > > > Describes the qoriq usb 2.0 controller driver binding, currently used > > > for LS1021A and LS1012A platform. > > > > > > Signed-off-by: Rajesh Bhagat > > > --- > > > Changes in v2: > > > - Adds DT binding documentation for qoriq usb 2.0 controller > > > - Changed the compatible string to fsl,ci-qoriq-usb2 > > > > > > .../devicetree/bindings/usb/ci-hdrc-qoriq.txt | 34 > > ++ > > > 1 file changed, 34 insertions(+) > > > create mode 100644 > > > Documentation/devicetree/bindings/usb/ci-hdrc-qoriq.txt > > > > > > diff --git a/Documentation/devicetree/bindings/usb/ci-hdrc-qoriq.txt > > > b/Documentation/devicetree/bindings/usb/ci-hdrc-qoriq.txt > > > new file mode 100644 > > > index 000..8ad7306 > > > --- /dev/null > > > +++ b/Documentation/devicetree/bindings/usb/ci-hdrc-qoriq.txt > > > @@ -0,0 +1,34 @@ > > > +* Freescale QorIQ SoC USB 2.0 Controllers > > > + > > > +Required properties: > > > +- compatible: Should be "fsl,ci-qoriq-usb2" > > > + Wherever applicable, the IP version of the USB controller should > > > + also be mentioned (for eg. fsl,ci-qoriq-usb2-vX.Y). > > > + where, X.Y is IP version of USB controller. > > Hello Peter, > > > > > Why you need to add IP version at compatible string? > > Does it can't be read out from ID register of Identification Registers. > > > > I agree. Will drop this controller version thing in DTS in v3. > > > > +- reg: Should contain registers location and length > > > +- interrupts: Should contain controller interrupt > > > +- phy-names: from the *Generic PHY* bindings > > > +- phys: from the *Generic PHY* bindings > > > +- clocks: clock provider specifier > > > +- clock-names: shall be "usb2-clock" > > > +Refer to clk/clock-bindings.txt for generic clock consumer properties > > > + > > > +Recommended properties: > > > +- dr_mode: One of "host" or "peripheral". > > > > Do you support dual-role? > > > > Yes. We do support both host/peripheral mode. > I mean dual-role switch. If you support that, the dr_mode should be "otg". -- Best Regards, Peter Chen
RE: [PATCH v2 2/5] usb: DT binding documentation for qoriq usb 2.0 controller
> -Original Message-
> From: Peter Chen [mailto:hzpeterc...@gmail.com]
> Sent: Monday, July 11, 2016 12:19 PM
> To: Rajesh Bhagat
> Cc: linux-...@vger.kernel.org; linux-kernel@vger.kernel.org;
> devicet...@vger.kernel.org; Peter Chen ;
> gre...@linuxfoundation.org; kis...@ti.com; robh...@kernel.org;
> shawn...@kernel.org; linux-arm-ker...@lists.infradead.org
> Subject: Re: [PATCH v2 2/5] usb: DT binding documentation for qoriq usb 2.0
> controller
>
> On Sat, Jul 09, 2016 at 10:00:53AM +0530, Rajesh Bhagat wrote:
> > Describes the qoriq usb 2.0 controller driver binding, currently used
> > for LS1021A and LS1012A platform.
> >
> > Signed-off-by: Rajesh Bhagat
> > ---
> > Changes in v2:
> > - Adds DT binding documentation for qoriq usb 2.0 controller
> > - Changed the compatible string to fsl,ci-qoriq-usb2
> >
> > .../devicetree/bindings/usb/ci-hdrc-qoriq.txt | 34
> ++
> > 1 file changed, 34 insertions(+)
> > create mode 100644
> > Documentation/devicetree/bindings/usb/ci-hdrc-qoriq.txt
> >
> > diff --git a/Documentation/devicetree/bindings/usb/ci-hdrc-qoriq.txt
> > b/Documentation/devicetree/bindings/usb/ci-hdrc-qoriq.txt
> > new file mode 100644
> > index 000..8ad7306
> > --- /dev/null
> > +++ b/Documentation/devicetree/bindings/usb/ci-hdrc-qoriq.txt
> > @@ -0,0 +1,34 @@
> > +* Freescale QorIQ SoC USB 2.0 Controllers
> > +
> > +Required properties:
> > +- compatible: Should be "fsl,ci-qoriq-usb2"
> > + Wherever applicable, the IP version of the USB controller should
> > + also be mentioned (for eg. fsl,ci-qoriq-usb2-vX.Y).
> > + where, X.Y is IP version of USB controller.
Hello Peter,
>
> Why you need to add IP version at compatible string?
> Does it can't be read out from ID register of Identification Registers.
>
I agree. Will drop this controller version thing in DTS in v3.
> > +- reg: Should contain registers location and length
> > +- interrupts: Should contain controller interrupt
> > +- phy-names: from the *Generic PHY* bindings
> > +- phys: from the *Generic PHY* bindings
> > +- clocks: clock provider specifier
> > +- clock-names: shall be "usb2-clock"
> > +Refer to clk/clock-bindings.txt for generic clock consumer properties
> > +
> > +Recommended properties:
> > +- dr_mode: One of "host" or "peripheral".
>
> Do you support dual-role?
>
Yes. We do support both host/peripheral mode.
Best Regards,
Rajesh Bhagat
> > +- phy_type: the type of the phy connected to the core. Should be one
> > + of "utmi", "utmi_wide", "ulpi", "serial" or "hsic". Without this
> > + property the PORTSC register won't be touched
> > +
> > +Examples:
> > +usb@860 {
> > + compatible = "fsl,ci-qoriq-usb2",
> > + "fsl,ci-qoriq-usb2-v2.5";
> > + reg = <0x0 0x860 0x0 0x1000>;
> > + interrupts = <0 139 0x4>;
> > + phy-names = "usb2-phy";
> > + phys = <&usbphy0>;
> > + clock-names = "usb2-clock";
> > + clocks = <&clockgen 4 3>;
> > + dr_mode = "host";
> > + phy_type = "ulpi";
> > +};
> > --
> > 2.6.2.198.g614a2ac
> >
> > --
> > To unsubscribe from this list: send the line "unsubscribe linux-usb"
> > in the body of a message to majord...@vger.kernel.org More majordomo
> > info at http://vger.kernel.org/majordomo-info.html
>
> --
>
> Best Regards,
> Peter Chen
Re: [PATCH v2 2/5] usb: DT binding documentation for qoriq usb 2.0 controller
On Sat, Jul 09, 2016 at 10:00:53AM +0530, Rajesh Bhagat wrote:
> Describes the qoriq usb 2.0 controller driver binding, currently used
> for LS1021A and LS1012A platform.
>
> Signed-off-by: Rajesh Bhagat
> ---
> Changes in v2:
> - Adds DT binding documentation for qoriq usb 2.0 controller
> - Changed the compatible string to fsl,ci-qoriq-usb2
>
> .../devicetree/bindings/usb/ci-hdrc-qoriq.txt | 34
> ++
> 1 file changed, 34 insertions(+)
> create mode 100644 Documentation/devicetree/bindings/usb/ci-hdrc-qoriq.txt
>
> diff --git a/Documentation/devicetree/bindings/usb/ci-hdrc-qoriq.txt
> b/Documentation/devicetree/bindings/usb/ci-hdrc-qoriq.txt
> new file mode 100644
> index 000..8ad7306
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/usb/ci-hdrc-qoriq.txt
> @@ -0,0 +1,34 @@
> +* Freescale QorIQ SoC USB 2.0 Controllers
> +
> +Required properties:
> +- compatible: Should be "fsl,ci-qoriq-usb2"
> + Wherever applicable, the IP version of the USB controller should
> + also be mentioned (for eg. fsl,ci-qoriq-usb2-vX.Y).
> + where, X.Y is IP version of USB controller.
Why you need to add IP version at compatible string?
Does it can't be read out from ID register of Identification Registers.
> +- reg: Should contain registers location and length
> +- interrupts: Should contain controller interrupt
> +- phy-names: from the *Generic PHY* bindings
> +- phys: from the *Generic PHY* bindings
> +- clocks: clock provider specifier
> +- clock-names: shall be "usb2-clock"
> +Refer to clk/clock-bindings.txt for generic clock consumer properties
> +
> +Recommended properties:
> +- dr_mode: One of "host" or "peripheral".
Do you support dual-role?
> +- phy_type: the type of the phy connected to the core. Should be one
> + of "utmi", "utmi_wide", "ulpi", "serial" or "hsic". Without this
> + property the PORTSC register won't be touched
> +
> +Examples:
> +usb@860 {
> + compatible = "fsl,ci-qoriq-usb2",
> + "fsl,ci-qoriq-usb2-v2.5";
> + reg = <0x0 0x860 0x0 0x1000>;
> + interrupts = <0 139 0x4>;
> + phy-names = "usb2-phy";
> + phys = <&usbphy0>;
> + clock-names = "usb2-clock";
> + clocks = <&clockgen 4 3>;
> + dr_mode = "host";
> + phy_type = "ulpi";
> +};
> --
> 2.6.2.198.g614a2ac
>
> --
> To unsubscribe from this list: send the line "unsubscribe linux-usb" in
> the body of a message to majord...@vger.kernel.org
> More majordomo info at http://vger.kernel.org/majordomo-info.html
--
Best Regards,
Peter Chen
