FreeRTOS/Demo/CORTEX_A5_SAMA5D2x_Xplained_IAR/AtmelFiles/drivers/cortex-a/cp15.c

/* ----------------------------------------------------------------------------
 *         SAM Software Package License
 * ----------------------------------------------------------------------------
 * Copyright (c) 2015, Atmel Corporation
 *
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are met:
 *
 * - Redistributions of source code must retain the above copyright notice,
 * this list of conditions and the disclaimer below.
 *
 * Atmel's name may not be used to endorse or promote products derived from
 * this software without specific prior written permission.
 *
 * DISCLAIMER: THIS SOFTWARE IS PROVIDED BY ATMEL "AS IS" AND ANY EXPRESS OR
 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT ARE
 * DISCLAIMED. IN NO EVENT SHALL ATMEL BE LIABLE FOR ANY DIRECT, INDIRECT,
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
 * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
 * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
 * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 * ----------------------------------------------------------------------------
 */

//-----------------------------------------------------------------------------
// Reg Reads                    Writes
//----------------------------------------------------------------------------
// 0   ID code                  Unpredictable
// 0   cache type               Unpredictable
// 0   TCM status               Unpredictable
// 1   Control                  Control
// 2   Translation table base   Translation table base
// 3   Domain access control    Domain access control
// 4                                                       (Reserved)
// 5   Data fault status        Data fault status
// 5   Instruction fault status Instruction fault status
// 6   Fault address            Fault address
// 7   cache operations         cache operations
// 8   Unpredictable            TLB operations
// 9   cache lockdown           cache lockdown
// 9   TCM region               TCM region
// 10  TLB lockdown             TLB lockdown
// 11                                                      (Reserved)
// 12                                                      (Reserved)
// 13  FCSE PID                 FCSE PID
// 13  Context ID               Context ID
// 14                                                      (Reserved)
// 15  Test configuration       Test configuration
//-----------------------------------------------------------------------------

/** \page cp15_f CP15 Functions
 *
 * \section CP15 function Usage
 *
 * Methods to manage the Coprocessor 15. Coprocessor 15, or System Control
 * Coprocessor CP15, is used to configure and control all the items in the
 * list below:
 * <ul>
 * <li> ARM core
 * <li> caches (Icache, Dcache and write buffer)
 * <li> TCM
 * <li> MMU
 * <li> Other system options
 * </ul>
 * \section Usage
 *
 * -# Enable or disable D cache with cp15_enable_dcache() and cp15_disable_dcache()
 * -# Enable or disable I cache with cp15_enable_icache() and cp15_disable_icache()
 *
 * Related files:\n
 * \ref cp15.h\n
 * \ref cp15.c\n
 */

/** \file */

/**
 * \addtogroup cp15_cache L1 Cache Operations
 * \ingroup cache_module
 *
 * \section Usage
 *
 * They are performed as MCR instructions and only operate on a level 1 cache associated with
 * ATM v7 processor.
 * The supported operations are:
 * <ul>
 * <li> Any of these operations can be applied to
 *  -# any data cache
 *  -# any unified cache.
 * <li> Invalidate by MVA
 *   Performs an invalidate of a data or unified cache line based on the address it contains.
 * <li> Invalidate by set/way
 *   Performs an invalidate of a data or unified cache line based on its location in the cache hierarchy.
 * <li> Clean by MVA
 *   Performs a clean of a data or unified cache line based on the address it contains.
 * <li> Clean by set/way
 *   Performs a clean of a data or unified cache line based on its location in the cache hierarchy.
 * <li> Clean and Invalidate by MVA
 *   Performs a clean and invalidate of a data or unified cache line based on the address it contains.
 * <li> Clean and Invalidate by set/way
 *   Performs a clean and invalidate of a data or unified cache line based on its location in the cache hierarchy.
 * </ul>
 *
 * Related files:\n
 * \ref cp15.h\n
 * \ref cp15_asm_gcc.S \n
 * \ref cp15_asm_iar.s \n
 */

/*----------------------------------------------------------------------------
 *        Headers
 *----------------------------------------------------------------------------*/

#include "chip.h"

#if defined(__ICCARM__)
	#include <intrinsics.h>
#endif

#include "cortex-a/cp15.h"
#include "trace.h"

#include <assert.h>

/*----------------------------------------------------------------------------
 *        Global functions
 *----------------------------------------------------------------------------*/

/**
 * \brief Check Instruction cache
 * \return 0 if I_cache disable, 1 if I_cache enable
 */
unsigned int cp15_is_icached_enabled(void)
{
	unsigned int control;
	control = cp15_read_control();
	return ((control & (1 << CP15_I_BIT)) != 0);
}

/**
 * \brief  Enable Instruction cache
 */
void cp15_enable_icache(void)
{
	unsigned int control;
	control = cp15_read_control();
	// Check if cache is disabled
	if ((control & (1 << CP15_I_BIT)) == 0) {
		cp15_icache_invalidate();
		control |= (1 << CP15_I_BIT);
		cp15_write_control(control);
		trace_info("I cache enabled.\n\r");
	} else {

		trace_info("I cache is already enabled.\n\r");
	}
}

/**
 * \brief  Disable Instruction cache
 */
void cp15_disable_icache(void)
{
	unsigned int control;
	control = cp15_read_control();
	// Check if cache is enabled
	if ((control & (1 << CP15_I_BIT)) != 0) {

		control &= ~(1ul << CP15_I_BIT);
		cp15_write_control(control);
		trace_info("I cache disabled.\n\r");
	} else {

		trace_info("I cache is already disabled.\n\r");
	}
}

/**
 * \brief  Check MMU
 * \return  0 if MMU disable, 1 if MMU enable
 */
unsigned int cp15_is_mmu_enabled(void)
{
	unsigned int control;
	control = cp15_read_control();
	return ((control & (1 << CP15_M_BIT)) != 0);
}

/**
 * \brief  Enable MMU
 */
void cp15_enable_mmu(void)
{
	unsigned int control;
	control = cp15_read_control();
	// Check if MMU is disabled
	if ((control & (1 << CP15_M_BIT)) == 0) {

		control |= (1 << CP15_M_BIT);
		cp15_write_control(control);
		trace_info("MMU enabled.\n\r");
	} else {
		trace_info("MMU is already enabled.\n\r");
	}
}

/**
 * \brief  Disable MMU
 */
void cp15_disable_mmu(void)
{
	unsigned int control;
	control = cp15_read_control();
	// Check if MMU is enabled
	if ((control & (1 << CP15_M_BIT)) != 0) {

		control &= ~(1ul << CP15_M_BIT);
		control &= ~(1ul << CP15_C_BIT);
		cp15_write_control(control);
		trace_info("MMU disabled.\n\r");
	} else {
		trace_info("MMU is already disabled.\n\r");
	}
}

/**
 * \brief  Check D_cache
 * \return  0 if D_cache disable, 1 if D_cache enable (with MMU of course)
 */
unsigned int cp15_is_dcache_enabled(void)
{
	unsigned int control;
	control = cp15_read_control();
	return ((control & ((1 << CP15_C_BIT) || (1 << CP15_M_BIT))) != 0);
}

/**
 * \brief  Enable Data cache
 */
void cp15_enable_dcache(void)
{
	unsigned int control;
	control = cp15_read_control();
	if (!cp15_is_mmu_enabled()) {
		trace_error("Do nothing: MMU not enabled\n\r");
	} else {
		// Check if cache is disabled
		if ((control & (1 << CP15_C_BIT)) == 0) {
			cp15_dcache_invalidate();
			control |= (1 << CP15_C_BIT);
			cp15_write_control(control);
			trace_info("D cache enabled.\n\r");
		} else {
			trace_info("D cache is already enabled.\n\r");
		}
	}
}

/**
 * \brief  Disable Data cache
 */
void cp15_disable_dcache(void)
{
	unsigned int control;
	control = cp15_read_control();
	// Check if cache is enabled
	if ((control & (1 << CP15_C_BIT)) != 0) {

		control &= ~(1ul << CP15_C_BIT);
		cp15_write_control(control);
		trace_info("D cache disabled.\n\r");
	} else {

		trace_info("D cache is already disabled.\n\r");
	}
}

/**
 * \brief  Clean Data cache
 */
void cp15_dcache_clean(void)
{
	cp15_select_dcache();
	cp15_clean_dcache_by_set_way();
	asm("DSB");
}

/**
 * \brief  Invalidate Icache
 */
void cp15_icache_invalidate(void)
{
	cp15_select_icache();
	cp15_invalid_icache_inner_sharable();
	asm ("ISB");
}

/**
 * \brief  Invalidate Dcache
 */
void cp15_dcache_invalidate(void)
{
	cp15_select_dcache();
	cp15_invalid_dcache_by_set_way();
	asm ("DSB");
}

/**
 * \brief  Flush(Clean and invalidate) Data cache
 */
void cp15_dcache_flush(void)
{
	cp15_select_dcache();
	cp15_clean_invalid_dcache_by_set_way();
	asm("DSB");

}

/**
 * \brief  Invalidate Data cache by address
 */
void cp15_invalid_dcache_by_va(uint32_t S_Add, uint32_t E_Add)
{
	cp15_select_dcache();
	cp15_invalid_dcache_by_mva(S_Add, E_Add);
}

/**
 * \brief  Clean Data cache by address
 */
void cp15_clean_dcache_by_va(uint32_t S_Add, uint32_t E_Add)
{
	cp15_select_dcache();
	cp15_clean_dcache_by_mva(S_Add, E_Add);
}

/**
 * \brief  Flush Data cache by address
 */

void cp15_flush_dcache_by_va(uint32_t S_Add, uint32_t E_Add)
{
	cp15_select_dcache();
	cp15_clean_invalid_dcache_by_mva(S_Add, E_Add);
}