1 # SPDX-License-Identifier: GPL-2.0
4 $id: http://devicetree.org/schemas/arm/qcom.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
10 - Bjorn Andersson <bjorn.andersson@linaro.org>
13 Some qcom based bootloaders identify the dtb blob based on a set of
14 device properties like SoC and platform and revisions of those components.
15 To support this scheme, we encode this information into the board compatible
18 Each board must specify a top-level board compatible string with the following
21 compatible = "qcom,<SoC>[-<soc_version>][-<foundry_id>]-<board>[/<subtype>][-<board_version>]"
23 The 'SoC' and 'board' elements are required. All other elements are optional.
25 The 'SoC' element must be one of the following strings:
91 The 'board' element must be one of the following strings:
119 The 'soc_version' and 'board_version' elements take the form of v<Major>.<Minor>
120 where the minor number may be omitted when it's zero, i.e. v1.0 is the same
121 as v1. If all versions of the 'board_version' elements match, then a
122 wildcard '*' should be used, e.g. 'v*'.
124 The 'foundry_id' and 'subtype' elements are one or more digits from 0 to 9.
128 "qcom,msm8916-v1-cdp-pm8916-v2.1"
130 A CDP board with an msm8916 SoC, version 1 paired with a pm8916 PMIC of version
133 "qcom,apq8074-v2.0-2-dragonboard/1-v0.1"
135 A dragonboard board v0.1 of subtype 1 with an apq8074 SoC version 2, made in
138 There are many devices in the list below that run the standard ChromeOS
139 bootloader setup and use the open source depthcharge bootloader to boot the
140 OS. These devices do not use the scheme described above. For details, see:
141 https://docs.kernel.org/arm/google/chromebook-boot-flow.html
151 - const: qcom,apq8016
158 - samsung,matisse-wifi
159 - const: qcom,apq8026
166 - qcom,apq8064-cm-qs600
167 - qcom,apq8064-ifc6410
168 - const: qcom,apq8064
172 - qcom,apq8074-dragonboard
173 - const: qcom,apq8074
177 - qcom,apq8060-dragonboard
179 - const: qcom,msm8660
185 - const: qcom,apq8084
190 - const: qcom,msm8226
198 - const: qcom,msm8939
204 - const: qcom,msm8956
210 - const: qcom,msm8960
217 - const: qcom,msm8974
225 - const: qcom,msm8974pro
226 - const: qcom,msm8974
229 - const: qcom,msm8916-mtp
230 - const: qcom,msm8916-mtp/1
231 - const: qcom,msm8916
255 - const: qcom,msm8916
258 - const: longcheer,l8150
259 - const: qcom,msm8916-v1-qrd/9-v1
260 - const: qcom,msm8916
269 - const: qcom,msm8953
276 - const: qcom,msm8992
281 - const: qcom,apq8094
292 - const: qcom,msm8994
296 - arrow,apq8096-db820c
298 - const: qcom,apq8096-sbc
299 - const: qcom,apq8096
310 - const: qcom,msm8996
316 - const: qcom,msm8996pro
317 - const: qcom,msm8996
321 - asus,novago-tp370ql
325 - oneplus,cheeseburger
332 - const: qcom,msm8998
337 - alfa-network,ap120c-ac
338 - const: qcom,ipq4018
342 - qcom,ipq4019-ap-dk01.1-c1
343 - qcom,ipq4019-ap-dk04.1-c3
344 - qcom,ipq4019-ap-dk07.1-c1
345 - qcom,ipq4019-ap-dk07.1-c2
346 - qcom,ipq4019-dk04.1-c1
347 - const: qcom,ipq4019
351 - qcom,ipq5018-rdp432-c2
352 - const: qcom,ipq5018
356 - qcom,ipq5332-ap-mi01.2
357 - qcom,ipq5332-ap-mi01.3
358 - qcom,ipq5332-ap-mi01.6
359 - qcom,ipq5332-ap-mi01.9
360 - const: qcom,ipq5332
366 - const: qcom,ipq8064
371 - qcom,ipq8074-hk10-c1
372 - qcom,ipq8074-hk10-c2
373 - const: qcom,ipq8074
377 - qcom,ipq9574-ap-al02-c2
378 - qcom,ipq9574-ap-al02-c6
379 - qcom,ipq9574-ap-al02-c7
380 - qcom,ipq9574-ap-al02-c8
381 - qcom,ipq9574-ap-al02-c9
382 - const: qcom,ipq9574
384 - description: Sierra Wireless MangOH Green with WP8548 Module
386 - const: swir,mangoh-green-wp8548
388 - const: qcom,mdm9615
390 - description: Qualcomm Technologies, Inc. Robotics RB1
394 - const: qcom,qrb2210
395 - const: qcom,qcm2290
400 - const: qcom,qcm6490
402 - description: Qualcomm Technologies, Inc. Distributed Unit 1000 platform
407 - const: qcom,qdu1000
409 - description: Qualcomm Technologies, Inc. Radio Unit 1000 platform
413 - const: qcom,qru1000
421 - description: HP Chromebook x2 11c (rev1 - 2)
423 - const: google,coachz-rev1
424 - const: google,coachz-rev2
427 - description: HP Chromebook x2 11c (newest rev)
429 - const: google,coachz
432 - description: HP Chromebook x2 11c with LTE (rev1 - 2)
434 - const: google,coachz-rev1-sku0
435 - const: google,coachz-rev2-sku0
438 - description: HP Chromebook x2 11c with LTE (newest rev)
440 - const: google,coachz-sku0
443 - description: Lenovo Chromebook Duet 5 13 (rev2)
445 - const: google,homestar-rev2
446 - const: google,homestar-rev23
449 - description: Lenovo Chromebook Duet 5 13 (rev3)
451 - const: google,homestar-rev3
454 - description: Lenovo Chromebook Duet 5 13 (newest rev)
456 - const: google,homestar
459 - description: Google Kingoftown (rev0)
461 - const: google,kingoftown-rev0
464 - description: Google Kingoftown (newest rev)
466 - const: google,kingoftown
469 - description: Acer Chromebook Spin 513 (rev0)
471 - const: google,lazor-rev0
474 - description: Acer Chromebook Spin 513 (rev1 - 2)
476 - const: google,lazor-rev1
477 - const: google,lazor-rev2
480 - description: Acer Chromebook Spin 513 (rev3 - 8)
482 - const: google,lazor-rev3
483 - const: google,lazor-rev4
484 - const: google,lazor-rev5
485 - const: google,lazor-rev6
486 - const: google,lazor-rev7
487 - const: google,lazor-rev8
490 - description: Acer Chromebook Spin 513 (rev9)
492 - const: google,lazor-rev9
495 - description: Acer Chromebook Spin 513 (newest rev)
497 - const: google,lazor
500 - description: Acer Chromebook Spin 513 with KB Backlight (rev1 - 2)
502 - const: google,lazor-rev1-sku2
503 - const: google,lazor-rev2-sku2
506 - description: Acer Chromebook Spin 513 with KB Backlight (rev3 - 8)
508 - const: google,lazor-rev3-sku2
509 - const: google,lazor-rev4-sku2
510 - const: google,lazor-rev5-sku2
511 - const: google,lazor-rev6-sku2
512 - const: google,lazor-rev7-sku2
513 - const: google,lazor-rev8-sku2
516 - description: Acer Chromebook Spin 513 with KB Backlight (rev9)
518 - const: google,lazor-rev9-sku2
521 - description: Acer Chromebook Spin 513 with KB Backlight (newest rev)
523 - const: google,lazor-sku2
526 - description: Acer Chromebook Spin 513 with LTE (rev1 - 2)
528 - const: google,lazor-rev1-sku0
529 - const: google,lazor-rev2-sku0
532 - description: Acer Chromebook Spin 513 with LTE (rev3 - 8)
534 - const: google,lazor-rev3-sku0
535 - const: google,lazor-rev4-sku0
536 - const: google,lazor-rev5-sku0
537 - const: google,lazor-rev6-sku0
538 - const: google,lazor-rev7-sku0
539 - const: google,lazor-rev8-sku0
542 - description: Acer Chromebook Spin 513 with LTE (rev9)
544 - const: google,lazor-rev9-sku0
545 - const: google,lazor-rev9-sku10
548 - description: Acer Chromebook Spin 513 with LTE (newest rev)
550 - const: google,lazor-sku0
551 - const: google,lazor-sku10
554 - description: Acer Chromebook 511 (rev4 - rev8)
556 - const: google,lazor-rev4-sku4
557 - const: google,lazor-rev5-sku4
558 - const: google,lazor-rev6-sku4
559 - const: google,lazor-rev7-sku4
560 - const: google,lazor-rev8-sku4
563 - description: Acer Chromebook 511 (rev9)
565 - const: google,lazor-rev9-sku4
566 - const: google,lazor-rev9-sku15
569 - description: Acer Chromebook 511 (newest rev)
571 - const: google,lazor-sku4
572 - const: google,lazor-sku15
575 - description: Acer Chromebook 511 without Touchscreen (rev4)
577 - const: google,lazor-rev4-sku5
580 - description: Acer Chromebook 511 without Touchscreen (rev5 - rev8)
582 - const: google,lazor-rev5-sku5
583 - const: google,lazor-rev5-sku6
584 - const: google,lazor-rev6-sku6
585 - const: google,lazor-rev7-sku6
586 - const: google,lazor-rev8-sku6
589 - description: Acer Chromebook 511 without Touchscreen (rev9)
591 - const: google,lazor-rev9-sku6
592 - const: google,lazor-rev9-sku18
595 - description: Acer Chromebook 511 without Touchscreen (newest rev)
597 - const: google,lazor-sku6
598 - const: google,lazor-sku18
601 - description: Google Mrbland with AUO panel (rev0)
603 - const: google,mrbland-rev0-sku0
606 - description: Google Mrbland with AUO panel (newest rev)
608 - const: google,mrbland-sku1536
611 - description: Google Mrbland with BOE panel (rev0)
613 - const: google,mrbland-rev0-sku16
616 - description: Google Mrbland with BOE panel (newest rev)
618 - const: google,mrbland-sku1024
619 - const: google,mrbland-sku768
622 - description: Google Pazquel with Parade (newest rev)
624 - const: google,pazquel-sku5
627 - description: Google Pazquel with TI (newest rev)
629 - const: google,pazquel-sku1
632 - description: Google Pazquel with LTE and Parade (newest rev)
634 - const: google,pazquel-sku6
635 - const: google,pazquel-sku4
638 - description: Google Pazquel with LTE and TI (newest rev)
640 - const: google,pazquel-sku0
641 - const: google,pazquel-sku2
644 - description: Google Pazquel360 with LTE (newest rev)
646 - const: google,pazquel-sku22
647 - const: google,pazquel-sku20
650 - description: Google Pazquel360 with WiFi (newest rev)
652 - const: google,pazquel-sku21
655 - description: Sharp Dynabook Chromebook C1 (rev1)
657 - const: google,pompom-rev1
660 - description: Sharp Dynabook Chromebook C1 (rev2)
662 - const: google,pompom-rev2
665 - description: Sharp Dynabook Chromebook C1 (newest rev)
667 - const: google,pompom
670 - description: Sharp Dynabook Chromebook C1 with LTE (rev1)
672 - const: google,pompom-rev1-sku0
675 - description: Sharp Dynabook Chromebook C1 with LTE (rev2)
677 - const: google,pompom-rev2-sku0
680 - description: Sharp Dynabook Chromebook C1 with LTE (newest rev)
682 - const: google,pompom-sku0
685 - description: Google Quackingstick (newest rev)
687 - const: google,quackingstick-sku1537
690 - description: Google Quackingstick with LTE (newest rev)
692 - const: google,quackingstick-sku1536
695 - description: Google Trogdor (newest rev)
697 - const: google,trogdor
700 - description: Google Trogdor with LTE (newest rev)
702 - const: google,trogdor-sku0
705 - description: Lenovo IdeaPad Chromebook Duet 3 with BOE panel (rev0)
707 - const: google,wormdingler-rev0-sku16
710 - description: Lenovo IdeaPad Chromebook Duet 3 with BOE panel (newest rev)
712 - const: google,wormdingler-sku1024
715 - description: Lenovo IdeaPad Chromebook Duet 3 with BOE panel and rt5682s (newest rev)
717 - const: google,wormdingler-sku1025
720 - description: Lenovo IdeaPad Chromebook Duet 3 with INX panel (rev0)
722 - const: google,wormdingler-rev0-sku0
725 - description: Lenovo IdeaPad Chromebook Duet 3 with INX panel (newest rev)
727 - const: google,wormdingler-sku0
730 - description: Lenovo IdeaPad Chromebook Duet 3 with INX panel and rt5682s (newest rev)
732 - const: google,wormdingler-sku1
735 - description: Qualcomm Technologies, Inc. sc7280 CRD platform (rev3 - 4)
737 - const: qcom,sc7280-crd
738 - const: google,hoglin-rev3
739 - const: google,hoglin-rev4
740 - const: google,piglin-rev3
741 - const: google,piglin-rev4
744 - description: Qualcomm Technologies, Inc. sc7280 CRD platform (newest rev)
746 - const: google,zoglin
747 - const: google,hoglin
750 - description: Qualcomm Technologies, Inc. sc7280 CRD Pro platform (newest rev)
752 - const: google,zoglin-sku1536
753 - const: google,hoglin-sku1536
756 - description: Qualcomm Technologies, Inc. sc7280 IDP SKU1 platform
758 - const: qcom,sc7280-idp
759 - const: google,senor
762 - description: Qualcomm Technologies, Inc. sc7280 IDP SKU2 platform
764 - const: qcom,sc7280-idp2
765 - const: google,piglin
768 - description: Google Evoker (newest rev)
770 - const: google,evoker
773 - description: Google Evoker with LTE (newest rev)
775 - const: google,evoker-sku512
778 - description: Google Herobrine (newest rev)
780 - const: google,herobrine
783 - description: Google Villager (rev0)
785 - const: google,villager-rev0
788 - description: Google Villager (newest rev)
790 - const: google,villager
793 - description: Google Villager with LTE (newest rev)
795 - const: google,villager-sku512
798 - description: Google Zombie (newest rev)
800 - const: google,zombie
803 - description: Google Zombie with LTE (newest rev)
805 - const: google,zombie-sku512
808 - description: Google Zombie with NVMe (newest rev)
810 - const: google,zombie-sku2
811 - const: google,zombie-sku3
812 - const: google,zombie-sku515
815 - description: Google Zombie with LTE and NVMe (newest rev)
817 - const: google,zombie-sku514
823 - microsoft,surface-prox
824 - qcom,sc8180x-primus
825 - const: qcom,sc8180x
829 - lenovo,thinkpad-x13s
832 - const: qcom,sc8280xp
876 - qcom,sdx55-telit-fn980-tlb
893 - qcom,ipq6018-cp01-c1
894 - const: qcom,ipq6018
898 - qcom,qcs404-evb-1000
899 - qcom,qcs404-evb-4000
900 - const: qcom,qcs404-evb
906 - const: qcom,sa8155p
912 - const: qcom,sa8540p
917 - const: qcom,sa8775p
931 - samsung,starqltechn
938 - xiaomi,beryllium-ebbg
950 - const: qcom,qrb4210
966 - const: qcom,sm6115p
972 - xiaomi,laurel-sprout
997 - microsoft,surface-duo
1000 - sony,bahamut-generic
1001 - sony,griffin-generic
1002 - const: qcom,sm8150
1009 - sony,pdx203-generic
1010 - sony,pdx206-generic
1012 - const: qcom,sm8250
1016 - microsoft,surface-duo2
1019 - sony,pdx214-generic
1020 - sony,pdx215-generic
1021 - const: qcom,sm8350
1029 - const: qcom,sm8450
1035 - const: qcom,sm8550
1037 # Board compatibles go above
1040 $ref: /schemas/types.yaml#/definitions/uint32-matrix
1046 MSM chipset ID - an exact match value consisting of two bitfields::
1047 - bits 0-15 - The unique MSM chipset ID
1048 - bits 16-31 - Reserved; should be 0
1050 Hardware revision ID - a chipset specific 32-bit ID representing
1051 the version of the chipset. It is best a match value - the
1052 bootloader will look for the closest possible match.
1055 The MSM chipset and hardware revision used Qualcomm bootloaders. It
1056 can optionally be an array of these to indicate multiple hardware that
1057 use the same device tree. It is expected that the bootloader will use
1058 this information at boot-up to decide which device tree to use when given
1059 multiple device trees, some of which may not be compatible with the
1060 actual hardware. It is the bootloader's responsibility to pass the
1061 correct device tree to the kernel.
1062 The property is deprecated.
1065 $ref: /schemas/types.yaml#/definitions/uint32-matrix
1072 Board ID consisting of three bitfields::
1073 - bits 31-24 - Unused
1074 - bits 23-16 - Platform Version Major
1075 - bits 15-8 - Platform Version Minor
1076 - bits 7-0 - Platform Type
1077 Platform Type field is an exact match value. The
1078 Platform Major/Minor field is a best match. The bootloader will
1079 look for the closest possible match.
1081 Subtype ID unique to a Platform Type/Chipset ID. For a given
1082 Platform Type, there will typically only be a single board and the
1083 subtype_id will be 0. However in some cases board variants may
1084 need to be distinguished by different subtype_id values.
1086 # OnePlus uses a variant of board-id with four elements:
1090 - description: OnePlus board ID
1091 - description: OnePlus subtype ID
1094 The board type and revision information. It can optionally be an array
1095 of these to indicate multiple boards that use the same device tree. It
1096 is expected that the bootloader will use this information at boot-up to
1097 decide which device tree to use when given multiple device trees, some of
1098 which may not be compatible with the actual hardware. It is the
1099 bootloader's responsibility to pass the correct device tree to the
1101 The property is deprecated.
1104 # Explicit allow-list for older SoCs. The legacy properties are not allowed
1143 qcom,board-id: false
1151 - oneplus,cheeseburger
1168 additionalProperties: true