1 # SPDX-License-Identifier: (GPL-2.0-only OR BS 1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2 %YAML 1.2 2 %YAML 1.2
3 --- 3 ---
4 $id: http://devicetree.org/schemas/fpga/lattic 4 $id: http://devicetree.org/schemas/fpga/lattice,sysconfig.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: Lattice Slave SPI sysCONFIG FPGA manage 7 title: Lattice Slave SPI sysCONFIG FPGA manager
8 8
9 maintainers: 9 maintainers:
10 - Vladimir Georgiev <v.georgiev@metrotek.ru> 10 - Vladimir Georgiev <v.georgiev@metrotek.ru>
11 11
12 description: | 12 description: |
13 Lattice sysCONFIG port, which is used for FP 13 Lattice sysCONFIG port, which is used for FPGA configuration, among others,
14 have Slave Serial Peripheral Interface. Only 14 have Slave Serial Peripheral Interface. Only full reconfiguration is
15 supported. 15 supported.
16 16
17 Programming of ECP5 is done by writing uncom 17 Programming of ECP5 is done by writing uncompressed bitstream image in .bit
18 format into FPGA's SRAM configuration memory 18 format into FPGA's SRAM configuration memory.
19 19
20 properties: 20 properties:
21 compatible: 21 compatible:
22 enum: 22 enum:
23 - lattice,sysconfig-ecp5 23 - lattice,sysconfig-ecp5
24 24
25 reg: 25 reg:
26 maxItems: 1 26 maxItems: 1
27 27
28 program-gpios: 28 program-gpios:
29 description: 29 description:
30 A GPIO line connected to PROGRAMN (activ 30 A GPIO line connected to PROGRAMN (active low) pin of the device.
31 Initiates configuration sequence. 31 Initiates configuration sequence.
32 maxItems: 1 32 maxItems: 1
33 33
34 init-gpios: 34 init-gpios:
35 description: 35 description:
36 A GPIO line connected to INITN (active l 36 A GPIO line connected to INITN (active low) pin of the device.
37 Indicates that the FPGA is ready to be c 37 Indicates that the FPGA is ready to be configured.
38 maxItems: 1 38 maxItems: 1
39 39
40 done-gpios: 40 done-gpios:
41 description: 41 description:
42 A GPIO line connected to DONE (active hi 42 A GPIO line connected to DONE (active high) pin of the device.
43 Indicates that the configuration sequenc 43 Indicates that the configuration sequence is complete.
44 maxItems: 1 44 maxItems: 1
45 45
46 required: 46 required:
47 - compatible 47 - compatible
48 - reg 48 - reg
49 49
50 allOf: 50 allOf:
51 - $ref: /schemas/spi/spi-peripheral-props.ya 51 - $ref: /schemas/spi/spi-peripheral-props.yaml
52 52
53 - if: 53 - if:
54 properties: 54 properties:
55 compatible: 55 compatible:
56 contains: 56 contains:
57 const: lattice,sysconfig-ecp5 57 const: lattice,sysconfig-ecp5
58 then: 58 then:
59 properties: 59 properties:
60 spi-max-frequency: 60 spi-max-frequency:
61 maximum: 60000000 61 maximum: 60000000
62 62
63 unevaluatedProperties: false 63 unevaluatedProperties: false
64 64
65 examples: 65 examples:
66 - | 66 - |
67 #include <dt-bindings/gpio/gpio.h> 67 #include <dt-bindings/gpio/gpio.h>
68 68
69 spi { 69 spi {
70 #address-cells = <1>; 70 #address-cells = <1>;
71 #size-cells = <0>; 71 #size-cells = <0>;
72 72
73 fpga-mgr@0 { 73 fpga-mgr@0 {
74 compatible = "lattice,sysconfig-ec 74 compatible = "lattice,sysconfig-ecp5";
75 reg = <0>; 75 reg = <0>;
76 spi-max-frequency = <20000000>; 76 spi-max-frequency = <20000000>;
77 program-gpios = <&gpio3 4 GPIO_ACT 77 program-gpios = <&gpio3 4 GPIO_ACTIVE_LOW>;
78 init-gpios = <&gpio3 3 GPIO_ACTIVE 78 init-gpios = <&gpio3 3 GPIO_ACTIVE_LOW>;
79 done-gpios = <&gpio3 2 GPIO_ACTIVE 79 done-gpios = <&gpio3 2 GPIO_ACTIVE_HIGH>;
80 }; 80 };
81 }; 81 };
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.