1# SPDX-License-Identifier: GPL-2.0
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/arm/bcm/raspberrypi,bcm2835-firmware.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Raspberry Pi VideoCore firmware driver
8
9maintainers:
10  - Eric Anholt <eric@anholt.net>
11  - Stefan Wahren <wahrenst@gmx.net>
12
13select:
14  properties:
15    compatible:
16      contains:
17        const: raspberrypi,bcm2835-firmware
18
19  required:
20    - compatible
21
22properties:
23  compatible:
24    items:
25      - const: raspberrypi,bcm2835-firmware
26      - const: simple-bus
27
28  mboxes:
29    $ref: '/schemas/types.yaml#/definitions/phandle'
30    description: |
31      Phandle to the firmware device's Mailbox.
32      (See: ../mailbox/mailbox.txt for more information)
33
34  clocks:
35    type: object
36
37    properties:
38      compatible:
39        const: raspberrypi,firmware-clocks
40
41      "#clock-cells":
42        const: 1
43        description: >
44          The argument is the ID of the clocks contained by the
45          firmware messages.
46
47    required:
48      - compatible
49      - "#clock-cells"
50
51    additionalProperties: false
52
53required:
54  - compatible
55  - mboxes
56
57examples:
58  - |
59    firmware {
60        compatible = "raspberrypi,bcm2835-firmware", "simple-bus";
61        mboxes = <&mailbox>;
62
63        firmware_clocks: clocks {
64            compatible = "raspberrypi,firmware-clocks";
65            #clock-cells = <1>;
66        };
67    };
68...
69