Dfxasm Standalone Driver

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.   


Table of Contents

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 NamePath in VitisPath 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 2023.2 release, the proper version of the code is: https://github.com/Xilinx/embeddedsw/tree/xlnx_rel_v2023.2/XilinxProcessorIPLib/drivers/dfxasm


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

DirectoryDescription
doc

Provides the API and data structure details

dataDriver .tcl , .mdd and .yaml files
examplesExample applications that show how to use the driver features
srcDriver 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_v2023.2/XilinxProcessorIPLib/drivers/dfxasm/examples

Test NameExample SourceDescription
Set the Dfxasm statexdfxasm_exampleThis 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

2023.2

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


Related Links





© Copyright 2019 - 2022 Xilinx Inc. Privacy Policy