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