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