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  $nodename:
77    const: "/"
78  compatible:
79    oneOf:
80      - items:
81          - enum:
82              - qcom,apq8016-sbc
83          - const: qcom,apq8016
84
85      - items:
86          - enum:
87              - qcom,apq8064-cm-qs600
88              - qcom,apq8064-ifc6410
89          - const: qcom,apq8064
90
91      - items:
92          - enum:
93              - qcom,apq8074-dragonboard
94          - const: qcom,apq8074
95
96      - items:
97          - enum:
98              - qcom,apq8060-dragonboard
99              - qcom,msm8660-surf
100          - const: qcom,msm8660
101
102      - items:
103          - enum:
104              - qcom,apq8084-mtp
105              - qcom,apq8084-sbc
106          - const: qcom,apq8084
107
108      - items:
109          - enum:
110              - qcom,msm8960-cdp
111          - const: qcom,msm8960
112
113      - items:
114          - enum:
115              - fairphone,fp2
116              - lge,hammerhead
117              - sony,xperia-amami
118              - sony,xperia-castor
119              - sony,xperia-honami
120          - const: qcom,msm8974
121
122      - items:
123          - const: qcom,msm8916-mtp/1
124          - const: qcom,msm8916-mtp
125          - const: qcom,msm8916
126
127      - items:
128          - enum:
129              - longcheer,l8150
130              - samsung,a3u-eur
131              - samsung,a5u-eur
132          - const: qcom,msm8916
133
134      - items:
135          - const: qcom,msm8996-mtp
136
137      - items:
138          - enum:
139              - qcom,ipq4019-ap-dk04.1-c3
140              - qcom,ipq4019-ap-dk07.1-c1
141              - qcom,ipq4019-ap-dk07.1-c2
142              - qcom,ipq4019-dk04.1-c1
143          - const: qcom,ipq4019
144
145      - items:
146          - enum:
147              - qcom,ipq8064-ap148
148          - const: qcom,ipq8064
149
150      - items:
151          - enum:
152              - qcom,ipq8074-hk01
153          - const: qcom,ipq8074
154
155      - items:
156          - enum:
157              - qcom,sc7180-idp
158          - const: qcom,sc7180
159
160      - items:
161          - enum:
162              - xiaomi,lavender
163          - const: qcom,sdm660
164
165      - items:
166          - enum:
167              - qcom,ipq6018-cp01-c1
168          - const: qcom,ipq6018
169
170...
171