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         msm8226
  35         msm8916
  36         msm8974
  37         msm8992
  38         msm8994
  39         msm8996
  40         sa8155p
  41         sc7180
  42         sc7280
  43         sdm630
  44         sdm660
  45         sdm845
  46         sdx55
  47         sm8150
  48         sm8250
  49         sm8350
  50
  51   The 'board' element must be one of the following strings:
  52
  53         adp
  54         cdp
  55         cp01-c1
  56         dragonboard
  57         hk01
  58         hk10-c1
  59         hk10-c2
  60         idp
  61         liquid
  62         mtp
  63         qrd
  64         sbc
  65
  66   The 'soc_version' and 'board_version' elements take the form of v<Major>.<Minor>
  67   where the minor number may be omitted when it's zero, i.e.  v1.0 is the same
  68   as v1. If all versions of the 'board_version' elements match, then a
  69   wildcard '*' should be used, e.g. 'v*'.
  70
  71   The 'foundry_id' and 'subtype' elements are one or more digits from 0 to 9.
  72
  73   Examples:
  74
  75         "qcom,msm8916-v1-cdp-pm8916-v2.1"
  76
  77   A CDP board with an msm8916 SoC, version 1 paired with a pm8916 PMIC of version
  78   2.1.
  79
  80         "qcom,apq8074-v2.0-2-dragonboard/1-v0.1"
  81
  82   A dragonboard board v0.1 of subtype 1 with an apq8074 SoC version 2, made in
  83   foundry 2.
  84
  85 properties:
  86   $nodename:
  87     const: "/"
  88   compatible:
  89     oneOf:
  90       - items:
  91           - enum:
  92               - qcom,apq8016-sbc
  93           - const: qcom,apq8016
  94
  95       - items:
  96           - enum:
  97               - qcom,apq8064-cm-qs600
  98               - qcom,apq8064-ifc6410
  99           - const: qcom,apq8064
 100
 101       - items:
 102           - enum:
 103               - qcom,apq8074-dragonboard
 104           - const: qcom,apq8074
 105
 106       - items:
 107           - enum:
 108               - qcom,apq8060-dragonboard
 109               - qcom,msm8660-surf
 110           - const: qcom,msm8660
 111
 112       - items:
 113           - enum:
 114               - qcom,apq8084-mtp
 115               - qcom,apq8084-sbc
 116           - const: qcom,apq8084
 117
 118       - items:
 119           - enum:
 120               - samsung,s3ve3g
 121           - const: qcom,msm8226
 122
 123       - items:
 124           - enum:
 125               - qcom,msm8960-cdp
 126           - const: qcom,msm8960
 127
 128       - items:
 129           - enum:
 130               - fairphone,fp2
 131               - lge,hammerhead
 132               - sony,xperia-amami
 133               - sony,xperia-castor
 134               - sony,xperia-honami
 135           - const: qcom,msm8974
 136
 137       - items:
 138           - const: qcom,msm8916-mtp/1
 139           - const: qcom,msm8916-mtp
 140           - const: qcom,msm8916
 141
 142       - items:
 143           - enum:
 144               - alcatel,idol347
 145               - longcheer,l8150
 146               - samsung,a3u-eur
 147               - samsung,a5u-eur
 148           - const: qcom,msm8916
 149
 150       - items:
 151           - enum:
 152               - sony,karin_windy
 153               - sony,karin-row
 154               - sony,satsuki-row
 155               - sony,sumire-row
 156               - sony,suzuran-row
 157               - qcom,msm8994
 158           - const: qcom,apq8094
 159
 160       - items:
 161           - const: qcom,msm8996-mtp
 162
 163       - items:
 164           - enum:
 165               - qcom,ipq4019-ap-dk04.1-c3
 166               - qcom,ipq4019-ap-dk07.1-c1
 167               - qcom,ipq4019-ap-dk07.1-c2
 168               - qcom,ipq4019-dk04.1-c1
 169           - const: qcom,ipq4019
 170
 171       - items:
 172           - enum:
 173               - qcom,ipq8064-ap148
 174           - const: qcom,ipq8064
 175
 176       - items:
 177           - enum:
 178               - qcom,ipq8074-hk01
 179               - qcom,ipq8074-hk10-c1
 180               - qcom,ipq8074-hk10-c2
 181           - const: qcom,ipq8074
 182
 183       - items:
 184           - enum:
 185               - qcom,sc7180-idp
 186           - const: qcom,sc7180
 187
 188       - items:
 189           - enum:
 190               - qcom,sc7280-idp
 191               - qcom,sc7280-idp2
 192               - google,piglin
 193               - google,senor
 194           - const: qcom,sc7280
 195
 196       - items:
 197           - enum:
 198               - xiaomi,lavender
 199           - const: qcom,sdm660
 200
 201       - items:
 202           - enum:
 203               - qcom,sdx55-mtp
 204               - qcom,sdx55-telit-fn980-tlb
 205               - qcom,sdx55-t55
 206           - const: qcom,sdx55
 207
 208       - items:
 209           - enum:
 210               - qcom,ipq6018-cp01
 211               - qcom,ipq6018-cp01-c1
 212           - const: qcom,ipq6018
 213
 214       - items:
 215           - enum:
 216               - qcom,sa8155p-adp
 217           - const: qcom,sa8155p
 218
 219       - items:
 220           - enum:
 221               - qcom,sm8150-mtp
 222           - const: qcom,sm8150
 223
 224       - items:
 225           - enum:
 226               - qcom,qrb5165-rb5
 227               - qcom,sm8250-mtp
 228           - const: qcom,sm8250
 229
 230       - items:
 231           - enum:
 232               - qcom,sm8350-hdk
 233               - qcom,sm8350-mtp
 234           - const: qcom,sm8350
 235
 236 additionalProperties: true
 237
 238 ...