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        sdm630
41        sdm660
42        sdm845
43        sdx55
44        sm8250
45        sm8350
46
47  The 'board' element must be one of the following strings:
48
49        cdp
50        cp01-c1
51        dragonboard
52        hk01
53        hk10-c1
54        hk10-c2
55        idp
56        liquid
57        mtp
58        qrd
59        sbc
60
61  The 'soc_version' and 'board_version' elements take the form of v<Major>.<Minor>
62  where the minor number may be omitted when it's zero, i.e.  v1.0 is the same
63  as v1. If all versions of the 'board_version' elements match, then a
64  wildcard '*' should be used, e.g. 'v*'.
65
66  The 'foundry_id' and 'subtype' elements are one or more digits from 0 to 9.
67
68  Examples:
69
70  	"qcom,msm8916-v1-cdp-pm8916-v2.1"
71
72  A CDP board with an msm8916 SoC, version 1 paired with a pm8916 PMIC of version
73  2.1.
74
75  	"qcom,apq8074-v2.0-2-dragonboard/1-v0.1"
76
77  A dragonboard board v0.1 of subtype 1 with an apq8074 SoC version 2, made in
78  foundry 2.
79
80properties:
81  $nodename:
82    const: "/"
83  compatible:
84    oneOf:
85      - items:
86          - enum:
87              - qcom,apq8016-sbc
88          - const: qcom,apq8016
89
90      - items:
91          - enum:
92              - qcom,apq8064-cm-qs600
93              - qcom,apq8064-ifc6410
94          - const: qcom,apq8064
95
96      - items:
97          - enum:
98              - qcom,apq8074-dragonboard
99          - const: qcom,apq8074
100
101      - items:
102          - enum:
103              - qcom,apq8060-dragonboard
104              - qcom,msm8660-surf
105          - const: qcom,msm8660
106
107      - items:
108          - enum:
109              - qcom,apq8084-mtp
110              - qcom,apq8084-sbc
111          - const: qcom,apq8084
112
113      - items:
114          - enum:
115              - qcom,msm8960-cdp
116          - const: qcom,msm8960
117
118      - items:
119          - enum:
120              - fairphone,fp2
121              - lge,hammerhead
122              - sony,xperia-amami
123              - sony,xperia-castor
124              - sony,xperia-honami
125          - const: qcom,msm8974
126
127      - items:
128          - const: qcom,msm8916-mtp/1
129          - const: qcom,msm8916-mtp
130          - const: qcom,msm8916
131
132      - items:
133          - enum:
134              - longcheer,l8150
135              - samsung,a3u-eur
136              - samsung,a5u-eur
137          - const: qcom,msm8916
138
139      - items:
140          - const: qcom,msm8996-mtp
141
142      - items:
143          - enum:
144              - qcom,ipq4019-ap-dk04.1-c3
145              - qcom,ipq4019-ap-dk07.1-c1
146              - qcom,ipq4019-ap-dk07.1-c2
147              - qcom,ipq4019-dk04.1-c1
148          - const: qcom,ipq4019
149
150      - items:
151          - enum:
152              - qcom,ipq8064-ap148
153          - const: qcom,ipq8064
154
155      - items:
156          - enum:
157              - qcom,ipq8074-hk01
158              - qcom,ipq8074-hk10-c1
159              - qcom,ipq8074-hk10-c2
160          - const: qcom,ipq8074
161
162      - items:
163          - enum:
164              - qcom,sc7180-idp
165          - const: qcom,sc7180
166
167      - items:
168          - enum:
169              - xiaomi,lavender
170          - const: qcom,sdm660
171
172      - items:
173          - enum:
174              - qcom,sdx55-mtp
175          - const: qcom,sdx55
176
177      - items:
178          - enum:
179              - qcom,ipq6018-cp01-c1
180          - const: qcom,ipq6018
181
182      - items:
183          - enum:
184              - qcom,qrb5165-rb5
185              - qcom,sm8250-mtp
186          - const: qcom,sm8250
187
188      - items:
189          - enum:
190              - qcom,sm8350-mtp
191          - const: qcom,sm8350
192
193additionalProperties: true
194
195...
196