xref: /freebsd-src/sys/contrib/device-tree/Bindings/ddr/lpddr3.txt (revision 2eb4d8dc723da3cf7d735a3226ae49da4c8c5dbc)
1c66ec88fSEmmanuel Vadot* LPDDR3 SDRAM memories compliant to JEDEC JESD209-3C
2c66ec88fSEmmanuel Vadot
3c66ec88fSEmmanuel VadotRequired properties:
4c66ec88fSEmmanuel Vadot- compatible : Should be "<vendor>,<type>", and generic value "jedec,lpddr3".
5c66ec88fSEmmanuel Vadot  Example "<vendor>,<type>" values:
6c66ec88fSEmmanuel Vadot    "samsung,K3QF2F20DB"
7c66ec88fSEmmanuel Vadot
8c66ec88fSEmmanuel Vadot- density  : <u32> representing density in Mb (Mega bits)
9c66ec88fSEmmanuel Vadot- io-width : <u32> representing bus width. Possible values are 8, 16, 32, 64
10c66ec88fSEmmanuel Vadot- #address-cells: Must be set to 1
11c66ec88fSEmmanuel Vadot- #size-cells: Must be set to 0
12c66ec88fSEmmanuel Vadot
13c66ec88fSEmmanuel VadotOptional properties:
14c66ec88fSEmmanuel Vadot
15*2eb4d8dcSEmmanuel Vadot- manufacturer-id : <u32>     Manufacturer ID value read from Mode Register 5
16*2eb4d8dcSEmmanuel Vadot- revision-id     : <u32 u32> Revision IDs read from Mode Registers 6 and 7
17*2eb4d8dcSEmmanuel Vadot
18c66ec88fSEmmanuel VadotThe following optional properties represent the minimum value of some AC
19c66ec88fSEmmanuel Vadottiming parameters of the DDR device in terms of number of clock cycles.
20c66ec88fSEmmanuel VadotThese values shall be obtained from the device data-sheet.
21c66ec88fSEmmanuel Vadot- tRFC-min-tck
22c66ec88fSEmmanuel Vadot- tRRD-min-tck
23c66ec88fSEmmanuel Vadot- tRPab-min-tck
24c66ec88fSEmmanuel Vadot- tRPpb-min-tck
25c66ec88fSEmmanuel Vadot- tRCD-min-tck
26c66ec88fSEmmanuel Vadot- tRC-min-tck
27c66ec88fSEmmanuel Vadot- tRAS-min-tck
28c66ec88fSEmmanuel Vadot- tWTR-min-tck
29c66ec88fSEmmanuel Vadot- tWR-min-tck
30c66ec88fSEmmanuel Vadot- tRTP-min-tck
31c66ec88fSEmmanuel Vadot- tW2W-C2C-min-tck
32c66ec88fSEmmanuel Vadot- tR2R-C2C-min-tck
33c66ec88fSEmmanuel Vadot- tWL-min-tck
34c66ec88fSEmmanuel Vadot- tDQSCK-min-tck
35c66ec88fSEmmanuel Vadot- tRL-min-tck
36c66ec88fSEmmanuel Vadot- tFAW-min-tck
37c66ec88fSEmmanuel Vadot- tXSR-min-tck
38c66ec88fSEmmanuel Vadot- tXP-min-tck
39c66ec88fSEmmanuel Vadot- tCKE-min-tck
40c66ec88fSEmmanuel Vadot- tCKESR-min-tck
41c66ec88fSEmmanuel Vadot- tMRD-min-tck
42c66ec88fSEmmanuel Vadot
43c66ec88fSEmmanuel VadotChild nodes:
44c66ec88fSEmmanuel Vadot- The lpddr3 node may have one or more child nodes of type "lpddr3-timings".
45c66ec88fSEmmanuel Vadot  "lpddr3-timings" provides AC timing parameters of the device for
46c66ec88fSEmmanuel Vadot  a given speed-bin. Please see Documentation/devicetree/
47c66ec88fSEmmanuel Vadot  bindings/ddr/lpddr3-timings.txt for more information on "lpddr3-timings"
48c66ec88fSEmmanuel Vadot
49c66ec88fSEmmanuel VadotExample:
50c66ec88fSEmmanuel Vadot
51c66ec88fSEmmanuel Vadotsamsung_K3QF2F20DB: lpddr3 {
52c66ec88fSEmmanuel Vadot	compatible	= "samsung,K3QF2F20DB", "jedec,lpddr3";
53c66ec88fSEmmanuel Vadot	density		= <16384>;
54c66ec88fSEmmanuel Vadot	io-width	= <32>;
55*2eb4d8dcSEmmanuel Vadot	manufacturer-id = <1>;
56*2eb4d8dcSEmmanuel Vadot	revision-id     = <123 234>;
57c66ec88fSEmmanuel Vadot	#address-cells	= <1>;
58c66ec88fSEmmanuel Vadot	#size-cells	= <0>;
59c66ec88fSEmmanuel Vadot
60c66ec88fSEmmanuel Vadot	tRFC-min-tck		= <17>;
61c66ec88fSEmmanuel Vadot	tRRD-min-tck		= <2>;
62c66ec88fSEmmanuel Vadot	tRPab-min-tck		= <2>;
63c66ec88fSEmmanuel Vadot	tRPpb-min-tck		= <2>;
64c66ec88fSEmmanuel Vadot	tRCD-min-tck		= <3>;
65c66ec88fSEmmanuel Vadot	tRC-min-tck		= <6>;
66c66ec88fSEmmanuel Vadot	tRAS-min-tck		= <5>;
67c66ec88fSEmmanuel Vadot	tWTR-min-tck		= <2>;
68c66ec88fSEmmanuel Vadot	tWR-min-tck		= <7>;
69c66ec88fSEmmanuel Vadot	tRTP-min-tck		= <2>;
70c66ec88fSEmmanuel Vadot	tW2W-C2C-min-tck	= <0>;
71c66ec88fSEmmanuel Vadot	tR2R-C2C-min-tck	= <0>;
72c66ec88fSEmmanuel Vadot	tWL-min-tck		= <8>;
73c66ec88fSEmmanuel Vadot	tDQSCK-min-tck		= <5>;
74c66ec88fSEmmanuel Vadot	tRL-min-tck		= <14>;
75c66ec88fSEmmanuel Vadot	tFAW-min-tck		= <5>;
76c66ec88fSEmmanuel Vadot	tXSR-min-tck		= <12>;
77c66ec88fSEmmanuel Vadot	tXP-min-tck		= <2>;
78c66ec88fSEmmanuel Vadot	tCKE-min-tck		= <2>;
79c66ec88fSEmmanuel Vadot	tCKESR-min-tck		= <2>;
80c66ec88fSEmmanuel Vadot	tMRD-min-tck		= <5>;
81c66ec88fSEmmanuel Vadot
82c66ec88fSEmmanuel Vadot	timings_samsung_K3QF2F20DB_800mhz: lpddr3-timings@800000000 {
83c66ec88fSEmmanuel Vadot		compatible	= "jedec,lpddr3-timings";
84c66ec88fSEmmanuel Vadot		/* workaround: 'reg' shows max-freq */
85c66ec88fSEmmanuel Vadot		reg		= <800000000>;
86c66ec88fSEmmanuel Vadot		min-freq	= <100000000>;
87c66ec88fSEmmanuel Vadot		tRFC		= <65000>;
88c66ec88fSEmmanuel Vadot		tRRD		= <6000>;
89c66ec88fSEmmanuel Vadot		tRPab		= <12000>;
90c66ec88fSEmmanuel Vadot		tRPpb		= <12000>;
91c66ec88fSEmmanuel Vadot		tRCD		= <10000>;
92c66ec88fSEmmanuel Vadot		tRC		= <33750>;
93c66ec88fSEmmanuel Vadot		tRAS		= <23000>;
94c66ec88fSEmmanuel Vadot		tWTR		= <3750>;
95c66ec88fSEmmanuel Vadot		tWR		= <7500>;
96c66ec88fSEmmanuel Vadot		tRTP		= <3750>;
97c66ec88fSEmmanuel Vadot		tW2W-C2C	= <0>;
98c66ec88fSEmmanuel Vadot		tR2R-C2C	= <0>;
99c66ec88fSEmmanuel Vadot		tFAW		= <25000>;
100c66ec88fSEmmanuel Vadot		tXSR		= <70000>;
101c66ec88fSEmmanuel Vadot		tXP		= <3750>;
102c66ec88fSEmmanuel Vadot		tCKE		= <3750>;
103c66ec88fSEmmanuel Vadot		tCKESR		= <3750>;
104c66ec88fSEmmanuel Vadot		tMRD		= <7000>;
105c66ec88fSEmmanuel Vadot	};
106c66ec88fSEmmanuel Vadot}
107