224 lines
9.6 KiB
C
224 lines
9.6 KiB
C
/* ----------------------------------------------------------------------------
|
|
* 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;
|
|
}
|
|
|