228 lines
8.4 KiB
C
228 lines
8.4 KiB
C
|
/**
|
||
|
|
*******************************************************************************
|
||
|
|
* @file hc32f4a0_swdt.h
|
||
|
|
* @brief This file contains all the functions prototypes of the SWDT driver
|
||
|
|
* library.
|
||
|
|
@verbatim
|
||
|
|
Change Logs:
|
||
|
|
Date Author Notes
|
||
|
|
2020-06-12 Yangjp First version
|
||
|
|
@endverbatim
|
||
|
|
*******************************************************************************
|
||
|
|
* Copyright (C) 2020, Huada Semiconductor Co., Ltd. All rights reserved.
|
||
|
|
*
|
||
|
|
* This software component is licensed by HDSC under BSD 3-Clause license
|
||
|
|
* (the "License"); You may not use this file except in compliance with the
|
||
|
|
* License. You may obtain a copy of the License at:
|
||
|
|
* opensource.org/licenses/BSD-3-Clause
|
||
|
|
*
|
||
|
|
*******************************************************************************
|
||
|
|
*/
|
||
|
|
#ifndef __HC32F4A0_SWDT_H__
|
||
|
|
#define __HC32F4A0_SWDT_H__
|
||
|
|
|
||
|
|
/* C binding of definitions if building with C++ compiler */
|
||
|
|
#ifdef __cplusplus
|
||
|
|
extern "C"
|
||
|
|
{
|
||
|
|
#endif
|
||
|
|
|
||
|
|
/*******************************************************************************
|
||
|
|
* Include files
|
||
|
|
******************************************************************************/
|
||
|
|
#include "hc32_common.h"
|
||
|
|
#include "ddl_config.h"
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @addtogroup HC32F4A0_DDL_Driver
|
||
|
|
* @{
|
||
|
|
*/
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @addtogroup DDL_SWDT
|
||
|
|
* @{
|
||
|
|
*/
|
||
|
|
|
||
|
|
#if (DDL_SWDT_ENABLE == DDL_ON)
|
||
|
|
|
||
|
|
/*******************************************************************************
|
||
|
|
* Global type definitions ('typedef')
|
||
|
|
******************************************************************************/
|
||
|
|
/**
|
||
|
|
* @defgroup SWDT_Global_Types SWDT Global Types
|
||
|
|
* @{
|
||
|
|
*/
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief SWDT Init structure definition
|
||
|
|
*/
|
||
|
|
typedef struct
|
||
|
|
{
|
||
|
|
uint32_t u32CountCycle; /*!< Specifies the SWDT Count Cycle.
|
||
|
|
This parameter can be a value of @ref SWDT_Counter_Cycle */
|
||
|
|
|
||
|
|
uint32_t u32ClockDivision; /*!< Specifies the SWDT Clock Division.
|
||
|
|
This parameter can be a value of @ref SWDT_Clock_Division */
|
||
|
|
|
||
|
|
uint32_t u32RefreshRange; /*!< Specifies the SWDT Allow Refresh Range.
|
||
|
|
This parameter can be a value of @ref SWDT_Refresh_Percent_Range */
|
||
|
|
|
||
|
|
uint32_t u32LPModeCountEn; /*!< Specifies the SWDT Count Enable/Disable In Low Power Mode(Sleep/Stop Mode).
|
||
|
|
This parameter can be a value of @ref SWDT_LPW_Mode_Count */
|
||
|
|
|
||
|
|
uint32_t u32TrigType; /*!< Specifies the SWDT Refresh Error or Count Underflow trigger event Type.
|
||
|
|
This parameter can be a value of @ref SWDT_Trigger_Event_Type */
|
||
|
|
} stc_swdt_init_t;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @}
|
||
|
|
*/
|
||
|
|
|
||
|
|
/*******************************************************************************
|
||
|
|
* Global pre-processor symbols/macros ('#define')
|
||
|
|
******************************************************************************/
|
||
|
|
/**
|
||
|
|
* @defgroup SWDT_Global_Macros SWDT Global Macros
|
||
|
|
* @{
|
||
|
|
*/
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @defgroup SWDT_Counter_Cycle SWDT Counter Cycle
|
||
|
|
* @{
|
||
|
|
*/
|
||
|
|
#define SWDT_COUNTER_CYCLE_256 (0UL) /*!< 256 clock cycle */
|
||
|
|
#define SWDT_COUNTER_CYCLE_4096 (SWDT_CR_PERI_0) /*!< 4096 clock cycle */
|
||
|
|
#define SWDT_COUNTER_CYCLE_16384 (SWDT_CR_PERI_1) /*!< 16384 clock cycle */
|
||
|
|
#define SWDT_COUNTER_CYCLE_65536 (SWDT_CR_PERI) /*!< 65536 clock cycle */
|
||
|
|
/**
|
||
|
|
* @}
|
||
|
|
*/
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @defgroup SWDT_Clock_Division SWDT Clock Division
|
||
|
|
* @{
|
||
|
|
*/
|
||
|
|
#define SWDT_CLOCK_DIV1 (0UL) /*!< SWDTCLK */
|
||
|
|
#define SWDT_CLOCK_DIV16 (SWDT_CR_CKS_2) /*!< SWDTCLK/16 */
|
||
|
|
#define SWDT_CLOCK_DIV32 (SWDT_CR_CKS_2 | SWDT_CR_CKS_0) /*!< SWDTCLK/32 */
|
||
|
|
#define SWDT_CLOCK_DIV64 (SWDT_CR_CKS_2 | SWDT_CR_CKS_1) /*!< SWDTCLK/64 */
|
||
|
|
#define SWDT_CLOCK_DIV128 (SWDT_CR_CKS_2 | SWDT_CR_CKS_1 | SWDT_CR_CKS_0) /*!< SWDTCLK/128 */
|
||
|
|
#define SWDT_CLOCK_DIV256 (SWDT_CR_CKS_3) /*!< SWDTCLK/256 */
|
||
|
|
#define SWDT_CLOCK_DIV2048 (SWDT_CR_CKS_3 | SWDT_CR_CKS_1 | SWDT_CR_CKS_0) /*!< SWDTCLK/2048 */
|
||
|
|
/**
|
||
|
|
* @}
|
||
|
|
*/
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @defgroup SWDT_Refresh_Percent_Range SWDT Refresh Percent Range
|
||
|
|
* @{
|
||
|
|
*/
|
||
|
|
#define SWDT_RANGE_0TO100PCT (0UL) /*!< 0%~100% */
|
||
|
|
#define SWDT_RANGE_0TO25PCT (SWDT_CR_WDPT_0) /*!< 0%~25% */
|
||
|
|
#define SWDT_RANGE_25TO50PCT (SWDT_CR_WDPT_1) /*!< 25%~50% */
|
||
|
|
#define SWDT_RANGE_0TO50PCT (SWDT_CR_WDPT_1 | SWDT_CR_WDPT_0) /*!< 0%~50% */
|
||
|
|
#define SWDT_RANGE_50TO75PCT (SWDT_CR_WDPT_2) /*!< 50%~75% */
|
||
|
|
#define SWDT_RANGE_0TO25PCT_50TO75PCT (SWDT_CR_WDPT_2 | SWDT_CR_WDPT_0) /*!< 0%~25% & 50%~75% */
|
||
|
|
#define SWDT_RANGE_25TO75PCT (SWDT_CR_WDPT_2 | SWDT_CR_WDPT_1) /*!< 25%~75% */
|
||
|
|
#define SWDT_RANGE_0TO75PCT (SWDT_CR_WDPT_2 | SWDT_CR_WDPT_1 | SWDT_CR_WDPT_0) /*!< 0%~75% */
|
||
|
|
#define SWDT_RANGE_75TO100PCT (SWDT_CR_WDPT_3) /*!< 75%~100% */
|
||
|
|
#define SWDT_RANGE_0TO25PCT_75TO100PCT (SWDT_CR_WDPT_3 | SWDT_CR_WDPT_0) /*!< 0%~25% & 75%~100% */
|
||
|
|
#define SWDT_RANGE_25TO50PCT_75TO100PCT (SWDT_CR_WDPT_3 | SWDT_CR_WDPT_1) /*!< 25%~50% & 75%~100% */
|
||
|
|
#define SWDT_RANGE_0TO50PCT_75TO100PCT (SWDT_CR_WDPT_3 | SWDT_CR_WDPT_1 | SWDT_CR_WDPT_0) /*!< 0%~50% & 75%~100% */
|
||
|
|
#define SWDT_RANGE_50TO100PCT (SWDT_CR_WDPT_3 | SWDT_CR_WDPT_2) /*!< 50%~100% */
|
||
|
|
#define SWDT_RANGE_0TO25PCT_50TO100PCT (SWDT_CR_WDPT_3 | SWDT_CR_WDPT_2 | SWDT_CR_WDPT_0) /*!< 0%~25% & 50%~100% */
|
||
|
|
#define SWDT_RANGE_25TO100PCT (SWDT_CR_WDPT_3 | SWDT_CR_WDPT_2 | SWDT_CR_WDPT_1) /*!< 25%~100% */
|
||
|
|
/**
|
||
|
|
* @}
|
||
|
|
*/
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @defgroup SWDT_LPW_Mode_Count SWDT Low Power Mode Count
|
||
|
|
* @brief SWDT count control in the sleep/stop mode
|
||
|
|
* @{
|
||
|
|
*/
|
||
|
|
#define SWDT_LPM_COUNT_CONTINUE (0UL) /*!< SWDT count continue in the sleep/stop mode */
|
||
|
|
#define SWDT_LPM_COUNT_STOP (SWDT_CR_SLPOFF) /*!< SWDT count stop in the sleep/stop mode */
|
||
|
|
/**
|
||
|
|
* @}
|
||
|
|
*/
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @defgroup SWDT_Trigger_Event_Type SWDT Trigger Event Type
|
||
|
|
* @{
|
||
|
|
*/
|
||
|
|
#define SWDT_TRIG_EVENT_INT (0UL) /*!< SWDT trigger interrupt */
|
||
|
|
#define SWDT_TRIG_EVENT_RESET (SWDT_CR_ITS) /*!< SWDT trigger reset */
|
||
|
|
/**
|
||
|
|
* @}
|
||
|
|
*/
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @defgroup SWDT_Flag SWDT Flag
|
||
|
|
* @{
|
||
|
|
*/
|
||
|
|
#define SWDT_FLAG_UDF (SWDT_SR_UDF) /*!< Count underflow flag */
|
||
|
|
#define SWDT_FLAG_REF (SWDT_SR_REF) /*!< Refresh error flag */
|
||
|
|
/**
|
||
|
|
* @}
|
||
|
|
*/
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @}
|
||
|
|
*/
|
||
|
|
|
||
|
|
/*******************************************************************************
|
||
|
|
* Global variable definitions ('extern')
|
||
|
|
******************************************************************************/
|
||
|
|
|
||
|
|
/*******************************************************************************
|
||
|
|
Global function prototypes (definition in C source)
|
||
|
|
******************************************************************************/
|
||
|
|
/**
|
||
|
|
* @addtogroup SWDT_Global_Functions
|
||
|
|
* @{
|
||
|
|
*/
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief Get SWDT count value.
|
||
|
|
* @param None
|
||
|
|
* @retval Count value
|
||
|
|
*/
|
||
|
|
__STATIC_INLINE uint16_t SWDT_GetCountValue(void)
|
||
|
|
{
|
||
|
|
return (uint16_t)(READ_REG32(M4_SWDT->SR) & SWDT_SR_CNT);
|
||
|
|
}
|
||
|
|
|
||
|
|
/* Initialization and configuration functions */
|
||
|
|
en_result_t SWDT_Init(const stc_swdt_init_t *pstcSwdtInit);
|
||
|
|
void SWDT_Feed(void);
|
||
|
|
uint16_t SWDT_GetCountValue(void);
|
||
|
|
|
||
|
|
/* Flags management functions */
|
||
|
|
en_flag_status_t SWDT_GetStatus(uint32_t u32Flag);
|
||
|
|
en_result_t SWDT_ClearStatus(uint32_t u32Flag);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @}
|
||
|
|
*/
|
||
|
|
|
||
|
|
#endif /* DDL_SWDT_ENABLE */
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @}
|
||
|
|
*/
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @}
|
||
|
|
*/
|
||
|
|
|
||
|
|
#ifdef __cplusplus
|
||
|
|
}
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#endif /* __HC32F4A0_SWDT_H__ */
|
||
|
|
|
||
|
|
/*******************************************************************************
|
||
|
|
* EOF (not truncated)
|
||
|
|
******************************************************************************/
|