dfxasm
Xilinx Vitis Drivers API Documentation
Dfxasm_v1_0

Macros

#define XDfxasm_ReadReg(Address)   Xil_In32(Address)
 This macro reads a value from the given register. More...
 
#define XDfxasm_WriteReg(Address, Data)   Xil_Out32(Address, (u32)(Data))
 This macro writes a value to the given register. More...
 

Functions

s32 XDfxasm_CfgInitialize (XDfxasm *InstancePtr, XDfxasm_Config *ConfigPtr, UINTPTR EffectiveAddress)
 This function initializes a XDfxasm instance/driver. More...
 
void XDfxasm_SetState (XDfxasm *InstancePtr, XDfxasm_State ShutdownValue)
 This function is used to set shutdown manager in shutdown or pass through mode. More...
 
u32 XDfxasm_GetState (XDfxasm *InstancePtr)
 This function is used to read the state of the shutdown manager. More...
 
XDfxasm_Config * XDfxasm_LookupConfig (u16 DeviceId)
 This function looks for the device configuration based on the unique device ID. More...
 

Register Offset

#define XDFX_ASM_CTRL_OFFSET   (0x000)
 Control register Offset and status register is also mappped to same address as Control register. More...
 

Register Mask

#define XDFX_ASM_CTRL_SHUTDOWN_MASK   (0x0000000F)
 Shutdown manager state mask. More...
 

Macro Definition Documentation

#define XDFX_ASM_CTRL_OFFSET   (0x000)

Control register Offset and status register is also mappped to same address as Control register.

Referenced by XDfxasm_GetState(), and XDfxasm_SetState().

#define XDFX_ASM_CTRL_SHUTDOWN_MASK   (0x0000000F)

Shutdown manager state mask.

Referenced by XDfxasm_GetState().

#define XDfxasm_ReadReg (   Address)    Xil_In32(Address)

This macro reads a value from the given register.

Parameters
Addressis the address of the register to read from.
Returns
The 32-bit value read from register.
Note
None.

Referenced by XDfxasm_GetState().

#define XDfxasm_WriteReg (   Address,
  Data 
)    Xil_Out32(Address, (u32)(Data))

This macro writes a value to the given register.

Parameters
Addressis the address of the register to write to.
Datais the 32-bit value to write to the register.
Returns
None.
Note
None.

Referenced by XDfxasm_SetState().

Function Documentation

s32 XDfxasm_CfgInitialize ( XDfxasm InstancePtr,
XDfxasm_Config *  ConfigPtr,
UINTPTR  EffectiveAddress 
)

This function initializes a XDfxasm instance/driver.

Parameters
InstancePtris a pointer to the XDfxasm instance.
ConfigPtrpoints to the XDfxasm device configuration structure.
EffectiveAddressis the device base address in the virtual memory address space. If the address translation is not used then the physical address is passed.
Returns
  • XST_SUCCESS if initialization was successful.
Note
None.

Set some default values for instance data, don't indicate the device is ready to use until everything has been initialized successfully.

References XDfxasm::Config, and XDfxasm::IsReady.

Referenced by XDfxasm_Example().

u32 XDfxasm_GetState ( XDfxasm InstancePtr)

This function is used to read the state of the shutdown manager.

Parameters
InstancePtris a pointer to the XDfxasm instance.
Returns
Returns shutdown manager state and its bit significance is as follows. -BIT0 - 0 Entry to Pass Through mode has been requested
  • 1 Entry to Shutdown mode has been requested -BIT1 - 0 The read or the write channel (or both) are in the Pass Through mode
  • 1 Both the read and write channels are in the Shutdown Mode -BIT2 - 0 The write channel is in the Pass Through mode
  • 1 The write channel is in the Shutdown Mode -BIT3 - 0 The read channel is in the Pass Through mode
  • 1 The read channel is in the Shutdown Mode
Note
None.

References XDfxasm::Config, XDfxasm::IsReady, XDFX_ASM_CTRL_OFFSET, XDFX_ASM_CTRL_SHUTDOWN_MASK, and XDfxasm_ReadReg.

Referenced by XDfxasm_TestState().

XDfxasm_Config* XDfxasm_LookupConfig ( u16  DeviceId)

This function looks for the device configuration based on the unique device ID.

The table XDfxasm_ConfigTable[] contains the configuration information for each device in the system.

Parameters
DeviceIdis the unique device ID of the device being looked up.
Returns
A pointer to the configuration table entry corresponding to the given device ID, or NULL if no match is found.
Note
None.

Referenced by XDfxasm_Example().

void XDfxasm_SetState ( XDfxasm InstancePtr,
XDfxasm_State  ShutdownValue 
)

This function is used to set shutdown manager in shutdown or pass through mode.

Parameters
InstancePtris a pointer to the XDfxasm instance.
ShutdownValueis to set shutdown manager in shutdown or pass through mode. Value can be either 0 or 1. Values are
  • XDFX_ASM_PASSTHROUGH_MODE(0) if in passthrough mode
    • XDFX_ASM_SHUTDOWN_MODE(1) if in shutdown mode
Returns
None
Note
When Shutdown manager is in shutdown mode it blocks the axi traffic thats going to the Reconfigurable partition from static logic while Partial Reconfiguration occurs.

References XDfxasm::Config, XDfxasm::IsReady, XDFX_ASM_CTRL_OFFSET, and XDfxasm_WriteReg.

Referenced by XDfxasm_TestState().