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