/***************************************************************************//** | |
* @file em_rmu.h | |
* @brief Reset Management Unit (RMU) peripheral API | |
* @version 5.1.2 | |
******************************************************************************* | |
* @section License | |
* <b>Copyright 2016 Silicon Laboratories, Inc. http://www.silabs.com</b> | |
******************************************************************************* | |
* | |
* Permission is granted to anyone to use this software for any purpose, | |
* including commercial applications, and to alter it and redistribute it | |
* freely, subject to the following restrictions: | |
* | |
* 1. The origin of this software must not be misrepresented; you must not | |
* claim that you wrote the original software. | |
* 2. Altered source versions must be plainly marked as such, and must not be | |
* misrepresented as being the original software. | |
* 3. This notice may not be removed or altered from any source distribution. | |
* | |
* DISCLAIMER OF WARRANTY/LIMITATION OF REMEDIES: Silicon Labs has no | |
* obligation to support this Software. Silicon Labs is providing the | |
* Software "AS IS", with no express or implied warranties of any kind, | |
* including, but not limited to, any implied warranties of merchantability | |
* or fitness for any particular purpose or warranties against infringement | |
* of any proprietary rights of a third party. | |
* | |
* Silicon Labs will not be liable for any consequential, incidental, or | |
* special damages, or any other relief, or for any claim by any third party, | |
* arising from your use of this Software. | |
* | |
******************************************************************************/ | |
#ifndef EM_RMU_H | |
#define EM_RMU_H | |
#include "em_device.h" | |
#if defined(RMU_COUNT) && (RMU_COUNT > 0) | |
#include "em_assert.h" | |
#include <stdbool.h> | |
#ifdef __cplusplus | |
extern "C" { | |
#endif | |
/***************************************************************************//** | |
* @addtogroup emlib | |
* @{ | |
******************************************************************************/ | |
/***************************************************************************//** | |
* @addtogroup RMU | |
* @{ | |
******************************************************************************/ | |
/******************************************************************************* | |
******************************** ENUMS ************************************ | |
******************************************************************************/ | |
/** RMU reset modes */ | |
typedef enum | |
{ | |
#if defined(_RMU_CTRL_PINRMODE_MASK) | |
rmuResetModeDisabled = _RMU_CTRL_PINRMODE_DISABLED, | |
rmuResetModeLimited = _RMU_CTRL_PINRMODE_LIMITED, | |
rmuResetModeExtended = _RMU_CTRL_PINRMODE_EXTENDED, | |
rmuResetModeFull = _RMU_CTRL_PINRMODE_FULL, | |
#else | |
rmuResetModeClear = 0, | |
rmuResetModeSet = 1, | |
#endif | |
} RMU_ResetMode_TypeDef; | |
/** RMU controlled peripheral reset control and reset source control */ | |
typedef enum | |
{ | |
#if defined(RMU_CTRL_BURSTEN) | |
rmuResetBU = _RMU_CTRL_BURSTEN_MASK, /**< Reset control over Backup Power domain select */ | |
#endif | |
#if defined(RMU_CTRL_LOCKUPRDIS) | |
rmuResetLockUp = _RMU_CTRL_LOCKUPRDIS_MASK, /**< Cortex lockup reset select */ | |
#elif defined(_RMU_CTRL_LOCKUPRMODE_MASK) | |
rmuResetLockUp = _RMU_CTRL_LOCKUPRMODE_MASK, /**< Cortex lockup reset select */ | |
#endif | |
#if defined(_RMU_CTRL_WDOGRMODE_MASK) | |
rmuResetWdog = _RMU_CTRL_WDOGRMODE_MASK, /**< WDOG reset select */ | |
#endif | |
#if defined(_RMU_CTRL_LOCKUPRMODE_MASK) | |
rmuResetCoreLockup = _RMU_CTRL_LOCKUPRMODE_MASK, /**< Cortex lockup reset select */ | |
#endif | |
#if defined(_RMU_CTRL_SYSRMODE_MASK) | |
rmuResetSys = _RMU_CTRL_SYSRMODE_MASK, /**< SYSRESET select */ | |
#endif | |
#if defined(_RMU_CTRL_PINRMODE_MASK) | |
rmuResetPin = _RMU_CTRL_PINRMODE_MASK, /**< Pin reset select */ | |
#endif | |
} RMU_Reset_TypeDef; | |
/******************************************************************************* | |
***************************** PROTOTYPES ********************************** | |
******************************************************************************/ | |
/** RMU_LockupResetDisable kept for backwards compatibility */ | |
#define RMU_LockupResetDisable(A) RMU_ResetControl(rmuResetLockUp, A) | |
void RMU_ResetControl(RMU_Reset_TypeDef reset, RMU_ResetMode_TypeDef mode); | |
void RMU_ResetCauseClear(void); | |
uint32_t RMU_ResetCauseGet(void); | |
#if defined(_RMU_CTRL_RESETSTATE_MASK) | |
/***************************************************************************//** | |
* @brief | |
* Set user reset state. This state is reset only by a Power-on-reset and a | |
* pin reset. | |
* | |
* @param[in] userState User state to set | |
******************************************************************************/ | |
__STATIC_INLINE void RMU_UserResetStateSet(uint32_t userState) | |
{ | |
EFM_ASSERT(!(userState | |
& ~(_RMU_CTRL_RESETSTATE_MASK >> _RMU_CTRL_RESETSTATE_SHIFT))); | |
RMU->CTRL = (RMU->CTRL & ~_RMU_CTRL_RESETSTATE_MASK) | |
| (userState << _RMU_CTRL_RESETSTATE_SHIFT); | |
} | |
/***************************************************************************//** | |
* @brief | |
* Get user reset state. This state is reset only by a Power-on-reset and a | |
* pin reset. | |
* | |
* @return | |
* Reset surviving user state | |
******************************************************************************/ | |
__STATIC_INLINE uint32_t RMU_UserResetStateGet(void) | |
{ | |
uint32_t userState = (RMU->CTRL & _RMU_CTRL_RESETSTATE_MASK) | |
>> _RMU_CTRL_RESETSTATE_SHIFT; | |
return userState; | |
} | |
#endif | |
/** @} (end addtogroup RMU) */ | |
/** @} (end addtogroup emlib) */ | |
#ifdef __cplusplus | |
} | |
#endif | |
#endif /* defined(RMU_COUNT) && (RMU_COUNT > 0) */ | |
#endif /* EM_RMU_H */ |