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