xref: /freebsd/sys/contrib/device-tree/Bindings/memory-controllers/ddr/jedec,lpddr3.yaml (revision fac71e4e09885bb2afa3d984a0c239a52e1a7418) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/memory-controllers/ddr/jedec,lpddr3.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: LPDDR3 SDRAM compliant to JEDEC JESD209-3
8
9maintainers:
10  - Krzysztof Kozlowski <krzk@kernel.org>
11
12allOf:
13  - $ref: jedec,lpddr-props.yaml#
14
15properties:
16  compatible:
17    oneOf:
18      - items:
19          - enum:
20              - samsung,K3QF2F20DB
21          - const: jedec,lpddr3
22      - items:
23          - pattern: "^lpddr3-[0-9a-f]{2},[0-9a-f]{4}$"
24          - const: jedec,lpddr3
25
26  '#address-cells':
27    const: 1
28    deprecated: true
29
30  manufacturer-id:
31    $ref: /schemas/types.yaml#/definitions/uint32
32    description: |
33      Manufacturer ID value read from Mode Register 5.  The property is
34      deprecated, manufacturer should be derived from the compatible.
35    deprecated: true
36
37  '#size-cells':
38    const: 0
39    deprecated: true
40
41  tCKE-min-tck:
42    $ref: /schemas/types.yaml#/definitions/uint32
43    maximum: 15
44    description: |
45      CKE minimum pulse width (HIGH and LOW pulse width) in terms of number
46      of clock cycles.
47
48  tCKESR-min-tck:
49    $ref: /schemas/types.yaml#/definitions/uint32
50    maximum: 15
51    description: |
52      CKE minimum pulse width during SELF REFRESH (low pulse width during
53      SELF REFRESH) in terms of number of clock cycles.
54
55  tDQSCK-min-tck:
56    $ref: /schemas/types.yaml#/definitions/uint32
57    maximum: 15
58    description: |
59      DQS output data access time from CK_t/CK_c in terms of number of clock
60      cycles.
61
62  tFAW-min-tck:
63    $ref: /schemas/types.yaml#/definitions/uint32
64    maximum: 63
65    description: |
66      Four-bank activate window in terms of number of clock cycles.
67
68  tMRD-min-tck:
69    $ref: /schemas/types.yaml#/definitions/uint32
70    maximum: 15
71    description: |
72      Mode register set command delay in terms of number of clock cycles.
73
74  tR2R-C2C-min-tck:
75    $ref: /schemas/types.yaml#/definitions/uint32
76    enum: [0, 1]
77    description: |
78      Additional READ-to-READ delay in chip-to-chip cases in terms of number
79      of clock cycles.
80
81  tRAS-min-tck:
82    $ref: /schemas/types.yaml#/definitions/uint32
83    maximum: 63
84    description: |
85      Row active time in terms of number of clock cycles.
86
87  tRC-min-tck:
88    $ref: /schemas/types.yaml#/definitions/uint32
89    maximum: 63
90    description: |
91      ACTIVATE-to-ACTIVATE command period in terms of number of clock cycles.
92
93  tRCD-min-tck:
94    $ref: /schemas/types.yaml#/definitions/uint32
95    maximum: 15
96    description: |
97      RAS-to-CAS delay in terms of number of clock cycles.
98
99  tRFC-min-tck:
100    $ref: /schemas/types.yaml#/definitions/uint32
101    maximum: 255
102    description: |
103      Refresh Cycle time in terms of number of clock cycles.
104
105  tRL-min-tck:
106    $ref: /schemas/types.yaml#/definitions/uint32
107    maximum: 15
108    description: |
109     READ data latency in terms of number of clock cycles.
110
111  tRPab-min-tck:
112    $ref: /schemas/types.yaml#/definitions/uint32
113    maximum: 15
114    description: |
115      Row precharge time (all banks) in terms of number of clock cycles.
116
117  tRPpb-min-tck:
118    $ref: /schemas/types.yaml#/definitions/uint32
119    maximum: 15
120    description: |
121      Row precharge time (single banks) in terms of number of clock cycles.
122
123  tRRD-min-tck:
124    $ref: /schemas/types.yaml#/definitions/uint32
125    maximum: 15
126    description: |
127      Active bank A to active bank B in terms of number of clock cycles.
128
129  tRTP-min-tck:
130    $ref: /schemas/types.yaml#/definitions/uint32
131    maximum: 15
132    description: |
133      Internal READ to PRECHARGE command delay in terms of number of clock
134      cycles.
135
136  tW2W-C2C-min-tck:
137    $ref: /schemas/types.yaml#/definitions/uint32
138    enum: [0, 1]
139    description: |
140      Additional WRITE-to-WRITE delay in chip-to-chip cases in terms of number
141      of clock cycles.
142
143  tWL-min-tck:
144    $ref: /schemas/types.yaml#/definitions/uint32
145    maximum: 15
146    description: |
147      WRITE data latency in terms of number of clock cycles.
148
149  tWR-min-tck:
150    $ref: /schemas/types.yaml#/definitions/uint32
151    maximum: 15
152    description: |
153      WRITE recovery time in terms of number of clock cycles.
154
155  tWTR-min-tck:
156    $ref: /schemas/types.yaml#/definitions/uint32
157    maximum: 15
158    description: |
159      Internal WRITE-to-READ command delay in terms of number of clock cycles.
160
161  tXP-min-tck:
162    $ref: /schemas/types.yaml#/definitions/uint32
163    maximum: 255
164    description: |
165      Exit power-down to next valid command delay in terms of number of clock
166      cycles.
167
168  tXSR-min-tck:
169    $ref: /schemas/types.yaml#/definitions/uint32
170    maximum: 1023
171    description: |
172      SELF REFRESH exit to next valid command delay in terms of number of clock
173      cycles.
174
175patternProperties:
176  "^timings((-[0-9])+|(@[0-9a-f]+))?$":
177    $ref: jedec,lpddr3-timings.yaml
178    description: |
179      The lpddr3 node may have one or more child nodes with timings.
180      Each timing node provides AC timing parameters of the device for a given
181      speed-bin. The user may provide the timings for as many speed-bins as is
182      required.
183
184required:
185  - compatible
186  - density
187  - io-width
188
189unevaluatedProperties: false
190
191examples:
192  - |
193    lpddr3 {
194        compatible = "samsung,K3QF2F20DB", "jedec,lpddr3";
195        density = <16384>;
196        io-width = <32>;
197
198        tCKE-min-tck = <2>;
199        tCKESR-min-tck = <2>;
200        tDQSCK-min-tck = <5>;
201        tFAW-min-tck = <5>;
202        tMRD-min-tck = <5>;
203        tR2R-C2C-min-tck = <0>;
204        tRAS-min-tck = <5>;
205        tRC-min-tck = <6>;
206        tRCD-min-tck = <3>;
207        tRFC-min-tck = <17>;
208        tRL-min-tck = <14>;
209        tRPab-min-tck = <2>;
210        tRPpb-min-tck = <2>;
211        tRRD-min-tck = <2>;
212        tRTP-min-tck = <2>;
213        tW2W-C2C-min-tck = <0>;
214        tWL-min-tck = <8>;
215        tWR-min-tck = <7>;
216        tWTR-min-tck = <2>;
217        tXP-min-tck = <2>;
218        tXSR-min-tck = <12>;
219
220        timings {
221            compatible = "jedec,lpddr3-timings";
222            max-freq = <800000000>;
223            min-freq = <100000000>;
224            tCKE = <3750>;
225            tCKESR = <3750>;
226            tFAW = <25000>;
227            tMRD = <7000>;
228            tR2R-C2C = <0>;
229            tRAS = <23000>;
230            tRC = <33750>;
231            tRCD = <10000>;
232            tRFC = <65000>;
233            tRPab = <12000>;
234            tRPpb = <12000>;
235            tRRD = <6000>;
236            tRTP = <3750>;
237            tW2W-C2C = <0>;
238            tWR = <7500>;
239            tWTR = <3750>;
240            tXP = <3750>;
241            tXSR = <70000>;
242        };
243    };
244