| lists.openwall.net | lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC | |
|
Open Source and information security mailing list archives
| ||
|
Message-Id: <20260116232106.2234978-2-elson.serrao@oss.qualcomm.com>
Date: Fri, 16 Jan 2026 15:20:58 -0800
From: Elson Serrao <elson.serrao@....qualcomm.com>
To: Greg Kroah-Hartman <gregkh@...uxfoundation.org>,
Bjorn Andersson <andersson@...nel.org>,
Konrad Dybcio <konradybcio@...nel.org>, Rob Herring <robh@...nel.org>,
Krzysztof Kozlowski <krzk+dt@...nel.org>,
Conor Dooley <conor+dt@...nel.org>,
Souradeep Chowdhury <quic_schowdhu@...cinc.com>
Cc: linux-arm-msm@...r.kernel.org, devicetree@...r.kernel.org,
linux-usb@...r.kernel.org, linux-kernel@...r.kernel.org
Subject: [PATCH 1/9] dt-bindings: soc: qcom: eud: Restructure to model multi-path hardware
The Qualcomm Embedded USB Debugger (EUD) hardware can intercept up to
two independent High-Speed UTMI data paths, depending on the SoC
configuration. Each path operates independently with:
- Dedicated PHY interface
- Distinct USB connector and controller associations
- Role dependent routing
Model these hardware paths as separate eud-path nodes to accurately
represent the physical topology and add below per-path properties:
phys: EUD exposes a High-Speed debug hub that relies on HS-PHY for its
operation. This property references the HS-PHY associated with the UTMI
path.
usb-role-switch: Indicates that the USB port on this UTMI path supports
role switching. In device role, debug mode inserts the EUD hub into the
UTMI path. In host role, the EUD hub is bypassed and UTMI traffic flows
directly between the PHY and the USB controller.
This change breaks backwards compatibility, but the previous binding
omitted critical resources like PHY and did not describe per-path
topology. Without these modifications EUD cannot be guaranteed to
function.
Signed-off-by: Elson Serrao <elson.serrao@....qualcomm.com>
---
.../bindings/soc/qcom/qcom,eud.yaml | 97 ++++++++++++++-----
1 file changed, 71 insertions(+), 26 deletions(-)
diff --git a/Documentation/devicetree/bindings/soc/qcom/qcom,eud.yaml b/Documentation/devicetree/bindings/soc/qcom/qcom,eud.yaml
index 84218636c0d8..a7162560c323 100644
--- a/Documentation/devicetree/bindings/soc/qcom/qcom,eud.yaml
+++ b/Documentation/devicetree/bindings/soc/qcom/qcom,eud.yaml
@@ -10,8 +10,11 @@ maintainers:
- Souradeep Chowdhury <quic_schowdhu@...cinc.com>
description:
- This binding is used to describe the Qualcomm Embedded USB Debugger, which is
- mini USB-hub implemented on chip to support USB-based debug capabilities.
+ This binding describes the Qualcomm Embedded USB Debugger (EUD), an on-chip
+ mini USB hub that enables USB-based debug capabilities. The EUD block is
+ positioned between the High-Speed USB PHY and the USB controller, where it
+ intercepts the UTMI interface to support debug and bypass modes. EUD can be
+ supported on up to two High-Speed USB ports.
properties:
compatible:
@@ -29,26 +32,59 @@ properties:
description: EUD interrupt
maxItems: 1
- ports:
- $ref: /schemas/graph.yaml#/properties/ports
+ '#address-cells':
+ const: 1
+
+ '#size-cells':
+ const: 0
+
+patternProperties:
+ "^eud-path@[0-1]$":
+ type: object
description:
- These ports is to be attached to the endpoint of the DWC3 controller node
- and type C connector node. The controller has the "usb-role-switch"
- property.
+ Represents one High-Speed UTMI path that EUD intercepts. This node models
+ the physical data path intercepted by EUD and provides graph endpoints to
+ link the USB controller and the external connector associated with this path.
properties:
- port@0:
- $ref: /schemas/graph.yaml#/properties/port
- description: This port is to be attached to the DWC3 controller.
+ reg:
+ maxItems: 1
+ description: Path number
+
+ phys:
+ maxItems: 1
+ description: High-Speed USB PHY associated with this data path.
+
+ usb-role-switch:
+ type: boolean
+ description:
+ Set this property if the USB port on this path is role switch capable.
+
+ ports:
+ $ref: /schemas/graph.yaml#/properties/ports
+ description:
+ These ports are to be attached to the endpoint of the USB controller node
+ and USB connector node.
+
+ properties:
+ port@0:
+ $ref: /schemas/graph.yaml#/properties/port
+ description: This port is to be attached to the USB controller.
- port@1:
- $ref: /schemas/graph.yaml#/properties/port
- description: This port is to be attached to the type C connector.
+ port@1:
+ $ref: /schemas/graph.yaml#/properties/port
+ description: This port is to be attached to the USB connector.
+
+ required:
+ - reg
+ - phys
+ - ports
+
+ additionalProperties: false
required:
- compatible
- reg
- - ports
additionalProperties: false
@@ -58,21 +94,30 @@ examples:
compatible = "qcom,sc7280-eud", "qcom,eud";
reg = <0x88e0000 0x2000>,
<0x88e2000 0x1000>;
+ #address-cells = <1>;
+ #size-cells = <0>;
+
+ eud-path@0 {
+ reg = <0>;
+ phys = <&usb_1_hsphy>;
+ usb-role-switch;
- ports {
- #address-cells = <1>;
- #size-cells = <0>;
- port@0 {
- reg = <0>;
- eud_ep: endpoint {
- remote-endpoint = <&usb2_role_switch>;
+ ports {
+ #address-cells = <1>;
+ #size-cells = <0>;
+
+ port@0 {
+ reg = <0>;
+ eud_ep: endpoint {
+ remote-endpoint = <&usb2_role_switch>;
+ };
};
- };
- port@1 {
- reg = <1>;
- eud_con: endpoint {
- remote-endpoint = <&con_eud>;
+ port@1 {
+ reg = <1>;
+ eud_con: endpoint {
+ remote-endpoint = <&con_eud>;
+ };
};
};
};
--
2.34.1
Powered by blists - more mailing lists