CREELINKS平台_处理器CeCcp资源使用说明(CeCcp的配置与使用)

提示：扫一扫查出行
【扫一扫了解最新限行尾号】
复制提示

0x00 CREELINKS平台简介

CREELINKS(创e联)是由大信科技有限公司研发，集合软硬件、操作系统、数据云储存、开发工具于一体，用于物联网产品的设计、研发与生产的平台。
平台涉及智能硬件、车联网、智能家居、可穿戴设备、工业控制等各个物联网领域。旨在辅助中小型企业快速完成物联网产品原型的设计与开发；并为开源软硬件爱好者、硬件DIY极客、教育机构等提供更高效的资源。
平台包含通用功能模块、操作系统、核心库、模块驱动库、物联网典型产品的解决方案及相关开发工具。

CREELINKS http://www.creelinks.com

0x01 处理器CeCcp资源是什么？

CeCcp资源是CREELINKS平台中将不同处理器平台中计数器（脉冲计数器）的共性提取出来，整理并编写出来的标准库。CeAd标准库包含了Ad操作相关的所有属性及API接口函数，如: 开始计数、停止计数、获得当前Ccp计数的值、清除计数等、。其标准库的头文件为CeCcp.h，不同处理器平台实现的源文件名统一为CeCcp.c。

详细介绍如下：

1、资源介绍

Creelinks平台Ccp对象的操作头文件，包含有关处理器平台Ccp内容的相关操作。可能不同处理器平台，Ccp计数的最大值有所不同，所以使用Ccp资源时，尽量使用CeMcu.h中的相关Ccp属性宏定义。

2、相关配置

在CeMcu.h中有与处理器平台有关的配置项如下：

#define CE_CCP_MAX_COUNT (uint32)65535 /*!< CCP所支持的最大计数值*/

其中：

CE_CCP_MAX_COUNT：因受处理器的计数器硬件结构限制，不同处理器平台的计数器可计数的最大值不同，则用户在设定计数器的最大值时，请误超过此值。

3、属性对象

/** * @brief 结构体，CCP对象可用属性集合 */ typedef struct { CE_RESOURCE ceResource; /*!< Ccp对应的资源号*/ uint32 ceCntVal; /*!< 用户设定的Ccp计数临界值*/ void* pAddPar; /*!< 空指针，可用于传递额外参数*/ void (*callBackReachCntVal)(void* pAddPar); /*!< Ccp计数到达用户设置的临界值后，需要执行的回调函数*/ CeExCcpPar ceExCcpPar; /*!< 与处理器平台相关的额外参数结构体，用以提高代码效率，用户无须关注*/ }CeCcp;

其中：

ceResource：对应核心模块的Ccp资源号，只要在核心板上，资源接口中带C标号即可。

ceCntVal：用户需设定的当前最大计数值，即达到此计数后即进入中断并调用用户提供的回调函数。

pAddPar：在调用回调函数时，传入的对象，可指向任意值。

callBackReachCntVal：用户需提供的当达到设定的最大计数值后，系统调用的用户回调，此回调一般均在中断中执行，故用户不要在回调内做大量耗时操作，以免影响系统性能。

ceExPwmPar：用于存不同的处理器平台,Ccp属性对象需要的额外参数。此结构体在CeMcu.h文件中定义。

4、操作对象

/** * @brief 结构体，CCP对象可用操作集合 */ typedef struct { CE_STATUS (*initial)(CeCcp* ceCcp); /*!< @brief 初始化Ccp计数器 @param ceCcp:ceCcp属性对象指针*/ void (*start)(CeCcp* ceCcp); /*!< @brief 开始Ccp计数 @param ceCcp:ceCcp属性对象指针*/ void (*stop)(CeCcp* ceCcp); /*!< @brief 停止Ccp计数 @param ceCcp:ceCcp属性对象指针*/ uint32 (*getNowCcpCnt)(CeCcp* ceCcp); /*!< @brief 获得当前Ccp计数的值，此值一定小于等于ceMaxCnt @param ceCcp:ceCcp属性对象指针 @return 获取本次计数周期的计数值*/ uint32 (*getAllCcpCnt)(CeCcp* ceCcp); /*!< @brief 获得从开始计数起(调用startCcp时开始)，到现在一共的计数值 @param ceCcp:ceCcp属性对象指针 @return 获取从开始计数到目前为止总的计数值*/ void (*clearCcpCnt)(CeCcp* ceCcp); /*!< @brief 清除计数，从0开始重新计数 @param ceCcp:ceCcp属性对象指针*/ }CeCcpOpBase; extern const CeCcpOpBase ceCcpOp; /*!< 所有与Ccp相关的操作*/

其中：

initial：对一个Ccp资源进行初始化，如果在CeMcu.h中的宏定义 __CE_CHECK_PAR__处于打开状态，则会对输入的CeCcp属性对象进行参数检查。

start：开始Ccp计数，开始计数时不会重置当前的计数值。

stop：停止Ccp计数，停止后，Ccp计数器操持各个寄存器的值不变，在下次调用start时，还将会在之前的基础上进行脉冲计数。

getNowCcpCnt：获得当前的计数值，即在未达到用户提供的最大计数值时，当前的计数值。一旦到达最大值后，调用回调后，则清空此值，并重新计数。

getAllCcpCnt：获得从Ccp第一次执行start开始到目前的计数总值，除非调用clearCcpCnt，否则内部计数不会清空。

clearCcpCnt：清空有关Ccp所有的计数寄存器，全部从0开始。

5、执行流程

6、应用示例

/** ****************************************************************************** * @brief 使用流程及示例程序(基于前后台非操作系统环境) * @function 设定Ccp的最大计数值为10，并每500ms读取当前值并通过Uart输出到上位机 ****************************************************************************** #include "Creelinks.h" CeCcp myCcp; //Ccp属性对象 uint8 ccpCount; //当前Ccp的计数值 // @brief Ccp计数器达到设置值后的事件回调 // @param pAddPar:Ccp对像指针里的pAddPar参数 void ceCcpReachCntCallBack(void* pAddPar) { ceSystemOp.printf("Ccp is reach setting count!\n"); } int main(void) { ceSystemOp.initial(); //Creelinks环境初始化 ceSystemOp.initialDebug(RxUart); //通过Uart串口输出Debug信息到上位机 //TODO:请在此处插入模块初始化等操作 myCcp.ceResource = RxC; //指定计数器资源号 myCcp.ceCntVal = 10; //指定计数到何值后，进入中断回调 myCcp.callBackReachCntVal = ceCcpReachCntCallBack;//指定回调函数 myCcp.pAddPar = &myCcp; //指定属性中空指针为本身，中断回调中传入此指针 ceCcpOp.initial(&myCcp); //初始化计数器 ceCcpOp.start(&myCcp); //开始计数 while (1) { ceSystemOp.mainTask(); //Creelinks环境主循环任务，请保证此函数能够被周期调用 //TODO:请在此处插入用户操作 ccpCount = ceCcpOp.getNowCcpCnt(&myCcp); //获得当前计数值 ceSystemOp.printf("Ccp count is %d\n", ccpCount);//打印当前计数值 ceSystemOp.delayMs(500); //延时500ms }; } ****************************************************************************** */