302 lines
12 KiB
C
302 lines
12 KiB
C
/******************************************************************************
|
||
* Copyright (C) 2017, Huada Semiconductor Co.,Ltd All rights reserved.
|
||
*
|
||
* This software is owned and published by:
|
||
* Huada Semiconductor Co.,Ltd ("HDSC").
|
||
*
|
||
* BY DOWNLOADING, INSTALLING OR USING THIS SOFTWARE, YOU AGREE TO BE BOUND
|
||
* BY ALL THE TERMS AND CONDITIONS OF THIS AGREEMENT.
|
||
*
|
||
* This software contains source code for use with HDSC
|
||
* components. This software is licensed by HDSC to be adapted only
|
||
* for use in systems utilizing HDSC components. HDSC shall not be
|
||
* responsible for misuse or illegal use of this software for devices not
|
||
* supported herein. HDSC is providing this software "AS IS" and will
|
||
* not be responsible for issues arising from incorrect user implementation
|
||
* of the software.
|
||
*
|
||
* Disclaimer:
|
||
* HDSC MAKES NO WARRANTY, EXPRESS OR IMPLIED, ARISING BY LAW OR OTHERWISE,
|
||
* REGARDING THE SOFTWARE (INCLUDING ANY ACOOMPANYING WRITTEN MATERIALS),
|
||
* ITS PERFORMANCE OR SUITABILITY FOR YOUR INTENDED USE, INCLUDING,
|
||
* WITHOUT LIMITATION, THE IMPLIED WARRANTY OF MERCHANTABILITY, THE IMPLIED
|
||
* WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE OR USE, AND THE IMPLIED
|
||
* WARRANTY OF NONINFRINGEMENT.
|
||
* HDSC SHALL HAVE NO LIABILITY (WHETHER IN CONTRACT, WARRANTY, TORT,
|
||
* NEGLIGENCE OR OTHERWISE) FOR ANY DAMAGES WHATSOEVER (INCLUDING, WITHOUT
|
||
* LIMITATION, DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION,
|
||
* LOSS OF BUSINESS INFORMATION, OR OTHER PECUNIARY LOSS) ARISING FROM USE OR
|
||
* INABILITY TO USE THE SOFTWARE, INCLUDING, WITHOUT LIMITATION, ANY DIRECT,
|
||
* INDIRECT, INCIDENTAL, SPECIAL OR CONSEQUENTIAL DAMAGES OR LOSS OF DATA,
|
||
* SAVINGS OR PROFITS,
|
||
* EVEN IF Disclaimer HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
|
||
* YOU ASSUME ALL RESPONSIBILITIES FOR SELECTION OF THE SOFTWARE TO ACHIEVE YOUR
|
||
* INTENDED RESULTS, AND FOR THE INSTALLATION OF, USE OF, AND RESULTS OBTAINED
|
||
* FROM, THE SOFTWARE.
|
||
*
|
||
* This software may be replicated in part or whole for the licensed use,
|
||
* with the restriction that this Disclaimer and Copyright notice must be
|
||
* included with each copy of this software, whether used in part or whole,
|
||
* at all times.
|
||
*/
|
||
/*****************************************************************************/
|
||
/** \file pca.h
|
||
**
|
||
** PCA（可编程计数阵列）数据结构及API声明
|
||
**
|
||
**
|
||
** History:
|
||
** - 2017-04-15 Husj First version
|
||
**
|
||
*****************************************************************************/
|
||
|
||
#ifndef __PCA_H__
|
||
#define __PCA_H__
|
||
|
||
/*****************************************************************************
|
||
* Include files
|
||
*****************************************************************************/
|
||
#include "ddl.h"
|
||
#include "interrupts_hc32l136.h"
|
||
|
||
#ifdef __cplusplus
|
||
extern "C"
|
||
{
|
||
#endif
|
||
|
||
/**
|
||
******************************************************************************
|
||
** \defgroup PcaGroup Programmable Counter Array (PCA)
|
||
**
|
||
******************************************************************************/
|
||
//@{
|
||
|
||
/******************************************************************************/
|
||
/* Global pre-processor symbols/macros ('#define') */
|
||
/******************************************************************************/
|
||
|
||
/******************************************************************************
|
||
* Global type definitions
|
||
******************************************************************************/
|
||
|
||
/**
|
||
******************************************************************************
|
||
** \brief PCA 模块选择数据类型重定义
|
||
*****************************************************************************/
|
||
typedef enum en_pca_module
|
||
{
|
||
Module0 = 0u, ///< 模块0
|
||
Module1 = 1u, ///< 模块1
|
||
Module2 = 2u, ///< 模块2
|
||
Module3 = 3u, ///< 模块3
|
||
Module4 = 4u, ///< 模块4
|
||
}en_pca_module_t;
|
||
|
||
/**
|
||
******************************************************************************
|
||
** \brief PCA 计数启/停控制数据类型重定义 (CR)
|
||
*****************************************************************************/
|
||
typedef enum en_pca_start
|
||
{
|
||
CRStop = 0u, ///< 停止计数
|
||
CRStart = 1u, ///< 开始计数
|
||
}en_pca_start_t;
|
||
|
||
/**
|
||
******************************************************************************
|
||
** \brief PCA IDLE 模式下启/停控制数据类型重定义 (CIDL)
|
||
*****************************************************************************/
|
||
typedef enum en_pca_cidl
|
||
{
|
||
IdleGoOn = 0u, ///< 休眠模式下 PCA继续工作
|
||
IdleStop = 1u, ///< 休眠模式下 PCA停止工作
|
||
}en_pca_cidl_t;
|
||
|
||
/**
|
||
******************************************************************************
|
||
** \brief PCA 模块4 WDT功能控制数据类型重定义 (WDTE)
|
||
*****************************************************************************/
|
||
typedef enum en_pca_wdte
|
||
{
|
||
PCAWDTDisable = 0u, ///< 关闭 PCA模块4 WDT功能
|
||
PCAWDTEnable = 1u, ///< 启动 PCA模块4 WDT功能
|
||
}en_pca_wdte_t;
|
||
|
||
/**
|
||
******************************************************************************
|
||
** \brief PCA 时钟分频及时钟源选择功能数据类型重定义 (CPS)
|
||
*****************************************************************************/
|
||
typedef enum en_pca_clksel
|
||
{
|
||
PCAPCLKDiv32 = 0u, ///< PCLK/32
|
||
PCAPCLKDiv16 = 1u, ///< PCLK/16
|
||
PCAPCLKDiv8 = 2u, ///< PCLK/8
|
||
PCAPCLKDiv4 = 3u, ///< PCLK/4
|
||
PCAPCLKDiv2 = 4u, ///< PCLK/2
|
||
PCATimer0Over = 5u, ///< timer0 overflow
|
||
PCATimer1Over = 6u, ///< timer1 overflow
|
||
PCAECI = 7u, ///< ECI 外部时钟,时钟PCLK四分频采样
|
||
}en_pca_clksel_t;
|
||
|
||
/**
|
||
******************************************************************************
|
||
** \brief PCA 允许比较器功能控制数据类型重定义 (ECOM)
|
||
*****************************************************************************/
|
||
typedef enum en_pca_ecom
|
||
{
|
||
ECOMDisable = 0u, ///< 禁止比较器功能
|
||
ECOMEnable = 1u, ///< 允许比较器功能
|
||
}en_pca_ecom_t;
|
||
|
||
/**
|
||
******************************************************************************
|
||
** \brief PCA 正沿捕获控制位数据类型重定义 (CAPP)
|
||
*****************************************************************************/
|
||
typedef enum en_pca_capp
|
||
{
|
||
CAPPDisable = 0u, ///< 禁止上升沿捕获
|
||
CAPPEnable = 1u, ///< 允许上升沿捕获
|
||
}en_pca_capp_t;
|
||
|
||
/**
|
||
******************************************************************************
|
||
** \brief PCA 负沿捕获控制位数据类型重定义 (CAPN)
|
||
*****************************************************************************/
|
||
typedef enum en_pca_capn
|
||
{
|
||
CAPNDisable = 0u, ///< 禁止下降沿捕获
|
||
CAPNEnable = 1u, ///< 允许下降沿捕获
|
||
}en_pca_capn_t;
|
||
|
||
/**
|
||
******************************************************************************
|
||
** \brief PCA 匹配控制位数据类型重定义 (MAT)
|
||
*****************************************************************************/
|
||
typedef enum en_pca_mat
|
||
{
|
||
MATDisable = 0u, ///< 禁止匹配
|
||
MATEnable = 1u, ///< 允许匹配
|
||
}en_pca_mat_t;
|
||
|
||
/**
|
||
******************************************************************************
|
||
** \brief PCA 翻转控制位数据类型重定义 (TOG)
|
||
*****************************************************************************/
|
||
typedef enum en_pca_tog
|
||
{
|
||
TOGDisable = 0u, ///< 禁止翻转功能
|
||
TOGEnable = 1u, ///< 允许翻转功能
|
||
}en_pca_tog_t;
|
||
|
||
/**
|
||
******************************************************************************
|
||
** \brief PCA 8bit脉宽调制控制数据类型重定义 (8bitPWM)
|
||
*****************************************************************************/
|
||
typedef enum en_pca_pwm_8_bit
|
||
{
|
||
PCA8bitPWMDisable = 0u, ///< 禁止 PWM功能
|
||
PCA8bitPWMEnable = 1u, ///< 允许CCPx引脚作为PWM输出
|
||
}en_pca_8bit_pwm_t;
|
||
|
||
/**
|
||
******************************************************************************
|
||
** \brief PCA 16bit脉宽调制控制数据类型重定义 (16bitPWM)
|
||
*****************************************************************************/
|
||
typedef enum en_pca_pwm_16_bit
|
||
{
|
||
PCA16bitPWMDisable = 0u, ///< 16bitPWM 禁止
|
||
PCA16bitPWMEnable = 1u, ///< 16bitPWM 使能
|
||
}en_pca_16bit_pwm_t;
|
||
|
||
/**
|
||
******************************************************************************
|
||
** \brief PCA 配置结构体定义
|
||
*****************************************************************************/
|
||
typedef struct stc_pca_config
|
||
{
|
||
en_pca_cidl_t enCIDL; ///< 模式下启/停控制
|
||
en_pca_wdte_t enWDTE; ///< WDT功能控制
|
||
en_pca_clksel_t enCPS; ///< 时钟分频及时钟源选择功能
|
||
|
||
func_ptr_t pfnPcaCb; ///< Pca中断服务回调函数[void function(void)]
|
||
}stc_pca_config_t;
|
||
|
||
/**
|
||
******************************************************************************
|
||
** \brief PCA 捕获模式配置结构体定义
|
||
*****************************************************************************/
|
||
typedef struct stc_pca_capmodconfig
|
||
{
|
||
en_pca_ecom_t enECOM; ///< 允许比较器功能控制
|
||
en_pca_capp_t enCAPP; ///< 正沿捕获控制
|
||
en_pca_capn_t enCAPN; ///< 负沿捕获控制
|
||
en_pca_mat_t enMAT; ///< 匹配控制
|
||
en_pca_tog_t enTOG; ///< 翻转控制
|
||
en_pca_8bit_pwm_t en8bitPWM; ///< 8位脉宽调制控制
|
||
}stc_pca_capmodconfig_t;
|
||
|
||
/******************************************************************************
|
||
* Global variable declarations ('extern', definition in C source)
|
||
*****************************************************************************/
|
||
|
||
/******************************************************************************
|
||
* Global function prototypes (definition in C source)
|
||
*****************************************************************************/
|
||
//Interrupt related
|
||
//PCA中断标志获取
|
||
boolean_t Pca_GetIntFlag(en_pca_module_t enModule);
|
||
//PCA计数器中断标志获取
|
||
boolean_t Pca_GetCntIntFlag(void);
|
||
//PCA中断标志清除
|
||
en_result_t Pca_ClearIntFlag(en_pca_module_t enModule);
|
||
//PCA计数器中断标志清除
|
||
en_result_t Pca_ClearCntIntFlag(void);
|
||
//PCA中断使能
|
||
en_result_t Pca_EnableIrq (en_pca_module_t enModule);
|
||
//PCA计数器中断使能
|
||
en_result_t Pca_EnableCntIrq (void);
|
||
//PCA中断关闭
|
||
en_result_t Pca_DisableIrq(en_pca_module_t enModule);
|
||
//PCA计数器中断关闭
|
||
en_result_t Pca_DisableCntIrq(void);
|
||
|
||
//PCA配置及操作
|
||
//PCA初始化
|
||
en_result_t Pca_Init(stc_pca_config_t* pstcConfig);
|
||
//PCA捕获模式配置
|
||
en_result_t Pca_CapModConfig(en_pca_module_t enModule, stc_pca_capmodconfig_t* pstcCapMod);
|
||
//PCA计数器启动/停止
|
||
en_result_t Pca_Run(void);
|
||
en_result_t Pca_Stop(void);
|
||
//PCA16位比较数据设置
|
||
en_result_t Pca_CmpData16Set(en_pca_module_t enModule, uint16_t u16Data);
|
||
//PCA捕获16位数据获取
|
||
uint16_t Pca_CapData16Get(en_pca_module_t enModule);
|
||
//PCA比较数据高8位设置
|
||
en_result_t Pca_CmpDataHSet(en_pca_module_t enModule, uint8_t u8Data);
|
||
//PCA比较数据低8位设置
|
||
en_result_t Pca_CmpDataLSet(en_pca_module_t enModule, uint8_t u8Data);
|
||
//PCA计数值设置/获取
|
||
en_result_t Pca_Cnt16Set(uint16_t u16Data);
|
||
uint16_t Pca_Cnt16Get(void);
|
||
//PCA周期重载值设置/获取
|
||
en_result_t Pca_CARRSet(uint16_t u16Data);
|
||
uint16_t Pca_CARRGet(void);
|
||
//PCA 增强PWM功能使能/禁止
|
||
en_result_t Pca_Enable16bitPWM(void);
|
||
en_result_t Pca_Disable16bitPWM(void);
|
||
//PCA比较高速输出标志获取
|
||
boolean_t Pca_GetCmpHighFlag(en_pca_module_t enModule);
|
||
//@} // PcaGroup
|
||
|
||
#ifdef __cplusplus
|
||
#endif
|
||
|
||
|
||
#endif /* __PCA_H__ */
|
||
/******************************************************************************
|
||
* EOF (not truncated)
|
||
*****************************************************************************/
|
||
|
||
|