From: Chen-Yu Tsai <wenst@chromium.org>
To: Greg Kroah-Hartman <gregkh@linuxfoundation.org>,
Felipe Balbi <balbi@kernel.org>, Rob Herring <robh@kernel.org>,
Krzysztof Kozlowski <krzk+dt@kernel.org>,
Conor Dooley <conor+dt@kernel.org>
Cc: "Chen-Yu Tsai" <wenst@chromium.org>,
linux-usb@vger.kernel.org, devicetree@vger.kernel.org,
"Neil Armstrong" <neil.armstrong@linaro.org>,
"Kevin Hilman" <khilman@baylibre.com>,
"Jerome Brunet" <jbrunet@baylibre.com>,
"Martin Blumenstingl" <martin.blumenstingl@googlemail.com>,
"Sven Peter" <sven@kernel.org>, "Janne Grunau" <j@jannau.net>,
"Neal Gompa" <neal@gompa.dev>, "Joel Stanley" <joel@jms.id.au>,
"Andrew Jeffery" <andrew@codeconstruct.com.au>,
"Ryan Chen" <ryan_chen@aspeedtech.com>,
"Billy Tsai" <billy_tsai@aspeedtech.com>,
"Michal Simek" <michal.simek@amd.com>,
"Frank Li" <Frank.Li@nxp.com>,
"Sascha Hauer" <s.hauer@pengutronix.de>,
"Pengutronix Kernel Team" <kernel@pengutronix.de>,
"Fabio Estevam" <festevam@gmail.com>,
"Peter Griffin" <peter.griffin@linaro.org>,
"André Draszik" <andre.draszik@linaro.org>,
"Tudor Ambarus" <tudor.ambarus@linaro.org>,
"Heiko Stuebner" <heiko@sntech.de>,
"Alim Akhtar" <alim.akhtar@samsung.com>,
"Kunihiko Hayashi" <hayashi.kunihiko@socionext.com>,
"Masami Hiramatsu" <mhiramat@kernel.org>,
"Yixun Lan" <dlan@kernel.org>,
"Troy Mitchell" <troy.mitchell@linux.spacemit.com>,
"Minda Chen" <minda.chen@starfivetech.com>,
"Shyam Pandey" <radhey.shyam.pandey@amd.com>,
"Wei Yang" <yangwei1@eswincomputing.com>,
"Senchuan Zhang" <zhangsenchuan@eswincomputing.com>,
"Hang Cao" <caohang@eswincomputing.com>,
"Li Jun" <jun.li@nxp.com>, "Peng Fan" <peng.fan@nxp.com>,
"Roy Luo" <royluo@google.com>,
"Yang Xiwen" <forbidden405@foxmail.com>,
"Ahmad Zainie" <wan.ahmad.zainie.wan.mohamad@intel.com>,
"Robert Marko" <robert.marko@sartura.hr>,
"Xu Yang" <xu.yang_2@nxp.com>,
"Wesley Cheng" <quic_wcheng@quicinc.com>,
"Stanley Chang" <stanley_chang@realtek.com>,
"Ze Huang" <huang.ze@linux.dev>,
"Aswath Govindraju" <a-govindraju@ti.com>,
"Roger Quadros" <rogerq@kernel.org>,
linux-arm-kernel@lists.infradead.org,
linux-amlogic@lists.infradead.org, linux-kernel@vger.kernel.org,
asahi@lists.linux.dev, linux-aspeed@lists.ozlabs.org,
imx@lists.linux.dev, linux-samsung-soc@vger.kernel.org,
linux-arm-msm@vger.kernel.org,
linux-rockchip@lists.infradead.org,
linux-riscv@lists.infradead.org, spacemit@lists.linux.dev
Subject: [PATCH 1/2] dt-bindings: usb: hcd: Add downstream USB ports
Date: Wed, 14 Oct 2026 16:20:35 +0800 [thread overview]
Message-ID: <20261014082037.1774672-2-wenst@chromium.org> (raw)
In-Reply-To: <20261014082037.1774672-1-wenst@chromium.org>
Besides hard-wired downstream USB devices, a USB HCD's downstream ports
can also connect to USB connector nodes via OF graph, just like with a
USB hub.
Allow a "ports" child node and describe the possible downstream port
nodes. USB downstream port numbers start at 1.
Also fix up the address portion of hard-wired downstream USB devices to
match.
Signed-off-by: Chen-Yu Tsai <wenst@chromium.org>
---
Documentation/devicetree/bindings/usb/usb-hcd.yaml | 10 +++++++++-
1 file changed, 9 insertions(+), 1 deletion(-)
diff --git a/Documentation/devicetree/bindings/usb/usb-hcd.yaml b/Documentation/devicetree/bindings/usb/usb-hcd.yaml
index 45a19d4928af..24df99dfb243 100644
--- a/Documentation/devicetree/bindings/usb/usb-hcd.yaml
+++ b/Documentation/devicetree/bindings/usb/usb-hcd.yaml
@@ -29,8 +29,16 @@ properties:
"#size-cells":
const: 0
+ ports:
+ $ref: /schemas/graph.yaml#/properties/ports
+ description: The downstream facing USB ports
+
+ patternProperties:
+ "^port@[1-9a-f][0-9a-f]?$":
+ $ref: /schemas/graph.yaml#/properties/port
+
patternProperties:
- "^.*@[0-9a-f]{1,2}$":
+ "^.*@[1-9a-f][0-9a-f]?$":
description: The hard wired USB devices
type: object
$ref: /schemas/usb/usb-device.yaml
--
2.56.0.212.g129ede20d9-goog
next prev parent reply other threads:[~2026-10-14 8:21 UTC|newest]
Thread overview: 9+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-10-14 8:20 [PATCH 0/2] dt-bindings: usb: downstream host ports for hcd and dwc3 Chen-Yu Tsai
2026-10-14 8:20 ` Chen-Yu Tsai [this message]
2026-10-14 8:20 ` [PATCH 2/2] dt-bindings: usb: snps,dwc3: Fix downstream port numbering Chen-Yu Tsai
2026-10-14 8:28 ` Neil Armstrong
2026-10-14 9:29 ` Chen-Yu Tsai
2026-10-14 9:44 ` Neil Armstrong
2026-10-14 10:14 ` Chen-Yu Tsai
2026-10-14 12:15 ` Neil Armstrong
2026-10-14 16:36 ` Konrad Dybcio
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=20261014082037.1774672-2-wenst@chromium.org \
--to=wenst@chromium.org \
--cc=Frank.Li@nxp.com \
--cc=a-govindraju@ti.com \
--cc=alim.akhtar@samsung.com \
--cc=andre.draszik@linaro.org \
--cc=andrew@codeconstruct.com.au \
--cc=asahi@lists.linux.dev \
--cc=balbi@kernel.org \
--cc=billy_tsai@aspeedtech.com \
--cc=caohang@eswincomputing.com \
--cc=conor+dt@kernel.org \
--cc=devicetree@vger.kernel.org \
--cc=dlan@kernel.org \
--cc=festevam@gmail.com \
--cc=forbidden405@foxmail.com \
--cc=gregkh@linuxfoundation.org \
--cc=hayashi.kunihiko@socionext.com \
--cc=heiko@sntech.de \
--cc=huang.ze@linux.dev \
--cc=imx@lists.linux.dev \
--cc=j@jannau.net \
--cc=jbrunet@baylibre.com \
--cc=joel@jms.id.au \
--cc=jun.li@nxp.com \
--cc=kernel@pengutronix.de \
--cc=khilman@baylibre.com \
--cc=krzk+dt@kernel.org \
--cc=linux-amlogic@lists.infradead.org \
--cc=linux-arm-kernel@lists.infradead.org \
--cc=linux-arm-msm@vger.kernel.org \
--cc=linux-aspeed@lists.ozlabs.org \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-riscv@lists.infradead.org \
--cc=linux-rockchip@lists.infradead.org \
--cc=linux-samsung-soc@vger.kernel.org \
--cc=linux-usb@vger.kernel.org \
--cc=martin.blumenstingl@googlemail.com \
--cc=mhiramat@kernel.org \
--cc=michal.simek@amd.com \
--cc=minda.chen@starfivetech.com \
--cc=neal@gompa.dev \
--cc=neil.armstrong@linaro.org \
--cc=peng.fan@nxp.com \
--cc=peter.griffin@linaro.org \
--cc=quic_wcheng@quicinc.com \
--cc=radhey.shyam.pandey@amd.com \
--cc=robert.marko@sartura.hr \
--cc=robh@kernel.org \
--cc=rogerq@kernel.org \
--cc=royluo@google.com \
--cc=ryan_chen@aspeedtech.com \
--cc=s.hauer@pengutronix.de \
--cc=spacemit@lists.linux.dev \
--cc=stanley_chang@realtek.com \
--cc=sven@kernel.org \
--cc=troy.mitchell@linux.spacemit.com \
--cc=tudor.ambarus@linaro.org \
--cc=wan.ahmad.zainie.wan.mohamad@intel.com \
--cc=xu.yang_2@nxp.com \
--cc=yangwei1@eswincomputing.com \
--cc=zhangsenchuan@eswincomputing.com \
/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
all inboxes | Powered by JetHome®