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