From d9455273053bb69a94a338dff56330d3be50f14e Mon Sep 17 00:00:00 2001 From: Wolfgang Denk Date: Tue, 30 May 2006 15:58:20 +0200 Subject: Minor cleanup. --- cpu/ixp/npe/include/IxOsalIoMem.h | 50 ++++++++++++++++++--------------------- 1 file changed, 23 insertions(+), 27 deletions(-) (limited to 'cpu/ixp/npe/include/IxOsalIoMem.h') diff --git a/cpu/ixp/npe/include/IxOsalIoMem.h b/cpu/ixp/npe/include/IxOsalIoMem.h index a3a71242ae9..ac0ce657037 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 */ -- cgit v1.2.3