[PATCH 1/6] dt-bindings: spi: Add Synopsys DWC SSI v2.02a binding

From: Prakriti Sharma

Date: Thu Nov 19 2026 - 05:06:38 EST


From: Siddhant Kumar <sidkumar@xxxxxxxxxxxx>

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@xxxxxxxxxxxx>
Signed-off-by: Siddhant Kumar <sidkumar@xxxxxxxxxxxx>
---
.../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@xxxxxxxxxxxx>
+ - Prakriti Sharma <prakriti@xxxxxxxxxxxx>
+
+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@xxxxxxxxxxxx>
+M: Siddhant Kumar <sidkumar@xxxxxxxxxxxx>
+L: linux-spi@xxxxxxxxxxxxxxx
+S: Maintained
+F: Documentation/devicetree/bindings/spi/snps,dwc-ssi-2.02a.yaml
+
SYNOPSYS HSDK RESET CONTROLLER DRIVER
M: Eugeniy Paltsev <Eugeniy.Paltsev@xxxxxxxxxxxx>
S: Supported
--
2.34.1