Merge tag 'tags/bcm2835-bindings-2021-12-18' into devicetree/next

Broadcom VCHIQ firmware services

Required properties:

- compatible:	Should be "brcm,bcm2835-vchiq" on BCM2835, otherwise

		"brcm,bcm2836-vchiq".

- reg:		Physical base address and length of the doorbell register pair

- interrupts:	The interrupt number

		  See bindings/interrupt-controller/brcm,bcm2835-armctrl-ic.txt

Example:

mailbox@7e00b840 {

	compatible = "brcm,bcm2835-vchiq";

	reg = <0x7e00b840 0xf>;

	interrupts = <0 2>;

};

# 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>;

    };

...