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           - enum:
 139               - alcatel,idol347
 140           - const: qcom,msm8916-mtp/1
 141           - const: qcom,msm8916-mtp
 142           - const: qcom,msm8916
 143
 144       - items:
 145           - enum:
 146               - longcheer,l8150
 147               - samsung,a3u-eur
 148               - samsung,a5u-eur
 149           - const: qcom,msm8916
 150
 151       - items:
 152           - enum:
 153               - sony,karin_windy
 154               - sony,karin-row
 155               - sony,satsuki-row
 156               - sony,sumire-row
 157               - sony,suzuran-row
 158               - qcom,msm8994
 159           - const: qcom,apq8094
 160
 161       - items:
 162           - const: qcom,msm8996-mtp
 163
 164       - items:
 165           - enum:
 166               - qcom,ipq4019-ap-dk04.1-c3
 167               - qcom,ipq4019-ap-dk07.1-c1
 168               - qcom,ipq4019-ap-dk07.1-c2
 169               - qcom,ipq4019-dk04.1-c1
 170           - const: qcom,ipq4019
 171
 172       - items:
 173           - enum:
 174               - qcom,ipq8064-ap148
 175           - const: qcom,ipq8064
 176
 177       - items:
 178           - enum:
 179               - qcom,ipq8074-hk01
 180               - qcom,ipq8074-hk10-c1
 181               - qcom,ipq8074-hk10-c2
 182           - const: qcom,ipq8074
 183
 184       - items:
 185           - enum:
 186               - qcom,sc7180-idp
 187           - const: qcom,sc7180
 188
 189       - items:
 190           - enum:
 191               - qcom,sc7280-idp
 192               - qcom,sc7280-idp2
 193               - google,piglin
 194               - google,senor
 195           - const: qcom,sc7280
 196
 197       - items:
 198           - enum:
 199               - xiaomi,lavender
 200           - const: qcom,sdm660
 201
 202       - items:
 203           - enum:
 204               - qcom,sdx55-mtp
 205               - qcom,sdx55-telit-fn980-tlb
 206               - qcom,sdx55-t55
 207           - const: qcom,sdx55
 208
 209       - items:
 210           - enum:
 211               - qcom,ipq6018-cp01
 212               - qcom,ipq6018-cp01-c1
 213           - const: qcom,ipq6018
 214
 215       - items:
 216           - enum:
 217               - qcom,sa8155p-adp
 218           - const: qcom,sa8155p
 219
 220       - items:
 221           - enum:
 222               - qcom,sm8150-mtp
 223           - const: qcom,sm8150
 224
 225       - items:
 226           - enum:
 227               - qcom,qrb5165-rb5
 228               - qcom,sm8250-mtp
 229           - const: qcom,sm8250
 230
 231       - items:
 232           - enum:
 233               - qcom,sm8350-hdk
 234               - qcom,sm8350-mtp
 235           - const: qcom,sm8350
 236
 237 additionalProperties: true
 238
 239 ...