Introduction
This page gives an overview of mailbox driver which is available as part of the Xilinx Vivado and SDK distribution.
In a multiprocessor environment, the processors need to communicate data with each other. The easiest method is to set up inter-processor communication through a mailbox. The Mailbox core features a bidirectional communication channel between two processors

Source Path for the driver
https://github.com/Xilinx/embeddedsw/tree/master/XilinxProcessorIPLib/drivers/mbox

How to enable

Driver source code is organized into different folders. Below diagram shows the axivdma driver source organization
Mbox
|
-- Doc - Provides the API and data structure details
|
- Examples - Reference application to show how to use the driver APIs and calling sequence
|
- Source - Driver source files

Features Supported

Controller Features

  • Supports AXI4-Lite and AXI4-Stream independently on each of the ports
  • Configurable depth of mailbox
  • Configurable interrupt thresholds and maskable interrupts
  • Configurable synchronous or asynchronous operation
  • Bidirectional communication

Standalone Driver Supported Features

The Mailbox driver support the below things.
  • Supports AXI4-Lite and AXI4-Stream independently on each of the ports
  • Configurable depth of mailbox
  • Configurable interrupt thresholds and maskable interrupts
  • Configurable synchronous or asynchronous operation
  • Bidirectional communication

Features not supported
  • None


Test cases


Mbox example
Mailbox is used can be tested by selecting xmbox_example.c. It is a simple example of initializing the core and passing data from one processor to another
Refer to https://github.com/Xilinx/embeddedsw/blob/master/XilinxProcessorIPLib/drivers/mbox/examples/readme.txtor more information.

Mbox intr example
Mailbox is used can be tested by selecting xmbox_example.c. It is a simple example of initializing the core and passing data from one processor to another in interrupt mode.
Refer to https://github.com/Xilinx/embeddedsw/blob/master/XilinxProcessorIPLib/drivers/mbox/examples/readme.txtor more information.

Known Issues/Limitations

  • None

Change log

2017.1
  • None
2017.2
  • None
2017.3
  • None
2017.4
  • None

Related Links