1 # SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
4 $id: http://devicetree.org/schemas/arm/apple.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
7 title: Apple ARM Machine Device Tree Bindings
10 - Hector Martin <marcan@marcan.st>
13 ARM platforms using SoCs designed by Apple Inc., branded "Apple Silicon".
15 This currently includes devices based on the "M1" SoC, starting with the
16 three Mac models released in late 2020:
19 - MacBook Pro (13-inch, M1, 2020)
20 - MacBook Air (M1, 2020)
22 The compatible property should follow this format:
24 compatible = "apple,<targettype>", "apple,<socid>", "apple,arm-platform";
26 <targettype> represents the board/device and comes from the `target-type`
27 property of the root node of the Apple Device Tree, lowercased. It can be
28 queried on macOS using the following command:
30 $ ioreg -d2 -l | grep target-type
32 <socid> is the lowercased SoC ID. Apple uses at least *five* different
35 - Marketing name ("M1")
36 - Internal name ("H13G")
39 - Package/IC part number ("APL1102")
41 Devicetrees should use the lowercased SoC ID, to avoid confusion if
42 multiple SoCs share the same marketing name. This can be obtained from
43 the `compatible` property of the arm-io node of the Apple Device Tree,
44 which can be queried as follows on macOS:
46 $ ioreg -n arm-io | grep compatible
53 - description: Apple M1 SoC based platforms
56 - apple,j274 # Mac mini (M1, 2020)
57 - apple,j293 # MacBook Pro (13-inch, M1, 2020)
58 - apple,j313 # MacBook Air (M1, 2020)
60 - const: apple,arm-platform
62 additionalProperties: true