bindings/spi/snps%2Cdw-apb-ssi.yaml

1 # SPDX-License-Identifier: GPL-2.0-only
3 ---
4 $id: http://devicetree.org/schemas/spi/snps,dw-apb-ssi.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
10   - Mark Brown <broonie@kernel.org>
13   - $ref: spi-controller.yaml#
14   - if:
19               - mscc,ocelot-spi
20               - mscc,jaguar2-spi
25   - if:
30               - baikal,bt1-sys-ssi
33         mux-controls:
36         - mux-controls
39         - interrupts
40   - if:
44             const: amd,pensando-elba-spi
47         - amd,pensando-elba-syscon
50         amd,pensando-elba-syscon: false
55       - description: Generic DW SPI Controller
57           - snps,dw-apb-ssi
58           - snps,dwc-ssi-1.01a
59       - description: Microchip Sparx5 SoC SPI Controller
60         const: microchip,sparx5-spi
61       - description: Amazon Alpine SPI Controller
62         const: amazon,alpine-dw-apb-ssi
63       - description: Vendor controllers which use snps,dw-apb-ssi as fallback
65           - enum:
66               - mscc,ocelot-spi
67               - mscc,jaguar2-spi
68               - renesas,rzn1-spi
69               - sophgo,sg2042-spi
70               - thead,th1520-spi
71           - const: snps,dw-apb-ssi
72       - description: Intel Keem Bay SPI Controller
73         const: intel,keembay-ssi
74       - description: Intel Mount Evans Integrated Management Complex SPI Controller
75         const: intel,mountevans-imc-ssi
76       - description: AMD Pensando Elba SoC SPI Controller
77         const: amd,pensando-elba-spi
78       - description: Baikal-T1 SPI Controller
79         const: baikal,bt1-ssi
80       - description: Baikal-T1 System Boot SPI Controller
81         const: baikal,bt1-sys-ssi
82       - description: Canaan Kendryte K210 SoS SPI Controller
83         const: canaan,k210-spi
84       - description: Renesas RZ/N1 SPI Controller
86           - enum:
87               - renesas,r9a06g032-spi # RZ/N1D
88               - renesas,r9a06g033-spi # RZ/N1S
89           - const: renesas,rzn1-spi   # RZ/N1
94       - description: DW APB SSI controller memory mapped registers
95       - description: SPI MST region map or directly mapped SPI ROM
103       - description: SPI Controller reference clock source
104       - description: APB interface clock source
106   clock-names:
109       - const: ssi_clk
110       - const: pclk
115   reset-names:
116     const: spi
118   reg-io-width:
123   num-cs:
130       - description: TX DMA Channel
131       - description: RX DMA Channel
133   dma-names:
135       - const: tx
136       - const: rx
138   rx-sample-delay-ns:
141       Default value of the rx-sample-delay-ns property.
143       for a SPI slave device.
145       SPI Rx sample delay offset, unit is nanoseconds.
151   amd,pensando-elba-syscon:
152     $ref: /schemas/types.yaml#/definitions/phandle-array
154       Block address to control SPI chip-selects. The Elba SoC system controller
155       provides an interface to override the native DWC SSI CS control.
158   "^.*@[0-9a-f]+$":
170   - compatible
171   - reg
172   - "#address-cells"
173   - "#size-cells"
174   - clocks
177   - |
178     spi@fff00000 {
179       compatible = "snps,dw-apb-ssi";
181       #address-cells = <1>;
182       #size-cells = <0>;
185       num-cs = <2>;
186       cs-gpios = <&gpio0 13 0>,
188       rx-sample-delay-ns = <3>;
190         compatible = "spi-nand";
192         rx-sample-delay-ns = <7>;
195   - |
196     spi@1f040100 {
197       compatible = "baikal,bt1-sys-ssi";
200       #address-cells = <1>;
201       #size-cells = <0>;
202       mux-controls = <&boot_mux>;
204       clock-names = "ssi_clk";