AXI Firewall Trips - 2025.2 English - UG1701

Embedded Design Development Using Vitis User Guide (UG1701)
Document ID
UG1701
Release Date
2025-11-20
Version
2025.2 English
The AXI firewall should prevent host hangs. This is why the AXI Protocol Firewall IP is included in all production Vitis platforms. When the firewall trips, one of the first checks to perform is confirming if the host code and kernels are set up to use the same memory banks. The following steps detail how to perform this check.
  1. Use xrt-smi to program the FPGA:
    xrt-smi program -p <xclbin>
    Tip: Refer to xrt-smi Utility in the Vitis Reference Guide (UG1702) for more information on xrt-smi.
  2. Run the xrt-smi examine option to check memory topology:
    xrt-smi examine -r memory -d <bdf>
    In the following example, there are no kernels associated with memory banks:

  3. If the host code expects any DDR banks/PLRAMs to be used, this report should indicate an issue. In this case, it is necessary to check kernel and host code expectations.