Cache API summary. STMicroelectronics ST200-TOOLSET

Caches and memory areas OS21

In a similar way, the read-only I-cache can be invalidated in order to safely handle dynamic code loading.

12.4 Cache API summary

All the definitions relating to the cache API can be obtained by including the header file os21.h

, which itself includes the header file cache.h. See

Table 31

,

Table 32

and

Table 33

for a complete list.

Table 31.

Functions defined in cache.h

Function

cache_allocate_data() cache_disable_data() cache_disable_instruction() cache_enable_data() cache_enable_instruction() cache_flush_data() cache_flush_data_all() cache_invalidate_data() cache_invalidate_data_all() cache_invalidate_instruction() cache_invalidate_instruction_all() cache_purge_data() cache_purge_data_all() cache_status()

Table 32.

Types defined in cache.h

Type

cache_data_mode_t cache_instruction_mode_t

Description

Allocates a range of D-cache

Disables the D-cache

Disables the I-cache

Enables the D-cache

Enables the I-cache

Flushes any dirty D-cache lines in range

Flushes any dirty D-cache

Invalidates D-cache lines in range

Invalidates all D-cache lines

Invalidates I-cache lines in range

Invalidates all I-cache lines

Purges D-cache lines in range

Purges all D-cache lines

Returns current cache status information

Description

Additional flags for cache_enable_data()

Additional flags for cache_enable_instruction()

Type for cache status information

Flags for cache_status() cache_status_t cache_status_flags_t

Table 33.

Macros defined in cache.h

Macro

ICACHE_LINE_SIZE

DCACHE_LINE_SIZE

Description

Returns the size of an I-cache line in bytes

Returns the size of a D-cache line in bytes

164/226 7358306