1# SPDX-License-Identifier: GPL-2.0
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/bindings/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  	msm8916
32  	msm8974
33  	msm8992
34  	msm8994
35  	msm8996
36  	mdm9615
37  	ipq8074
38  	sdm845
39
40  The 'board' element must be one of the following strings:
41
42  	cdp
43  	liquid
44  	dragonboard
45  	mtp
46  	sbc
47  	hk01
48  	qrd
49
50  The 'soc_version' and 'board_version' elements take the form of v<Major>.<Minor>
51  where the minor number may be omitted when it's zero, i.e.  v1.0 is the same
52  as v1. If all versions of the 'board_version' elements match, then a
53  wildcard '*' should be used, e.g. 'v*'.
54
55  The 'foundry_id' and 'subtype' elements are one or more digits from 0 to 9.
56
57  Examples:
58
59  	"qcom,msm8916-v1-cdp-pm8916-v2.1"
60
61  A CDP board with an msm8916 SoC, version 1 paired with a pm8916 PMIC of version
62  2.1.
63
64  	"qcom,apq8074-v2.0-2-dragonboard/1-v0.1"
65
66  A dragonboard board v0.1 of subtype 1 with an apq8074 SoC version 2, made in
67  foundry 2.
68
69properties:
70  compatible:
71    oneOf:
72      - items:
73          - enum:
74              - qcom,apq8016-sbc
75          - const: qcom,apq8016
76
77      - items:
78          - enum:
79              - qcom,apq8064-cm-qs600
80              - qcom,apq8064-ifc6410
81          - const: qcom,apq8064
82
83      - items:
84          - enum:
85              - qcom,apq8074-dragonboard
86          - const: qcom,apq8074
87
88      - items:
89          - enum:
90              - qcom,apq8060-dragonboard
91              - qcom,msm8660-surf
92          - const: qcom,msm8660
93
94      - items:
95          - enum:
96              - qcom,apq8084-mtp
97              - qcom,apq8084-sbc
98          - const: qcom,apq8084
99
100      - items:
101          - enum:
102              - qcom,msm8960-cdp
103          - const: qcom,msm8960
104
105      - items:
106          - enum:
107              - fairphone,fp2
108              - lge,hammerhead
109              - sony,xperia-amami
110              - sony,xperia-castor
111              - sony,xperia-honami
112          - const: qcom,msm8974
113
114      - items:
115          - const: qcom,msm8916-mtp/1
116          - const: qcom,msm8916-mtp
117          - const: qcom,msm8916
118
119      - items:
120          - enum:
121              - longcheer,l8150
122              - samsung,a3u-eur
123              - samsung,a5u-eur
124          - const: qcom,msm8916
125
126      - items:
127          - const: qcom,msm8996-mtp
128
129      - items:
130          - enum:
131              - qcom,ipq4019-ap-dk04.1-c3
132              - qcom,ipq4019-ap-dk07.1-c1
133              - qcom,ipq4019-ap-dk07.1-c2
134              - qcom,ipq4019-dk04.1-c1
135          - const: qcom,ipq4019
136
137      - items:
138          - enum:
139              - qcom,ipq8064-ap148
140          - const: qcom,ipq8064
141
142      - items:
143          - enum:
144              - qcom,ipq8074-hk01
145          - const: qcom,ipq8074
146
147...
148