Linux-libre 3.16.78-gnu
[librecmc/linux-libre.git] / Documentation / devicetree / bindings / mtd / gpmi-nand.txt
1 * Freescale General-Purpose Media Interface (GPMI)
2
3 The GPMI nand controller provides an interface to control the
4 NAND flash chips. We support only one NAND chip now.
5
6 Required properties:
7   - compatible : should be "fsl,<chip>-gpmi-nand"
8   - reg : should contain registers location and length for gpmi and bch.
9   - reg-names: Should contain the reg names "gpmi-nand" and "bch"
10   - interrupts : BCH interrupt number.
11   - interrupt-names : Should be "bch".
12   - dmas: DMA specifier, consisting of a phandle to DMA controller node
13     and GPMI DMA channel ID.
14     Refer to dma.txt and fsl-mxs-dma.txt for details.
15   - dma-names: Must be "rx-tx".
16
17 Optional properties:
18   - nand-on-flash-bbt: boolean to enable on flash bbt option if not
19                        present false
20   - fsl,use-minimum-ecc: Protect this NAND flash with the minimum ECC
21                        strength required. The required ECC strength is
22                        automatically discoverable for some flash
23                        (e.g., according to the ONFI standard).
24                        However, note that if this strength is not
25                        discoverable or this property is not enabled,
26                        the software may chooses an implementation-defined
27                        ECC scheme.
28
29 The device tree may optionally contain sub-nodes describing partitions of the
30 address space. See partition.txt for more detail.
31
32 Examples:
33
34 gpmi-nand@8000c000 {
35         compatible = "fsl,imx28-gpmi-nand";
36         #address-cells = <1>;
37         #size-cells = <1>;
38         reg = <0x8000c000 2000>, <0x8000a000 2000>;
39         reg-names = "gpmi-nand", "bch";
40         interrupts = <41>;
41         interrupt-names = "bch";
42         dmas = <&dma_apbh 4>;
43         dma-names = "rx-tx";
44
45         partition@0 {
46         ...
47         };
48 };