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
  49   The 'soc_version' and 'board_version' elements take the form of v<Major>.<Minor>
  50   where the minor number may be omitted when it's zero, i.e.  v1.0 is the same
  51   as v1. If all versions of the 'board_version' elements match, then a
  52   wildcard '*' should be used, e.g. 'v*'.
  53
  54   The 'foundry_id' and 'subtype' elements are one or more digits from 0 to 9.
  55
  56   Examples:
  57
  58         "qcom,msm8916-v1-cdp-pm8916-v2.1"
  59
  60   A CDP board with an msm8916 SoC, version 1 paired with a pm8916 PMIC of version
  61   2.1.
  62
  63         "qcom,apq8074-v2.0-2-dragonboard/1-v0.1"
  64
  65   A dragonboard board v0.1 of subtype 1 with an apq8074 SoC version 2, made in
  66   foundry 2.
  67
  68 properties:
  69   compatible:
  70     oneOf:
  71       - items:
  72           - enum:
  73               - qcom,apq8016-sbc
  74           - const: qcom,apq8016
  75
  76       - items:
  77           - enum:
  78               - qcom,apq8064-cm-qs600
  79               - qcom,apq8064-ifc6410
  80           - const: qcom,apq8064
  81
  82       - items:
  83           - enum:
  84               - qcom,apq8074-dragonboard
  85           - const: qcom,apq8074
  86
  87       - items:
  88           - enum:
  89               - qcom,apq8060-dragonboard
  90               - qcom,msm8660-surf
  91           - const: qcom,msm8660
  92
  93       - items:
  94           - enum:
  95               - qcom,apq8084-mtp
  96               - qcom,apq8084-sbc
  97           - const: qcom,apq8084
  98
  99       - items:
 100           - enum:
 101               - qcom,msm8960-cdp
 102           - const: qcom,msm8960
 103
 104       - items:
 105           - const: qcom,msm8916-mtp/1
 106           - const: qcom,msm8916-mtp
 107           - const: qcom,msm8916
 108
 109       - items:
 110           - const: qcom,msm8996-mtp
 111
 112       - items:
 113           - const: qcom,ipq4019
 114
 115       - items:
 116           - enum:
 117               - qcom,ipq8064-ap148
 118           - const: qcom,ipq8064
 119
 120       - items:
 121           - enum:
 122               - qcom,ipq8074-hk01
 123           - const: qcom,ipq8074
 124
 125 ...