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