xref: /linux/Documentation/devicetree/bindings/arm/qcom.yaml (revision bd628c1bed7902ec1f24ba0fe70758949146abbe) 
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
49  The 'soc_version' and 'board_version' elements take the form of v<Major>.<Minor>
50  where the minor number may be omitted when it's zero, i.e.  v1.0 is the same
51  as v1. If all versions of the 'board_version' elements match, then a
52  wildcard '*' should be used, e.g. 'v*'.
53
54  The 'foundry_id' and 'subtype' elements are one or more digits from 0 to 9.
55
56  Examples:
57
58  	"qcom,msm8916-v1-cdp-pm8916-v2.1"
59
60  A CDP board with an msm8916 SoC, version 1 paired with a pm8916 PMIC of version
61  2.1.
62
63  	"qcom,apq8074-v2.0-2-dragonboard/1-v0.1"
64
65  A dragonboard board v0.1 of subtype 1 with an apq8074 SoC version 2, made in
66  foundry 2.
67
68properties:
69  compatible:
70    oneOf:
71      - items:
72          - enum:
73              - qcom,apq8016-sbc
74          - const: qcom,apq8016
75
76      - items:
77          - enum:
78              - qcom,apq8064-cm-qs600
79              - qcom,apq8064-ifc6410
80          - const: qcom,apq8064
81
82      - items:
83          - enum:
84              - qcom,apq8074-dragonboard
85          - const: qcom,apq8074
86
87      - items:
88          - enum:
89              - qcom,apq8060-dragonboard
90              - qcom,msm8660-surf
91          - const: qcom,msm8660
92
93      - items:
94          - enum:
95              - qcom,apq8084-mtp
96              - qcom,apq8084-sbc
97          - const: qcom,apq8084
98
99      - items:
100          - enum:
101              - qcom,msm8960-cdp
102          - const: qcom,msm8960
103
104      - items:
105          - const: qcom,msm8916-mtp/1
106          - const: qcom,msm8916-mtp
107          - const: qcom,msm8916
108
109      - items:
110          - const: qcom,msm8996-mtp
111
112      - items:
113          - const: qcom,ipq4019
114
115      - items:
116          - enum:
117              - qcom,ipq8064-ap148
118          - const: qcom,ipq8064
119
120      - items:
121          - enum:
122              - qcom,ipq8074-hk01
123          - const: qcom,ipq8074
124
125...
126