From: Prakriti Sharma <Prakriti.Sharma@synopsys.com>
To: Mark Brown <broonie@kernel.org>, linux-spi@vger.kernel.org
Cc: Rob Herring <robh@kernel.org>,
Krzysztof Kozlowski <krzk+dt@kernel.org>,
Conor Dooley <conor+dt@kernel.org>,
devicetree@vger.kernel.org,
Philipp Zabel <p.zabel@pengutronix.de>,
linux-kernel@vger.kernel.org,
Siddhant Kumar <Siddhant.Kumar@synopsys.com>,
Prakriti Sharma <Prakriti.Sharma@synopsys.com>
Subject: [PATCH 1/6] dt-bindings: spi: Add Synopsys DWC SSI v2.02a binding
Date: Thu, 19 Nov 2026 15:35:08 +0530 [thread overview]
Message-ID: <20261119100513.433044-2-prakriti@synopsys.com> (raw)
In-Reply-To: <20261119100513.433044-1-prakriti@synopsys.com>
From: Siddhant Kumar <sidkumar@synopsys.com>
Add a binding for the Synopsys DesignWare Synchronous Serial Interface
(DWC_ssi v2.02a). The controller has a per-chip-select register map
and dedicated chip-select control.
Signed-off-by: Prakriti Sharma <prakriti@synopsys.com>
Signed-off-by: Siddhant Kumar <sidkumar@synopsys.com>
---
.../bindings/spi/snps,dwc-ssi-2.02a.yaml | 144 ++++++++++++++++++
MAINTAINERS | 7 +
2 files changed, 151 insertions(+)
create mode 100644 Documentation/devicetree/bindings/spi/snps,dwc-ssi-2.02a.yaml
diff --git a/Documentation/devicetree/bindings/spi/snps,dwc-ssi-2.02a.yaml b/Documentation/devicetree/bindings/spi/snps,dwc-ssi-2.02a.yaml
new file mode 100644
index 000000000000..7cccd627f809
--- /dev/null
+++ b/Documentation/devicetree/bindings/spi/snps,dwc-ssi-2.02a.yaml
@@ -0,0 +1,144 @@
+# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/spi/snps,dwc-ssi-2.02a.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Synopsys DesignWare SSI Gen2 SPI Controller
+
+maintainers:
+ - Siddhant Kumar <sidkumar@synopsys.com>
+ - Prakriti Sharma <prakriti@synopsys.com>
+
+description: |
+ The Synopsys DesignWare SSI Gen2 (DWC_ssi v2.02a) is an enhanced SPI
+ controller featuring per-chip-select register banks, dedicated CS control,
+ and support for Standard/Dual/Quad/Octal SPI modes with DDR capability.
+
+allOf:
+ - $ref: spi-controller.yaml#
+
+properties:
+ compatible:
+ const: snps,dwc-ssi-2.02a
+
+ reg:
+ maxItems: 1
+
+ interrupts:
+ description: |
+ The DWC SSI Gen2 IP exposes per-source interrupt outputs alongside a
+ combined ssi_intr. SoC integrators may route either the combined line,
+ the individual lines, or any subset. Provide either a single combined
+ IRQ, or one entry per declared name in interrupt-names (matching order).
+ minItems: 1
+ maxItems: 4
+
+ interrupt-names:
+ description: |
+ Optional. Naming for each physical IRQ line when the SoC breaks the
+ controller's interrupt output into multiple wires. Each name is gated
+ by its corresponding ISR bit in the controller:
+ "rxf" - RX FIFO threshold (SSI_RXF_INTR, ISR.RXFI)
+ "txe" - TX FIFO threshold (SSI_TXE_INTR, ISR.TXEI)
+ "txaf" - TX FIFO almost full (ssi_txaf_intr, ISR.TXAFI)
+ "wsf" - Write status fail (spi_wr_status_fail_intr, ISR.SPIWSFI)
+ Omit this property if the SoC combines all sources onto one wire.
+ minItems: 1
+ maxItems: 4
+ items:
+ enum: [rxf, txe, txaf, wsf]
+
+ clocks:
+ minItems: 1
+ items:
+ - description: SSI controller reference clock
+ - description: APB interface clock
+
+ clock-names:
+ minItems: 1
+ items:
+ - const: ssi_clk
+ - const: pclk
+
+ resets:
+ maxItems: 1
+
+ num-cs:
+ minimum: 1
+ maximum: 4
+ description:
+ Number of chip selects supported by the controller.
+
+ dmas:
+ items:
+ - description: TX DMA Channel
+ - description: RX DMA Channel
+
+ dma-names:
+ items:
+ - const: tx
+ - const: rx
+
+ rx-sample-delay-ns:
+ default: 0
+ description: |
+ Default value of the rx-sample-delay-ns property.
+ This value will be used if the property is not explicitly defined
+ for a SPI slave device.
+
+ SPI Rx sample delay offset, unit is nanoseconds.
+ The delay from the default sample time before the actual sample of the
+ rxd input signal occurs. The "rx_sample_delay" is an optional feature
+ of the designware controller, and the upper limit is also subject to
+ controller configuration.
+
+patternProperties:
+ "^.*@[0-9a-f]+$":
+ type: object
+ $ref: spi-peripheral-props.yaml
+ additionalProperties: true
+
+ properties:
+ reg:
+ minimum: 0
+ maximum: 3
+
+ rx-sample-delay-ns:
+ description:
+ Per-device Rx sample delay override, in nanoseconds.
+
+unevaluatedProperties: false
+
+required:
+ - compatible
+ - reg
+ - "#address-cells"
+ - "#size-cells"
+ - clocks
+
+examples:
+ - |
+ spi@20100000 {
+ compatible = "snps,dwc-ssi-2.02a";
+ reg = <0x20100000 0x1000>;
+ #address-cells = <1>;
+ #size-cells = <0>;
+ interrupts = <0 42 4>;
+ clocks = <&spi_clk>;
+ clock-names = "ssi_clk";
+ num-cs = <2>;
+ dmas = <&dma0 10>, <&dma0 11>;
+ dma-names = "tx", "rx";
+ rx-sample-delay-ns = <3>;
+
+ flash@0 {
+ compatible = "jedec,spi-nor";
+ reg = <0>;
+ spi-max-frequency = <50000000>;
+ spi-rx-bus-width = <4>;
+ spi-tx-bus-width = <4>;
+ rx-sample-delay-ns = <7>;
+ };
+ };
+...
diff --git a/MAINTAINERS b/MAINTAINERS
index ce1b9e514e08..e68a4337a651 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -27304,6 +27304,13 @@ S: Supported
F: Documentation/admin-guide/perf/dwc_pcie_pmu.rst
F: drivers/perf/dwc_pcie_pmu.c
+SYNOPSYS DESIGNWARE SSI GEN2 SPI DRIVER
+M: Prakriti Sharma <prakriti@synopsys.com>
+M: Siddhant Kumar <sidkumar@synopsys.com>
+L: linux-spi@vger.kernel.org
+S: Maintained
+F: Documentation/devicetree/bindings/spi/snps,dwc-ssi-2.02a.yaml
+
SYNOPSYS HSDK RESET CONTROLLER DRIVER
M: Eugeniy Paltsev <Eugeniy.Paltsev@synopsys.com>
S: Supported
--
2.34.1
next prev parent reply other threads:[~2026-11-19 10:06 UTC|newest]
Thread overview: 8+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-11-19 10:05 [PATCH 0/6] spi: dw-g2: add Synopsys DWC SSI v2.02a controller support Prakriti Sharma
2026-11-19 10:05 ` Prakriti Sharma [this message]
2026-11-19 10:05 ` [PATCH 2/6] spi: dw-g2: Add Synopsys DWC SSI v2.02a driver Prakriti Sharma
2026-11-19 10:05 ` [PATCH 3/6] spi: dw-g2: Add indirect read and write Prakriti Sharma
2026-11-19 10:05 ` [PATCH 4/6] spi: dw-g2: Add SPI-NAND support Prakriti Sharma
2026-11-19 10:05 ` [PATCH 5/6] dt-bindings: spi: Document DWC SSI XIP properties Prakriti Sharma
2026-11-19 12:18 ` Krzysztof Kozlowski
2026-11-19 10:05 ` [PATCH 6/6] spi: dw-g2: Add XIP support Prakriti Sharma
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20261119100513.433044-2-prakriti@synopsys.com \
--to=prakriti.sharma@synopsys.com \
--cc=Siddhant.Kumar@synopsys.com \
--cc=broonie@kernel.org \
--cc=conor+dt@kernel.org \
--cc=devicetree@vger.kernel.org \
--cc=krzk+dt@kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-spi@vger.kernel.org \
--cc=p.zabel@pengutronix.de \
--cc=robh@kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox
all inboxes | Powered by JetHome®