1# SPDX-License-Identifier: GPL-2.0
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/arm/qcom.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: QCOM device tree bindings
8
9maintainers:
10  - Stephen Boyd <sboyd@codeaurora.org>
11
12description: |
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
16  string.
17
18  Each board must specify a top-level board compatible string with the following
19  format:
20
21  	compatible = "qcom,<SoC>[-<soc_version>][-<foundry_id>]-<board>[/<subtype>][-<board_version>]"
22
23  The 'SoC' and 'board' elements are required. All other elements are optional.
24
25  The 'SoC' element must be one of the following strings:
26
27        apq8016
28        apq8074
29        apq8084
30        apq8096
31        ipq6018
32        ipq8074
33        mdm9615
34        msm8916
35        msm8974
36        msm8992
37        msm8994
38        msm8996
39        sc7180
40        sdm845
41
42  The 'board' element must be one of the following strings:
43
44        cdp
45        cp01-c1
46        dragonboard
47        hk01
48        idp
49        liquid
50        mtp
51        qrd
52        sbc
53
54  The 'soc_version' and 'board_version' elements take the form of v<Major>.<Minor>
55  where the minor number may be omitted when it's zero, i.e.  v1.0 is the same
56  as v1. If all versions of the 'board_version' elements match, then a
57  wildcard '*' should be used, e.g. 'v*'.
58
59  The 'foundry_id' and 'subtype' elements are one or more digits from 0 to 9.
60
61  Examples:
62
63  	"qcom,msm8916-v1-cdp-pm8916-v2.1"
64
65  A CDP board with an msm8916 SoC, version 1 paired with a pm8916 PMIC of version
66  2.1.
67
68  	"qcom,apq8074-v2.0-2-dragonboard/1-v0.1"
69
70  A dragonboard board v0.1 of subtype 1 with an apq8074 SoC version 2, made in
71  foundry 2.
72
73properties:
74  compatible:
75    oneOf:
76      - items:
77          - enum:
78              - qcom,apq8016-sbc
79          - const: qcom,apq8016
80
81      - items:
82          - enum:
83              - qcom,apq8064-cm-qs600
84              - qcom,apq8064-ifc6410
85          - const: qcom,apq8064
86
87      - items:
88          - enum:
89              - qcom,apq8074-dragonboard
90          - const: qcom,apq8074
91
92      - items:
93          - enum:
94              - qcom,apq8060-dragonboard
95              - qcom,msm8660-surf
96          - const: qcom,msm8660
97
98      - items:
99          - enum:
100              - qcom,apq8084-mtp
101              - qcom,apq8084-sbc
102          - const: qcom,apq8084
103
104      - items:
105          - enum:
106              - qcom,msm8960-cdp
107          - const: qcom,msm8960
108
109      - items:
110          - enum:
111              - fairphone,fp2
112              - lge,hammerhead
113              - sony,xperia-amami
114              - sony,xperia-castor
115              - sony,xperia-honami
116          - const: qcom,msm8974
117
118      - items:
119          - const: qcom,msm8916-mtp/1
120          - const: qcom,msm8916-mtp
121          - const: qcom,msm8916
122
123      - items:
124          - enum:
125              - longcheer,l8150
126              - samsung,a3u-eur
127              - samsung,a5u-eur
128          - const: qcom,msm8916
129
130      - items:
131          - const: qcom,msm8996-mtp
132
133      - items:
134          - enum:
135              - qcom,ipq4019-ap-dk04.1-c3
136              - qcom,ipq4019-ap-dk07.1-c1
137              - qcom,ipq4019-ap-dk07.1-c2
138              - qcom,ipq4019-dk04.1-c1
139          - const: qcom,ipq4019
140
141      - items:
142          - enum:
143              - qcom,ipq8064-ap148
144          - const: qcom,ipq8064
145
146      - items:
147          - enum:
148              - qcom,ipq8074-hk01
149          - const: qcom,ipq8074
150
151      - items:
152          - enum:
153              - qcom,sc7180-idp
154          - const: qcom,sc7180
155
156      - items:
157          - enum:
158              - qcom,ipq6018-cp01-c1
159          - const: qcom,ipq6018
160
161...
162