From nobody Sun Feb 8 16:49:53 2026 Received: from mail-pg1-f177.google.com (mail-pg1-f177.google.com [209.85.215.177]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 7611F337BB2 for ; Mon, 26 Jan 2026 13:22:17 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.215.177 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1769433739; cv=none; b=Moutrw0ykDYr8KsJnqi9dvJ1V5xgylLhsc9Dl0lZhBsaBnyFSJF6SodwLMvvMeol/VaaqUtuuZsCJch1hfIfuweeEt9cl3U5NT3/NQW3Gi84tv/bktm1TMAP9sQ9mmq+2oqgi5sghgm+UVMWdJshdoKEfOwC+PqBPei9I9VA28M= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1769433739; c=relaxed/simple; bh=hV0HFkDk7Y0DrpEXXZZld7ePFqj1GfpzDnGLxSrxS/o=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=bVoD4uTTA3tSZCeu5X8zt6W19xqBgK29rsCcLkY/hpXgQ69Rw6eZx5rVAAG/Tx6rz9spKICL9nv8FCUdEmfp5XuaQZXAT5RZnvZZAvmWw83HEJ8eijTflaUFi+vWaYERlWLFJAcPZxS0wIEntF7Dh6OCAuKMIReDEK2JxjtP0og= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=eUpOoAR+; arc=none smtp.client-ip=209.85.215.177 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="eUpOoAR+" Received: by mail-pg1-f177.google.com with SMTP id 41be03b00d2f7-c56188aef06so1752938a12.2 for ; Mon, 26 Jan 2026 05:22:17 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1769433737; x=1770038537; darn=vger.kernel.org; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:from:to:cc:subject:date:message-id :reply-to; bh=pcbMiQsJB40EYOu8uLFm79D1kLu7v22jBDTwBj1l4qQ=; b=eUpOoAR+lRrFF0Sdjz012B37lC9FTBFXrf8ZsQrF/Zka/IJaY30UuNzuc6nn1mmQyU ojlcpeiplTLvT0fbSfYztCgWb/eg7l0YukHqtctgZypWsoGFox0KX4bTT33tyZReQb7w v9ZGPrRNSeZ6FwkAO1t6wDM+3olb5xwl9QOfeX4aGCNTER5xtsggAywKSbB21ZKjjdqr rRAc/qzcoNBmY6ovlT3aX5C5nuZ1AEnRKI2TUXWiyoQnf5p+D232lv/9AsVwuXQOZ8r9 5Qjun1ghoWmLXmaB92l40i6msO/9gOAWi98/dbmC9q207FDxPtnwxcQGXn7L+WF3AHJd ylxQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1769433737; x=1770038537; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:x-gm-gg:x-gm-message-state:from:to :cc:subject:date:message-id:reply-to; bh=pcbMiQsJB40EYOu8uLFm79D1kLu7v22jBDTwBj1l4qQ=; b=eUqKXR8VlVQRrYddmkXQS3e5t3gUuvMQ+AFwG3qyH8BEHfNMASDkWSZD+rn9hUGaLo KV8Pn87XPY+3vB3ABnyYFMZJOR1P5pwtFlW7in7Scw74l0pUcYF8zw2xyZGXR0vKHuPJ Mz4zG79U4XtzZzUi39AXaL5nI9EtY+DRaPocXMVqd0DUYazr82dTIFCLP+MYbdqNFVeW TqfyVKi3+jDFBrL9NnWnvb+XXuCi2vd9P22qmSq8Bfow6ng+C6FuCm5IKzisCaVV8+Gn d3veqxIOZvqLLTGelE1IgiV6D7faQRsoeqpgBdY18ruFBEva0TtlJvEFXE9LEdorhVNX U8yg== X-Forwarded-Encrypted: i=1; AJvYcCXhDXzZLo49S/JSMfpFcaa9xnbAfOO7F2WD3mMsvkwLTAfuum+OjUGCOPd8O4bL7LrtE/N5dGMdJgPOEqw=@vger.kernel.org X-Gm-Message-State: AOJu0YwUMkjDBz+ZPXi0ahCMrmva9EyjYUbwhLYyU0BozzbnwviRR1yn bOAXPx6X9LB1p14F9Q/J/NLpETDIOVa/9kDUHLBbtt2rmQz/YzvxQ70H X-Gm-Gg: AZuq6aLoyuDBgcf1c8m4TPJLsaykZZjWgj/bF1SFiEI8XckutcdQWOxPAvnoooGXhGP pp9V+HH3QtsJAWvTeN0fAWj6g0n7Szv9qLf0xZI2O5pWBUHWkoH1QZZ+6i8cNeTy0pdpK0QATaP XQhM/BpZrIJ5nM0AMKl2PXWngCvOw0GeGLP4MOmoJD7AvuS+hKLj7tnlp71l6Ro/5O0GEx08W+F FSn5MrBqFKI2YSdb5xe4TitLbIzvhIUoRNLwgIRvrDeSbIDScAES6B/ySlRCfGYw83Nl4JBRRn6 6L7mKmDHkPvzdwH3he5SXlCLn1oaVlVqoMCXQjCEvPkgHEN+BoiUjpziJdvfHyY+eqoHlvQI4Vu ZSbqTHqmrvZkCIVNO9yccG1Zl7ki32mWmbaOb6egUwrCtHmh977ZbhH39MWI03HfTWZ5xaxHN3I sR6FyUvypYEZTgRXkpC+07IZYYfvUzib7JKw== X-Received: by 2002:a17:903:2343:b0:294:def6:5961 with SMTP id d9443c01a7336-2a84530eab4mr44260565ad.45.1769433736653; Mon, 26 Jan 2026 05:22:16 -0800 (PST) Received: from Black-Pearl.localdomain ([115.99.251.203]) by smtp.googlemail.com with ESMTPSA id d9443c01a7336-2a802daa65fsm90602575ad.12.2026.01.26.05.22.13 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 26 Jan 2026 05:22:16 -0800 (PST) From: Charan Pedumuru Date: Mon, 26 Jan 2026 13:22:05 +0000 Subject: [PATCH 2/2] dt-bindings: usb: ti,dwc3: convert to DT schema Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Message-Id: <20260126-ti-usb-v1-2-2855c129eb6d@gmail.com> References: <20260126-ti-usb-v1-0-2855c129eb6d@gmail.com> In-Reply-To: <20260126-ti-usb-v1-0-2855c129eb6d@gmail.com> To: Greg Kroah-Hartman , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Felipe Balbi Cc: linux-usb@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, Charan Pedumuru X-Mailer: b4 0.14.3 Convert OMAP DWC3 USB Glue Layer binding to DT schema. Changes during conversion: - Introduce a new compatible string pattern "omap_dwc3" to match nodes already present in existing device tree sources. Signed-off-by: Charan Pedumuru --- Documentation/devicetree/bindings/usb/omap-usb.txt | 80 --------------- Documentation/devicetree/bindings/usb/ti,dwc3.yaml | 112 +++++++++++++++++= ++++ 2 files changed, 112 insertions(+), 80 deletions(-) diff --git a/Documentation/devicetree/bindings/usb/omap-usb.txt b/Documenta= tion/devicetree/bindings/usb/omap-usb.txt deleted file mode 100644 index f0dbc5ae45ae..000000000000 --- a/Documentation/devicetree/bindings/usb/omap-usb.txt +++ /dev/null @@ -1,80 +0,0 @@ -OMAP GLUE AND OTHER OMAP SPECIFIC COMPONENTS - -OMAP MUSB GLUE - - compatible : Should be "ti,omap4-musb" or "ti,omap3-musb" - - ti,hwmods : must be "usb_otg_hs" - - multipoint : Should be "1" indicating the musb controller supports - multipoint. This is a MUSB configuration-specific setting. - - num-eps : Specifies the number of endpoints. This is also a - MUSB configuration-specific setting. Should be set to "16" - - ram-bits : Specifies the ram address size. Should be set to "12" - - interface-type : This is a board specific setting to describe the type = of - interface between the controller and the phy. It should be "0" or "1" - specifying ULPI and UTMI respectively. - - mode : Should be "3" to represent OTG. "1" signifies HOST and "2" - represents PERIPHERAL. - - power : Should be "50". This signifies the controller can supply up to - 100mA when operating in host mode. - - usb-phy : the phandle for the PHY device - - phys : the phandle for the PHY device (used by generic PHY framework) - - phy-names : the names of the PHY corresponding to the PHYs present in t= he - *phy* phandle. - -Optional properties: - - ctrl-module : phandle of the control module this glue uses to write to - mailbox - -SOC specific device node entry -usb_otg_hs: usb_otg_hs@4a0ab000 { - compatible =3D "ti,omap4-musb"; - ti,hwmods =3D "usb_otg_hs"; - multipoint =3D <1>; - num-eps =3D <16>; - ram-bits =3D <12>; - ctrl-module =3D <&omap_control_usb>; - phys =3D <&usb2_phy>; - phy-names =3D "usb2-phy"; -}; - -Board specific device node entry -&usb_otg_hs { - interface-type =3D <1>; - mode =3D <3>; - power =3D <50>; -}; - -OMAP DWC3 GLUE - - compatible : Should be - * "ti,dwc3" for OMAP5 and DRA7 - * "ti,am437x-dwc3" for AM437x - - ti,hwmods : Should be "usb_otg_ss" - - reg : Address and length of the register set for the device. - - interrupts : The irq number of this device that is used to interrupt the - MPU - - #address-cells, #size-cells : Must be present if the device has sub-nod= es - - utmi-mode : controls the source of UTMI/PIPE status for VBUS and OTG ID. - It should be set to "1" for HW mode and "2" for SW mode. - - ranges: the child address space are mapped 1:1 onto the parent address = space - -Optional Properties: - - extcon : phandle for the extcon device omap dwc3 uses to detect - connect/disconnect events. - - vbus-supply : phandle to the regulator device tree node if needed. - -Sub-nodes: -The dwc3 core should be added as subnode to omap dwc3 glue. -- dwc3 : - The binding details of dwc3 can be found in: - Documentation/devicetree/bindings/usb/snps,dwc3.yaml - -omap_dwc3 { - compatible =3D "ti,dwc3"; - ti,hwmods =3D "usb_otg_ss"; - reg =3D <0x4a020000 0x1ff>; - interrupts =3D <0 93 4>; - #address-cells =3D <1>; - #size-cells =3D <1>; - utmi-mode =3D <2>; - ranges; -}; - diff --git a/Documentation/devicetree/bindings/usb/ti,dwc3.yaml b/Documenta= tion/devicetree/bindings/usb/ti,dwc3.yaml new file mode 100644 index 000000000000..859da4b1f207 --- /dev/null +++ b/Documentation/devicetree/bindings/usb/ti,dwc3.yaml @@ -0,0 +1,112 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/usb/ti,dwc3.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Texas Instruments OMAP DWC3 USB Glue Layer + +maintainers: + - Felipe Balbi + +description: + Texas Instruments glue layer for Synopsys DesignWare USB3 (DWC3) + controller on OMAP and AM43xx SoCs. Manages SoC-specific integration + including register mapping, interrupt routing, UTMI/PIPE interface mode + selection (HW/SW), and child DWC3 core instantiation via address space + translation. Supports both legacy single-instance and multi-instance + (numbered) configurations. + +properties: + $nodename: + pattern: "^omap_dwc3(_[0-9]+)?@.*$" + + compatible: + enum: + - ti,dwc3 + - ti,am437x-dwc3 + + ti,hwmods: + $ref: /schemas/types.yaml#/definitions/string + description: + TI PRCM hardware module name that must be enabled (powered and + clocked) for this node. "usb_otg_ss" refers to the SuperSpeed + (USB3 + USB2 OTG) controller wrapper/glue layer found in OMAP5, + DRA7, AM57x, and similar TI SoCs using DWC3. + const: usb_otg_ss + + reg: + maxItems: 1 + + interrupts: + maxItems: 1 + + utmi-mode: + $ref: /schemas/types.yaml#/definitions/uint32 + description: + Controls the source of UTMI/PIPE status for VBUS and OTG ID. + 1 for HW mode, 2 for SW mode. + enum: [1, 2] + + "#address-cells": + const: 1 + + "#size-cells": + const: 1 + + ranges: true + + extcon: + $ref: /schemas/types.yaml#/definitions/phandle + description: + Phandle for the extcon device used to detect connect/ + disconnect events. + + vbus-supply: + description: Phandle to the regulator device tree node if needed. + +patternProperties: + "^usb@[0-9a-f]+$": + type: object + $ref: snps,dwc3.yaml# + unevaluatedProperties: false + +required: + - reg + - compatible + - interrupts + - "#address-cells" + - "#size-cells" + - utmi-mode + - ranges + +unevaluatedProperties: false + +examples: + - | + #include + omap_dwc3_1@0 { + compatible =3D "ti,dwc3"; + reg =3D <0x0 0x10000>; + interrupts =3D ; + #address-cells =3D <1>; + #size-cells =3D <1>; + utmi-mode =3D <2>; + ranges =3D <0 0 0x20000>; + + usb@10000 { + compatible =3D "snps,dwc3"; + reg =3D <0x10000 0x17000>; + interrupts =3D , + , + ; + interrupt-names =3D "peripheral", "host", "otg"; + phys =3D <&usb2_phy1>, <&usb3_phy1>; + phy-names =3D "usb2-phy", "usb3-phy"; + maximum-speed =3D "super-speed"; + dr_mode =3D "otg"; + snps,dis_u3_susphy_quirk; + snps,dis_u2_susphy_quirk; + }; + }; +... --=20 2.52.0