This page gives an overview of the bare-metal driver support for the Xilinx® LogiCORE™ IP Dynamic Function eXchange (DFX) AXI Shutdown Manager soft IP.

Introduction

The Dynamic Function eXchange (DFX) AXI Shutdown Manager can be used to make the AXI interfaces between a Reconfigurable Partition and the static logic safe during dynamic reconfiguration. When active, AXI transactions sent to the Reconfigurable Module (RM), and AXI transactions emanating from the RM, are terminated because the RM might not be able to complete them. Failure to complete could cause system deadlock. When inactive, transactions are passed unaltered.

Multiple DFX AXI Shutdown Manager cores can be used within a single design to create a safe working environment for an AXI-based DFX design. The cores can be controlled and queried using signals or an AXI4-Lite interface. They can also connect directly to the DFX Controller IP core using the signal based control interface.

For more information, please refer to the Dfxasm product page which includes links to the official documentation and resource utilization.

Driver Sources

The source code for the driver is included with the Vitis Unified Software Platform installation, as well as being available in the Xilinx Github repository.

Driver Name	Path in Vitis	Path in Github
dfxasm	<Vitis Install Directory>/data/embedded/XilinxProcessorIPLib/drivers/dfxasm_<version>	https://github.com/Xilinx/embeddedsw/tree/master/XilinxProcessorIPLib/drivers/dfxasm

Note: To view the sources for a particular release, use the rel-version tag in github. For example, for the 2024.1 release, the proper version of the code is: https://github.com/Xilinx/embeddedsw/tree/xlnx_rel_v2024.1/XilinxProcessorIPLib/drivers/dfxasm

The driver source code is organized into different folders. The table below shows the dfxasm driver source organization.

Directory	Description
doc	Provides the API and data structure details
data	Driver .tcl , .mdd and .yaml files
examples	Example applications that show how to use the driver features
src	Driver source files, make and cmakelists file

Note: AMD Xilinx embeddedsw build flow has been changed from 2023.2 release to adapt to the new system device tree based flow. For further information, refer to the wiki page Porting embeddedsw components to system device tree (SDT) based flow - Xilinx Wiki - Confluence (atlassian.net).

The .yaml(in data folder) and CMakeLists.txt(in src folder) files are needed for the System Device Tree based flow. The Driver .tcl and .mdd files are for the older build flow which will be deprecated in future.

Driver Implementation

For a full list of features supported by this IP, please refer to the dfx-axi-shutdown-manager

Features

AXI4MM and AXI4Lite support
Optional Signal based or AXI4Lite control
Optional AXI4Lite status (signal status is always available)
Optional termination control

Known Issues and Limitations

None

Example Applications

Refer to the driver examples directory for various example applications that exercise the different features of the driver. Each application is linked in the table below. The following sections describe the usage and expected output of the various applications. These example applications can be imported into the Vitis IDE from the Board Support Package settings tab.

Links to Examples

Examples Path: https://github.com/Xilinx/embeddedsw/tree/xlnx_rel_v2024.1/XilinxProcessorIPLib/drivers/dfxasm/examples

Test Name	Example Source	Description
Set the Dfxasm state	xdfxasm_example	This example demonstrates how to set the Dfxasm state(Dfxasm OFF/ON).

Example Application Usage

Set the Dfxasm state

This example demonstrates how to set the Dfxasm state(Decoupling OFF/ON).

Expected Output

--- Entering main() ---
Successfully ran Dfx Axi Shutdown manager Example
--- Exiting main() ---

Change Log

2024.1

None

2023.2

https://github.com/Xilinx/embeddedsw/blob/xlnx_rel_v2023.2/doc/ChangeLog#L272

Xilinx Wiki

Dfxasm Standalone Driver

Table of Contents