^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) # SPDX-License-Identifier: GPL-2.0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2) %YAML 1.2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) ---
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) $id: http://devicetree.org/schemas/arm/qcom.yaml#
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5) $schema: http://devicetree.org/meta-schemas/core.yaml#
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) title: QCOM device tree bindings
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9) maintainers:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) - Stephen Boyd <sboyd@codeaurora.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) description: |
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) Some qcom based bootloaders identify the dtb blob based on a set of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) device properties like SoC and platform and revisions of those components.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) To support this scheme, we encode this information into the board compatible
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) string.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) Each board must specify a top-level board compatible string with the following
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) format:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) compatible = "qcom,<SoC>[-<soc_version>][-<foundry_id>]-<board>[/<subtype>][-<board_version>]"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) The 'SoC' and 'board' elements are required. All other elements are optional.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) The 'SoC' element must be one of the following strings:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) apq8016
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) apq8074
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) apq8084
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) apq8096
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) ipq6018
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) ipq8074
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) mdm9615
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) msm8916
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) msm8974
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) msm8992
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) msm8994
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) msm8996
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) sc7180
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) sdm630
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) sdm660
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) sdm845
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) sm8250
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) The 'board' element must be one of the following strings:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) cdp
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) cp01-c1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) dragonboard
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) hk01
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) hk10-c1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) hk10-c2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) idp
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) liquid
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) mtp
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) qrd
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) sbc
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) The 'soc_version' and 'board_version' elements take the form of v<Major>.<Minor>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) where the minor number may be omitted when it's zero, i.e. v1.0 is the same
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) as v1. If all versions of the 'board_version' elements match, then a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) wildcard '*' should be used, e.g. 'v*'.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) The 'foundry_id' and 'subtype' elements are one or more digits from 0 to 9.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) Examples:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68) "qcom,msm8916-v1-cdp-pm8916-v2.1"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70) A CDP board with an msm8916 SoC, version 1 paired with a pm8916 PMIC of version
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71) 2.1.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73) "qcom,apq8074-v2.0-2-dragonboard/1-v0.1"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75) A dragonboard board v0.1 of subtype 1 with an apq8074 SoC version 2, made in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 76) foundry 2.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 77)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 78) properties:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 79) $nodename:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 80) const: "/"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 81) compatible:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 82) oneOf:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 83) - items:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 84) - enum:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 85) - qcom,apq8016-sbc
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 86) - const: qcom,apq8016
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 87)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 88) - items:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 89) - enum:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 90) - qcom,apq8064-cm-qs600
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 91) - qcom,apq8064-ifc6410
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 92) - const: qcom,apq8064
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 93)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 94) - items:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 95) - enum:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 96) - qcom,apq8074-dragonboard
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 97) - const: qcom,apq8074
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 98)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 99) - items:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 100) - enum:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 101) - qcom,apq8060-dragonboard
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 102) - qcom,msm8660-surf
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 103) - const: qcom,msm8660
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 104)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 105) - items:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 106) - enum:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 107) - qcom,apq8084-mtp
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 108) - qcom,apq8084-sbc
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 109) - const: qcom,apq8084
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 110)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 111) - items:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 112) - enum:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 113) - qcom,msm8960-cdp
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 114) - const: qcom,msm8960
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 115)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 116) - items:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 117) - enum:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 118) - fairphone,fp2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 119) - lge,hammerhead
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 120) - sony,xperia-amami
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 121) - sony,xperia-castor
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 122) - sony,xperia-honami
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 123) - const: qcom,msm8974
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 124)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 125) - items:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 126) - const: qcom,msm8916-mtp/1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 127) - const: qcom,msm8916-mtp
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 128) - const: qcom,msm8916
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 129)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 130) - items:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 131) - enum:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 132) - longcheer,l8150
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 133) - samsung,a3u-eur
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 134) - samsung,a5u-eur
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 135) - const: qcom,msm8916
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 136)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 137) - items:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 138) - const: qcom,msm8996-mtp
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 139)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 140) - items:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 141) - enum:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 142) - qcom,ipq4019-ap-dk04.1-c3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 143) - qcom,ipq4019-ap-dk07.1-c1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 144) - qcom,ipq4019-ap-dk07.1-c2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 145) - qcom,ipq4019-dk04.1-c1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 146) - const: qcom,ipq4019
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 147)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 148) - items:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 149) - enum:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 150) - qcom,ipq8064-ap148
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 151) - const: qcom,ipq8064
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 152)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 153) - items:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 154) - enum:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 155) - qcom,ipq8074-hk01
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 156) - qcom,ipq8074-hk10-c1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 157) - qcom,ipq8074-hk10-c2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 158) - const: qcom,ipq8074
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 159)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 160) - items:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 161) - enum:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 162) - qcom,sc7180-idp
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 163) - const: qcom,sc7180
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 164)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 165) - items:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 166) - enum:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 167) - xiaomi,lavender
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 168) - const: qcom,sdm660
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 169)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 170) - items:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 171) - enum:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 172) - qcom,ipq6018-cp01-c1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 173) - const: qcom,ipq6018
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 174)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 175) - items:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 176) - enum:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 177) - qcom,qrb5165-rb5
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 178) - qcom,sm8250-mtp
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 179) - const: qcom,sm8250
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 180)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 181) additionalProperties: true
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 182)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 183) ...