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           - const: fsl,imx7d-gpmi-nand
36       - description: Address and length of gpmi block.
37       - description: Address and length of bch block.
39   reg-names:
41       - const: gpmi-nand
42       - const: bch
47   interrupt-names:
53   dma-names:
54     const: rx-tx
60   clock-names:
64   fsl,use-minimum-ecc:
67       Protect this NAND flash with the minimum ECC strength required.
69       flash (e.g., according to the ONFI standard). However, note that
71       the software may chooses an implementation-defined ECC scheme.
73   fsl,no-blockmark-swap:
77       the data area but rely on the flash based BBT for identifying bad blocks.
78       NOTE: this is only valid in conjunction with 'nand-on-flash-bbt'.
79       WARNING: on i.MX28 blockmark swapping cannot be disabled for the BootROM
81       on may not be accessible by the BootROM code.
84   - compatible
85   - reg
86   - reg-names
87   - interrupts
88   - interrupt-names
89   - clocks
90   - clock-names
91   - dmas
92   - dma-names
97   - $ref: nand-controller.yaml
99   - if:
104               - fsl,imx23-gpmi-nand
105               - fsl,imx28-gpmi-nand
110             - description: SoC gpmi io clock
111         clock-names:
113             - const: gpmi_io
115   - if:
120               - fsl,imx6q-gpmi-nand
121               - fsl,imx6sx-gpmi-nand
126             - description: SoC gpmi io clock
127             - description: SoC gpmi apb clock
128             - description: SoC gpmi bch clock
129             - description: SoC gpmi bch apb clock
130             - description: SoC per1 bch clock
131         clock-names:
133             - const: gpmi_io
134             - const: gpmi_apb
135             - const: gpmi_bch
136             - const: gpmi_bch_apb
137             - const: per1_bch
139   - if:
143             const: fsl,imx7d-gpmi-nand
148             - description: SoC gpmi io clock
149             - description: SoC gpmi bch apb clock
150         clock-names:
152             - const: gpmi_io
153             - const: gpmi_bch_apb
155   - if:
160               - fsl,imx8qxp-gpmi-nand
165             - description: SoC gpmi io clock
166             - description: SoC gpmi apb clock
167             - description: SoC gpmi bch clock
168             - description: SoC gpmi bch apb clock
169         clock-names:
171             - const: gpmi_io
172             - const: gpmi_apb
173             - const: gpmi_bch
174             - const: gpmi_bch_apb
177   - |
178     nand-controller@8000c000 {
179         #address-cells = <1>;
180         #size-cells = <0>;
181         compatible = "fsl,imx28-gpmi-nand";
183         reg-names = "gpmi-nand", "bch";
185         interrupt-names = "bch";
187         clock-names = "gpmi_io";
189         dma-names = "rx-tx";