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
13properties:
14  compatible:
15    items:
16      - const: raspberrypi,bcm2835-firmware
17      - const: simple-bus
18
19  mboxes:
20    $ref: '/schemas/types.yaml#/definitions/phandle'
21    description: |
22      Phandle to the firmware device's Mailbox.
23      (See: ../mailbox/mailbox.txt for more information)
24
25  clocks:
26    type: object
27
28    properties:
29      compatible:
30        const: raspberrypi,firmware-clocks
31
32      "#clock-cells":
33        const: 1
34        description: >
35          The argument is the ID of the clocks contained by the
36          firmware messages.
37
38    required:
39      - compatible
40      - "#clock-cells"
41
42    additionalProperties: false
43
44required:
45  - compatible
46  - mboxes
47
48examples:
49  - |
50    firmware {
51        compatible = "raspberrypi,bcm2835-firmware", "simple-bus";
52        mboxes = <&mailbox>;
53
54        firmware_clocks: clocks {
55            compatible = "raspberrypi,firmware-clocks";
56            #clock-cells = <1>;
57        };
58    };
59...
60