xref: /linux/Documentation/devicetree/bindings/arm/apple.yaml (revision 570f7e331f5febb30f1384817463c7e42b65ca7d)
1# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/arm/apple.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Apple ARM Machine
8
9maintainers:
10  - Hector Martin <marcan@marcan.st>
11
12description: |
13  ARM platforms using SoCs designed by Apple Inc., branded "Apple Silicon".
14
15  This currently includes devices based on the "A7" SoC:
16
17  - iPhone 5s
18  - iPad Air (1)
19  - iPad mini 2
20  - iPad mini 3
21
22  Devices based on the "A8" SoC:
23
24  - iPhone 6
25  - iPhone 6 Plus
26  - iPad mini 4
27  - iPod touch 6
28  - Apple TV HD
29
30  Device based on the "A8X" SoC:
31
32  - iPad Air 2
33
34  Devices based on the "A9" SoC:
35
36  - iPhone 6s
37  - iPhone 6s Plus
38  - iPhone SE (2016)
39  - iPad 5
40
41  Devices based on the "A9X" SoC:
42
43  - iPad Pro (9.7-inch)
44  - iPad Pro (12.9-inch)
45
46  Devices based on the "A10" SoC:
47
48  - iPhone 7
49  - iPhone 7 Plus
50  - iPod touch 7
51  - iPad 6
52  - iPad 7
53
54  Devices based on the "A10X" SoC:
55
56  - Apple TV 4K (1st generation)
57  - iPad Pro (2nd Generation) (10.5 Inch)
58  - iPad Pro (2nd Generation) (12.9 Inch)
59
60  Devices based on the "T2" SoC:
61
62  - Apple T2 MacBookPro15,2 (j132)
63  - Apple T2 iMacPro1,1 (j137)
64  - Apple T2 MacBookAir8,2 (j140a)
65  - Apple T2 MacBookAir8,1 (j140k)
66  - Apple T2 MacBookPro16,1 (j152f)
67  - Apple T2 MacPro7,1 (j160)
68  - Apple T2 Macmini8,1 (j174)
69  - Apple T2 iMac20,1 (j185)
70  - Apple T2 iMac20,2 (j185f)
71  - Apple T2 MacBookPro15,4 (j213)
72  - Apple T2 MacBookPro16,2 (j214k)
73  - Apple T2 MacBookPro16,4 (j215)
74  - Apple T2 MacBookPro16,3 (j223)
75  - Apple T2 MacBookAir9,1 (j230k)
76  - Apple T2 MacBookPro15,1 (j680)
77  - Apple T2 MacBookPro15,3 (j780)
78
79  Devices based on the "A11" SoC:
80
81  - iPhone 8
82  - iPhone 8 Plus
83  - iPhone X
84
85  Devices based on the "M1" SoC:
86
87  - Mac mini (M1, 2020)
88  - MacBook Pro (13-inch, M1, 2020)
89  - MacBook Air (M1, 2020)
90  - iMac (24-inch, M1, 2021)
91
92  Devices based on the "M2" SoC:
93
94  - MacBook Air (M2, 2022)
95  - MacBook Air (15-inch, M2, 2023)
96  - MacBook Pro (13-inch, M2, 2022)
97  - Mac mini (M2, 2023)
98
99  Devices based on the "M3" SoC:
100
101  - MacBook Air (13-inch, M3, 2024)
102  - MacBook Air (15-inch, M3, 2024)
103  - MacBook Pro (14-inch, M3, 2023)
104  - iMac (24-inch, M3, 2023)
105
106  Devices based on the "M1 Pro", "M1 Max" and "M1 Ultra" SoCs:
107
108  - MacBook Pro (14-inch, M1 Pro, 2021)
109  - MacBook Pro (14-inch, M1 Max, 2021)
110  - MacBook Pro (16-inch, M1 Pro, 2021)
111  - MacBook Pro (16-inch, M1 Max, 2021)
112  - Mac Studio (M1 Max, 2022)
113  - Mac Studio (M1 Ultra, 2022)
114
115  Devices based on the "M2 Pro", "M2 Max" and "M2 Ultra" SoCs:
116
117  - MacBook Pro (14-inch, M2 Pro, 2023)
118  - MacBook Pro (14-inch, M2 Max, 2023)
119  - MacBook Pro (16-inch, M2 Pro, 2023)
120  - MacBook Pro (16-inch, M2 Max, 2023)
121  - Mac mini (M2 Pro, 2023)
122  - Mac Studio (M2 Max, 2023)
123  - Mac Studio (M2 Ultra, 2023)
124  - Mac Pro (M2 Ultra, 2023)
125
126  Devices based on the "M3 Pro", "M3 Max" and "M3 Ultra" SoCs:
127
128  - MacBook Pro (14-inch, M3 Pro, 2023)
129  - MacBook Pro (14-inch, M3 Max, 2023)
130  - MacBook Pro (16-inch, M3 Pro, 2023)
131  - MacBook Pro (16-inch, M3 Max, 2023)
132  - Mac Studio (M3 Ultra, 2025)
133
134  The compatible property should follow this format:
135
136  compatible = "apple,<targettype>", "apple,<socid>", "apple,arm-platform";
137
138  <targettype> represents the board/device and comes from the `target-type`
139  property of the root node of the Apple Device Tree, lowercased. It can be
140  queried on macOS using the following command:
141
142  $ ioreg -d2 -l | grep target-type
143
144  <socid> is the lowercased SoC ID. Apple uses at least *five* different
145  names for their SoCs:
146
147  - Marketing name ("M1")
148  - Internal name ("H13G")
149  - Codename ("Tonga")
150  - SoC ID ("T8103")
151  - Package/IC part number ("APL1102")
152
153  Devicetrees should use the lowercased SoC ID, to avoid confusion if
154  multiple SoCs share the same marketing name. This can be obtained from
155  the `compatible` property of the arm-io node of the Apple Device Tree,
156  which can be queried as follows on macOS:
157
158  $ ioreg -n arm-io | grep compatible
159
160properties:
161  $nodename:
162    const: "/"
163  compatible:
164    oneOf:
165      - description: Apple A7 SoC based platforms
166        items:
167          - enum:
168              - apple,j71  # iPad Air (Wi-Fi)
169              - apple,j72  # iPad Air (Cellular)
170              - apple,j73  # iPad Air (Cellular, China)
171              - apple,j85  # iPad mini 2 (Wi-Fi)
172              - apple,j85m # iPad mini 3 (Wi-Fi)
173              - apple,j86  # iPad mini 2 (Cellular)
174              - apple,j86m # iPad mini 3 (Cellular)
175              - apple,j87  # iPad mini 2 (Cellular, China)
176              - apple,j87m # iPad mini 3 (Cellular, China)
177              - apple,n51  # iPhone 5s (GSM)
178              - apple,n53  # iPhone 5s (LTE)
179          - const: apple,s5l8960x
180          - const: apple,arm-platform
181
182      - description: Apple A8 SoC based platforms
183        items:
184          - enum:
185              - apple,j42d # Apple TV HD
186              - apple,j96  # iPad mini 4 (Wi-Fi)
187              - apple,j97  # iPad mini 4 (Cellular)
188              - apple,n56  # iPhone 6 Plus
189              - apple,n61  # iPhone 6
190              - apple,n102 # iPod touch 6
191          - const: apple,t7000
192          - const: apple,arm-platform
193
194      - description: Apple A8X SoC based platforms
195        items:
196          - enum:
197              - apple,j81 # iPad Air 2 (Wi-Fi)
198              - apple,j82 # iPad Air 2 (Cellular)
199          - const: apple,t7001
200          - const: apple,arm-platform
201
202      - description: Apple Samsung A9 SoC based platforms
203        items:
204          - enum:
205              - apple,j71s # iPad 5 (Wi-Fi) (S8000)
206              - apple,j72s # iPad 5 (Cellular) (S8000)
207              - apple,n66  # iPhone 6s Plus (S8000)
208              - apple,n69u # iPhone SE (S8000)
209              - apple,n71  # iPhone 6S (S8000)
210          - const: apple,s8000
211          - const: apple,arm-platform
212
213      - description: Apple TSMC A9 SoC based platforms
214        items:
215          - enum:
216              - apple,j71t # iPad 5 (Wi-Fi) (S8003)
217              - apple,j72t # iPad 5 (Cellular) (S8003)
218              - apple,n66m # iPhone 6s Plus (S8003)
219              - apple,n69  # iPhone SE (S8003)
220              - apple,n71m # iPhone 6S (S8003)
221          - const: apple,s8003
222          - const: apple,arm-platform
223
224      - description: Apple A9X SoC based platforms
225        items:
226          - enum:
227              - apple,j127 # iPad Pro (9.7-inch) (Wi-Fi)
228              - apple,j128 # iPad Pro (9.7-inch) (Cellular)
229              - apple,j98a # iPad Pro (12.9-inch) (Wi-Fi)
230              - apple,j99a # iPad Pro (12.9-inch) (Cellular)
231          - const: apple,s8001
232          - const: apple,arm-platform
233
234      - description: Apple A10 SoC based platforms
235        items:
236          - enum:
237              - apple,d10  # iPhone 7 (Qualcomm)
238              - apple,d11  # iPhone 7 (Intel)
239              - apple,d101 # iPhone 7 Plus (Qualcomm)
240              - apple,d111 # iPhone 7 Plus (Intel)
241              - apple,j71b # iPad 6 (Wi-Fi)
242              - apple,j72b # iPad 6 (Cellular)
243              - apple,j171 # iPad 7 (Wi-Fi)
244              - apple,j172 # iPad 7 (Cellular)
245              - apple,n112 # iPod touch 7
246          - const: apple,t8010
247          - const: apple,arm-platform
248
249      - description: Apple A10X SoC based platforms
250        items:
251          - enum:
252              - apple,j105a # Apple TV 4K (1st Generation)
253              - apple,j120  # iPad Pro 2 (12.9-inch) (Wi-Fi)
254              - apple,j121  # iPad Pro 2 (12.9-inch) (Cellular)
255              - apple,j207  # iPad Pro 2 (10.5-inch) (Wi-Fi)
256              - apple,j208  # iPad Pro 2 (10.5-inch) (Cellular)
257          - const: apple,t8011
258          - const: apple,arm-platform
259
260      - description: Apple T2 SoC based platforms
261        items:
262          - enum:
263              - apple,j132  # Apple T2 MacBookPro15,2 (j132)
264              - apple,j137  # Apple T2 iMacPro1,1 (j137)
265              - apple,j140a # Apple T2 MacBookAir8,2 (j140a)
266              - apple,j140k # Apple T2 MacBookAir8,1 (j140k)
267              - apple,j152f # Apple T2 MacBookPro16,1 (j152f)
268              - apple,j160  # Apple T2 MacPro7,1 (j160)
269              - apple,j174  # Apple T2 Macmini8,1 (j174)
270              - apple,j185  # Apple T2 iMac20,1 (j185)
271              - apple,j185f # Apple T2 iMac20,2 (j185f)
272              - apple,j213  # Apple T2 MacBookPro15,4 (j213)
273              - apple,j214k # Apple T2 MacBookPro16,2 (j214k)
274              - apple,j215  # Apple T2 MacBookPro16,4 (j215)
275              - apple,j223  # Apple T2 MacBookPro16,3 (j223)
276              - apple,j230k # Apple T2 MacBookAir9,1 (j230k)
277              - apple,j680  # Apple T2 MacBookPro15,1 (j680)
278              - apple,j780  # Apple T2 MacBookPro15,3 (j780)
279          - const: apple,t8012
280          - const: apple,arm-platform
281
282      - description: Apple A11 SoC based platforms
283        items:
284          - enum:
285              - apple,d20  # iPhone 8 (Global)
286              - apple,d21  # iPhone 8 Plus (Global)
287              - apple,d22  # iPhone X (Global)
288              - apple,d201 # iPhone 8 (GSM)
289              - apple,d211 # iPhone 8 Plus (GSM)
290              - apple,d221 # iPhone X (GSM)
291          - const: apple,t8015
292          - const: apple,arm-platform
293
294      - description: Apple M1 SoC based platforms
295        items:
296          - enum:
297              - apple,j274 # Mac mini (M1, 2020)
298              - apple,j293 # MacBook Pro (13-inch, M1, 2020)
299              - apple,j313 # MacBook Air (M1, 2020)
300              - apple,j456 # iMac (24-inch, 4x USB-C, M1, 2021)
301              - apple,j457 # iMac (24-inch, 2x USB-C, M1, 2021)
302          - const: apple,t8103
303          - const: apple,arm-platform
304
305      - description: Apple M2 SoC based platforms
306        items:
307          - enum:
308              - apple,j413 # MacBook Air (M2, 2022)
309              - apple,j415 # MacBook Air (15-inch, M2, 2023)
310              - apple,j473 # Mac mini (M2, 2023)
311              - apple,j493 # MacBook Pro (13-inch, M2, 2022)
312          - const: apple,t8112
313          - const: apple,arm-platform
314
315      - description: Apple M3 SoC based platforms
316        items:
317          - enum:
318              - apple,j433 # iMac (24-inch, 2x USB-C, M3, 2023)
319              - apple,j434 # iMac (24-inch, 4x USB-C, M3, 2023)
320              - apple,j504 # MacBook Pro (14-inch, M3, 2023)
321              - apple,j613 # MacBook Air (13-inch, M3, 2024)
322              - apple,j615 # MacBook Air (15-inch, M3, 2024)
323          - const: apple,t8122
324          - const: apple,arm-platform
325
326      - description: Apple M1 Pro SoC based platforms
327        items:
328          - enum:
329              - apple,j314s # MacBook Pro (14-inch, M1 Pro, 2021)
330              - apple,j316s # MacBook Pro (16-inch, M1 Pro, 2021)
331          - const: apple,t6000
332          - const: apple,arm-platform
333
334      - description: Apple M1 Max SoC based platforms
335        items:
336          - enum:
337              - apple,j314c # MacBook Pro (14-inch, M1 Max, 2021)
338              - apple,j316c # MacBook Pro (16-inch, M1 Max, 2021)
339              - apple,j375c # Mac Studio (M1 Max, 2022)
340          - const: apple,t6001
341          - const: apple,arm-platform
342
343      - description: Apple M1 Ultra SoC based platforms
344        items:
345          - enum:
346              - apple,j375d # Mac Studio (M1 Ultra, 2022)
347          - const: apple,t6002
348          - const: apple,arm-platform
349
350      - description: Apple M2 Pro SoC based platforms
351        items:
352          - enum:
353              - apple,j414s # MacBook Pro (14-inch, M2 Pro, 2023)
354              - apple,j416s # MacBook Pro (16-inch, M2 Pro, 2023)
355              - apple,j474s # Mac mini (M2 Pro, 2023)
356          - const: apple,t6020
357          - const: apple,arm-platform
358
359      - description: Apple M2 Max SoC based platforms
360        items:
361          - enum:
362              - apple,j414c # MacBook Pro (14-inch, M2 Max, 2023)
363              - apple,j416c # MacBook Pro (16-inch, M2 Max, 2023)
364              - apple,j475c # Mac Studio (M2 Max, 2023)
365          - const: apple,t6021
366          - const: apple,arm-platform
367
368      - description: Apple M2 Ultra SoC based platforms
369        items:
370          - enum:
371              - apple,j180d # Mac Pro (M2 Ultra, 2023)
372              - apple,j475d # Mac Studio (M2 Ultra, 2023)
373          - const: apple,t6022
374          - const: apple,arm-platform
375
376      - description: Apple M3 Pro SoC based platforms
377        items:
378          - enum:
379              - apple,j514s  # MacBook Pro (14-inch, M3 Pro, 2023)
380              - apple,j516s  # MacBook Pro (16-inch, M3 Pro, 2023)
381          - const: apple,t6030
382          - const: apple,arm-platform
383
384      - description: Apple M3 Max SoC based platforms
385        oneOf:
386          - items:
387              - enum:
388                  - apple,j514c  # MacBook Pro (14-inch, M3 Max, 16 cores, 2023)
389                  - apple,j516c  # MacBook Pro (16-inch, M3 Max, 16 cores, 2023)
390              - const: apple,t6031
391              - const: apple,arm-platform
392          - items:
393              - enum:
394                  - apple,j514m  # MacBook Pro (14-inch, M3 Max, 14 cores, 2023)
395                  - apple,j516m  # MacBook Pro (16-inch, M3 Max, 14 cores, 2023)
396              - const: apple,t6034
397              - const: apple,arm-platform
398
399      - description: Apple M3 Ultra SoC based platforms
400        items:
401          - const: apple,j575d  # Mac Studio (M3 Ultra, 2025)
402          - const: apple,t6032
403          - const: apple,arm-platform
404
405additionalProperties: true
406
407...
408