xref: /linux/Documentation/devicetree/bindings/mtd/ingenic,nand.yaml (revision cdd5b5a9761fd66d17586e4f4ba6588c70e640ea) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/mtd/ingenic,nand.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Ingenic SoCs NAND controller
8
9maintainers:
10  - Paul Cercueil <paul@crapouillou.net>
11
12allOf:
13  - $ref: nand-controller.yaml#
14  - $ref: /schemas/memory-controllers/ingenic,nemc-peripherals.yaml#
15
16properties:
17  compatible:
18    enum:
19      - ingenic,jz4740-nand
20      - ingenic,jz4725b-nand
21      - ingenic,jz4780-nand
22
23  reg:
24    items:
25      - description: Bank number, offset and size of first attached NAND chip
26      - description: Bank number, offset and size of second attached NAND chip
27      - description: Bank number, offset and size of third attached NAND chip
28      - description: Bank number, offset and size of fourth attached NAND chip
29    minItems: 1
30
31  ecc-engine: true
32
33  partitions:
34    type: object
35    deprecated: true
36    description:
37      Node containing description of fixed partitions.
38
39patternProperties:
40  "^nand@[a-f0-9]$":
41    type: object
42    $ref: raw-nand-chip.yaml
43    properties:
44
45      rb-gpios:
46        description: GPIO specifier for the busy pin.
47        maxItems: 1
48
49      wp-gpios:
50        description: GPIO specifier for the write-protect pin.
51        maxItems: 1
52
53    unevaluatedProperties: false
54
55required:
56  - compatible
57  - reg
58
59unevaluatedProperties: false
60
61examples:
62  - |
63    #include <dt-bindings/clock/ingenic,jz4780-cgu.h>
64    memory-controller@13410000 {
65        compatible = "ingenic,jz4780-nemc";
66        reg = <0x13410000 0x10000>;
67        #address-cells = <2>;
68        #size-cells = <1>;
69        ranges = <1 0 0x1b000000 0x1000000>,
70                 <2 0 0x1a000000 0x1000000>,
71                 <3 0 0x19000000 0x1000000>,
72                 <4 0 0x18000000 0x1000000>,
73                 <5 0 0x17000000 0x1000000>,
74                 <6 0 0x16000000 0x1000000>;
75
76        clocks = <&cgu JZ4780_CLK_NEMC>;
77
78        nand-controller@1 {
79            compatible = "ingenic,jz4780-nand";
80            reg = <1 0 0x1000000>;
81
82            #address-cells = <1>;
83            #size-cells = <0>;
84
85            ecc-engine = <&bch>;
86
87            ingenic,nemc-tAS = <10>;
88            ingenic,nemc-tAH = <5>;
89            ingenic,nemc-tBP = <10>;
90            ingenic,nemc-tAW = <15>;
91            ingenic,nemc-tSTRV = <100>;
92
93            pinctrl-names = "default";
94            pinctrl-0 = <&pins_nemc>;
95
96            nand@1 {
97                reg = <1>;
98
99                nand-ecc-step-size = <1024>;
100                nand-ecc-strength = <24>;
101                nand-ecc-mode = "hw";
102                nand-on-flash-bbt;
103
104                pinctrl-names = "default";
105                pinctrl-0 = <&pins_nemc_cs1>;
106
107                partitions {
108                    compatible = "fixed-partitions";
109                    #address-cells = <2>;
110                    #size-cells = <2>;
111
112                    partition@0 {
113                        label = "u-boot-spl";
114                        reg = <0x0 0x0 0x0 0x800000>;
115                    };
116
117                    partition@800000 {
118                        label = "u-boot";
119                        reg = <0x0 0x800000 0x0 0x200000>;
120                    };
121
122                    partition@a00000 {
123                        label = "u-boot-env";
124                        reg = <0x0 0xa00000 0x0 0x200000>;
125                    };
126
127                    partition@c00000 {
128                        label = "boot";
129                        reg = <0x0 0xc00000 0x0 0x4000000>;
130                    };
131
132                    partition@4c00000 {
133                        label = "system";
134                        reg = <0x0 0x4c00000 0x1 0xfb400000>;
135                    };
136                };
137            };
138        };
139    };
140