xref: /OK3568_Linux_fs/kernel/Documentation/devicetree/bindings/mtd/nand-macronix.txt (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593SmuzhiyunMacronix NANDs Device Tree Bindings
2*4882a593Smuzhiyun-----------------------------------
3*4882a593Smuzhiyun
4*4882a593SmuzhiyunMacronix NANDs support randomizer operation for scrambling user data,
5*4882a593Smuzhiyunwhich can be enabled with a SET_FEATURE. The penalty when using the
6*4882a593Smuzhiyunrandomizer are subpage accesses prohibited and more time period needed
7*4882a593Smuzhiyunfor program operation, i.e., tPROG 300us to 340us (randomizer enabled).
8*4882a593SmuzhiyunEnabling the randomizer is a one time persistent and non reversible
9*4882a593Smuzhiyunoperation.
10*4882a593Smuzhiyun
11*4882a593SmuzhiyunFor more high-reliability concern, if subpage write is not available
12*4882a593Smuzhiyunwith hardware ECC and not enabled at UBI level, then enabling the
13*4882a593Smuzhiyunrandomizer is recommended by default by adding a new specific property
14*4882a593Smuzhiyunin children nodes.
15*4882a593Smuzhiyun
16*4882a593SmuzhiyunRequired NAND chip properties in children mode:
17*4882a593Smuzhiyun- randomizer enable: should be "mxic,enable-randomizer-otp"
18*4882a593Smuzhiyun
19*4882a593SmuzhiyunExample:
20*4882a593Smuzhiyun
21*4882a593Smuzhiyun	nand: nand-controller@unit-address {
22*4882a593Smuzhiyun
23*4882a593Smuzhiyun		nand@0 {
24*4882a593Smuzhiyun			reg = <0>;
25*4882a593Smuzhiyun			mxic,enable-randomizer-otp;
26*4882a593Smuzhiyun		};
27*4882a593Smuzhiyun	};
28