Documentation/devicetree/bindings/arm/qcom.yaml

   1 # SPDX-License-Identifier: GPL-2.0
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/bindings/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         msm8916
  32         msm8974
  33         msm8992
  34         msm8994
  35         msm8996
  36         mdm9615
  37         ipq8074
  38         sdm845
  39
  40   The 'board' element must be one of the following strings:
  41
  42         cdp
  43         liquid
  44         dragonboard
  45         mtp
  46         sbc
  47         hk01
  48         qrd
  49
  50   The 'soc_version' and 'board_version' elements take the form of v<Major>.<Minor>
  51   where the minor number may be omitted when it's zero, i.e.  v1.0 is the same
  52   as v1. If all versions of the 'board_version' elements match, then a
  53   wildcard '*' should be used, e.g. 'v*'.
  54
  55   The 'foundry_id' and 'subtype' elements are one or more digits from 0 to 9.
  56
  57   Examples:
  58
  59         "qcom,msm8916-v1-cdp-pm8916-v2.1"
  60
  61   A CDP board with an msm8916 SoC, version 1 paired with a pm8916 PMIC of version
  62   2.1.
  63
  64         "qcom,apq8074-v2.0-2-dragonboard/1-v0.1"
  65
  66   A dragonboard board v0.1 of subtype 1 with an apq8074 SoC version 2, made in
  67   foundry 2.
  68
  69 properties:
  70   compatible:
  71     oneOf:
  72       - items:
  73           - enum:
  74               - qcom,apq8016-sbc
  75           - const: qcom,apq8016
  76
  77       - items:
  78           - enum:
  79               - qcom,apq8064-cm-qs600
  80               - qcom,apq8064-ifc6410
  81           - const: qcom,apq8064
  82
  83       - items:
  84           - enum:
  85               - qcom,apq8074-dragonboard
  86           - const: qcom,apq8074
  87
  88       - items:
  89           - enum:
  90               - qcom,apq8060-dragonboard
  91               - qcom,msm8660-surf
  92           - const: qcom,msm8660
  93
  94       - items:
  95           - enum:
  96               - qcom,apq8084-mtp
  97               - qcom,apq8084-sbc
  98           - const: qcom,apq8084
  99
 100       - items:
 101           - enum:
 102               - qcom,msm8960-cdp
 103           - const: qcom,msm8960
 104
 105       - items:
 106           - enum:
 107               - fairphone,fp2
 108               - lge,hammerhead
 109               - sony,xperia-amami
 110               - sony,xperia-castor
 111               - sony,xperia-honami
 112           - const: qcom,msm8974
 113
 114       - items:
 115           - const: qcom,msm8916-mtp/1
 116           - const: qcom,msm8916-mtp
 117           - const: qcom,msm8916
 118
 119       - items:
 120           - enum:
 121               - longcheer,l8150
 122               - samsung,a3u-eur
 123               - samsung,a5u-eur
 124           - const: qcom,msm8916
 125
 126       - items:
 127           - const: qcom,msm8996-mtp
 128
 129       - items:
 130           - enum:
 131               - qcom,ipq4019-ap-dk04.1-c3
 132               - qcom,ipq4019-ap-dk07.1-c1
 133               - qcom,ipq4019-ap-dk07.1-c2
 134               - qcom,ipq4019-dk04.1-c1
 135           - const: qcom,ipq4019
 136
 137       - items:
 138           - enum:
 139               - qcom,ipq8064-ap148
 140           - const: qcom,ipq8064
 141
 142       - items:
 143           - enum:
 144               - qcom,ipq8074-hk01
 145           - const: qcom,ipq8074
 146
 147 ...