Documentation/devicetree/bindings/arm/qcom.yaml

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