Back to home page

OSCL-LXR

 
 

    


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 };