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)
|
|||
|
|
*****************************************************************************/
|
|||
|
|
|
|||
|
|
|