/* ---------------------------------------------------------------------------- | |
* ATMEL Microcontroller Software Support | |
* ---------------------------------------------------------------------------- | |
* Copyright (c) 2008, 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. | |
* ---------------------------------------------------------------------------- | |
*/ | |
//------------------------------------------------------------------------------ | |
// Headers | |
//------------------------------------------------------------------------------ | |
#include "supc.h" | |
#include <board.h> | |
#include <utility/assert.h> | |
//------------------------------------------------------------------------------ | |
// Local definitions | |
//------------------------------------------------------------------------------ | |
/// Key value for the SUPC_MR register. | |
#define SUPC_KEY ((unsigned int) (0xA5 << 24)) | |
//------------------------------------------------------------------------------ | |
// Global functions | |
//------------------------------------------------------------------------------ | |
//------------------------------------------------------------------------------ | |
/// Enables the SLCD power supply. | |
/// \param internal If 1, the power supply is configured as internal; otherwise | |
/// it is set at external. | |
//------------------------------------------------------------------------------ | |
void SUPC_EnableSlcd(unsigned char internal) | |
{ | |
if (internal) { | |
AT91C_BASE_SUPC->SUPC_MR = SUPC_KEY | (AT91C_BASE_SUPC->SUPC_MR & ~AT91C_SUPC_LCDMODE) | AT91C_SUPC_LCDMODE_INTERNAL; | |
} | |
else { | |
AT91C_BASE_SUPC->SUPC_MR = SUPC_KEY | (AT91C_BASE_SUPC->SUPC_MR & ~AT91C_SUPC_LCDMODE) | AT91C_SUPC_LCDMODE_EXTERNAL; | |
} | |
while ((AT91C_BASE_SUPC->SUPC_SR & AT91C_SUPC_LCDS) != AT91C_SUPC_LCDS); | |
} | |
//------------------------------------------------------------------------------ | |
/// Disables the SLCD power supply. | |
//------------------------------------------------------------------------------ | |
void SUPC_DisableSlcd(void) | |
{ | |
AT91C_BASE_SUPC->SUPC_MR = SUPC_KEY | (AT91C_BASE_SUPC->SUPC_MR & ~AT91C_SUPC_LCDMODE); | |
while ((AT91C_BASE_SUPC->SUPC_SR & AT91C_SUPC_LCDS) == AT91C_SUPC_LCDS); | |
} | |
//------------------------------------------------------------------------------ | |
/// Sets the output voltage of the SLCD charge pump. | |
/// \param voltage Output voltage. | |
//------------------------------------------------------------------------------ | |
void SUPC_SetSlcdVoltage(unsigned int voltage) | |
{ | |
SANITY_CHECK((voltage & ~AT91C_SUPC_LCDOUT) == 0); | |
AT91C_BASE_SUPC->SUPC_MR = SUPC_KEY | (AT91C_BASE_SUPC->SUPC_MR & ~AT91C_SUPC_LCDOUT) | voltage; | |
} | |
#if !defined(__ICCARM__) | |
__attribute__ ((section (".ramfunc"))) // GCC | |
#endif | |
//------------------------------------------------------------------------------ | |
/// Enables the flash power supply with the given wake-up setting. | |
/// \param time Wake-up time. | |
//------------------------------------------------------------------------------ | |
void SUPC_EnableFlash(unsigned int time) | |
{ | |
AT91C_BASE_SUPC->SUPC_FWUTR = time; | |
AT91C_BASE_SUPC->SUPC_MR = SUPC_KEY | AT91C_BASE_SUPC->SUPC_MR | AT91C_SUPC_FLASHON; | |
while ((AT91C_BASE_SUPC->SUPC_SR & AT91C_SUPC_FLASHS) != AT91C_SUPC_FLASHS); | |
} | |
#if !defined(__ICCARM__) | |
__attribute__ ((section (".ramfunc"))) // GCC | |
#endif | |
//------------------------------------------------------------------------------ | |
/// Disables the flash power supply. | |
//------------------------------------------------------------------------------ | |
void SUPC_DisableFlash(void) | |
{ | |
AT91C_BASE_SUPC->SUPC_MR = SUPC_KEY | (AT91C_BASE_SUPC->SUPC_MR & ~AT91C_SUPC_FLASHON); | |
while ((AT91C_BASE_SUPC->SUPC_SR & AT91C_SUPC_FLASHS) == AT91C_SUPC_FLASHS); | |
} | |
//------------------------------------------------------------------------------ | |
/// Sets the voltage regulator output voltage. | |
/// \param voltage Voltage to set. | |
//------------------------------------------------------------------------------ | |
void SUPC_SetVoltageOutput(unsigned int voltage) | |
{ | |
SANITY_CHECK((voltage & ~AT91C_SUPC_VRVDD) == 0); | |
AT91C_BASE_SUPC->SUPC_MR = SUPC_KEY | (AT91C_BASE_SUPC->SUPC_MR & ~AT91C_SUPC_VRVDD) | voltage; | |
} | |
//------------------------------------------------------------------------------ | |
/// Puts the voltage regulator in deep mode. | |
//------------------------------------------------------------------------------ | |
void SUPC_EnableDeepMode(void) | |
{ | |
AT91C_BASE_SUPC->SUPC_MR = SUPC_KEY | AT91C_BASE_SUPC->SUPC_MR | AT91C_SUPC_VRDEEP; | |
} | |
//------------------------------------------------------------------------------ | |
/// Puts the voltage regulator in normal mode. | |
//------------------------------------------------------------------------------ | |
void SUPC_DisableDeepMode(void) | |
{ | |
AT91C_BASE_SUPC->SUPC_MR = SUPC_KEY | (AT91C_BASE_SUPC->SUPC_MR & ~AT91C_SUPC_VRDEEP); | |
} | |
//----------------------------------------------------------------------------- | |
/// Enables the backup SRAM power supply, so its data is saved while the device | |
/// is in backup mode. | |
//----------------------------------------------------------------------------- | |
void SUPC_EnableSram(void) | |
{ | |
AT91C_BASE_SUPC->SUPC_MR = SUPC_KEY | AT91C_BASE_SUPC->SUPC_MR | AT91C_SUPC_SRAMON; | |
} | |
//----------------------------------------------------------------------------- | |
/// Disables the backup SRAM power supply. | |
//----------------------------------------------------------------------------- | |
void SUPC_DisableSram(void) | |
{ | |
AT91C_BASE_SUPC->SUPC_MR = SUPC_KEY | (AT91C_BASE_SUPC->SUPC_MR & ~AT91C_SUPC_SRAMON); | |
} | |
//----------------------------------------------------------------------------- | |
/// Enables the RTC power supply. | |
//----------------------------------------------------------------------------- | |
void SUPC_EnableRtc(void) | |
{ | |
AT91C_BASE_SUPC->SUPC_MR = SUPC_KEY | AT91C_BASE_SUPC->SUPC_MR | AT91C_SUPC_RTCON; | |
while ((AT91C_BASE_SUPC->SUPC_SR & AT91C_SUPC_RTS) != AT91C_SUPC_RTS); | |
} | |
//----------------------------------------------------------------------------- | |
/// Disables the RTC power supply. | |
//----------------------------------------------------------------------------- | |
void SUPC_DisableRtc(void) | |
{ | |
AT91C_BASE_SUPC->SUPC_MR = SUPC_KEY | (AT91C_BASE_SUPC->SUPC_MR & ~AT91C_SUPC_RTCON); | |
while ((AT91C_BASE_SUPC->SUPC_SR & AT91C_SUPC_RTS) == AT91C_SUPC_RTS); | |
} | |
//----------------------------------------------------------------------------- | |
/// Sets the BOD sampling mode (or disables it). | |
/// \param mode BOD sampling mode. | |
//----------------------------------------------------------------------------- | |
void SUPC_SetBodSampling(unsigned int mode) | |
{ | |
SANITY_CHECK((mode & ~AT91C_SUPC_BODSMPL) == 0); | |
AT91C_BASE_SUPC->SUPC_BOMR &= ~AT91C_SUPC_BODSMPL; | |
AT91C_BASE_SUPC->SUPC_BOMR |= mode; | |
} | |
//------------------------------------------------------------------------------ | |
/// Disables the voltage regulator, which makes the device enter backup mode. | |
//------------------------------------------------------------------------------ | |
void SUPC_DisableVoltageRegulator(void) | |
{ | |
AT91C_BASE_SUPC->SUPC_CR = SUPC_KEY | AT91C_SUPC_VROFF; | |
while (1); | |
} | |
//------------------------------------------------------------------------------ | |
/// Shuts the device down so it enters Off mode. | |
//------------------------------------------------------------------------------ | |
void SUPC_Shutdown(void) | |
{ | |
AT91C_BASE_SUPC->SUPC_CR = SUPC_KEY | AT91C_SUPC_SHDW; | |
while (1); | |
} | |
//------------------------------------------------------------------------------ | |
/// Sets the wake-up sources when in backup mode. | |
/// \param sources Wake-up sources to enable. | |
//------------------------------------------------------------------------------ | |
void SUPC_SetWakeUpSources(unsigned int sources) | |
{ | |
SANITY_CHECK((sources & ~0x0000000B) == 0); | |
AT91C_BASE_SUPC->SUPC_WUMR &= ~0x0000000B; | |
AT91C_BASE_SUPC->SUPC_WUMR |= sources; | |
} | |
//------------------------------------------------------------------------------ | |
/// Sets the wake-up inputs when in backup mode. | |
/// \param inputs Wake up inputs to enable. | |
//------------------------------------------------------------------------------ | |
void SUPC_SetWakeUpInputs(unsigned int inputs) | |
{ | |
SANITY_CHECK((inputs & ~0xFFFF) == 0); | |
AT91C_BASE_SUPC->SUPC_WUIR &= ~0xFFFF; | |
AT91C_BASE_SUPC->SUPC_WUIR |= inputs; | |
} | |