cache.h

Go to the documentation of this file.

/* KallistiOS ##version##

   arch/dreamcast/include/cache.h
   (c)2001 Dan Potter

*/

/** \file   arch/cache.h
    \brief  Cache management functionality.

    This file contains definitions for functions that manage the cache in the
    Dreamcast, including functions to flush and invalidate the caches.

    \author Dan Potter
*/

#ifndef __ARCH_CACHE_H
#define __ARCH_CACHE_H

#include <sys/cdefs.h>
__BEGIN_DECLS

#include <arch/types.h>

/** \brief  Flush the instruction cache.

    This function flushes a range of the instruction cache.

    \param  start           The physical address to begin flushing at.
    \param  count           The number of bytes to flush.
*/
void icache_flush_range(uint32 start, uint32 count);

/** \brief  Invalidate the data/operand cache.

    This function invalidates a range of the data/operand cache. If you care
    about the contents of the cache that have not been written back yet, use
    dcache_flush_range() before using this function.

    \param  start           The physical address to begin invalidating at.
    \param  count           The number of bytes to invalidate.
*/
void dcache_inval_range(uint32 start, uint32 count);

/** \brief  Flush the data/operand cache.

    This function flushes a range of the data/operand cache, forcing a write-
    back on all of the data in the specified range. This does not invalidate the
    cache in the process (meaning the blocks will still be in the cache, just
    not marked as dirty after this has completed). If you wish to invalidate the
    cache as well, call dcache_inval_range() after calling this function.

    \param  start           The physical address to begin flushing at.
    \param  count           The number of bytes to flush.
*/
void dcache_flush_range(uint32 start, uint32 count);

__END_DECLS

#endif  /* __ARCH_CACHE_H */