Main Content

AXI4-Stream IIO Read (HOST)

Read DDR memory buffer from IP core device into simulation model

Since R2020b

Add-On Required: This feature requires the SoC Blockset Support Package for Xilinx Devices add-on.

  • AXI4-Stream IIO Read icon

Libraries:
SoC Blockset Support Package for Xilinx Devices / Common / Host I/O

Description

The AXI4-Stream IIO Read (HOST) block reads data from the direct-memory-access (DMA) buffer of the specified AXI4-Stream IP core device on a connected Xilinx® SoC device to a running Simulink® model. This block enables low-latency high-throughput data transmission between your simulation model and the IP core on the SoC device.

The AXI4-Stream IIO Read (HOST) block receives a copy of the DDR memory buffer from the SoC device on the host computer. This block uses the Industrial I/O (IIO) library driver to create a network server daemon on the SoC device and client host computer to pass the buffer data copies to the host computer running the simulated portion of the model. This diagram shows the connection between the HDL Coder™ generated IP core, DDR memory buffer, and communication bridge to the running Simulink model.

AXI4-Stream IIO Read diagram

Ports

Output

expand all

This port outputs the N-by-1 vector received from the DMA buffer transfer. Use the Frame size parameter to set the number of samples read for each DMA transfer.

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | ufix128

A flag indicating a valid data frame read from the memory channel.

Dependencies

To enable this port, set the Timeout (sec) parameter to a finite value.

Data Types: Boolean

Parameters

expand all

Enter the name and channel of the IP core on the FPGA as a colon-separated list.

Note

If you are using HDL Coder to generate the IP core, HDL Coder maps the IP core to mwipcore0 and uses channel s2mm0.

Enter the network address of the connected SoC device.

Example: 10.0.0.201

Specify the maximum timeout delay for the DMA stream read.

Select the data type used by the IP core on the device.

Enter the size of the data vector to be read from the IP core device.

The signal data output by the AXI4-Stream IIO Read blocks polls from the DMA buffer using the AXI4-Stream protocol. The Sample time or base-rate of the subsystem specifies the polling rate of the DMA buffer.

When connected to a board, this block writes data directly to the board. When used in a simulation environment, clear this parameter to enable simulation without error due to lack of IIO connection. When cleared, the data displayed in the data output port does not reflect actual data.

Tips

  • To get a list of available IIO device names and channels, open a terminal to the Xilinx Zynq® device, and execute this command: iio_info. This image shows the sample output from the iio_info command.

    command line info from iio_info

Version History

Introduced in R2020b