/* ---------------------------------------------------------------------------- */
/* Atmel Microcontroller Software Support */
/* 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 condition is 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. */
/* ---------------------------------------------------------------------------- */
/** \addtogroup efc_module Working with EEFC
* \ingroup peripherals_module
*
* The EEFC driver provides the interface to configure and use the EEFC
* peripheral.
*
* The user needs to set the number of wait states depending on the frequency
* used.\n
* Configure number of cycles for flash read/write operations in the FWS field
* of EEFC_FMR.
*
* It offers a function to send flash command to EEFC and waits for the
* flash to be ready.
*
* To send flash command, the user could do in either of following way:
* <ul>
* <li>Write a correct key, command and argument in EEFC_FCR. </li>
* <li>Or, Use IAP (In Application Programming) function which is executed from
* ROM directly, this allows flash programming to be done by code running in
* flash.</li>
* <li>Once the command is achieved, it can be detected even by polling
* EEFC_FSR or interrupt.
* </ul>
*
* The command argument could be a page number,GPNVM number or nothing, it
* depends on the command itself. Some useful functions in this driver could
* help user translate physical flash address into a page number and vice verse.
*
* For more accurate information, please look at the EEFC section of the
* Datasheet.
*
* Related files :\n
* \ref efc.c\n
* \ref efc.h.\n
*/
/*@{*/
/*@}*/
/**
* \file
*
* Implementation of Enhanced Embedded Flash Controller (EEFC).
*
*/
/*----------------------------------------------------------------------------
* Headers
*----------------------------------------------------------------------------*/
#include "chip.h"
#include <assert.h>
/*----------------------------------------------------------------------------
* Macro
*----------------------------------------------------------------------------*/
#define EEFC_FCR_FCMD(value) ((EEFC_FCR_FCMD_Msk & ((value) << EEFC_FCR_FCMD_Pos)))
/*----------------------------------------------------------------------------
* Exported functions
*----------------------------------------------------------------------------*/
extern void EFC_WriteFMR(Efc *efc, uint32_t dwFmr);
#ifdef __ICCARM__
extern __ramfunc void EFC_WriteFMR(Efc *efc, uint32_t dwFmr)
#else
__attribute__ ((section (".ramfunc")))
extern void EFC_WriteFMR(Efc *efc, uint32_t dwFmr)
#endif
{
efc->EEFC_FMR = dwFmr;
}
/**
* \brief Enables the flash ready interrupt source on the EEFC peripheral.
*
* \param efc Pointer to a Efc instance
*/
extern void EFC_EnableFrdyIt(Efc *efc)
{
uint32_t dwFmr;
dwFmr = efc->EEFC_FMR |= EEFC_FMR_FRDY;
EFC_WriteFMR(efc, dwFmr);
}
/**
* \brief Disables the flash ready interrupt source on the EEFC peripheral.
*
* \param efc Pointer to a Efc instance
*/
extern void EFC_DisableFrdyIt(Efc *efc)
{
uint32_t dwFmr;
dwFmr = efc->EEFC_FMR & (~EEFC_FMR_FRDY);
EFC_WriteFMR(efc, dwFmr);
}
/**
* \brief Set read/write wait state on the EEFC peripheral.
*
* \param efc Pointer to a Efc instance
* \param cycles the number of wait states in cycle.
*/
extern void EFC_SetWaitState(Efc *efc, uint8_t ucCycles)
{
uint32_t dwFmr;
dwFmr = efc->EEFC_FMR;
dwFmr &= ~((uint32_t)EEFC_FMR_FWS_Msk);
dwFmr |= EEFC_FMR_FWS(ucCycles);
EFC_WriteFMR(efc, dwFmr);
}
/**
* \brief Returns the current status of the EEFC.
*
* \note Keep in mind that this function clears the value of some status bits
* (LOCKE, PROGE).
*
* \param efc Pointer to a Efc instance
*/
extern uint32_t EFC_GetStatus(Efc *efc)
{
return efc->EEFC_FSR;
}
/**
* \brief Returns the result of the last executed command.
*
* \param efc Pointer to a Efc instance
*/
extern uint32_t EFC_GetResult(Efc *efc)
{
return efc->EEFC_FRR;
}
/**
* \brief Translates the given address page and offset values.
* \note The resulting values are stored in the provided variables if they are
* not null.
*
* \param efc Pointer to a Efc instance
* \param address Address to translate.
* \param pPage First page accessed.
* \param pOffset Byte offset in first page.
*/
extern void EFC_TranslateAddress(Efc **ppEfc, uint32_t dwAddress,
uint16_t *pwPage,
uint16_t *pwOffset)
{
assert(dwAddress >= IFLASH_ADDR);
assert(dwAddress <= (IFLASH_ADDR + IFLASH_SIZE));
/* Store values */
if (ppEfc)
*ppEfc = EFC;
if (pwPage)
*pwPage = (dwAddress - IFLASH_ADDR) / IFLASH_PAGE_SIZE;
if (pwOffset) {
*pwOffset = (dwAddress - IFLASH_ADDR) % IFLASH_PAGE_SIZE;;
}
}
/**
* \brief Computes the address of a flash access given the page and offset.
*
* \param efc Pointer to a Efc instance
* \param page Page number.
* \param offset Byte offset inside page.
* \param pAddress Computed address (optional).
*/
extern void EFC_ComputeAddress(Efc *efc, uint16_t wPage, uint16_t wOffset,
uint32_t *pdwAddress)
{
uint32_t dwAddress;
/* Stop warning */
efc = efc;
assert(efc);
assert(wPage <= IFLASH_NB_OF_PAGES);
assert(wOffset < IFLASH_PAGE_SIZE);
dwAddress = IFLASH_ADDR + wPage * IFLASH_PAGE_SIZE + wOffset;
/* Store result */
if (pdwAddress != NULL)
*pdwAddress = dwAddress;
}
/**
* \brief Performs the given command and wait until its completion (or an error).
*
* \param efc Pointer to a Efc instance
* \param command Command to perform.
* \param argument Optional command argument.
*
* \return 0 if successful, otherwise returns an error code.
*/
extern uint32_t EFC_PerformCommand(Efc *efc, uint32_t dwCommand,
uint32_t dwArgument, uint32_t dwUseIAP)
{
if (dwUseIAP != 0) {
/* Pointer on IAP function in ROM */
static uint32_t (*IAP_PerformCommand)(uint32_t, uint32_t);
IAP_PerformCommand = (uint32_t (*)(uint32_t, uint32_t))
* ((uint32_t *)CHIP_FLASH_IAP_ADDRESS);
if (efc == EFC) {
IAP_PerformCommand(0, EEFC_FCR_FKEY_PASSWD | EEFC_FCR_FARG(dwArgument)
| EEFC_FCR_FCMD(dwCommand));
}
return (efc->EEFC_FSR & (EEFC_FSR_FLOCKE | EEFC_FSR_FCMDE | EEFC_FSR_FLERR));
} else {
uint32_t dwStatus;
efc->EEFC_FCR = EEFC_FCR_FKEY_PASSWD | EEFC_FCR_FARG(dwArgument)
| EEFC_FCR_FCMD(dwCommand);
do {
dwStatus = efc->EEFC_FSR;
} while ((dwStatus & EEFC_FSR_FRDY) != EEFC_FSR_FRDY);
return (dwStatus & (EEFC_FSR_FLOCKE | EEFC_FSR_FCMDE | EEFC_FSR_FLERR));
}
}
/**
* \brief Set flash access mode.
*
* \param dwMode - 0:128-bit, (1<<24):64-bit
*/
extern void EFC_SetFlashAccessMode(Efc *efc, uint32_t dwMode)
{
uint32_t dwFmr;
dwFmr = dwMode;
EFC_WriteFMR(efc, dwFmr);
}