summaryrefslogtreecommitdiff
path: root/cpu/ixp/npe/include/IxOsalIoMem.h
diff options
context:
space:
mode:
Diffstat (limited to 'cpu/ixp/npe/include/IxOsalIoMem.h')
-rw-r--r--cpu/ixp/npe/include/IxOsalIoMem.h50
1 files changed, 23 insertions, 27 deletions
diff --git a/cpu/ixp/npe/include/IxOsalIoMem.h b/cpu/ixp/npe/include/IxOsalIoMem.h
index a3a7124..ac0ce65 100644
--- a/cpu/ixp/npe/include/IxOsalIoMem.h
+++ b/cpu/ixp/npe/include/IxOsalIoMem.h
@@ -63,13 +63,12 @@
* @{
*/
-
/* Low-level conversion macros - DO NOT USE UNLESS ABSOLUTELY NEEDED */
#ifndef __wince
/*
- * Private function to swap word*//*
+ * Private function to swap word
*/
#ifdef __XSCALE__
static __inline__ UINT32
@@ -91,7 +90,6 @@ ixOsalCoreWordSwap (UINT32 wordIn)
return wordOut;
}
-
#define IX_OSAL_SWAP_LONG(wData) (ixOsalCoreWordSwap(wData))
#else
@@ -149,7 +147,7 @@ typedef enum
/**
* @ingroup IxOsalIoMem
* @enum IxOsalMapEndianessType
- * @brief This is an emum for OSAL I/O mem Endianess and Coherency mode.
+ * @brief This is an emum for OSAL I/O mem Endianess and Coherency mode.
*/
typedef enum
{
@@ -172,10 +170,9 @@ typedef struct _IxOsalMemoryMap
UINT32 size; /**< size of the map */
-
- UINT32 virtualAddress; /**< virtual address of the zone; must be predefined
- in the global memory map for static maps and has
- to be NULL for dynamic maps (populated on allocation)
+ UINT32 virtualAddress; /**< virtual address of the zone; must be predefined
+ in the global memory map for static maps and has
+ to be NULL for dynamic maps (populated on allocation)
*/
/*
* pointer to a map function called to map a dynamic map;
@@ -245,12 +242,12 @@ ixOsalIoMemPhysToVirt (UINT32 physicalAddress, UINT32 coherency);
*
* @def IX_OSAL_MEM_MAP(physAddr, size)
*
- * @brief Map an I/O mapped physical memory zone to virtual zone and return virtual
- * pointer.
+ * @brief Map an I/O mapped physical memory zone to virtual zone and return virtual
+ * pointer.
* @param physAddr - the physical address
* @param size - the size
- * @return start address of the virtual memory zone.
- *
+ * @return start address of the virtual memory zone.
+ *
* @note This function maps an I/O mapped physical memory zone of the given size
* into a virtual memory zone accessible by the caller and returns a cookie -
* the start address of the virtual memory zone.
@@ -260,23 +257,23 @@ ixOsalIoMemPhysToVirt (UINT32 physicalAddress, UINT32 coherency);
* finished using this zone (e.g. on driver unload) using the cookie as
* parameter.
* The IX_OSAL_READ/WRITE_LONG/SHORT macros should be used to read and write
- * the mapped memory, adding the necessary offsets to the address cookie.
+ * the mapped memory, adding the necessary offsets to the address cookie.
*/
#define IX_OSAL_MEM_MAP(physAddr, size) \
ixOsalIoMemMap((physAddr), (size), IX_OSAL_COMPONENT_MAPPING)
-/**
+/**
* @ingroup IxOsalIoMem
*
* @def IX_OSAL_MEM_UNMAP(virtAddr)
*
- * @brief Unmap a previously mapped I/O memory zone using virtual pointer obtained
- * during the mapping operation.
- * pointer.
+ * @brief Unmap a previously mapped I/O memory zone using virtual pointer obtained
+ * during the mapping operation.
+ * pointer.
* @param virtAddr - the virtual pointer to the zone to be unmapped.
- * @return none
- *
+ * @return none
+ *
* @note This function unmaps a previously mapped I/O memory zone using
* the cookie obtained in the mapping operation. The memory zone in question
* becomes unavailable to the caller once unmapped and the cookie should be
@@ -288,37 +285,36 @@ ixOsalIoMemPhysToVirt (UINT32 physicalAddress, UINT32 coherency);
#define IX_OSAL_MEM_UNMAP(virtAddr) \
ixOsalIoMemUnmap ((virtAddr), IX_OSAL_COMPONENT_MAPPING)
-/**
+/**
* @ingroup IxOsalIoMem
*
* @def IX_OSAL_MMAP_VIRT_TO_PHYS(virtAddr)
*
* @brief This function Converts a virtual address into a physical
* address, including the dynamically mapped memory.
- *
+ *
* @param virtAddr - virtual address to convert
- * Return value: corresponding physical address, or NULL
+ * Return value: corresponding physical address, or NULL
*/
#define IX_OSAL_MMAP_VIRT_TO_PHYS(virtAddr) \
ixOsalIoMemVirtToPhys(virtAddr, IX_OSAL_COMPONENT_MAPPING)
-/**
+/**
* @ingroup IxOsalIoMem
*
* @def IX_OSAL_MMAP_PHYS_TO_VIRT(physAddr)
*
* @brief This function Converts a virtual address into a physical
* address, including the dynamically mapped memory.
- *
+ *
* @param physAddr - physical address to convert
- * Return value: corresponding virtual address, or NULL
- *
+ * Return value: corresponding virtual address, or NULL
+ *
*/
#define IX_OSAL_MMAP_PHYS_TO_VIRT(physAddr) \
ixOsalIoMemPhysToVirt(physAddr, IX_OSAL_COMPONENT_MAPPING)
-
/**
* @} IxOsalIoMem
*/