D-Cache Functions

Functions for the level-1 data cache. More...

Functions
__STATIC_FORCEINLINE void	SCB_EnableDCache (void)
	Enable D-Cache.
__STATIC_FORCEINLINE void	SCB_DisableDCache (void)
	Disable D-Cache.
__STATIC_FORCEINLINE void	SCB_InvalidateDCache (void)
	Invalidate D-Cache.
__STATIC_FORCEINLINE void	SCB_CleanDCache (void)
	Clean D-Cache.
__STATIC_FORCEINLINE void	SCB_CleanInvalidateDCache (void)
	Clean & Invalidate D-Cache.
__STATIC_FORCEINLINE void	SCB_InvalidateDCache_by_Addr (volatile void *addr, int32_t dsize)
	D-Cache Invalidate by address.
__STATIC_FORCEINLINE void	SCB_CleanDCache_by_Addr (volatile void *addr, int32_t dsize)
	D-Cache Clean by address.
__STATIC_FORCEINLINE void	SCB_CleanInvalidateDCache_by_Addr (volatile void *addr, int32_t dsize)
	D-Cache Clean and Invalidate by address.

Description

Functions for the level-1 data cache.

// close ICache functions

Function Documentation

SCB_CleanDCache()

__STATIC_FORCEINLINE void SCB_CleanDCache

(

void

)

Clean D-Cache.

The function cleans the entire data cache.

SCB_CleanDCache_by_Addr()

__STATIC_FORCEINLINE void SCB_CleanDCache_by_Addr	(	volatile void *	addr,
		int32_t	dsize
	)

D-Cache Clean by address.

Parameters

[in]	addr	address (aligned to 32-byte boundary)
[in]	dsize	size of memory block (in number of bytes)

The function cleans a memory block of size dsize [bytes] starting at address address. The address is aligned to 32-byte boundary.

SCB_CleanInvalidateDCache()

__STATIC_FORCEINLINE void SCB_CleanInvalidateDCache

(

void

)

Clean & Invalidate D-Cache.

The function cleans and invalidates the entire data cache.

SCB_CleanInvalidateDCache_by_Addr()

__STATIC_FORCEINLINE void SCB_CleanInvalidateDCache_by_Addr	(	volatile void *	addr,
		int32_t	dsize
	)

D-Cache Clean and Invalidate by address.

Parameters

[in]	addr	address (aligned to 32-byte boundary)
[in]	dsize	size of memory block (in number of bytes)

The function invalidates and cleans a memory block of size dsize [bytes] starting at address address. The address is aligned to 32-byte boundary.

SCB_DisableDCache()

__STATIC_FORCEINLINE void SCB_DisableDCache

(

void

)

Disable D-Cache.

The function turns off the entire data cache.

Note

When disabling the data cache, you must clean (SCB_CleanDCache) the entire cache to ensure that any dirty data is flushed to external memory.

SCB_EnableDCache()

__STATIC_FORCEINLINE void SCB_EnableDCache

(

void

)

Enable D-Cache.

The function turns on the entire data cache.

Note

Before enabling the data cache, you must invalidate the entire data cache (SCB_InvalidateDCache), because external memory might have changed from when the cache was disabled.

After reset, you must invalidate (SCB_InvalidateDCache) each cache before enabling it.

SCB_InvalidateDCache()

__STATIC_FORCEINLINE void SCB_InvalidateDCache

(

void

)

Invalidate D-Cache.

The function invalidates the entire data cache.

Note

After reset, you must invalidate each cache before enabling (SCB_EnableDCache) it.

SCB_InvalidateDCache_by_Addr()

__STATIC_FORCEINLINE void SCB_InvalidateDCache_by_Addr	(	volatile void *	addr,
		int32_t	dsize
	)

D-Cache Invalidate by address.

Parameters

[in]	addr	address (aligned to 32-byte boundary)
[in]	dsize	size of memory block (in number of bytes)

The function invalidates a memory block of size dsize [bytes] starting at address address. The address is aligned to 32-byte boundary.