1 Device tree bindings for Texas instruments Dav 1 Device tree bindings for Texas instruments Davinci/Keystone NAND controller
2 2
3 This file provides information, what the devic 3 This file provides information, what the device node for the davinci/keystone
4 NAND interface contains. 4 NAND interface contains.
5 5
6 Documentation: 6 Documentation:
7 Davinci DM646x - https://www.ti.com/lit/ug/spr 7 Davinci DM646x - https://www.ti.com/lit/ug/sprueq7c/sprueq7c.pdf
8 Kestone - https://www.ti.com/lit/ug/sprugz3a/s 8 Kestone - https://www.ti.com/lit/ug/sprugz3a/sprugz3a.pdf
9 9
10 Required properties: 10 Required properties:
11 11
12 - compatible: "ti,davinci-na 12 - compatible: "ti,davinci-nand"
13 "ti,keystone-n 13 "ti,keystone-nand"
14 14
15 - reg: Contains 2 off 15 - reg: Contains 2 offset/length values:
16 - offset and l 16 - offset and length for the access window.
17 - offset and l 17 - offset and length for accessing the AEMIF
18 control regist 18 control registers.
19 19
20 - ti,davinci-chipselect: number of chip 20 - ti,davinci-chipselect: number of chipselect. Indicates on the
21 davinci_nand d 21 davinci_nand driver which chipselect is used
22 for accessing 22 for accessing the nand.
23 Can be in the 23 Can be in the range [0-3].
24 24
25 Recommended properties : 25 Recommended properties :
26 26
27 - ti,davinci-mask-ale: mask for ALE. 27 - ti,davinci-mask-ale: mask for ALE. Needed for executing address
28 phase. These o 28 phase. These offset will be added to the base
29 address for th 29 address for the chip select space the NAND Flash
30 device is conn 30 device is connected to.
31 If not set equ 31 If not set equal to 0x08.
32 32
33 - ti,davinci-mask-cle: mask for CLE. 33 - ti,davinci-mask-cle: mask for CLE. Needed for executing command
34 phase. These o 34 phase. These offset will be added to the base
35 address for th 35 address for the chip select space the NAND Flash
36 device is conn 36 device is connected to.
37 If not set equ 37 If not set equal to 0x10.
38 38
39 - ti,davinci-mask-chipsel: mask for chips 39 - ti,davinci-mask-chipsel: mask for chipselect address. Needed to mask
40 addresses for 40 addresses for given chipselect.
41 41
42 - nand-ecc-mode: operation mode 42 - nand-ecc-mode: operation mode of the NAND ecc mode. ECC mode
43 valid values f 43 valid values for davinci driver:
44 - "none" 44 - "none"
45 - "soft" 45 - "soft"
46 - "hw" 46 - "hw"
47 47
48 - ti,davinci-ecc-bits: used ECC bits, 48 - ti,davinci-ecc-bits: used ECC bits, currently supported 1 or 4.
49 49
50 - nand-bus-width: buswidth 8 or 50 - nand-bus-width: buswidth 8 or 16. If not present 8.
51 51
52 - nand-on-flash-bbt: use flash base 52 - nand-on-flash-bbt: use flash based bad block table support. OOB
53 identifier is 53 identifier is saved in OOB area. If not present
54 false. 54 false.
55 55
56 Deprecated properties: 56 Deprecated properties:
57 57
58 - ti,davinci-ecc-mode: operation mode 58 - ti,davinci-ecc-mode: operation mode of the NAND ecc mode. ECC mode
59 valid values f 59 valid values for davinci driver:
60 - "none" 60 - "none"
61 - "soft" 61 - "soft"
62 - "hw" 62 - "hw"
63 63
64 - ti,davinci-nand-buswidth: buswidth 8 or 64 - ti,davinci-nand-buswidth: buswidth 8 or 16. If not present 8.
65 65
66 - ti,davinci-nand-use-bbt: use flash base 66 - ti,davinci-nand-use-bbt: use flash based bad block table support. OOB
67 identifier is 67 identifier is saved in OOB area. If not present
68 false. 68 false.
69 69
70 Nand device bindings may contain additional su 70 Nand device bindings may contain additional sub-nodes describing partitions of
71 the address space. See mtd.yaml for more detai 71 the address space. See mtd.yaml for more detail. The NAND Flash timing
72 values must be programmed in the chip select†72 values must be programmed in the chip select’s node of AEMIF
73 memory-controller (see Documentation/devicetre 73 memory-controller (see Documentation/devicetree/bindings/memory-controllers/
74 davinci-aemif.txt). 74 davinci-aemif.txt).
75 75
76 Example(da850 EVM ): 76 Example(da850 EVM ):
77 77
78 nand_cs3@62000000 { 78 nand_cs3@62000000 {
79 compatible = "ti,davinci-nand"; 79 compatible = "ti,davinci-nand";
80 reg = <0x62000000 0x807ff 80 reg = <0x62000000 0x807ff
81 0x68000000 0x8000>; 81 0x68000000 0x8000>;
82 ti,davinci-chipselect = <1>; 82 ti,davinci-chipselect = <1>;
83 ti,davinci-mask-ale = <0>; 83 ti,davinci-mask-ale = <0>;
84 ti,davinci-mask-cle = <0>; 84 ti,davinci-mask-cle = <0>;
85 ti,davinci-mask-chipsel = <0>; 85 ti,davinci-mask-chipsel = <0>;
86 nand-ecc-mode = "hw"; 86 nand-ecc-mode = "hw";
87 ti,davinci-ecc-bits = <4>; 87 ti,davinci-ecc-bits = <4>;
88 nand-on-flash-bbt; 88 nand-on-flash-bbt;
89 89
90 partition@180000 { 90 partition@180000 {
91 label = "ubifs"; 91 label = "ubifs";
92 reg = <0x180000 0x7e80000>; 92 reg = <0x180000 0x7e80000>;
93 }; 93 };
94 }; 94 };
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.