0001 Device tree bindings for Texas instruments Davinci/Keystone NAND controller
0002
0003 This file provides information, what the device node for the davinci/keystone
0004 NAND interface contains.
0005
0006 Documentation:
0007 Davinci DM646x - https://www.ti.com/lit/ug/sprueq7c/sprueq7c.pdf
0008 Kestone - https://www.ti.com/lit/ug/sprugz3a/sprugz3a.pdf
0009
0010 Required properties:
0011
0012 - compatible: "ti,davinci-nand"
0013 "ti,keystone-nand"
0014
0015 - reg: Contains 2 offset/length values:
0016 - offset and length for the access window.
0017 - offset and length for accessing the AEMIF
0018 control registers.
0019
0020 - ti,davinci-chipselect: number of chipselect. Indicates on the
0021 davinci_nand driver which chipselect is used
0022 for accessing the nand.
0023 Can be in the range [0-3].
0024
0025 Recommended properties :
0026
0027 - ti,davinci-mask-ale: mask for ALE. Needed for executing address
0028 phase. These offset will be added to the base
0029 address for the chip select space the NAND Flash
0030 device is connected to.
0031 If not set equal to 0x08.
0032
0033 - ti,davinci-mask-cle: mask for CLE. Needed for executing command
0034 phase. These offset will be added to the base
0035 address for the chip select space the NAND Flash
0036 device is connected to.
0037 If not set equal to 0x10.
0038
0039 - ti,davinci-mask-chipsel: mask for chipselect address. Needed to mask
0040 addresses for given chipselect.
0041
0042 - nand-ecc-mode: operation mode of the NAND ecc mode. ECC mode
0043 valid values for davinci driver:
0044 - "none"
0045 - "soft"
0046 - "hw"
0047
0048 - ti,davinci-ecc-bits: used ECC bits, currently supported 1 or 4.
0049
0050 - nand-bus-width: buswidth 8 or 16. If not present 8.
0051
0052 - nand-on-flash-bbt: use flash based bad block table support. OOB
0053 identifier is saved in OOB area. If not present
0054 false.
0055
0056 Deprecated properties:
0057
0058 - ti,davinci-ecc-mode: operation mode of the NAND ecc mode. ECC mode
0059 valid values for davinci driver:
0060 - "none"
0061 - "soft"
0062 - "hw"
0063
0064 - ti,davinci-nand-buswidth: buswidth 8 or 16. If not present 8.
0065
0066 - ti,davinci-nand-use-bbt: use flash based bad block table support. OOB
0067 identifier is saved in OOB area. If not present
0068 false.
0069
0070 Nand device bindings may contain additional sub-nodes describing partitions of
0071 the address space. See partition.txt for more detail. The NAND Flash timing
0072 values must be programmed in the chip select’s node of AEMIF
0073 memory-controller (see Documentation/devicetree/bindings/memory-controllers/
0074 davinci-aemif.txt).
0075
0076 Example(da850 EVM ):
0077
0078 nand_cs3@62000000 {
0079 compatible = "ti,davinci-nand";
0080 reg = <0x62000000 0x807ff
0081 0x68000000 0x8000>;
0082 ti,davinci-chipselect = <1>;
0083 ti,davinci-mask-ale = <0>;
0084 ti,davinci-mask-cle = <0>;
0085 ti,davinci-mask-chipsel = <0>;
0086 nand-ecc-mode = "hw";
0087 ti,davinci-ecc-bits = <4>;
0088 nand-on-flash-bbt;
0089
0090 partition@180000 {
0091 label = "ubifs";
0092 reg = <0x180000 0x7e80000>;
0093 };
0094 };