Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

dt-bindings: phy: mxs-usb-phy: convert to DT schema format

Convert the binding to DT schema format. Besides, this also add clocks,
'#phy-cells', phy-3p0-supply and power-domains properties which are not
contained in txt file due to txt file lack updates.

Signed-off-by: Xu Yang <xu.yang_2@nxp.com>
Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Link: https://lore.kernel.org/r/20230613083445.1129137-1-xu.yang_2@nxp.com
Signed-off-by: Vinod Koul <vkoul@kernel.org>

authored by

Xu Yang and committed by
Vinod Koul
bbbfd032 1eac0f95

+125 -33
+125
Documentation/devicetree/bindings/phy/fsl,mxs-usbphy.yaml
··· 1 + # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) 2 + %YAML 1.2 3 + --- 4 + $id: http://devicetree.org/schemas/phy/fsl,mxs-usbphy.yaml# 5 + $schema: http://devicetree.org/meta-schemas/core.yaml# 6 + 7 + title: Freescale MXS USB Phy Device 8 + 9 + maintainers: 10 + - Xu Yang <xu.yang_2@nxp.com> 11 + 12 + properties: 13 + compatible: 14 + oneOf: 15 + - enum: 16 + - fsl,imx23-usbphy 17 + - fsl,imx7ulp-usbphy 18 + - fsl,vf610-usbphy 19 + - items: 20 + - enum: 21 + - fsl,imx28-usbphy 22 + - fsl,imx6ul-usbphy 23 + - fsl,imx6sl-usbphy 24 + - fsl,imx6sx-usbphy 25 + - fsl,imx6q-usbphy 26 + - const: fsl,imx23-usbphy 27 + - items: 28 + - const: fsl,imx6sll-usbphy 29 + - const: fsl,imx6ul-usbphy 30 + - const: fsl,imx23-usbphy 31 + - items: 32 + - const: fsl,imx8dxl-usbphy 33 + - const: fsl,imx7ulp-usbphy 34 + 35 + reg: 36 + maxItems: 1 37 + 38 + interrupts: 39 + maxItems: 1 40 + 41 + clocks: 42 + maxItems: 1 43 + 44 + '#phy-cells': 45 + const: 0 46 + 47 + power-domains: 48 + maxItems: 1 49 + 50 + fsl,anatop: 51 + description: 52 + phandle for anatop register, it is only for imx6 SoC series. 53 + $ref: /schemas/types.yaml#/definitions/phandle 54 + 55 + phy-3p0-supply: 56 + description: 57 + One of USB PHY's power supply. Can be used to keep a good signal 58 + quality. 59 + 60 + fsl,tx-cal-45-dn-ohms: 61 + description: 62 + Resistance (in ohms) of switchable high-speed trimming resistor 63 + connected in parallel with the 45 ohm resistor that terminates 64 + the DN output signal. 65 + minimum: 35 66 + maximum: 54 67 + default: 45 68 + 69 + fsl,tx-cal-45-dp-ohms: 70 + description: 71 + Resistance (in ohms) of switchable high-speed trimming resistor 72 + connected in parallel with the 45 ohm resistor that terminates 73 + the DP output signal. 74 + minimum: 35 75 + maximum: 54 76 + default: 45 77 + 78 + fsl,tx-d-cal: 79 + description: 80 + Current trimming value (as a percentage) of the 17.78 mA TX 81 + reference current. 82 + $ref: /schemas/types.yaml#/definitions/uint32 83 + minimum: 79 84 + maximum: 119 85 + default: 100 86 + 87 + required: 88 + - compatible 89 + - reg 90 + - clocks 91 + 92 + allOf: 93 + - if: 94 + properties: 95 + compatible: 96 + oneOf: 97 + - enum: 98 + - fsl,imx6q-usbphy 99 + - fsl,imx6sl-usbphy 100 + - fsl,imx6sx-usbphy 101 + - fsl,imx6sll-usbphy 102 + - fsl,vf610-usbphy 103 + - items: 104 + - const: fsl,imx6ul-usbphy 105 + - const: fsl,imx23-usbphy 106 + then: 107 + required: 108 + - fsl,anatop 109 + 110 + additionalProperties: false 111 + 112 + examples: 113 + - | 114 + #include <dt-bindings/interrupt-controller/arm-gic.h> 115 + #include <dt-bindings/clock/imx6qdl-clock.h> 116 + 117 + usbphy1: usb-phy@20c9000 { 118 + compatible = "fsl,imx6q-usbphy", "fsl,imx23-usbphy"; 119 + reg = <0x020c9000 0x1000>; 120 + clocks = <&clks IMX6QDL_CLK_USBPHY1>; 121 + interrupts = <GIC_SPI 44 IRQ_TYPE_LEVEL_HIGH>; 122 + fsl,anatop = <&anatop>; 123 + }; 124 + 125 + ...
-33
Documentation/devicetree/bindings/phy/mxs-usb-phy.txt
··· 1 - * Freescale MXS USB Phy Device 2 - 3 - Required properties: 4 - - compatible: should contain: 5 - * "fsl,imx23-usbphy" for imx23 and imx28 6 - * "fsl,imx6q-usbphy" for imx6dq and imx6dl 7 - * "fsl,imx6sl-usbphy" for imx6sl 8 - * "fsl,vf610-usbphy" for Vybrid vf610 9 - * "fsl,imx6sx-usbphy" for imx6sx 10 - * "fsl,imx7ulp-usbphy" for imx7ulp 11 - * "fsl,imx8dxl-usbphy" for imx8dxl 12 - "fsl,imx23-usbphy" is still a fallback for other strings 13 - - reg: Should contain registers location and length 14 - - interrupts: Should contain phy interrupt 15 - - fsl,anatop: phandle for anatop register, it is only for imx6 SoC series 16 - 17 - Optional properties: 18 - - fsl,tx-cal-45-dn-ohms: Integer [35-54]. Resistance (in ohms) of switchable 19 - high-speed trimming resistor connected in parallel with the 45 ohm resistor 20 - that terminates the DN output signal. Default: 45 21 - - fsl,tx-cal-45-dp-ohms: Integer [35-54]. Resistance (in ohms) of switchable 22 - high-speed trimming resistor connected in parallel with the 45 ohm resistor 23 - that terminates the DP output signal. Default: 45 24 - - fsl,tx-d-cal: Integer [79-119]. Current trimming value (as a percentage) of 25 - the 17.78mA TX reference current. Default: 100 26 - 27 - Example: 28 - usbphy1: usb-phy@20c9000 { 29 - compatible = "fsl,imx6q-usbphy", "fsl,imx23-usbphy"; 30 - reg = <0x020c9000 0x1000>; 31 - interrupts = <0 44 0x04>; 32 - fsl,anatop = <&anatop>; 33 - };