From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-vs1-f52.google.com (mail-vs1-f52.google.com [209.85.217.52]) (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 431BF1F03DE for ; Wed, 25 Feb 2026 01:48:00 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.217.52 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1771984081; cv=none; b=RfBv0RfsAtfVb86z7x/FNFZDzTEiMq/9GOOIXyNOesc2d8WoR9A7ZhEvlkTcPqZcD3/jXbMpIIvKwPcZewXFN4Quc3cohtewOtepZX4ecFgXbgzUfoDJMOodh5fMqBhX6mHeSpBa+5LBTr5DpxfUb3GSRbjViwDhrCon3Q7+RuM= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1771984081; c=relaxed/simple; bh=MAGEEd13MCvi6LrJomw1tdWe/J4Nih2UdmE3xgcfTm4=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=bXKGD3TF8e6e6He8bYiGhG4L3SrSsJc44uRxNfaM+8Ot9J18bpDLl/tzXVcDrsHLeRs7+YQUVma9htwuSEpsLsho/KL553mYzqtxNDQyVJ5QX3XbD5FpeuBB2qr6odpZTDXoRgQcp9kEPP91pWQLWdnki/hQ8LOwrW69cWAtIlg= 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=DtapZzeF; arc=none smtp.client-ip=209.85.217.52 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="DtapZzeF" Received: by mail-vs1-f52.google.com with SMTP id ada2fe7eead31-5f5418c40daso411843137.0 for ; Tue, 24 Feb 2026 17:48:00 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1771984079; x=1772588879; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=bhdRsHb+agfbG472LK6KXfddMx+16zI/+slYVcbavrw=; b=DtapZzeFzuw+2Ee4FtNaZyPyvN+sRGDtXiHIc6rUpua4MZJ7xomuX7BiGWFNLD5OTB JeNFDuY2M6u2KBz3NbNKwB4YvudxisI+wudMcKeeWeYG7/gU1IXHUVxGXlWuhGqAJU7U OjAEJPbIJXVvvAm1sxZHBLiSLwYqlxr3N2/plNTL8Aa45enjC5aZWrhH+wSlC7IQkWgv tJ/avQYEnnSgNQIlvBe0Nx7LrJTzGv+nPgtDLU4GGZq1hjoB7aqIq4m9XpjOgZgOI1OM f1zmMET3QOsfRlg/Rekf4dMlU2O0R5Z6uLg7ewIqBYORO7FM+zZCOfPC/mjPaedU1P1l qlxQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1771984079; x=1772588879; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-gg:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=bhdRsHb+agfbG472LK6KXfddMx+16zI/+slYVcbavrw=; b=t9nsBYjaTi35m1u880M8awjV2Xu+2HdJ57Yv14wyEBDdfm/k7fT5mG3dRmN+DKCJ9X Yi/KVDRmkCT0ucmi8ouvYOFU/PHhbcBazWWt6opY2SPSfqUc7YombsD3IMrkxTtFciej cQ9mvQU5mXW8k7YxuKokfbnB/UmWKaXwjaSQbyNen/u9Fn0irpU1ZjWO9rfIB/t0sWXv PFQ8+WFJci9kL8sYKbTHDS9junrvN2xfoAha+KNr22iHStrp4fVmoYExIKakk1UeSlt3 7ik1sk7IWD7K6ZTY2WFQySseDBFA+VTzsJAOs8YkzOvIw1gDnHgjnSwRKyq2LEJqLU8d pkCw== X-Forwarded-Encrypted: i=1; AJvYcCVCy8vXNiEp8WG9ayI5oRu8op5W4kISOhnGDKOtR7z5v2lWspGh5ngIpCWT5Izw1lvnArX8TBvpHWQ=@vger.kernel.org X-Gm-Message-State: AOJu0YyFJ5D0wbje9/qshXx2OzTEn9GA/VtL/W5W413w2IKhVQ5zRIaQ hPIwng6wHKKgrqhsjaaadpG0cBLfzFFR+wKRUjgjnLKUgm75s6j9doJY X-Gm-Gg: ATEYQzxLd3bkpy9Ex07EKrDvKsBasNbXAohhkcAovjoUyb6BXYePHyUOSORrsL8z4OY +G0HLCbcd4Faj3qAnIGIH3Wkh+ZxxATPpYMR5wrhW2w1pcms+SQzmb+fk1xaIZiAl7mjpUBEfBM w7DjBUxw3B9AuBYgb1Y68QpjqGnzrKvF500btNxOBVAcTaEqt2mwAQ+Hn+HZypkQTJxckHe1dP5 QCY8/U+Jk2Chf1z916EkFuO1Xu7h+2afZNzazl0k6b9OSLwwume+fPI5YMpKoPn6e1Rm2vJXYmc Vs7TxaPmDbQjWZQ00DqXSzKUgLpVgA/ToUxXiXNiVjqHQmE6ndHSkzCA84Lql4LDXpCmXn3qTp7 VdkAXh06xb8ASPjiLnKfP0PgXbbUOnDEJuWRvsdspkEIxYIOZA4sS3oJcqLRikT0ah/ioXVXgJv afLYtqUh2Wy+ikmuILAf8fUrnxp7gsC+iu0buU6pIAwnXKeqaUilnliLfHMRIZS4RCraodwDbjl JQV X-Received: by 2002:a05:6102:26c3:b0:5ef:a1ea:bd33 with SMTP id ada2fe7eead31-5feffdf4bbbmr1123398137.9.1771984079132; Tue, 24 Feb 2026 17:47:59 -0800 (PST) Received: from localhost.localdomain ([2804:14d:4c64:82a2:db88:7d47:d63:c87b]) by smtp.gmail.com with ESMTPSA id a1e0cc1a2514c-94de1869b3csm1767247241.13.2026.02.24.17.47.55 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 24 Feb 2026 17:47:58 -0800 (PST) From: Rodrigo Gobbi To: krzysztof.kozlowski@oss.qualcomm.com, gregkh@linuxfoundation.org, robh@kernel.org, krzk+dt@kernel.org, conor+dt@kernel.org, davidm@egauge.net Cc: ~lkcamp/patches@lists.sr.ht, linux-usb@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH RESEND v2] dt-bindings: usb: maxim,max3421: convert to DT schema Date: Tue, 24 Feb 2026 22:23:20 -0300 Message-ID: <20260225014751.9121-1-rodrigo.gobbi.7@gmail.com> X-Mailer: git-send-email 2.48.1 Precedence: bulk X-Mailing-List: linux-usb@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Convert legacy maxim,max3421.txt to proper format. Reviewed-by: Krzysztof Kozlowski Signed-off-by: Rodrigo Gobbi --- Just resending this from last year [1] since it might not be on Greg's inbox anymore. Same as v2, just with review tag. Tks and regards. [1] https://lore.kernel.org/linux-devicetree/20251107001812.10180-1-rodrigo.gobbi.7@gmail.com/ Changelog: v2: https://lore.kernel.org/linux-devicetree/20251107001812.10180-1-rodrigo.gobbi.7@gmail.com/ v1: https://lore.kernel.org/all/20251009182046.185520-1-rodrigo.gobbi.7@gmail.com/ --- .../devicetree/bindings/usb/maxim,max3421.txt | 23 ------- .../bindings/usb/maxim,max3421.yaml | 67 +++++++++++++++++++ 2 files changed, 67 insertions(+), 23 deletions(-) delete mode 100644 Documentation/devicetree/bindings/usb/maxim,max3421.txt create mode 100644 Documentation/devicetree/bindings/usb/maxim,max3421.yaml diff --git a/Documentation/devicetree/bindings/usb/maxim,max3421.txt b/Documentation/devicetree/bindings/usb/maxim,max3421.txt deleted file mode 100644 index 90495b1aeec2..000000000000 --- a/Documentation/devicetree/bindings/usb/maxim,max3421.txt +++ /dev/null @@ -1,23 +0,0 @@ -Maxim Integrated SPI-based USB 2.0 host controller MAX3421E - -Required properties: - - compatible: Should be "maxim,max3421" - - spi-max-frequency: maximum frequency for this device must not exceed 26 MHz. - - reg: chip select number to which this device is connected. - - maxim,vbus-en-pin: - GPOUTx is the number (1-8) of the GPOUT pin of MAX3421E to drive Vbus. - ACTIVE_LEVEL is 0 or 1. - - interrupts: the interrupt line description for the interrupt controller. - The driver configures MAX3421E for active low level triggered interrupts, - configure your interrupt line accordingly. - -Example: - - usb@0 { - compatible = "maxim,max3421"; - reg = <0>; - maxim,vbus-en-pin = <3 1>; - spi-max-frequency = <26000000>; - interrupt-parent = <&PIC>; - interrupts = <42>; - }; diff --git a/Documentation/devicetree/bindings/usb/maxim,max3421.yaml b/Documentation/devicetree/bindings/usb/maxim,max3421.yaml new file mode 100644 index 000000000000..4639be7ab059 --- /dev/null +++ b/Documentation/devicetree/bindings/usb/maxim,max3421.yaml @@ -0,0 +1,67 @@ +# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/usb/maxim,max3421.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: MAXIM MAX3421e USB Peripheral/Host Controller + +maintainers: + - David Mosberger + +description: | + The controller provides USB2.0 compliant with Full Speed or Low Speed when in + the host mode. At peripheral, it operates at Full Speed. At both cases, it + uses a SPI interface. + Datasheet at: + https://www.analog.com/media/en/technical-documentation/data-sheets/max3421e.pdf + +properties: + compatible: + const: maxim,max3421 + + reg: + maxItems: 1 + + interrupts: + maxItems: 1 + + spi-max-frequency: + maximum: 26000000 + + maxim,vbus-en-pin: + $ref: /schemas/types.yaml#/definitions/uint32-array + description: + One of eight GPOUT pins to control external VBUS power and the polarity + of the active level. It's an array of GPIO number and the active level of it. + minItems: 2 + maxItems: 2 + +required: + - compatible + - reg + - interrupts + - maxim,vbus-en-pin + +allOf: + - $ref: /schemas/spi/spi-peripheral-props.yaml# + +unevaluatedProperties: false + +examples: + - | + #include + #include + spi { + #address-cells = <1>; + #size-cells = <0>; + + usb@0 { + compatible = "maxim,max3421"; + reg = <0>; + maxim,vbus-en-pin = <3 1>; + spi-max-frequency = <26000000>; + interrupt-parent = <&gpio>; + interrupts = <42>; + }; + }; -- 2.48.1