# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/hisilicon,hi3660-mbox.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Hisilicon Hi3660 Mailbox Controller

maintainers:
  - Wei Xu <xuwei5@hisilicon.com>

description:
  Hisilicon Hi3660 mailbox controller supports up to 32 channels.  Messages
  are passed between processors, including application & communication
  processors, MCU, HIFI, etc.  Each channel is unidirectional and accessed
  by using MMIO registers; it supports maximum to 8 words message.

properties:
  compatible:
    items:
      - const: hisilicon,hi3660-mbox

  reg:
    maxItems: 1

  interrupts:
    description: Mailbox interrupt vectors for message processing
    maxItems: 2

  '#mbox-cells':
    description: >
      The cells content are as follows:
        - Channel number
        - Remote destination interrupt vector
        - Local ack interrupt vector
    const: 3

required:
  - compatible
  - reg
  - interrupts
  - '#mbox-cells'

additionalProperties: false

examples:
  - |
    #include <dt-bindings/interrupt-controller/arm-gic.h>
    #include <dt-bindings/interrupt-controller/irq.h>

    mailbox@e896b000 {
        compatible = "hisilicon,hi3660-mbox";
        reg = <0xe896b000 0x1000>;
        interrupts = <GIC_SPI 0xc0 IRQ_TYPE_LEVEL_HIGH>,
                     <GIC_SPI 0xc1 IRQ_TYPE_LEVEL_HIGH>;
        #mbox-cells = <3>;
    };