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