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