Path: blob/master/Documentation/devicetree/bindings/arm/apple.yaml
26308 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 "A7" SoC:1516- iPhone 5s17- iPad Air (1)18- iPad mini 219- iPad mini 32021Devices based on the "A8" SoC:2223- iPhone 624- iPhone 6 Plus25- iPad mini 426- iPod touch 627- Apple TV HD2829Device based on the "A8X" SoC:3031- iPad Air 23233Devices based on the "A9" SoC:3435- iPhone 6s36- iPhone 6s Plus37- iPhone SE (2016)38- iPad 53940Devices based on the "A9X" SoC:4142- iPad Pro (9.7-inch)43- iPad Pro (12.9-inch)4445Devices based on the "A10" SoC:4647- iPhone 748- iPhone 7 Plus49- iPod touch 750- iPad 651- iPad 75253Devices based on the "A10X" SoC:5455- Apple TV 4K (1st generation)56- iPad Pro (2nd Generation) (10.5 Inch)57- iPad Pro (2nd Generation) (12.9 Inch)5859Devices based on the "T2" SoC:6061- Apple T2 MacBookPro15,2 (j132)62- Apple T2 iMacPro1,1 (j137)63- Apple T2 MacBookAir8,2 (j140a)64- Apple T2 MacBookAir8,1 (j140k)65- Apple T2 MacBookPro16,1 (j152f)66- Apple T2 MacPro7,1 (j160)67- Apple T2 Macmini8,1 (j174)68- Apple T2 iMac20,1 (j185)69- Apple T2 iMac20,2 (j185f)70- Apple T2 MacBookPro15,4 (j213)71- Apple T2 MacBookPro16,2 (j214k)72- Apple T2 MacBookPro16,4 (j215)73- Apple T2 MacBookPro16,3 (j223)74- Apple T2 MacBookAir9,1 (j230k)75- Apple T2 MacBookPro15,1 (j680)76- Apple T2 MacBookPro15,3 (j780)7778Devices based on the "A11" SoC:7980- iPhone 881- iPhone 8 Plus82- iPhone X8384Devices based on the "M1" SoC:8586- Mac mini (M1, 2020)87- MacBook Pro (13-inch, M1, 2020)88- MacBook Air (M1, 2020)89- iMac (24-inch, M1, 2021)9091Devices based on the "M2" SoC:9293- MacBook Air (M2, 2022)94- MacBook Pro (13-inch, M2, 2022)95- Mac mini (M2, 2023)9697And devices based on the "M1 Pro", "M1 Max" and "M1 Ultra" SoCs:9899- MacBook Pro (14-inch, M1 Pro, 2021)100- MacBook Pro (14-inch, M1 Max, 2021)101- MacBook Pro (16-inch, M1 Pro, 2021)102- MacBook Pro (16-inch, M1 Max, 2021)103- Mac Studio (M1 Max, 2022)104- Mac Studio (M1 Ultra, 2022)105106The compatible property should follow this format:107108compatible = "apple,<targettype>", "apple,<socid>", "apple,arm-platform";109110<targettype> represents the board/device and comes from the `target-type`111property of the root node of the Apple Device Tree, lowercased. It can be112queried on macOS using the following command:113114$ ioreg -d2 -l | grep target-type115116<socid> is the lowercased SoC ID. Apple uses at least *five* different117names for their SoCs:118119- Marketing name ("M1")120- Internal name ("H13G")121- Codename ("Tonga")122- SoC ID ("T8103")123- Package/IC part number ("APL1102")124125Devicetrees should use the lowercased SoC ID, to avoid confusion if126multiple SoCs share the same marketing name. This can be obtained from127the `compatible` property of the arm-io node of the Apple Device Tree,128which can be queried as follows on macOS:129130$ ioreg -n arm-io | grep compatible131132properties:133$nodename:134const: "/"135compatible:136oneOf:137- description: Apple A7 SoC based platforms138items:139- enum:140- apple,j71 # iPad Air (Wi-Fi)141- apple,j72 # iPad Air (Cellular)142- apple,j73 # iPad Air (Cellular, China)143- apple,j85 # iPad mini 2 (Wi-Fi)144- apple,j85m # iPad mini 3 (Wi-Fi)145- apple,j86 # iPad mini 2 (Cellular)146- apple,j86m # iPad mini 3 (Cellular)147- apple,j87 # iPad mini 2 (Cellular, China)148- apple,j87m # iPad mini 3 (Cellular, China)149- apple,n51 # iPhone 5s (GSM)150- apple,n53 # iPhone 5s (LTE)151- const: apple,s5l8960x152- const: apple,arm-platform153154- description: Apple A8 SoC based platforms155items:156- enum:157- apple,j42d # Apple TV HD158- apple,j96 # iPad mini 4 (Wi-Fi)159- apple,j97 # iPad mini 4 (Cellular)160- apple,n56 # iPhone 6 Plus161- apple,n61 # iPhone 6162- apple,n102 # iPod touch 6163- const: apple,t7000164- const: apple,arm-platform165166- description: Apple A8X SoC based platforms167items:168- enum:169- apple,j81 # iPad Air 2 (Wi-Fi)170- apple,j82 # iPad Air 2 (Cellular)171- const: apple,t7001172- const: apple,arm-platform173174- description: Apple Samsung A9 SoC based platforms175items:176- enum:177- apple,j71s # iPad 5 (Wi-Fi) (S8000)178- apple,j72s # iPad 5 (Cellular) (S8000)179- apple,n66 # iPhone 6s Plus (S8000)180- apple,n69u # iPhone SE (S8000)181- apple,n71 # iPhone 6S (S8000)182- const: apple,s8000183- const: apple,arm-platform184185- description: Apple TSMC A9 SoC based platforms186items:187- enum:188- apple,j71t # iPad 5 (Wi-Fi) (S8003)189- apple,j72t # iPad 5 (Cellular) (S8003)190- apple,n66m # iPhone 6s Plus (S8003)191- apple,n69 # iPhone SE (S8003)192- apple,n71m # iPhone 6S (S8003)193- const: apple,s8003194- const: apple,arm-platform195196- description: Apple A9X SoC based platforms197items:198- enum:199- apple,j127 # iPad Pro (9.7-inch) (Wi-Fi)200- apple,j128 # iPad Pro (9.7-inch) (Cellular)201- apple,j98a # iPad Pro (12.9-inch) (Wi-Fi)202- apple,j99a # iPad Pro (12.9-inch) (Cellular)203- const: apple,s8001204- const: apple,arm-platform205206- description: Apple A10 SoC based platforms207items:208- enum:209- apple,d10 # iPhone 7 (Qualcomm)210- apple,d11 # iPhone 7 (Intel)211- apple,d101 # iPhone 7 Plus (Qualcomm)212- apple,d111 # iPhone 7 Plus (Intel)213- apple,j71b # iPad 6 (Wi-Fi)214- apple,j72b # iPad 6 (Cellular)215- apple,j171 # iPad 7 (Wi-Fi)216- apple,j172 # iPad 7 (Cellular)217- apple,n112 # iPod touch 7218- const: apple,t8010219- const: apple,arm-platform220221- description: Apple A10X SoC based platforms222items:223- enum:224- apple,j105a # Apple TV 4K (1st Generation)225- apple,j120 # iPad Pro 2 (12.9-inch) (Wi-Fi)226- apple,j121 # iPad Pro 2 (12.9-inch) (Cellular)227- apple,j207 # iPad Pro 2 (10.5-inch) (Wi-Fi)228- apple,j208 # iPad Pro 2 (10.5-inch) (Cellular)229- const: apple,t8011230- const: apple,arm-platform231232- description: Apple T2 SoC based platforms233items:234- enum:235- apple,j132 # Apple T2 MacBookPro15,2 (j132)236- apple,j137 # Apple T2 iMacPro1,1 (j137)237- apple,j140a # Apple T2 MacBookAir8,2 (j140a)238- apple,j140k # Apple T2 MacBookAir8,1 (j140k)239- apple,j152f # Apple T2 MacBookPro16,1 (j152f)240- apple,j160 # Apple T2 MacPro7,1 (j160)241- apple,j174 # Apple T2 Macmini8,1 (j174)242- apple,j185 # Apple T2 iMac20,1 (j185)243- apple,j185f # Apple T2 iMac20,2 (j185f)244- apple,j213 # Apple T2 MacBookPro15,4 (j213)245- apple,j214k # Apple T2 MacBookPro16,2 (j214k)246- apple,j215 # Apple T2 MacBookPro16,4 (j215)247- apple,j223 # Apple T2 MacBookPro16,3 (j223)248- apple,j230k # Apple T2 MacBookAir9,1 (j230k)249- apple,j680 # Apple T2 MacBookPro15,1 (j680)250- apple,j780 # Apple T2 MacBookPro15,3 (j780)251- const: apple,t8012252- const: apple,arm-platform253254- description: Apple A11 SoC based platforms255items:256- enum:257- apple,d20 # iPhone 8 (Global)258- apple,d21 # iPhone 8 Plus (Global)259- apple,d22 # iPhone X (Global)260- apple,d201 # iPhone 8 (GSM)261- apple,d211 # iPhone 8 Plus (GSM)262- apple,d221 # iPhone X (GSM)263- const: apple,t8015264- const: apple,arm-platform265266- description: Apple M1 SoC based platforms267items:268- enum:269- apple,j274 # Mac mini (M1, 2020)270- apple,j293 # MacBook Pro (13-inch, M1, 2020)271- apple,j313 # MacBook Air (M1, 2020)272- apple,j456 # iMac (24-inch, 4x USB-C, M1, 2021)273- apple,j457 # iMac (24-inch, 2x USB-C, M1, 2021)274- const: apple,t8103275- const: apple,arm-platform276277- description: Apple M2 SoC based platforms278items:279- enum:280- apple,j413 # MacBook Air (M2, 2022)281- apple,j473 # Mac mini (M2, 2023)282- apple,j493 # MacBook Pro (13-inch, M2, 2022)283- const: apple,t8112284- const: apple,arm-platform285286- description: Apple M1 Pro SoC based platforms287items:288- enum:289- apple,j314s # MacBook Pro (14-inch, M1 Pro, 2021)290- apple,j316s # MacBook Pro (16-inch, M1 Pro, 2021)291- const: apple,t6000292- const: apple,arm-platform293294- description: Apple M1 Max SoC based platforms295items:296- enum:297- apple,j314c # MacBook Pro (14-inch, M1 Max, 2021)298- apple,j316c # MacBook Pro (16-inch, M1 Max, 2021)299- apple,j375c # Mac Studio (M1 Max, 2022)300- const: apple,t6001301- const: apple,arm-platform302303- description: Apple M1 Ultra SoC based platforms304items:305- enum:306- apple,j375d # Mac Studio (M1 Ultra, 2022)307- const: apple,t6002308- const: apple,arm-platform309310additionalProperties: true311312...313314315