mutex v4_0

The Xilinx Mutex driver. This driver supports the Xilinx Mutex Core. More detailed description of the driver operation can be found in the xmutex.c file.

Features

The Xilinx Mutex supports the following features:

• Provide for synchronization between multiple processors in the system.
• Write to lock scheme with CPU ID encoded.
• Multiple Mutex locks within a single instance of the device.
• An optional user field within each Mutex that can be read or written to by software.

This driver is intended to be RTOS and processor independent. Any needs for dynamic memory management, threads or thread mutual exclusion, virtual memory, or cache control must be satisfied by the layer above this driver. The effective address provided to the XMutex_CfgInitialize() function can be either the real, physical address or the remapped virtual address. The remapping of this address occurs above this driver, no remapping occurs within the driver itself.

Initialization & Configuration

The XMutex_Config structure is used by the driver to configure itself. This configuration structure is typically created by the tool-chain based on HW build properties.

To support multiple runtime loading and initialization strategies employed by various operating systems, the driver instance can be initialized in the following way:

• XMutex_LookupConfig (DeviceId) - Use the device identifier to find the static configuration structure defined in XMutex_g.c. This is setup by the tools. For some operating systems the config structure will be initialized by the software and this call is not needed. This function returns the CfgPtr argument used by the CfgInitialize function described below.

• XMutex_CfgInitialize (InstancePtr, ConfigPtr, EffectiveAddress) - Uses a configuration structure provided by the caller. If running in a system with address translation, the provided virtual memory base address replaces the physical address present in the configuration structure. The EffectiveAddress argument is required regardless of operating system environment, i.e. in standalone, ConfigPtr->BaseAddress is recommended and not the xparameters definition..

 MODIFICATION HISTORY:

 Ver   Who  Date     Changes
 ----- ---- -------- -----------------------------------------------
 1.00a va            First release
 1.00a ecm  06/01/07 Cleanup, new coding standard, check into XCS
 1.00b ecm  06/01/07 fixed tcl error for number of mutex's, CR502416
 2.00a hm   04/14/09 Fixed CR 466322, removed extra definitions
			Also fixed canonical definitions treating an interface
			as an device instance.
 3.00a hbm  10/15/09 Migrated to HAL phase 1 to use xil_io, xil_types,
			and xil_assert.
 3.01a sdm  05/06/10 New driver to support AXI version of the core and
		      cleaned up for coding guidelines.
 3.02a bss  01/31/13 Updated driver tcl to fix CR #679127
 4.0   adk  19/12/13 Updated as per the New Tcl API's
 4.00a bss  03/05/14 Modified XMutex_CfgInitialize to fix CR# 770096