target/linux/bcm27xx/patches-5.4/950-0517-dt-bindings-clock-Add-a-binding-for-the-RPi-Firmware.patch

   1 From 9d4360fc454056fffa9ca487270aca9179906f5d Mon Sep 17 00:00:00 2001
   2 From: Maxime Ripard <maxime@cerno.tech>
   3 Date: Thu, 13 Feb 2020 17:51:09 +0100
   4 Subject: [PATCH] dt-bindings: clock: Add a binding for the RPi
   5  Firmware clocks
   6
   7 The firmare running on the RPi VideoCore can be used to discover and
   8 change the various clocks running in the BCM2711. Since devices will
   9 need to use them through the DT, let's add a pretty simple binding.
  10
  11 Cc: Michael Turquette <mturquette@baylibre.com>
  12 Cc: Stephen Boyd <sboyd@kernel.org>
  13 Cc: Rob Herring <robh+dt@kernel.org>
  14 Cc: linux-clk@vger.kernel.org
  15 Cc: devicetree@vger.kernel.org
  16 Signed-off-by: Maxime Ripard <maxime@cerno.tech>
  17 ---
  18  .../clock/raspberrypi,firmware-clocks.yaml    | 39 +++++++++++++++++++
  19  1 file changed, 39 insertions(+)
  20  create mode 100644 Documentation/devicetree/bindings/clock/raspberrypi,firmware-clocks.yaml
  21
  22 --- /dev/null
  23 +++ b/Documentation/devicetree/bindings/clock/raspberrypi,firmware-clocks.yaml
  24 @@ -0,0 +1,39 @@
  25 +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
  26 +%YAML 1.2
  27 +---
  28 +$id: http://devicetree.org/schemas/clock/raspberrypi,firmware-clocks.yaml#
  29 +$schema: http://devicetree.org/meta-schemas/core.yaml#
  30 +
  31 +title: RaspberryPi Firmware Clocks Device Tree Bindings
  32 +
  33 +maintainers:
  34 +  - Maxime Ripard <mripard@kernel.org>
  35 +
  36 +properties:
  37 +  "#clock-cells":
  38 +    const: 1
  39 +
  40 +  compatible:
  41 +    const: raspberrypi,firmware-clocks
  42 +
  43 +  raspberrypi,firmware:
  44 +    $ref: /schemas/types.yaml#/definitions/phandle
  45 +    description: >
  46 +      Phandle to the mailbox node to communicate with the firmware.
  47 +
  48 +required:
  49 +  - "#clock-cells"
  50 +  - compatible
  51 +  - raspberrypi,firmware
  52 +
  53 +additionalProperties: false
  54 +
  55 +examples:
  56 +  - |
  57 +    firmware_clocks: firmware-clocks {
  58 +        compatible = "raspberrypi,firmware-clocks";
  59 +        raspberrypi,firmware = <&firmware>;
  60 +        #clock-cells = <1>;
  61 +    };
  62 +
  63 +...