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           - enum:
 106               - fairphone,fp2
 107               - lge,hammerhead
 108               - sony,xperia-amami
 109               - sony,xperia-castor
 110               - sony,xperia-honami
 111           - const: qcom,msm8974
 112
 113       - items:
 114           - const: qcom,msm8916-mtp/1
 115           - const: qcom,msm8916-mtp
 116           - const: qcom,msm8916
 117
 118       - items:
 119           - const: qcom,msm8996-mtp
 120
 121       - items:
 122           - enum:
 123               - qcom,ipq4019-ap-dk04.1-c3
 124               - qcom,ipq4019-ap-dk07.1-c1
 125               - qcom,ipq4019-ap-dk07.1-c2
 126               - qcom,ipq4019-dk04.1-c1
 127           - const: qcom,ipq4019
 128
 129       - items:
 130           - enum:
 131               - qcom,ipq8064-ap148
 132           - const: qcom,ipq8064
 133
 134       - items:
 135           - enum:
 136               - qcom,ipq8074-hk01
 137           - const: qcom,ipq8074
 138
 139 ...