Set Up AXI Manager

Note

MATLAB^® AXI master has been renamed to AXI manager. In the software and documentation, the terms "manager" and "subordinate" replace "master" and "slave," respectively.

Access on-board memory locations from MATLAB or Simulink^® over Ethernet (programmable logic (PL) Ethernet or processing system (PS) Ethernet), JTAG, PCI Express^®, or USB Ethernet interface.

Set Up AXI Manager for JTAG, PCI Express, or PL Ethernet

To access on-board memory locations over JTAG, PCI Express, or PL Ethernet interface, you must include the AXI manager IP in your FPGA design. This IP connects to subordinate memory locations on the board. The IP also responds to read and write commands from MATLAB or Simulink.

Integrate AXI Manager IP in FPGA Design

To set up the AXI manager IP for access from MATLAB or Simulink, follow these setup steps:

1. Add the path for the AXI manager IP files to your project using the setupAXIManagerForQuartus or setupAXIManagerForVivado function.

2. Open Quartus^® or Vivado^®, and from the IP Catalog select the AXI manager IP in your FPGA design.

   • When using JTAG as a physical connection, select AXI Manager.

   • When using PCIe as a physical connection, select PCIe AXI Manager and add it to your project.

   • When using PL Ethernet as a physical connection, select UDP AXI Manager and Ethernet MAC Hub and add them to your project.

3. In your FPGA project, specify which addresses the AXI manager IP is allowed to access.

   Note

   Intel^® only — The AXI manager IP supports AXI4 Lite, AXI4, and Altera^® Avalon slave memory locations. The FPGA interconnect automatically converts AXI4 transactions to the protocol of each address.

4. Compile your FPGA project, including the AXI manager IP.

5. Connect your FPGA board to your host computer using a physical cable (Ethernet, JTAG, or PCI Express cable).

6. Program the FPGA with your compiled design.

Note

Alternatively, you can perform these steps in the HDL Coder™ guided workflow by using a sample reference design, such as the ones included in these examples: Use IP Core Generation to Access DUT Registers on Pure Intel FPGA Devices (HDL Coder) and Use IP Core Generation to Access DUT Registers on Pure AMD FPGA Devices (HDL Coder).

After loading the design on your FPGA, you can access memory-mapped locations on the board.

To access the board from MATLAB, create an aximanager object and use the readmemory and writememory methods to read and write memory-mapped locations on the board.

To access the board from Simulink, create a Simulink model and include AXI Manager Write and AXI Manager Read in it. Configure the blocks to read and write memory-mapped locations on the board. For more information, see Use Simulink to Access FPGA Locations.

Set Up AXI Manager for PS Ethernet or USB Ethernet

To access on-board memory locations over PS Ethernet or USB Ethernet interface, you need not to include an AXI manager IP in your FPGA design. The FPGA design directly responds to read and write commands from MATLAB or Simulink.

Note

AXI manager supports the PS Ethernet and USB Ethernet interfaces for only the AMD^® Zynq^® devices.

For a PS Ethernet interface, follow the setup steps in Ethernet AXI Manager for AMD Zynq SoC Devices. For a USB Ethernet interface, follow the setup steps in USB Ethernet AXI Manager.

JTAG Considerations

When using JTAG as a physical connection to your board, you might have additional IPs that use the same JTAG connection. Such IPs include Intel SignalTap II or AMD Vivado Logic Analyzer cores. However, only one of these applications can use the JTAG cable at a time. You must release the aximanager object to return the JTAG resource for use by other applications.

However, the nonblocking capture mode enables you to simultaneously use FPGA data capture and AXI manager, which share a common JTAG interface. In this capture mode, you do not need to close or release the JTAG resource to switch between FPGA data capture and AXI manager. For more information, see Simultaneous Use of FPGA Data Capture and AXI Manager.

The most common conflicting use of the JTAG cable is to reprogram the FPGA. You must stop any FPGA data capture or AXI manager JTAG connection before you can use the cable to program the FPGA.

The maximum data rate between host computer and FPGA is limited by the JTAG clock frequency. For Intel boards, the JTAG clock frequency is 12 MHz or 24 MHz. For AMD boards, the JTAG clock frequency is 33 MHz or 66 MHz. The JTAG frequency depends on the type of cable and the maximum clock frequency supported by the FPGA board.