AXI Firewall Trips - 2025.2 English

AXI Firewall Trips - 2025.2 English - UG1700

Data Center Acceleration Using Vitis User Guide (UG1700)

Document ID

UG1700

Release Date

2025-11-20

Version

2025.2 English

The AXI firewall prevents 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.

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.
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:
If the host code expects any DDR banks/PLRAMs to be used, this report must indicate an issue. In this case, it is necessary to check kernel and host code expectations. If the host code is using the AMD OpenCL extensions, it is necessary to check which DDR banks must be used by the kernel. These must match the connectivity.sp options specified as discussed in Mapping Kernel Ports to Memory.