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        msm8226
35        msm8916
36        msm8974
37        msm8992
38        msm8994
39        msm8996
40        sa8155p
41        sc7180
42        sc7280
43        sdm630
44        sdm660
45        sdm845
46        sdx55
47        sm7225
48        sm8150
49        sm8250
50        sm8350
51
52  The 'board' element must be one of the following strings:
53
54        adp
55        cdp
56        cp01-c1
57        dragonboard
58        hk01
59        hk10-c1
60        hk10-c2
61        idp
62        liquid
63        mtp
64        qrd
65        sbc
66
67  The 'soc_version' and 'board_version' elements take the form of v<Major>.<Minor>
68  where the minor number may be omitted when it's zero, i.e.  v1.0 is the same
69  as v1. If all versions of the 'board_version' elements match, then a
70  wildcard '*' should be used, e.g. 'v*'.
71
72  The 'foundry_id' and 'subtype' elements are one or more digits from 0 to 9.
73
74  Examples:
75
76  	"qcom,msm8916-v1-cdp-pm8916-v2.1"
77
78  A CDP board with an msm8916 SoC, version 1 paired with a pm8916 PMIC of version
79  2.1.
80
81  	"qcom,apq8074-v2.0-2-dragonboard/1-v0.1"
82
83  A dragonboard board v0.1 of subtype 1 with an apq8074 SoC version 2, made in
84  foundry 2.
85
86properties:
87  $nodename:
88    const: "/"
89  compatible:
90    oneOf:
91      - items:
92          - enum:
93              - qcom,apq8016-sbc
94          - const: qcom,apq8016
95
96      - items:
97          - enum:
98              - qcom,apq8064-cm-qs600
99              - qcom,apq8064-ifc6410
100          - const: qcom,apq8064
101
102      - items:
103          - enum:
104              - qcom,apq8074-dragonboard
105          - const: qcom,apq8074
106
107      - items:
108          - enum:
109              - qcom,apq8060-dragonboard
110              - qcom,msm8660-surf
111          - const: qcom,msm8660
112
113      - items:
114          - enum:
115              - qcom,apq8084-mtp
116              - qcom,apq8084-sbc
117          - const: qcom,apq8084
118
119      - items:
120          - enum:
121              - samsung,s3ve3g
122          - const: qcom,msm8226
123
124      - items:
125          - enum:
126              - qcom,msm8960-cdp
127          - const: qcom,msm8960
128
129      - items:
130          - enum:
131              - fairphone,fp2
132              - lge,hammerhead
133              - sony,xperia-amami
134              - sony,xperia-castor
135              - sony,xperia-honami
136          - const: qcom,msm8974
137
138      - items:
139          - enum:
140              - alcatel,idol347
141          - const: qcom,msm8916-mtp/1
142          - const: qcom,msm8916-mtp
143          - const: qcom,msm8916
144
145      - items:
146          - enum:
147              - longcheer,l8150
148              - samsung,a3u-eur
149              - samsung,a5u-eur
150          - const: qcom,msm8916
151
152      - items:
153          - enum:
154              - sony,karin_windy
155              - sony,karin-row
156              - sony,satsuki-row
157              - sony,sumire-row
158              - sony,suzuran-row
159              - qcom,msm8994
160          - const: qcom,apq8094
161
162      - items:
163          - const: qcom,msm8996-mtp
164
165      - items:
166          - enum:
167              - qcom,ipq4019-ap-dk04.1-c3
168              - qcom,ipq4019-ap-dk07.1-c1
169              - qcom,ipq4019-ap-dk07.1-c2
170              - qcom,ipq4019-dk04.1-c1
171          - const: qcom,ipq4019
172
173      - items:
174          - enum:
175              - qcom,ipq8064-ap148
176          - const: qcom,ipq8064
177
178      - items:
179          - enum:
180              - qcom,ipq8074-hk01
181              - qcom,ipq8074-hk10-c1
182              - qcom,ipq8074-hk10-c2
183          - const: qcom,ipq8074
184
185      - items:
186          - enum:
187              - qcom,sc7180-idp
188          - const: qcom,sc7180
189
190      - items:
191          - enum:
192              - qcom,sc7280-idp
193              - qcom,sc7280-idp2
194              - google,piglin
195              - google,senor
196          - const: qcom,sc7280
197
198      - items:
199          - enum:
200              - xiaomi,lavender
201          - const: qcom,sdm660
202
203      - items:
204          - enum:
205              - qcom,sdx55-mtp
206              - qcom,sdx55-telit-fn980-tlb
207              - qcom,sdx55-t55
208          - const: qcom,sdx55
209
210      - items:
211          - enum:
212              - qcom,ipq6018-cp01
213              - qcom,ipq6018-cp01-c1
214          - const: qcom,ipq6018
215
216      - items:
217          - enum:
218              - qcom,sa8155p-adp
219          - const: qcom,sa8155p
220
221      - items:
222          - enum:
223              - fairphone,fp4
224          - const: qcom,sm7225
225
226      - items:
227          - enum:
228              - qcom,sm8150-mtp
229          - const: qcom,sm8150
230
231      - items:
232          - enum:
233              - qcom,qrb5165-rb5
234              - qcom,sm8250-mtp
235          - const: qcom,sm8250
236
237      - items:
238          - enum:
239              - qcom,sm8350-hdk
240              - qcom,sm8350-mtp
241          - const: qcom,sm8350
242
243additionalProperties: true
244
245...
246