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