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

title: Hisilicon Hi6220 Mailbox Controller

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

description:
  Hisilicon Hi6220 mailbox supports up to 32 channels. Each channel is
  unidirectional with a maximum message size of 8 words. I/O is performed using
  register access (there is no DMA) and the cell raises an interrupt when
  messages are received.

properties:
  compatible:
    const: hisilicon,hi6220-mbox

  reg:
    items:
      - description: IPC registers
      - description: Shared buffer for mailbox slots

  interrupts:
    maxItems: 1

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

  hi6220,mbox-tx-noirq:
    description:
      Flag to request MCU to enable automatic idle flag mode instead of IRQ for
      TX completion.
    type: boolean

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@f7510000 {
        compatible = "hisilicon,hi6220-mbox";
        reg = <0xf7510000 0x1000>,
              <0x06dff800 0x0800>;
        interrupts = <GIC_SPI 94 IRQ_TYPE_LEVEL_HIGH>;
        #mbox-cells = <3>;
    };