From mboxrd@z Thu Jan 1 00:00:00 1970 Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.remote-ip=209.127.231.19 ARC-Seal: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; cv=none; t=1794992283; b=e4jf1ixsoqG7LtfHr141pe3b0JoW/gh6Q7CBrLmL3mQM8s++ddWrDpbP9HR36WYwC1vV 86f7AzFwpjBDaoC3vYg2vU9iEWv4d6mDIKiWI/XyOCyS4rvqFbHtzoJ/AsGQpz4OGsmC9 1ZS+jkEoNSe5PQniIvCr+y38SUqgziRdF+wkeRujXELUerRiyE0Yi43m0fcXMkB9UXF0s WWbwUdZY7WXMW0S9bVfsX5yEfl5H050rmdhUlHw/D/eCi4IG+Jo5Gargs3srvErMa8byN V6AWzxYEzs4qx28kP889TcczeCajjoQnO/nQoTGAqoYqT0NPlSGj3OTs/l4ZyW7kWAQ== ARC-Message-Signature: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; c=relaxed/relaxed; t=1794992283; h=DMARC-Filter:DKIM-Signature:To:Date:In-Reply-To:Cc:Subject:X-Mailer: X-Lms-Return-Path:Content-Transfer-Encoding:Content-Type:Message-Id: Received:X-Original-From:From:Mime-Version:References; bh=S4+nY5S4u49URlEXcMNdkTuO3X5mh5b+AFVZYGcYQ60=; b=LoTq/qap8mCA0HkVxzImL/u5fS1XJU5GZix6i7cmMrivnnt2BxX6pMWZoI7lSBJ5AcjF r3MNu6YjnOOrdOSs7B4vuR+B7s/rqQaxfRQfNIZC9Xu6txsRFEY6PVSaykvh0pGUSQzix hUyk/bEOYrSSz9xatF2K2WerLVdEwr+JdqxI/yCB1A/k8o+MCTG67RWR0/7KAU2D53xRp 9qFa4/1YsxLGTttH2wubJtPFHjvui9TryyAQ7lwipPdsyTt6RPj0oG9TrQf3k05abm/pM bXNCkFUTKTKTt/Gl9FzKc3SmguT1IXEl3k8NPF7xYPW7kYnxkikY/OV5xocQqWrAKNw== ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass header.from=deepcomputing.io; spf=pass smtp.mailfrom=deepcomputing.io; dkim=pass header.d=deepcomputing-io.20200927.dkim.feishu.cn header.i=@deepcomputing-io.20200927.dkim.feishu.cn header.a=rsa-sha256 header.s=s1 header.b=lNTTVwdl; arc=none smtp.remote-ip=209.127.231.19 Received: from va-2-19.ptr.blmpb.com (va-2-19.ptr.blmpb.com [209.127.231.19]) (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 80ADB606A32A for ; Wed, 18 Nov 2026 08:58:02 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.4.2 smtp.subspace.kernel.org 80ADB606A32A Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=deepcomputing.io Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=deepcomputing.io Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=deepcomputing-io.20200927.dkim.feishu.cn header.i=@deepcomputing-io.20200927.dkim.feishu.cn header.a=rsa-sha256 header.s=s1 header.b=lNTTVwdl DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; s=s1; d=deepcomputing-io.20200927.dkim.feishu.cn; t=1794992276; h=from:subject:mime-version:from:date:message-id:subject:to:cc: reply-to:content-type:mime-version:in-reply-to:message-id; bh=S4+nY5S4u49URlEXcMNdkTuO3X5mh5b+AFVZYGcYQ60=; b=lNTTVwdlBx8X0fhtS9f9tRj/W006HpT2WDGvrAE4IaSa9g1pEJWMTD50M+2rnaUFJcRY/+ UkPZdZe0dCp7u6yFTqMN0FZ9nlCIseutsqC8lOQ8IovkssEZZU1fdUp/P3kBCLtmwaTB1G nhkZAqC9B9fD7mFt5Aw1gsaCyr6sst379q9frXHP/fUId9RyepZ0IlH8osRt1H9HOOwKPL a3AZ32LHNTxfid0tiQmrMS2uIwAcMze/0otcMUJ9kXThUn/dT+kTRdp+paqXgvqm7SdBuv 3K4qkwReRhfbQ4ja5R2fuEA9gQjH2ZYDkAgq9bKjH+UU1fyxa15QcSqdR92wQg== To: "Yixun Lan" , "Benson Leung" Date: Wed, 18 Nov 2026 16:57:34 +0800 In-Reply-To: <20261118085742.1817536-1-yang.wang@deepcomputing.io> Cc: "Troy Mitchell" , "Tzung-Bi Shih" , "Guenter Roeck" , "Rob Herring" , "Krzysztof Kozlowski" , "Conor Dooley" , "Paul Walmsley" , "Palmer Dabbelt" , "Albert Ou" , "Alexandre Ghiti" , "Sandie Cao" , , , , , Subject: [PATCH 1/9] dt-bindings: bus: Add SpacemiT K3 eSPI controller X-Mailer: git-send-email 2.43.0 X-Lms-Return-Path: Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset=UTF-8 Message-Id: <20261118085742.1817536-2-yang.wang@deepcomputing.io> Received: from ubuntu.. ([183.23.101.74]) by smtp.feishu.cn with ESMTPS; Wed, 18 Nov 2026 16:57:53 +0800 X-Original-From: Wang Yang From: "Wang Yang" X-Mailing-List: devicetree@vger.kernel.org List-Id: List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Owner: Precedence: list Mime-Version: 1.0 References: <20261118085742.1817536-1-yang.wang@deepcomputing.io> Describe the K3 eSPI controller and its peripheral memory translation window, clocks, resets and link configuration. The EC uses this memory window rather than the ordinary SPI transfer interface. The controller implementation is carried as a separate prerequisite so that the hardware vendor can review it independently. Prepared with Codex assistance from the existing DC-linux EC support. Signed-off-by: Wang Yang --- .../bindings/bus/spacemit,k3-espi.yaml | 146 ++++++++++++++++++ 1 file changed, 146 insertions(+) create mode 100644 Documentation/devicetree/bindings/bus/spacemit,k3-espi.yaml diff --git a/Documentation/devicetree/bindings/bus/spacemit,k3-espi.yaml b/Documentation/devicetree/bindings/bus/spacemit,k3-espi.yaml new file mode 100644 index 000000000..30985ee0a --- /dev/null +++ b/Documentation/devicetree/bindings/bus/spacemit,k3-espi.yaml @@ -0,0 +1,146 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/bus/spacemit,k3-espi.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: SpacemiT K3 eSPI controller + +maintainers: + - Yixun Lan + +description: | + The K3 eSPI controller connects the application processor to an embedded + controller. Child registers are accessed through a peripheral shared-memory + window, translated by ranges. The controller manages clocks, resets and + channel negotiation, including link recovery after an EC reboot. + +properties: + compatible: + const: spacemit,k3-espi + + reg: + maxItems: 1 + + '#address-cells': + const: 1 + + '#size-cells': + const: 1 + + ranges: + maxItems: 1 + + clocks: + items: + - description: Serial clock source + - description: Serial clock + - description: Bus clock + + clock-names: + items: + - const: sclk_src + - const: sclk + - const: mclk + + resets: + items: + - description: Bus reset + - description: Serial clock reset + + pr-mem-base0: + $ref: /schemas/types.yaml#/definitions/uint32 + description: First peripheral memory translation base. + + pr-mem-base1: + $ref: /schemas/types.yaml#/definitions/uint32 + description: Second peripheral memory translation base. + + operating-frequency: + $ref: /schemas/types.yaml#/definitions/uint32 + description: Requested link clock frequency in MHz. + enum: [20, 25, 33, 50, 66] + default: 20 + + io-mode: + $ref: /schemas/types.yaml#/definitions/string + description: Requested number of eSPI data lines. + enum: [single, dual, quad] + default: single + + alert-mode: + $ref: /schemas/types.yaml#/definitions/string + description: Use the shared IO1 line or the dedicated alert pin. + enum: [io1, pin] + default: io1 + + alert-type: + $ref: /schemas/types.yaml#/definitions/string + description: Electrical mode of the dedicated alert pin. + enum: [open-drain, push-pull] + default: open-drain + + watchdog-timeout: + $ref: /schemas/types.yaml#/definitions/uint32 + description: Controller watchdog counter value. + maximum: 65535 + default: 65535 + + crc-enable: + type: boolean + description: Enable link CRC checking. + + auto-gating-enable: + type: boolean + description: Enable automatic controller clock gating. + + peripheral-channel-enable: + type: boolean + description: Enable the peripheral channel. + + vwire-channel-enable: + type: boolean + description: Enable the virtual-wire channel. + + oob-channel-enable: + type: boolean + description: Enable the out-of-band channel. + + flash-channel-enable: + type: boolean + description: Enable the flash access channel. + +patternProperties: + '^ec@[0-9a-f]+$': + $ref: /schemas/embedded-controller/google,cros-ec.yaml# + +required: + - compatible + - reg + - '#address-cells' + - '#size-cells' + - ranges + - clocks + - clock-names + - resets + +additionalProperties: false + +examples: + - | + #include + #include + + espi@cac8c000 { + compatible = "spacemit,k3-espi"; + reg = <0xcac8c000 0x1000>; + #address-cells = <1>; + #size-cells = <1>; + ranges = <0 0x84000000 0x1000>; + clocks = <&syscon_apmu CLK_APMU_ESPI_SCLK_SRC>, + <&syscon_apmu CLK_APMU_ESPI_SCLK>, + <&syscon_apmu CLK_APMU_ESPI_MCLK>; + clock-names = "sclk_src", "sclk", "mclk"; + resets = <&syscon_apmu RESET_APMU_ESPI_MCLK>, + <&syscon_apmu RESET_APMU_ESPI_SCLK>; + }; base-commit: 749a4de370409464cf8501ec5b2451df45c84eb4 -- 2.43.0