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