target/linux/ipq806x/patches-4.19/0034-0009-dt-bindings-arm-Document-qcom-kpss-gcc.patch

   1 From 40e5ddf4f84869815129551f4a8cfc2c223ebeae Mon Sep 17 00:00:00 2001
   2 From: Stephen Boyd <sboyd@codeaurora.org>
   3 Date: Tue, 14 Aug 2018 17:42:28 +0530
   4 Subject: [PATCH 09/12] dt-bindings: arm: Document qcom,kpss-gcc
   5
   6 The ACC and GCC regions present in KPSSv1 contain registers to
   7 control clocks and power to each Krait CPU and L2. Documenting
   8 the bindings here.
   9
  10 Reviewed-by: Rob Herring <robh@kernel.org>
  11 Signed-off-by: Stephen Boyd <sboyd@codeaurora.org>
  12 Signed-off-by: Sricharan R <sricharan@codeaurora.org>
  13 Tested-by: Craig Tatlor <ctatlor97@gmail.com>
  14 Signed-off-by: Stephen Boyd <sboyd@kernel.org>
  15 ---
  16  .../bindings/arm/msm/qcom,kpss-acc.txt        | 19 ++++++++
  17  .../bindings/arm/msm/qcom,kpss-gcc.txt        | 44 +++++++++++++++++++
  18  2 files changed, 63 insertions(+)
  19  create mode 100644 Documentation/devicetree/bindings/arm/msm/qcom,kpss-gcc.txt
  20
  21 --- a/Documentation/devicetree/bindings/arm/msm/qcom,kpss-acc.txt
  22 +++ b/Documentation/devicetree/bindings/arm/msm/qcom,kpss-acc.txt
  23 @@ -21,10 +21,29 @@ PROPERTIES
  24                     the register region. An optional second element specifies
  25                     the base address and size of the alias register region.
  26
  27 +- clocks:
  28 +        Usage: required
  29 +        Value type: <prop-encoded-array>
  30 +        Definition: reference to the pll parents.
  31 +
  32 +- clock-names:
  33 +        Usage: required
  34 +        Value type: <stringlist>
  35 +        Definition: must be "pll8_vote", "pxo".
  36 +
  37 +- clock-output-names:
  38 +       Usage: optional
  39 +       Value type: <string>
  40 +       Definition: Name of the output clock. Typically acpuX_aux where X is a
  41 +                   CPU number starting at 0.
  42 +
  43  Example:
  44
  45         clock-controller@2088000 {
  46                 compatible = "qcom,kpss-acc-v2";
  47                 reg = <0x02088000 0x1000>,
  48                       <0x02008000 0x1000>;
  49 +               clocks = <&gcc PLL8_VOTE>, <&gcc PXO_SRC>;
  50 +               clock-names = "pll8_vote", "pxo";
  51 +               clock-output-names = "acpu0_aux";
  52         };
  53 --- /dev/null
  54 +++ b/Documentation/devicetree/bindings/arm/msm/qcom,kpss-gcc.txt
  55 @@ -0,0 +1,44 @@
  56 +Krait Processor Sub-system (KPSS) Global Clock Controller (GCC)
  57 +
  58 +PROPERTIES
  59 +
  60 +- compatible:
  61 +       Usage: required
  62 +       Value type: <string>
  63 +       Definition: should be one of the following. The generic compatible
  64 +                       "qcom,kpss-gcc" should also be included.
  65 +                       "qcom,kpss-gcc-ipq8064", "qcom,kpss-gcc"
  66 +                       "qcom,kpss-gcc-apq8064", "qcom,kpss-gcc"
  67 +                       "qcom,kpss-gcc-msm8974", "qcom,kpss-gcc"
  68 +                       "qcom,kpss-gcc-msm8960", "qcom,kpss-gcc"
  69 +
  70 +- reg:
  71 +       Usage: required
  72 +       Value type: <prop-encoded-array>
  73 +       Definition: base address and size of the register region
  74 +
  75 +- clocks:
  76 +       Usage: required
  77 +       Value type: <prop-encoded-array>
  78 +       Definition: reference to the pll parents.
  79 +
  80 +- clock-names:
  81 +       Usage: required
  82 +       Value type: <stringlist>
  83 +       Definition: must be "pll8_vote", "pxo".
  84 +
  85 +- clock-output-names:
  86 +       Usage: required
  87 +       Value type: <string>
  88 +       Definition: Name of the output clock. Typically acpu_l2_aux indicating
  89 +                   an L2 cache auxiliary clock.
  90 +
  91 +Example:
  92 +
  93 +       l2cc: clock-controller@2011000 {
  94 +               compatible = "qcom,kpss-gcc-ipq8064", "qcom,kpss-gcc";
  95 +               reg = <0x2011000 0x1000>;
  96 +               clocks = <&gcc PLL8_VOTE>, <&gcc PXO_SRC>;
  97 +               clock-names = "pll8_vote", "pxo";
  98 +               clock-output-names = "acpu_l2_aux";
  99 +       };