From: Caleb James DeLisle <cjd@cjdns.fr>
To: linux-mips@vger.kernel.org
Cc: vkoul@kernel.org, neil.armstrong@linaro.org, robh@kernel.org,
krzk+dt@kernel.org, conor+dt@kernel.org,
linux-phy@lists.infradead.org, devicetree@vger.kernel.org,
linux-kernel@vger.kernel.org, Caleb James DeLisle <cjd@cjdns.fr>
Subject: [PATCH 1/2] dt-bindings: phy: econet: Document EN751221 USB PHY
Date: Mon, 18 May 2026 14:13:42 +0000 [thread overview]
Message-ID: <20260518141343.401555-2-cjd@cjdns.fr> (raw)
In-Reply-To: <20260518141343.401555-1-cjd@cjdns.fr>
Document the USB PHY devices which appear in EcoNet EN751221, EN751627,
and EN7528 based SoCs.
Signed-off-by: Caleb James DeLisle <cjd@cjdns.fr>
---
.../bindings/phy/econet,en751221-usb-phy.yaml | 128 ++++++++++++++++++
MAINTAINERS | 6 +
2 files changed, 134 insertions(+)
create mode 100644 Documentation/devicetree/bindings/phy/econet,en751221-usb-phy.yaml
diff --git a/Documentation/devicetree/bindings/phy/econet,en751221-usb-phy.yaml b/Documentation/devicetree/bindings/phy/econet,en751221-usb-phy.yaml
new file mode 100644
index 000000000000..a44f59601747
--- /dev/null
+++ b/Documentation/devicetree/bindings/phy/econet,en751221-usb-phy.yaml
@@ -0,0 +1,128 @@
+# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
+# Copyright (C) 2024 EcoNet
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/phy/econet,en751221-usb-phy.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: EcoNet EN751221 USB PHY
+
+maintainers:
+ - Caleb James DeLisle <cjd@cjdns.fr>
+
+description: |
+ USB PHY controller found on EcoNet EN751221 SoCs as well as on EN751627 and
+ EN7528. These devices generally have two ports, one of which is a USB 3.0,
+ and the other is USB 2.0. The USB 3.0 port is driven by one of two PHY
+ blocks, depending on whether the connected device has negotiated USB 3.0 or
+ 2.0. These PHYs are also used on other EcoNet silicon in varying
+ configurations, such as only port 0 (the USB 3.0 port), or only port 1 (the
+ USB 2.0 port).
+
+properties:
+ compatible:
+ enum:
+ - econet,en751221-usb-phy
+ - econet,en751627-usb-phy
+ - econet,en7528-usb-phy
+
+ reg:
+ maxItems: 1
+
+ "#address-cells": true
+ "#size-cells": true
+ ranges: true
+
+ clocks:
+ maxItems: 1
+ description: |
+ Crystal oscillator clock source. EcoNet devices run at either 20Mhz or
+ 25Mhz. 25Mhz devices require additional tuning in the USB 3.0 PHY.
+
+ clock-names:
+ items:
+ - const: xtal
+
+patternProperties:
+ "^usb-phy@[0-9a-f]+$":
+ type: object
+ description: USB 2.0 or 3.0 PHY sub-node.
+
+ properties:
+ compatible:
+ enum:
+ - econet,usb2-phy
+ - econet,usb3-phy
+
+ reg:
+ maxItems: 1
+
+ resets:
+ maxItems: 1
+
+ econet,usb-port-id:
+ $ref: /schemas/types.yaml#/definitions/uint32
+ enum: [0, 1]
+ description: |
+ Physical port number. Since USB 3.0 requires a second PHY for the 2.0
+ fallback, multiple PHYs can map to the same physical port.
+
+ "#phy-cells":
+ const: 0
+
+ required:
+ - compatible
+ - reg
+ - econet,usb-port-id
+ - "#phy-cells"
+
+ additionalProperties: false
+
+required:
+ - compatible
+ - reg
+ - "#address-cells"
+ - "#size-cells"
+ - ranges
+ - clocks
+ - clock-names
+
+additionalProperties: false
+
+examples:
+ - |
+ #include <dt-bindings/reset/econet,en751221-scu.h>
+
+ usb-phy@1fa80000 {
+ compatible = "econet,en751221-usb-phy";
+ reg = <0x1fa80000 0x700>;
+ #address-cells = <1>;
+ #size-cells = <1>;
+ ranges;
+ clocks = <&xtalclk>;
+ clock-names = "xtal";
+
+ usb-phy@1fa80800 {
+ compatible = "econet,usb2-phy";
+ reg = <0x1fa80800 0x100>;
+ resets = <&scuclk EN751221_USB_PHY_P0_RST>;
+ econet,usb-port-id = <0>;
+ #phy-cells = <0>;
+ };
+
+ usb-phy@1fa80900 {
+ compatible = "econet,usb3-phy";
+ reg = <0x1fa80900 0x700>;
+ resets = <&scuclk EN751221_USB_PHY_P0_RST>;
+ econet,usb-port-id = <0>;
+ #phy-cells = <0>;
+ };
+
+ usb-phy@1fa81000 {
+ compatible = "econet,usb2-phy";
+ reg = <0x1fa81000 0x100>;
+ resets = <&scuclk EN751221_USB_PHY_P1_RST>;
+ econet,usb-port-id = <1>;
+ #phy-cells = <0>;
+ };
+ };
diff --git a/MAINTAINERS b/MAINTAINERS
index f877e5aaf2c7..1a90a1736294 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -9204,6 +9204,12 @@ F: drivers/irqchip/irq-econet-en751221.c
F: include/dt-bindings/clock/econet,en751221-scu.h
F: include/dt-bindings/reset/econet,en751221-scu.h
+ECONET USB PHY DRIVER
+M: Caleb James DeLisle <cjd@cjdns.fr>
+L: linux-mips@vger.kernel.org
+S: Maintained
+F: Documentation/devicetree/bindings/phy/econet,en751221-usb-phy.yaml
+
ECRYPT FILE SYSTEM
M: Tyler Hicks <code@tyhicks.com>
L: ecryptfs@vger.kernel.org
--
2.39.5
next prev parent reply other threads:[~2026-05-18 14:14 UTC|newest]
Thread overview: 5+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-05-18 14:13 [PATCH 0/2] Add support for EcoNet USB PHY Caleb James DeLisle
2026-05-18 14:13 ` Caleb James DeLisle [this message]
2026-06-01 22:58 ` [PATCH 1/2] dt-bindings: phy: econet: Document EN751221 " Rob Herring
2026-06-02 12:40 ` Caleb James DeLisle
2026-05-18 14:13 ` [PATCH 2/2] phy: econet: Add EcoNet " Caleb James DeLisle
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20260518141343.401555-2-cjd@cjdns.fr \
--to=cjd@cjdns.fr \
--cc=conor+dt@kernel.org \
--cc=devicetree@vger.kernel.org \
--cc=krzk+dt@kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-mips@vger.kernel.org \
--cc=linux-phy@lists.infradead.org \
--cc=neil.armstrong@linaro.org \
--cc=robh@kernel.org \
--cc=vkoul@kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).