mirror of
https://mirrors.bfsu.edu.cn/git/linux.git
synced 2024-12-26 12:34:41 +08:00
dca669354e
Another pass at removing unnecessary use of 'allOf' with a '$ref'. json-schema versions draft7 and earlier have a weird behavior in that any keywords combined with a '$ref' are ignored (silently). The correct form was to put a '$ref' under an 'allOf'. This behavior is now changed in the 2019-09 json-schema spec and '$ref' can be mixed with other keywords. Cc: Krzysztof Kozlowski <krzysztof.kozlowski@canonical.com> Cc: Thierry Reding <thierry.reding@gmail.com> Cc: Sam Ravnborg <sam@ravnborg.org> Cc: Dmitry Torokhov <dmitry.torokhov@gmail.com> Cc: Pavel Machek <pavel@ucw.cz> Cc: Guenter Roeck <groeck@chromium.org> Cc: Richard Weinberger <richard@nod.at> Cc: Vignesh Raghavendra <vigneshr@ti.com> Cc: "David S. Miller" <davem@davemloft.net> Cc: Kishon Vijay Abraham I <kishon@ti.com> Cc: Sebastian Reichel <sre@kernel.org> Cc: Mathieu Poirier <mathieu.poirier@linaro.org> Signed-off-by: Rob Herring <robh@kernel.org> Acked-by: Mark Brown <broonie@kernel.org> Reviewed-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org> Acked-By: Vinod Koul <vkoul@kernel.org> Acked-by: Lee Jones <lee.jones@linaro.org> Acked-by: Marek Behún <kabel@kernel.org> Acked-by: Miquel Raynal <miquel.raynal@bootlin.com> Reviewed-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com> Acked-by: Jakub Kicinski <kuba@kernel.org> Acked-by: Bjorn Andersson <bjorn.andersson@linaro.org> Link: https://lore.kernel.org/r/20220228213802.1639658-1-robh@kernel.org
281 lines
8.0 KiB
YAML
281 lines
8.0 KiB
YAML
# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/phy/phy-stm32-usbphyc.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: STMicroelectronics STM32 USB HS PHY controller binding
|
|
|
|
description:
|
|
|
|
The STM32 USBPHYC block contains a dual port High Speed UTMI+ PHY and a UTMI
|
|
switch. It controls PHY configuration and status, and the UTMI+ switch that
|
|
selects either OTG or HOST controller for the second PHY port. It also sets
|
|
PLL configuration.
|
|
|
|
USBPHYC
|
|
|_ PLL
|
|
|
|
|
|_ PHY port#1 _________________ HOST controller
|
|
| __ |
|
|
| / 1|________________|
|
|
|_ PHY port#2 ----| |________________
|
|
| \_0| |
|
|
|_ UTMI switch_______| OTG controller
|
|
|
|
maintainers:
|
|
- Amelie Delaunay <amelie.delaunay@foss.st.com>
|
|
|
|
properties:
|
|
compatible:
|
|
const: st,stm32mp1-usbphyc
|
|
|
|
reg:
|
|
maxItems: 1
|
|
|
|
clocks:
|
|
maxItems: 1
|
|
|
|
resets:
|
|
maxItems: 1
|
|
|
|
"#address-cells":
|
|
const: 1
|
|
|
|
"#size-cells":
|
|
const: 0
|
|
|
|
vdda1v1-supply:
|
|
description: regulator providing 1V1 power supply to the PLL block
|
|
|
|
vdda1v8-supply:
|
|
description: regulator providing 1V8 power supply to the PLL block
|
|
|
|
'#clock-cells':
|
|
description: number of clock cells for ck_usbo_48m consumer
|
|
const: 0
|
|
|
|
#Required child nodes:
|
|
|
|
patternProperties:
|
|
"^usb-phy@[0|1]$":
|
|
type: object
|
|
description:
|
|
Each port the controller provides must be represented as a sub-node.
|
|
|
|
properties:
|
|
reg:
|
|
description: phy port index.
|
|
maxItems: 1
|
|
|
|
phy-supply:
|
|
description: regulator providing 3V3 power supply to the PHY.
|
|
|
|
"#phy-cells":
|
|
enum: [ 0x0, 0x1 ]
|
|
|
|
connector:
|
|
type: object
|
|
$ref: /schemas/connector/usb-connector.yaml
|
|
properties:
|
|
vbus-supply: true
|
|
|
|
# It can be necessary to adjust the PHY settings to compensate parasitics, which can be due
|
|
# to USB connector/receptacle, routing, ESD protection component,... Here is the list of
|
|
# all optional parameters to tune the interface of the PHY (HS for High-Speed, FS for Full-
|
|
# Speed, LS for Low-Speed)
|
|
|
|
st,current-boost-microamp:
|
|
description: Current boosting in uA
|
|
enum: [ 1000, 2000 ]
|
|
|
|
st,no-lsfs-fb-cap:
|
|
description: Disables the LS/FS feedback capacitor
|
|
type: boolean
|
|
|
|
st,decrease-hs-slew-rate:
|
|
description: Decreases the HS driver slew rate by 10%
|
|
type: boolean
|
|
|
|
st,tune-hs-dc-level:
|
|
description: |
|
|
Tunes the HS driver DC level
|
|
- <0> normal level
|
|
- <1> increases the level by 5 to 7 mV
|
|
- <2> increases the level by 10 to 14 mV
|
|
- <3> decreases the level by 5 to 7 mV
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
minimum: 0
|
|
maximum: 3
|
|
default: 0
|
|
|
|
st,enable-fs-rftime-tuning:
|
|
description: Enables the FS rise/fall tuning option
|
|
type: boolean
|
|
|
|
st,enable-hs-rftime-reduction:
|
|
description: Enables the HS rise/fall reduction feature
|
|
type: boolean
|
|
|
|
st,trim-hs-current:
|
|
description: |
|
|
Controls HS driver current trimming for choke compensation
|
|
- <0> = 18.87 mA target current / nominal + 0%
|
|
- <1> = 19.165 mA target current / nominal + 1.56%
|
|
- <2> = 19.46 mA target current / nominal + 3.12%
|
|
- <3> = 19.755 mA target current / nominal + 4.68%
|
|
- <4> = 20.05 mA target current / nominal + 6.24%
|
|
- <5> = 20.345 mA target current / nominal + 7.8%
|
|
- <6> = 20.64 mA target current / nominal + 9.36%
|
|
- <7> = 20.935 mA target current / nominal + 10.92%
|
|
- <8> = 21.23 mA target current / nominal + 12.48%
|
|
- <9> = 21.525 mA target current / nominal + 14.04%
|
|
- <10> = 21.82 mA target current / nominal + 15.6%
|
|
- <11> = 22.115 mA target current / nominal + 17.16%
|
|
- <12> = 22.458 mA target current / nominal + 19.01%
|
|
- <13> = 22.755 mA target current / nominal + 20.58%
|
|
- <14> = 23.052 mA target current / nominal + 22.16%
|
|
- <15> = 23.348 mA target current / nominal + 23.73%
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
minimum: 0
|
|
maximum: 15
|
|
default: 0
|
|
|
|
st,trim-hs-impedance:
|
|
description: |
|
|
Controls HS driver impedance tuning for choke compensation
|
|
- <0> = no impedance offset
|
|
- <1> = reduce the impedance by 2 ohms
|
|
- <2> = reduce the impedance by 4 ohms
|
|
- <3> = reduce the impedance by 6 ohms
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
minimum: 0
|
|
maximum: 3
|
|
default: 0
|
|
|
|
st,tune-squelch-level:
|
|
description: |
|
|
Tunes the squelch DC threshold value
|
|
- <0> = no shift in threshold
|
|
- <1> = threshold shift by +7 mV
|
|
- <2> = threshold shift by -5 mV
|
|
- <3> = threshold shift by +14 mV
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
minimum: 0
|
|
maximum: 3
|
|
default: 0
|
|
|
|
st,enable-hs-rx-gain-eq:
|
|
description: Enables the HS Rx gain equalizer
|
|
type: boolean
|
|
|
|
st,tune-hs-rx-offset:
|
|
description: |
|
|
Adjusts the HS Rx offset
|
|
- <0> = no offset
|
|
- <1> = offset of +5 mV
|
|
- <2> = offset of +10 mV
|
|
- <3> = offset of -5 mV
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
minimum: 0
|
|
maximum: 3
|
|
default: 0
|
|
|
|
st,no-hs-ftime-ctrl:
|
|
description: Disables the HS fall time control of single ended signals during pre-emphasis
|
|
type: boolean
|
|
|
|
st,no-lsfs-sc:
|
|
description: Disables the short circuit protection in LS/FS driver
|
|
type: boolean
|
|
|
|
st,enable-hs-tx-staggering:
|
|
description: Enables the basic staggering in HS Tx mode
|
|
type: boolean
|
|
|
|
allOf:
|
|
- if:
|
|
properties:
|
|
reg:
|
|
const: 0
|
|
then:
|
|
properties:
|
|
"#phy-cells":
|
|
const: 0
|
|
else:
|
|
properties:
|
|
"#phy-cells":
|
|
const: 1
|
|
description:
|
|
The value is used to select UTMI switch output.
|
|
0 for OTG controller and 1 for Host controller.
|
|
|
|
required:
|
|
- reg
|
|
- phy-supply
|
|
- "#phy-cells"
|
|
|
|
additionalProperties: false
|
|
|
|
required:
|
|
- compatible
|
|
- reg
|
|
- clocks
|
|
- "#address-cells"
|
|
- "#size-cells"
|
|
- vdda1v1-supply
|
|
- vdda1v8-supply
|
|
- usb-phy@0
|
|
- usb-phy@1
|
|
|
|
additionalProperties: false
|
|
|
|
examples:
|
|
- |
|
|
#include <dt-bindings/clock/stm32mp1-clks.h>
|
|
#include <dt-bindings/reset/stm32mp1-resets.h>
|
|
usbphyc: usbphyc@5a006000 {
|
|
compatible = "st,stm32mp1-usbphyc";
|
|
reg = <0x5a006000 0x1000>;
|
|
clocks = <&rcc USBPHY_K>;
|
|
resets = <&rcc USBPHY_R>;
|
|
vdda1v1-supply = <®11>;
|
|
vdda1v8-supply = <®18>;
|
|
#address-cells = <1>;
|
|
#size-cells = <0>;
|
|
#clock-cells = <0>;
|
|
|
|
usbphyc_port0: usb-phy@0 {
|
|
reg = <0>;
|
|
phy-supply = <&vdd_usb>;
|
|
#phy-cells = <0>;
|
|
st,tune-hs-dc-level = <2>;
|
|
st,enable-fs-rftime-tuning;
|
|
st,enable-hs-rftime-reduction;
|
|
st,trim-hs-current = <15>;
|
|
st,trim-hs-impedance = <1>;
|
|
st,tune-squelch-level = <3>;
|
|
st,tune-hs-rx-offset = <2>;
|
|
st,no-lsfs-sc;
|
|
connector {
|
|
compatible = "usb-a-connector";
|
|
vbus-supply = <&vbus_sw>;
|
|
};
|
|
};
|
|
|
|
usbphyc_port1: usb-phy@1 {
|
|
reg = <1>;
|
|
phy-supply = <&vdd_usb>;
|
|
#phy-cells = <1>;
|
|
st,tune-hs-dc-level = <2>;
|
|
st,enable-fs-rftime-tuning;
|
|
st,enable-hs-rftime-reduction;
|
|
st,trim-hs-current = <15>;
|
|
st,trim-hs-impedance = <1>;
|
|
st,tune-squelch-level = <3>;
|
|
st,tune-hs-rx-offset = <2>;
|
|
st,no-lsfs-sc;
|
|
};
|
|
};
|
|
...
|