axi_lite_mailbox implements a hardware mailbox, where two AXI4-Lite slave ports are connected to each other over two FIFOs. Data written on port 0 is made available on the read data at port 1 and vice versa.
The module features an interrupt for each port which can be enabled with the IRQEN register. Interrupts can be configured to trigger depending on the fill levels of the read (RIRQT) and write (WIRQT) FIFO. It is further possible to trigger an interrupt on an mailbox error condition as defined by the ERROR register.
This table describes the parameters of the module.
| Name | Type | Description |
|---|---|---|
MailboxDepth |
int unsigned |
The depth of the FIFOs between the two slave ports, min 32'd2 |
IrqEdgeTrig |
bit |
Interrupts trigger mode. [0]: level trigger [1]: edge trigger |
IrqActHigh |
bit |
Interrupts polarity. [0]: active low / falling edge [1]: active high / rising edge |
AxiAddrWidth |
int unsigned |
The AXI4-Lite address width on the AW and AR channels |
AxiDataWidth |
int unsigned |
The AXI4-Lite data width on the W and R channels |
req_lite_t |
type |
In accordance with the AXI_LITE_TYPEDEF_REQ_T macro |
resp_lite_t |
type |
In accordance with the AXI_LITE_TYPEDEF_RESP_T macro |
This table describes the ports of the module.
| Name | Type | Description |
|---|---|---|
clk_i |
input logic |
clock |
rst_ni |
input logic |
asynchronous reset active low |
test_i |
input logic |
testmode enable |
slv_reqs_i |
input req_lite_t [1:0] |
requests of the two AXI4-Lite ports |
slv_resps_o |
output resp_lite_t [1:0] |
responses of the two AXI4-Lite ports |
irq_o |
output logic [1:0] |
interrupt output for each port |
base_addr_i |
input addr_t [1:0] |
base address for each port |
This table describes the type of register and the respective address mapping. The address depends on the parameter AxiDataWidth and the respective base_addr_i[*] of the port associated to the index.
There are two example columns given for the resulting address for a base_addr_i[*] of '0 and AxiDataWidth of 32 and 64 bit.
Each register has one of the access types R/W = read and write, R = read-only and W = write-only. Writes to read-only and reads from write-only registers are responded by an axi_pkg::RESP_SLVERR.
| Base Address + Offset*AxiDataWidth/8 | Address for AxiDataWidth = 32 |
Address for AxiDataWidth = 64 |
Register Name | Access Type | Default Value | Description |
|---|---|---|---|---|---|---|
| base_addr_i + 0*AxiDataWidth/8 | 0x00 | 0x00 | MBOXW | W | N/A | Write data address |
| base_addr_i + 1*AxiDataWidth/8 | 0x04 | 0x08 | MBOXR | R | N/A | Read data address |
| base_addr_i + 2*AxiDataWidth/8 | 0x08 | 0x10 | STATUS | R | 0x1 |
Status flags of the mailbox |
| base_addr_i + 3*AxiDataWidth/8 | 0x0C | 0x18 | ERROR | R | 0x0 |
Error flags |
| base_addr_i + 4*AxiDataWidth/8 | 0x10 | 0x20 | WIRQT | R/W | 0x0 |
Write data interrupt threshold |
| base_addr_i + 5*AxiDataWidth/8 | 0x14 | 0x28 | RIRQT | R/W | 0x0 |
Read data interrupt threshold |
| base_addr_i + 6*AxiDataWidth/8 | 0x18 | 0x30 | IRQS | R/W | 0x0 |
Interrupt status register |
| base_addr_i + 7*AxiDataWidth/8 | 0x1C | 0x38 | IRQEN | R/W | 0x0 |
Interrupt enable register |
| base_addr_i + 8*AxiDataWidth/8 | 0x20 | 0x40 | IRQP | R | 0x0 |
Interrupt pending register |
| base_addr_i + 9*AxiDataWidth/8 | 0x24 | 0x48 | CRTL | R/W | 0x0 |
Module control register |
Mailbox write register. Write here to send data to the other slave port. A interrupt request will be raised when the fill pointer of the FIFO surpasses the WIRQT Register (if enabled).
Writes are ignored when the FIFO is full and a axi_pkg::RESP_SLVERR is returned. Additionally the corresponding bit in the ERROR Register is set.
Mailbox read register. Read here to receive data from the other slave port. A interrupt request will be raised when the fill pointer of the FIFO surpasses the RIRQT Register (if enabled).
When the FIFO is empty, the read response axi_pkg::RESP_SLVERR is returned. Additionally the corresponding bit in the ERROR Register is set.
Mailbox status register. This read-only register holds the current status of the mailbox.
| Bit(s) | Name | Access Type | Reset Value | Description |
|---|---|---|---|---|
AxiDataWidth-1:4 |
Reserved | Reserved | ||
3 |
RFIFOL | R | 1'b0 |
Read FIFO level is higher than the threshold set in RIRQT [0]: Write FIFO level is less or equal to the threshold. [1]: Read FIFO level is higher than the threshold. |
2 |
WFIFOL | R | 1'b0 |
Write FIFO level is higher than the threshold set in WIRQT [0]: Write FIFO level is less or equal to the threshold. [1]: Write FIFO level is higher than the threshold. |
1 |
Full | R | 1'b0 |
Write FIFO is full and subsequent writes to mailbox are ignored [0]: Space for write data. [1]: No space for data, writes are ignored and responded with axi_pkg::RESP_SLVERR. |
0 |
Empty | R | 1'b1 |
Read FIFO is empty [0]: Data is available. [1]: No available data, reads respond with axi_pkg::RESP_SLVERR. |
Mailbox error register. This read-only register contains information if a read occurred on an empty FIFO or a write occurred on a full FIFO. This register is cleared on read.
| Bit(s) | Name | Access Type | Reset Value | Description |
|---|---|---|---|---|
AxiDataWidth-1:2 |
Reserved | Reserved | ||
1 |
Write Error | R | 1'b0 |
Attempted write to a full mailbox. [0]: No Error. [1]: Mailbox write error. |
0 |
Read Error | R | 1'b1 |
Attempted read from an empty mailbox [0]: No Error. [1]: Mailbox read error. |
Write interrupt request threshold register. When the usage pointer of the FIFO connected to the W channel exceeds this value, a write threshold IRQ is triggered and the corresponding STATUS register bit is set.
When a value larger than or equal to the MailboxDepth parameter is written to this register, it gets reduced to MailboxDepth - 1 to ensure an IRQ is triggered when the write FIFO is full.
| Bit(s) | Name | Access Type | Reset Value | Description |
|---|---|---|---|---|
AxiDataWidth-1:$clog2(MailboxDepth) |
Reserved | Reserved | ||
$clog2(MailboxDepth)-1:0 |
WIRQT |
R/W | '0 |
Write IRQ threshold level |
Read interrupt request threshold register. When the fill pointer of the FIFO connected to the R channel exceeds this value, a read threshold IRQ is triggered and the corresponding STATUS register bit is set.
When a value larger than or equal to the MailboxDepth parameter is written to this register, it gets reduced to MailboxDepth - 1 to ensure an IRQ is triggered when the read FIFO is full.
| Bit(s) | Name | Access Type | Reset Value | Description |
|---|---|---|---|---|
AxiDataWidth-1:$clog2(MailboxDepth) |
Reserved | Reserved | ||
$clog2(MailboxDepth)-1:0 |
RIRQT |
R/W | '0 |
Read IRQ threshold level |
Interrupt request status register. This register holds the current interrupt status of this slave port. There are three types of interrupts which can be enabled in the IRQEN register. The bits inside this register are sticky and get set when the trigger condition is fulfilled. This register has to be cleared explicitly by acknowledging the interrupt request status described below. This register will also get updated when the respective interrupt is not enabled.
EIRQ: Error interrupt request, is set to high when there was a read from an empty mailbox or a write to a full mailbox.RTIRQ: Read threshold interrupt request, is set to high when the fill pointer of the FIFO connected to the R channel is higher than the threshold set inRIRQT.WTIRQ: Write threshold interrupt request, is set to high when the fill pointer of the FIFO connected to the W channel is higher than the threshold set inWIRQT. To acknowledge an interrupt request write a1'b1to the corresponding bit described in following table.
| Bit(s) | Name | Access Type | Reset Value | Description |
|---|---|---|---|---|
AxiDataWidth-1:3 |
Reserved | Reserved | ||
2 |
EIRQ |
R/W | 1'b0 |
On read: [0]: No interrupt request [1]: Error on mailbox access On write: [0]: No acknowledge [1]: Acknowledge and clear interrupt request |
1 |
RTIRQ |
R/W | 1'b0 |
On read: [0]: No interrupt request [1]: Usage level threshold in read mailbox exceeded On write: [0]: No acknowledge [1]: Acknowledge and clear interrupt request |
0 |
WTIRQ |
R/W | 1'b0 |
On read: [0]: No interrupt request [1]: Usage level threshold in write mailbox exceeded On write: [0]: No acknowledge [1]: Acknowledge and clear interrupt request |
Interrupt request enable register. Here the interrupts from IRQS can be enabled by setting the corresponding bit in the following table.
| Bit(s) | Name | Access Type | Reset Value | Description |
|---|---|---|---|---|
AxiDataWidth-1:3 |
Reserved | Reserved | ||
2 |
EIRQ |
R/W | 1'b0 |
[0]: Error IRQ disabled [1]: Error IRQ enabled |
1 |
RTIRQ |
R/W | 1'b0 |
[0]: Read threshold IRQ disabled [1]: Read threshold IRQ enabled |
0 |
WTIRQ |
R/W | 1'b0 |
[0]: Write threshold IRQ disabled [1]: Write threshold IRQ enabled |
Interrupt request pending register. This read-only register holds the pending interrupts for this slave port. It is generated by the bitwise AND of the IRQS and IRQEN registers. An interrupt gets triggered by the OR of the bits of this register.
| Bit(s) | Name | Access Type | Reset Value | Description |
|---|---|---|---|---|
AxiDataWidth-1:3 |
Reserved | Reserved | ||
2 |
EIRQ |
R | 1'b0 |
[0]: No error IRQ pending [1]: Error IRQ pending |
1 |
RTIRQ |
R | 1'b0 |
[0]: No read threshold IRQ pending [1]: Read threshold IRQ pending |
0 |
WTIRQ |
R | 1'b0 |
[0]: No write threshold IRQ pending [1]: Write threshold IRQ pending |
Mailbox control register. Here the FIFOs can be cleared from each interface. The flush signal of each FIFO is the OR combination of the respective bit of this register at each slave port. On register write, the FIFO is cleared and the register is reset.
| Bit(s) | Name | Access Type | Reset Value | Description |
|---|---|---|---|---|
AxiDataWidth-1:2 |
Reserved | Reserved | ||
1 |
RTIRQ |
W | 1'b0 |
Flush the read FIFO for this port |
0 |
WTIRQ |
W | 1'b0 |
Flush the write FIFO for this port |