Merge remote-tracking branches 'spi/topic/spidev', 'spi/topic/spidev-test', 'spi...
[sfrench/cifs-2.6.git] / Documentation / devicetree / bindings / arm / qcom.txt
1 QCOM device tree bindings
2 -------------------------
3
4 Some qcom based bootloaders identify the dtb blob based on a set of
5 device properties like SoC and platform and revisions of those components.
6 To support this scheme, we encode this information into the board compatible
7 string.
8
9 Each board must specify a top-level board compatible string with the following
10 format:
11
12         compatible = "qcom,<SoC>[-<soc_version>][-<foundry_id>]-<board>[/<subtype>][-<board_version>]"
13
14 The 'SoC' and 'board' elements are required. All other elements are optional.
15
16 The 'SoC' element must be one of the following strings:
17
18         apq8016
19         apq8074
20         apq8084
21         apq8096
22         msm8916
23         msm8974
24         msm8992
25         msm8994
26         msm8996
27         mdm9615
28
29 The 'board' element must be one of the following strings:
30
31         cdp
32         liquid
33         dragonboard
34         mtp
35         sbc
36
37 The 'soc_version' and 'board_version' elements take the form of v<Major>.<Minor>
38 where the minor number may be omitted when it's zero, i.e.  v1.0 is the same
39 as v1. If all versions of the 'board_version' elements match, then a
40 wildcard '*' should be used, e.g. 'v*'.
41
42 The 'foundry_id' and 'subtype' elements are one or more digits from 0 to 9.
43
44 Examples:
45
46         "qcom,msm8916-v1-cdp-pm8916-v2.1"
47
48 A CDP board with an msm8916 SoC, version 1 paired with a pm8916 PMIC of version
49 2.1.
50
51         "qcom,apq8074-v2.0-2-dragonboard/1-v0.1"
52
53 A dragonboard board v0.1 of subtype 1 with an apq8074 SoC version 2, made in
54 foundry 2.