Messages in this thread | | | Subject | Re: [PATCH v4] dt-binding: phy: convert ti,omap-usb2 to YAML | From | Roger Quadros <> | Date | Mon, 24 Aug 2020 10:47:08 +0300 |
| |
Hi,
On 21/08/2020 11:11, Roger Quadros wrote: > Move ti,omap-usb2 to its own YAML schema. > > Signed-off-by: Roger Quadros <rogerq@ti.com> > Reviewed-by: Rob Herring <robh@kernel.org> > --- > > v4 > - fix example to fix dt_binding_check warnings > - '#phy-cells' -> "#phy-cells" > - Add 'oneOf' to compatible logic to allow just "ti,omap-usb2" as valid > > v3 > - Removed quotes from compatibles > - changed property to "ti,disable-charger-det" > > v2 > - Address Rob's comments on YAML schema. > > .../devicetree/bindings/phy/ti,omap-usb2.yaml | 72 +++++++++++++++++++ > .../devicetree/bindings/phy/ti-phy.txt | 37 ---------- > 2 files changed, 72 insertions(+), 37 deletions(-) > create mode 100644 Documentation/devicetree/bindings/phy/ti,omap-usb2.yaml > > diff --git a/Documentation/devicetree/bindings/phy/ti,omap-usb2.yaml b/Documentation/devicetree/bindings/phy/ti,omap-usb2.yaml > new file mode 100644 > index 000000000000..a05110351814 > --- /dev/null > +++ b/Documentation/devicetree/bindings/phy/ti,omap-usb2.yaml > @@ -0,0 +1,72 @@ > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/phy/ti,omap-usb2.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: OMAP USB2 PHY > + > +maintainers: > + - Kishon Vijay Abraham I <kishon@ti.com> > + - Roger Quadros <rogerq@ti.com> > + > +properties: > + compatible: > + oneOf: > + - items: > + - enum: > + - ti,dra7x-usb2 > + - ti,dra7x-usb2-phy2 > + - ti,am654-usb2
I missed these two. "ti,omap5-usb2" "ti,am437x-usb2"
While "ti,am437x-usb2" is being used in the device tree files I don't see "ti,omap5-usb2" being used anywhere.
omap5-l4.dtsi uses "ti,omap-usb2"
Should we get rid of "ti,omap5-usb2"?
cheers, -roger
> + - enum: > + - ti,omap-usb2 > + - items: > + - const: ti,omap-usb2 > + > + reg: > + maxItems: 1 > + > + "#phy-cells": > + const: 0 > + > + clocks: > + minItems: 1 > + items: > + - description: wakeup clock > + - description: reference clock > + > + clock-names: > + minItems: 1 > + items: > + - const: wkupclk > + - const: refclk > + > + syscon-phy-power: > + $ref: /schemas/types.yaml#definitions/phandle-array > + description: > + phandle/offset pair. Phandle to the system control module and > + register offset to power on/off the PHY. > + > + ctrl-module: > + $ref: /schemas/types.yaml#definitions/phandle > + description: > + (deprecated) phandle of the control module used by PHY driver > + to power on the PHY. Use syscon-phy-power instead. > + > +required: > + - compatible > + - reg > + - "#phy-cells" > + - clocks > + - clock-names > + > +examples: > + - | > + usb0_phy: phy@4100000 { > + compatible = "ti,am654-usb2", "ti,omap-usb2"; > + reg = <0x4100000 0x54>; > + syscon-phy-power = <&scm_conf 0x4000>; > + clocks = <&k3_clks 151 0>, <&k3_clks 151 1>; > + clock-names = "wkupclk", "refclk"; > + #phy-cells = <0>; > + }; > diff --git a/Documentation/devicetree/bindings/phy/ti-phy.txt b/Documentation/devicetree/bindings/phy/ti-phy.txt > index 8f93c3b694a7..60c9d0ac75e6 100644 > --- a/Documentation/devicetree/bindings/phy/ti-phy.txt > +++ b/Documentation/devicetree/bindings/phy/ti-phy.txt > @@ -27,43 +27,6 @@ omap_control_usb: omap-control-usb@4a002300 { > reg-names = "otghs_control"; > }; > > -OMAP USB2 PHY > - > -Required properties: > - - compatible: Should be "ti,omap-usb2" > - Should be "ti,dra7x-usb2" for the 1st instance of USB2 PHY on > - DRA7x > - Should be "ti,dra7x-usb2-phy2" for the 2nd instance of USB2 PHY > - in DRA7x > - Should be "ti,am654-usb2" for the USB2 PHYs on AM654. > - - reg : Address and length of the register set for the device. > - - #phy-cells: determine the number of cells that should be given in the > - phandle while referencing this phy. > - - clocks: a list of phandles and clock-specifier pairs, one for each entry in > - clock-names. > - - clock-names: should include: > - * "wkupclk" - wakeup clock. > - * "refclk" - reference clock (optional). > - > -Deprecated properties: > - - ctrl-module : phandle of the control module used by PHY driver to power on > - the PHY. > - > -Recommended properies: > -- syscon-phy-power : phandle/offset pair. Phandle to the system control > - module and the register offset to power on/off the PHY. > - > -This is usually a subnode of ocp2scp to which it is connected. > - > -usb2phy@4a0ad080 { > - compatible = "ti,omap-usb2"; > - reg = <0x4a0ad080 0x58>; > - ctrl-module = <&omap_control_usb>; > - #phy-cells = <0>; > - clocks = <&usb_phy_cm_clk32k>, <&usb_otg_ss_refclk960m>; > - clock-names = "wkupclk", "refclk"; > -}; > - > TI PIPE3 PHY > > Required properties: >
-- Texas Instruments Finland Oy, Porkkalankatu 22, 00180 Helsinki. Y-tunnus/Business ID: 0615521-4. Kotipaikka/Domicile: Helsinki
| |