# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/soc/bcm/brcm,bcm2835-vchiq.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Broadcom VCHIQ firmware services

maintainers:
  - Nicolas Saenz Julienne <nsaenz@kernel.org>

description:
  The VCHIQ communication channel can be provided by BCM283x and Capri SoCs,
  to communicate with the VPU-side OS services.

properties:
  compatible:
    oneOf:
      - description: BCM2835 based boards
        items:
          - enum:
              - brcm,bcm2835-vchiq

      - description: BCM2836/BCM2837 based boards
        items:
          - enum:
              - brcm,bcm2836-vchiq
          - const: brcm,bcm2835-vchiq

  reg:
    description: Physical base address and length of the doorbell register pair
    minItems: 1

  interrupts:
    description: Interrupt number of the doorbell interrupt
    minItems: 1

required:
  - compatible
  - reg
  - interrupts

additionalProperties: false

examples:
  - |
    mailbox@7e00b840 {
      compatible = "brcm,bcm2835-vchiq";
      reg = <0x7e00b840 0xf>;
      interrupts = <0 2>;
    };

...