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