Path: blob/main/sys/contrib/device-tree/Bindings/arm/apple.yaml
48375 views
# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause1%YAML 1.22---3$id: http://devicetree.org/schemas/arm/apple.yaml#4$schema: http://devicetree.org/meta-schemas/core.yaml#56title: Apple ARM Machine78maintainers:9- Hector Martin <marcan@marcan.st>1011description: |12ARM platforms using SoCs designed by Apple Inc., branded "Apple Silicon".1314This currently includes devices based on the "M1" SoC:1516- Mac mini (M1, 2020)17- MacBook Pro (13-inch, M1, 2020)18- MacBook Air (M1, 2020)19- iMac (24-inch, M1, 2021)2021Devices based on the "M2" SoC:2223- MacBook Air (M2, 2022)24- MacBook Pro (13-inch, M2, 2022)25- Mac mini (M2, 2023)2627And devices based on the "M1 Pro", "M1 Max" and "M1 Ultra" SoCs:2829- MacBook Pro (14-inch, M1 Pro, 2021)30- MacBook Pro (14-inch, M1 Max, 2021)31- MacBook Pro (16-inch, M1 Pro, 2021)32- MacBook Pro (16-inch, M1 Max, 2021)33- Mac Studio (M1 Max, 2022)34- Mac Studio (M1 Ultra, 2022)3536The compatible property should follow this format:3738compatible = "apple,<targettype>", "apple,<socid>", "apple,arm-platform";3940<targettype> represents the board/device and comes from the `target-type`41property of the root node of the Apple Device Tree, lowercased. It can be42queried on macOS using the following command:4344$ ioreg -d2 -l | grep target-type4546<socid> is the lowercased SoC ID. Apple uses at least *five* different47names for their SoCs:4849- Marketing name ("M1")50- Internal name ("H13G")51- Codename ("Tonga")52- SoC ID ("T8103")53- Package/IC part number ("APL1102")5455Devicetrees should use the lowercased SoC ID, to avoid confusion if56multiple SoCs share the same marketing name. This can be obtained from57the `compatible` property of the arm-io node of the Apple Device Tree,58which can be queried as follows on macOS:5960$ ioreg -n arm-io | grep compatible6162properties:63$nodename:64const: "/"65compatible:66oneOf:67- description: Apple M1 SoC based platforms68items:69- enum:70- apple,j274 # Mac mini (M1, 2020)71- apple,j293 # MacBook Pro (13-inch, M1, 2020)72- apple,j313 # MacBook Air (M1, 2020)73- apple,j456 # iMac (24-inch, 4x USB-C, M1, 2021)74- apple,j457 # iMac (24-inch, 2x USB-C, M1, 2021)75- const: apple,t810376- const: apple,arm-platform7778- description: Apple M2 SoC based platforms79items:80- enum:81- apple,j413 # MacBook Air (M2, 2022)82- apple,j473 # Mac mini (M2, 2023)83- apple,j493 # MacBook Pro (13-inch, M2, 2022)84- const: apple,t811285- const: apple,arm-platform8687- description: Apple M1 Pro SoC based platforms88items:89- enum:90- apple,j314s # MacBook Pro (14-inch, M1 Pro, 2021)91- apple,j316s # MacBook Pro (16-inch, M1 Pro, 2021)92- const: apple,t600093- const: apple,arm-platform9495- description: Apple M1 Max SoC based platforms96items:97- enum:98- apple,j314c # MacBook Pro (14-inch, M1 Max, 2021)99- apple,j316c # MacBook Pro (16-inch, M1 Max, 2021)100- apple,j375c # Mac Studio (M1 Max, 2022)101- const: apple,t6001102- const: apple,arm-platform103104- description: Apple M1 Ultra SoC based platforms105items:106- enum:107- apple,j375d # Mac Studio (M1 Ultra, 2022)108- const: apple,t6002109- const: apple,arm-platform110111additionalProperties: true112113...114115116