bindings/mtd/gpmi-nand.yaml

1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
3 ---
4 $id: http://devicetree.org/schemas/mtd/gpmi-nand.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
7 title: Freescale General-Purpose Media Interface (GPMI)
10   - Han Xu <han.xu@nxp.com>
13   The GPMI nand controller provides an interface to control the NAND
14   flash chips. The device tree may optionally contain sub-nodes
21       - enum:
22           - fsl,imx23-gpmi-nand
23           - fsl,imx28-gpmi-nand
24           - fsl,imx6q-gpmi-nand
25           - fsl,imx6sx-gpmi-nand
26           - fsl,imx7d-gpmi-nand
27           - fsl,imx8qxp-gpmi-nand
28       - items:
29           - enum:
30               - fsl,imx8mm-gpmi-nand
31               - fsl,imx8mn-gpmi-nand
32               - fsl,imx8mp-gpmi-nand
33               - fsl,imx8mq-gpmi-nand
34           - const: fsl,imx7d-gpmi-nand
35       - items:
36           - enum:
37               - fsl,imx8dxl-gpmi-nand
38               - fsl,imx8qm-gpmi-nand
39           - const: fsl,imx8qxp-gpmi-nand
43       - description: Address and length of gpmi block.
44       - description: Address and length of bch block.
46   reg-names:
48       - const: gpmi-nand
49       - const: bch
54   interrupt-names:
60   dma-names:
61     const: rx-tx
67   clock-names:
71   fsl,use-minimum-ecc:
74       Protect this NAND flash with the minimum ECC strength required.
76       flash (e.g., according to the ONFI standard). However, note that
78       the software may chooses an implementation-defined ECC scheme.
80   fsl,no-blockmark-swap:
84       the data area but rely on the flash based BBT for identifying bad blocks.
85       NOTE: this is only valid in conjunction with 'nand-on-flash-bbt'.
86       WARNING: on i.MX28 blockmark swapping cannot be disabled for the BootROM
88       on may not be accessible by the BootROM code.
91   - compatible
92   - reg
93   - reg-names
94   - interrupts
95   - interrupt-names
96   - clocks
97   - clock-names
98   - dmas
99   - dma-names
104   - $ref: nand-controller.yaml
106   - if:
111               - fsl,imx23-gpmi-nand
112               - fsl,imx28-gpmi-nand
117             - description: SoC gpmi io clock
118         clock-names:
120             - const: gpmi_io
122   - if:
127               - fsl,imx6q-gpmi-nand
128               - fsl,imx6sx-gpmi-nand
133             - description: SoC gpmi io clock
134             - description: SoC gpmi apb clock
135             - description: SoC gpmi bch clock
136             - description: SoC gpmi bch apb clock
137             - description: SoC per1 bch clock
138         clock-names:
140             - const: gpmi_io
141             - const: gpmi_apb
142             - const: gpmi_bch
143             - const: gpmi_bch_apb
144             - const: per1_bch
146   - if:
150             const: fsl,imx7d-gpmi-nand
155             - description: SoC gpmi io clock
156             - description: SoC gpmi bch apb clock
157         clock-names:
159             - const: gpmi_io
160             - const: gpmi_bch_apb
162   - if:
167               - fsl,imx8qxp-gpmi-nand
172             - description: SoC gpmi io clock
173             - description: SoC gpmi apb clock
174             - description: SoC gpmi bch clock
175             - description: SoC gpmi bch apb clock
176         clock-names:
178             - const: gpmi_io
179             - const: gpmi_apb
180             - const: gpmi_bch
181             - const: gpmi_bch_apb
184   - |
185     nand-controller@8000c000 {
186         #address-cells = <1>;
187         #size-cells = <0>;
188         compatible = "fsl,imx28-gpmi-nand";
190         reg-names = "gpmi-nand", "bch";
192         interrupt-names = "bch";
194         clock-names = "gpmi_io";
196         dma-names = "rx-tx";