From nobody Sat Feb 7 09:36:55 2026 Received: from mail-pj1-f48.google.com (mail-pj1-f48.google.com [209.85.216.48]) (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 0E7ED3242D4 for ; Tue, 27 Jan 2026 17:42:24 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.216.48 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1769535751; cv=none; b=HZcglJ99GpHCYGczuExDxpKF7I/RuKwwHeYMXQdth7JLCaQhDTh6mKR9stXWF+kKQyG9Cyb2ykOx9t2OW+Hw4mk2vgOop2RXi7ybcDv/0TqNQqQC+DELJ7jnqNJjhe0UJBl0i0dOEfiDxeoXg360IhgoC3ia3PPo64+IPeugc7I= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1769535751; c=relaxed/simple; bh=4V4W9RP5kRoxw48NKQ2W22yEt3obXwvxUNoMxf9i/xs=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=QdLOFQCBuepxo2mv2B5zUnXUlhiy/YKABJv1ruob220Ee2NTKu1YwaJf+ezVJpVTT7fatLpM030bRzWm1g7gzt3fZArY/lOr/sAtfvNm6u4TeDnf/r9cxzJ9CpPBKweEsksapYdodTuFomLLxn/jV+ihUE2o1p60x6Kk0lJFii0= 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=OvkPFdie; arc=none smtp.client-ip=209.85.216.48 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="OvkPFdie" Received: by mail-pj1-f48.google.com with SMTP id 98e67ed59e1d1-34c27d14559so3590103a91.2 for ; Tue, 27 Jan 2026 09:42:24 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1769535744; x=1770140544; 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=4ilP7qxMWQg+G58bC8nFVdbjHonl73Ir3/PIz7djdzo=; b=OvkPFdiev0eOPYoBdw1R+IMZ6ZckImPa1zK7gcqE1e5+Bv7BtzB8AnfLhJHj0nii2z lFRQVZe3gNJNVkLocTFYtxvlsSbDIgq7I5e3Yy6kFfyoxKam18k6PIUMZrrU1tqLhaTj qyquZaNB71ZN5M40TIQYdQEgBZSnZDud/Rk9DV2bpHIxqSQ7XW4gELriEGboiWk31HKk X0mLHBwU0rkvr10dmqDkWBDDgaLTV7r3ZqeKwR49NGH7CXtepgzutgI1NDBqEh36Pueh QBxlYLV8jNn7RgnWsrZe0NP24oxpQ2b6rdrFunSqhv05aePMIkdX+gyBEsLxmbgsBP/M unYw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1769535744; x=1770140544; 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=4ilP7qxMWQg+G58bC8nFVdbjHonl73Ir3/PIz7djdzo=; b=DwidWPD74W6FDuKW05byYgJ1x4/pMck27tHaitrwDKDeYVpVmb/A6TuhhrRaqH7Azu 6Cw7EmgGPiyiRB9BvmXjWTMPbUlkPJjh4E7cNOxhgktTOKQjsLSNwTfWug44/cW6/Zih hqDS5TFg6GYJaBinB3+nQkCv4N78gxmq1qyJW00EheF1R0jQoYDyv2m9x1fk92kF/1W2 R4/HIpdnMsa+dw3zRgKDi1J2QTiRQU5kewUgMiRnMZ/0yOrupi7yJF0lLJNWB4JRhWu1 irH6pPuo7dblUhg3I821lOhJnUZLI2mTU1RKaum/vFoQ5sf+aqCQjD7/cuTKmmjObMSz 4Ofw== X-Forwarded-Encrypted: i=1; AJvYcCU77AC6e1KjeQKLopGJuHmq3n9rUIfgWdbZubwZTSHBoO0D5BSL9EaTwkxkWWckSGspZ9GoznOe5j1d3xs=@vger.kernel.org X-Gm-Message-State: AOJu0Yz7mSeGrQ6w1rWKkNp4Gir54rN1lv+wILoWTtP/wzdwHImD8VkB JwQQ0Ix9qbTO8DE1r7QybvCuqR9FWLSKHsHDze9PzhUGtwljOQuMFaSM X-Gm-Gg: AZuq6aI3hFDORqHyMLW+r8NXywF5kJH77LI2lacwd0jD7gDy0Y063FzioDnHN/9G6CW mXfiphcVvMzPd28n6/tp8XTqvUvQBIaU+I7wiYFzEQwjygppi7mps9MNmICLSn9rCBV486kxEYW xpw6fFnAP+KXT/MpyJBHlL1TMjq65ccpW+Q5rJICohzXrXmXJSvehADgqds/zBjriyiL9T5KVfz /Us/bhIuMJcIwKcmtYUZb5zBPc3d0GKNTtsr2hCg5MONI2N48hdh4WhNr7tJjqQBtyNxPzM1rS5 wAiiMxs5MCwpK+PmgbsKh3CxJ18YwYdCQQHukZc7z+9RGnGXHbQoBJpTFJ5nWPZo0oAp8z9f12c TSzQT9/3AqeMa0nbmQCXOR4Gcmphgdgu6tF+eahT1SH0GdlMORk3tLL9oQsETV7gtJNAcTDZzGQ i9dH6P46bSq4lMW9IwkveZ3kDZjIHLebXa2g== X-Received: by 2002:a17:90b:2c86:b0:34c:2f3f:d27e with SMTP id 98e67ed59e1d1-353feccaa0emr2272522a91.3.1769535744145; Tue, 27 Jan 2026 09:42:24 -0800 (PST) Received: from Black-Pearl.localdomain ([115.99.251.203]) by smtp.googlemail.com with ESMTPSA id 98e67ed59e1d1-3540f2cae91sm89251a91.4.2026.01.27.09.42.21 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 27 Jan 2026 09:42:23 -0800 (PST) From: Charan Pedumuru Date: Tue, 27 Jan 2026 17:42:14 +0000 Subject: [PATCH v2 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: <20260127-ti-usb-v2-2-9dd6a65b43df@gmail.com> References: <20260127-ti-usb-v2-0-9dd6a65b43df@gmail.com> In-Reply-To: <20260127-ti-usb-v2-0-9dd6a65b43df@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 made during the conversion: - Drop the ti,hwmods property, as it is not used by any in-tree DTS files. Signed-off-by: Charan Pedumuru Reviewed-by: Rob Herring (Arm) --- Documentation/devicetree/bindings/usb/omap-usb.txt | 80 ----------------- Documentation/devicetree/bindings/usb/ti,dwc3.yaml | 100 +++++++++++++++++= ++++ 2 files changed, 100 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..77ac11c3b2db --- /dev/null +++ b/Documentation/devicetree/bindings/usb/ti,dwc3.yaml @@ -0,0 +1,100 @@ +# 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: + compatible: + enum: + - ti,dwc3 + - ti,am437x-dwc3 + + 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