From mboxrd@z Thu Jan 1 00:00:00 1970 Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.remote-ip=209.85.161.43 ARC-Seal: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; cv=none; t=1793413611; b=CR5kdGl1cS1Km3olkoEASeZT+HCWSjhyykZLiqd52t6Oi81LOuWoabTvDIlDhQtCZAZl UvTSMshfwP4ypDxSuu7ZSpy0bczyKk3eCBSxhS43BB1FZ/AchebKotwno7k9Jg5Jfxk8v pHZa/lpeuzqtJKgGZtJRNJGVLuc5ReqnBuayzZ5qlL5qogtU7W71JHQ+shom2Qbf3744H xbl44EAwQpEu6bniaFpkCHwGE446ebk0sGWLKQxDAg4EIBxRzSCRygKF2fjzlTrtrTEG8 nOzacygM1FHpmex9Pdx0fQMs1hXNXnngEv9QI6Z+nIZ0tvBDE2TDF2+Ma8WZ6ne2Pbw== ARC-Message-Signature: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; c=relaxed/relaxed; t=1793413611; h=DMARC-Filter:Received:DKIM-Signature:X-Google-DKIM-Signature: X-Forwarded-Encrypted:X-Gm-Message-State:X-Gm-Gg:X-Received:Received: From:To:Cc:Subject:Date:Message-ID:MIME-Version:Content-Type: Content-Transfer-Encoding; bh=knhN+uUso/I5nZA/3isy8rW61w7+X2wALPCWBAgmsNk=; b=nSyRnuH9FyQiGGVJGTcM45ydSpsDmob6kaXRWz72hSnXhdq0+1zqb4CzJK87kG/wHq1S 2DmcN4VYh5nAn0NEIQY4XPK7JUa52dR4Y5qDFDCP+Q2DDehPd8OvUzzBGRCRDtfJQhovU UJvXh1eCyWcAXAGKx0wNnyfocKstMeG3SN2x+Jx5/+xLke0unlCz0U8Ihey40ltQKMMKd Myuhphtgdylp+xADesc3Q18bkR2vrRX/HqAYpqL9MXlmS+i9dVoUV+D1d3ENt9yldPdTt nXWkAPuLO2RYS7XTdPEVKJBX2777bB9ML+vE9IfBxF5Gx94nXYVyc1xs9ZxfkqnWSdg== ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass header.d=gmail.com header.i=@gmail.com header.a=rsa-sha256 header.s=20260707 header.b=glUCXoFL; arc=none smtp.remote-ip=209.85.161.43 Received: from mail-oo1-f43.google.com (mail-oo1-f43.google.com [209.85.161.43]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature ECDSA (prime256v1) server-digest SHA256) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id F2ED2606A320 for ; Sat, 31 Oct 2026 02:26:50 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.4.2 smtp.subspace.kernel.org F2ED2606A320 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, unprotected) header.d=gmail.com header.i=@gmail.com header.a=rsa-sha256 header.s=20260707 header.b=glUCXoFL Received: by mail-oo1-f43.google.com with SMTP id 006d021491bc7-705cb6ceebaso905366eaf.3 for ; Fri, 30 Oct 2026 19:26:50 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20260707; t=1793413610; x=1794018410; darn=vger.kernel.org; h=content-transfer-encoding:content-type:mime-version:message-id:date :subject:cc:to:from:from:to:cc:subject:date:message-id:reply-to :content-type; bh=knhN+uUso/I5nZA/3isy8rW61w7+X2wALPCWBAgmsNk=; b=glUCXoFLqm7/xMKQrZuJ4D9rfNxN0e9bXiDZ/X9dcYrcrKb6856ArrDVOPzh4wMx0t VATTbSUi/nQfD94AGMtGnqPJ8aMXjm/Bqtok6hKk3Jj8GuXe9GZxGlV7qQ7W+uBylAnE zVF/zU5pBDEROvoiLxlHfUje4TJFdS8VbhShtH18wN0iXBFBdoFfUXr1iMQaKku9TXDv u/3IxmnWLP98Rz51etX1EQpD6HDNDbPrIF/XvVnRWlVLRAYLbBYeTQDKZAgHw2ZpKA5X WXhsBkuk5x/vQjVURclhedubGkSEwxFa0nv/ysCoqnq1X7vZN6jHIALq7PEWp3oiQP3k EyLg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20260707; t=1793413610; x=1794018410; h=content-transfer-encoding:content-type: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:content-type; bh=knhN+uUso/I5nZA/3isy8rW61w7+X2wALPCWBAgmsNk=; b=deTeiN6b+ExMo5X9fxZln5uR1Ic+U83bDXsivU9DD/+Rf7PEApM7RD8NfQO4plI3Yr kVd1F4l2Nri10zNjVWY7bmm8KdS0rQaaGlZOt3iz6TfD+44KhWusHIMgEMM16Z4wgH7F jwrNsUtqbllmlyGp/zYY3T6Sp1kwHbn4RwVqOHBwKROFlvAov9O+4rsKDQiRwW1ox/Xj MLG7pWHP8YSfwiWBn184jrh/zgiDolfRYR13XQtcmW0ZVDG6AOi85XsytKSaL6+PZc6s koUAG4XwFkqJCYOOg+LhEhFOLqQs2TzPat1ATiyooQnUsyhwbYWv94nc2UtvdJpvLhhs g1ug== X-Forwarded-Encrypted: i=1; AKwUvBwobzPqM+/RnScP3amcTlH/IMlrqlq6wJCHXeVRbDETIv9qxlJRMWhg59sCrhOHXs3NK5bsBA+Nu7w=@vger.kernel.org X-Gm-Message-State: AFq9FYI0Awlux2U+DWEeeBi67POt9criIWKrGyfdhsGXheOJDW8HaiIC bDFGHurlFSGM/RrPoAQqZpxS9kq2X6oQTGg26iX1G873K8xBlLw1U7i/ X-Gm-Gg: AYBFou3vHSk8fTMIRly8Vz3J8171gHbjzrlWZf3DtV9mCdMFPhDr9oQeu2biJ/yXOV3 bh3ycAnooAdeoKCz6IJuLOXkh1/ABN1ggySFNWVNiO5n0MnPmuXpRfHZGGhdCncYIIG5bBnnXTu yFJaXsbRI2mnlm92iqOLEBXLCFw0a5YDKdiBGG675KsTQUekIiBga564DmEKsga3TiufEbTRTQG PE/9UikKDf6JEgJl0jsxWMtdUnHkQANgAAGo4iNzGY8OitlS7dDuqoX4h+n1UV+oL/8nI5Zsm79 JwQCaDcZBwsyxqJIO26+I0TBXYKaYmaCLzN1mjqqn6TfCpZaePe45QlzBpMIeGX5NPpzwBr1x8S pg7UWkW216q1xdhjPZpgz3HVqg9GVL5RB+Q0DbO6arHAoVMZJdCkN5lGYKsC1yFnURYUrY9yK8A RS+Q83GMMh3GQOYWR/FFt58vG4TBDv5wytFFVG7HePnqB+GQP3zGiOuWqPjekb73+JQWDkti/5b YJrCZAFWoGb4qH4PJDbLQDWUIwikBmRoRZOKp3SUq0Q4vFvS/79jB90q7gNE9CxCEyuDHbrRmOZ WHIQAKuveZteLtxCgvw6njwrMmsyHwL9Kyybd4jeDSCWuovZLYPEnBu0sUZFvzsihTpVMUcni+G VaLDEww== X-Received: by 2002:a05:6820:7082:10b0:70d:9d05:dbf with SMTP id 006d021491bc7-714f27fe3cemr1676288eaf.90.1793413609920; Fri, 30 Oct 2026 19:26:49 -0700 (PDT) Received: from AMD.home.internal (dhcp-9-244-8-156.gobrightspeed.net. [9.244.8.156]) by smtp.gmail.com with ESMTPSA id 006d021491bc7-714f2e500d0sm3126067eaf.10.2026.10.30.19.26.48 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 30 Oct 2026 19:26:49 -0700 (PDT) From: Enzo Adriano To: Ulf Hansson , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Chen-Yu Tsai , Jernej Skrabec , Samuel Holland Cc: Maxime Ripard , linux-mmc@vger.kernel.org, devicetree@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-sunxi@lists.linux.dev, linux-kernel@vger.kernel.org, Andre Przywara , Junhui Liu Subject: [PATCH] dt-bindings: mmc: describe the Allwinner A733 eMMC controller Date: Fri, 30 Oct 2026 22:26:47 -0400 Message-ID: <20261031020640-263f7b05-a7s-mmc-binding@gmail.com> X-Mailing-List: linux-mmc@vger.kernel.org List-Id: List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Owner: Precedence: list MIME-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: 8bit SMHC3 uses a different DMA descriptor format from SMHC0/2: the length field is 12 bits and the ownership/control word carries different control and high-address fields. An older A100/D1 fallback would claim unsupported programming compatibility with the existing sunxi-mmc descriptor builder. Give SMHC3 a distinct compatible and describe its register range, interrupt, bus/module/storage-MBUS/MSI-Lite1 clocks and bus reset. This binding permits an accurate disabled hardware description; no operational driver match or eMMC functionality is claimed here. AI assistance: Codex:gpt-6-astra. Assisted-by: LLM Signed-off-by: Enzo Adriano --- This binding is a separate prerequisite for the disabled MMC3 node in the A733 DT v2. It does not add a sunxi-mmc driver match or claim an operational eMMC path. The original A733 manual and public vendor implementation distinguish SMHC3's descriptor control/high-address fields and 12-bit buffer length from SMHC0-2. Its resources are the 0x04023000/0x1000 register window, SPI 164, AHB/module/storage-MBUS/MSI-Lite1 clocks and AHB reset. The generic A733/D1 MMC0-2 compatible already in the base is unchanged. The example uses the public A733 CCU header IDs. The tested standalone base is official commit d89e1d186ec9271bf78e62771779e9fc03bf0fc3 plus the clock helpers and CCU v6: https://lore.kernel.org/r/20260906-sunxi-clk-no-p-v1-0-cbde21c9fe69@pigmoral.tech https://lore.kernel.org/r/20261009-a733-clk-v6-0-ae8178fce7e8@pigmoral.tech The binding example passes dt_binding_check, and its disabled DTS user passes W=2 CHECK_DTBS=y. MMC0 runtime tests exercise the existing controller driver; they are not MMC3 hardware validation. .../mmc/allwinner,sun60i-a733-emmc.yaml | 77 +++++++++++++++++++ 1 file changed, 77 insertions(+) create mode 100644 Documentation/devicetree/bindings/mmc/allwinner,sun60i-a733-emmc.yaml diff --git a/Documentation/devicetree/bindings/mmc/allwinner,sun60i-a733-emmc.yaml b/Documentation/devicetree/bindings/mmc/allwinner,sun60i-a733-emmc.yaml new file mode 100644 index 0000000000000000000000000000000000000000..07dc6759b937c8998c4ca72cae027f9444a0793c --- /dev/null +++ b/Documentation/devicetree/bindings/mmc/allwinner,sun60i-a733-emmc.yaml @@ -0,0 +1,77 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/mmc/allwinner,sun60i-a733-emmc.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Allwinner A733 eMMC controller + +maintainers: + - Chen-Yu Tsai + - Maxime Ripard + +description: + The SMHC3 controller has a different DMA descriptor format from SMHC0-2, + with 12-bit buffer lengths and high address bits in the descriptor control + word. It is not compatible with the earlier Allwinner MMC controllers. + +allOf: + - $ref: mmc-controller.yaml + +properties: + compatible: + const: allwinner,sun60i-a733-emmc + + reg: + maxItems: 1 + + interrupts: + maxItems: 1 + + clocks: + items: + - description: AHB interface clock + - description: Module clock + - description: Storage MBUS clock + - description: MSI-Lite1 interface clock + + clock-names: + items: + - const: ahb + - const: mmc + - const: mbus + - const: msi + + resets: + maxItems: 1 + + reset-names: + const: ahb + +required: + - compatible + - reg + - interrupts + - clocks + - clock-names + - resets + - reset-names + +unevaluatedProperties: false + +examples: + - | + #include + #include + #include + + mmc@4023000 { + compatible = "allwinner,sun60i-a733-emmc"; + reg = <0x04023000 0x1000>; + interrupts = ; + clocks = <&ccu CLK_BUS_MMC3>, <&ccu CLK_MMC3>, + <&ccu CLK_MBUS_STORE>, <&ccu CLK_BUS_MSI_LITE1>; + clock-names = "ahb", "mmc", "mbus", "msi"; + resets = <&ccu RST_BUS_MMC3>; + reset-names = "ahb"; + }; base-commit: d89e1d186ec9271bf78e62771779e9fc03bf0fc3 prerequisite-patch-id: 0df2ae41836b86fd868dfa01ddfde57f888f761a prerequisite-patch-id: 88f3a431e7c551a9fa732f062188f10fdd362eeb prerequisite-patch-id: 3e88bc873c909059d1199f82cda4013765e7a5e5 prerequisite-patch-id: 0dbc27cd7417352319a0705a051dff35085e8922 prerequisite-patch-id: 0ed6b92774b5b794761c7ce34db653a5435dc833 prerequisite-patch-id: 27ed3814dbd0c7ad830532ff125625917c873b4b prerequisite-patch-id: 74d03898c5ce14763f4e89fb73e021de59f0fb9f prerequisite-patch-id: 9225cb094cf6cbb338b14ac63711d68bed12d24d prerequisite-patch-id: 568dae1c91a0d7318d6eb14a18054343b84b603a prerequisite-patch-id: ff3806332e741f0e2c8dac1c11f4c71449c16c8c prerequisite-patch-id: 39461e0543aefb5c40184664625cbab19ac8408a prerequisite-patch-id: 6fc03bfbd343042dd3b660938fcc09c5e7d48314 -- 2.53.0