/cpost

Primary LanguageCMIT LicenseMIT

cpost

c语言程序上下文切换和解耦的工具

简介

cpost是一个c语言编写的,用于c语言程序上下文切换和解耦的工具

cpost包含cpostcevent两个工具,cpost用于c语言的上下文切换,cevent用于程序模块之间的解耦

cpost借鉴了Android的Handler机制,在c语言环境中,可以通过调用cpost接口,将函数抛出到另外的线程(上下文)中运行,对于某些场景,尤其是嵌入式编程无操作系统环境下的中断延迟处理

cevent借鉴了Android的广播机制,在c语言环境中,当程序运行至相应的位置,可以通过cevent接口抛出一个事件,其他模块可以通过注册的方式,监听这个事件,当事件发生时,调用注册的函数,能很大程度上实现模块间的解耦

使用

cpostcevent可以同时使用,也可以独立使用,特别针对于嵌入式无操作系统的环境,使用cpostcevent,可以简化编程,更容易实现模块化的编程

cpost使用

以使用在嵌入式无操作系统中为例,主要用作中断延迟处理的情况

  1. 配置系统tick

    配置cpost.h中的宏CPOST_GET_TICK(),配置成获取系统tick

  2. 配置处理进程

    在main loop调用cpostProcess函数,通过cpost执行的函数都会在cpostProcess中执行

cevent使用

cevent使用注册的方式监听事件,会依赖于编译环境,目前支持keil,iar,和gcc,对于gcc,需要修改链接文件(.ld),在只读数据区添加:

_cevent_start = .;
KEEP (*(cEvent))
_cevent_end = .;
  1. 初始化cevent

    系统初始化时,调用ceventInit

    ceventInit();
  2. 注册cevent事件监听

    在c文件中,调用CEVENT_EXPORT导出事件监听

    CEVENT_EXPORT(0, handler, (void *)param);
  3. 发送cevent事件

    在事件发生的地方,调用ceventPost抛出事件

    ceventPost(0);

Api

cpost提供了简单的接口用于延迟处理函数,其接口设计和Android的Handler设计类似,cevnet提供了一个事件发送接口,用于抛出事件

post

post接口会将函数抛出,然后在cpostProcess中立刻执行

signed char cpost(void *handler);
  • 参数

    • handler 被抛出的函数
  • 返回值

    • signed char 0 post成功 -1 post失败
signed char cpostEx(void *handler, void *param);
  • 参数

    • handler 被抛出的函数
    • param 传递给被抛出函数的参数
  • 返回值

    • signed char 0 post成功 -1 post失败

post delay

post delay接口会将函数抛出,然后在挂起在cpostProcess中,当延时时间达到后执行

signed char cpostDelay(void *handler, size_t delay);
  • 参数

    • handler 被抛出的函数
    • delay 延时时间(tick)
  • 返回值

    • signed char 0 post成功 -1 post失败
signed char cpostDelayEx(void *handler, void *param, size_t delay);
  • 参数

    • handler 被抛出的函数
    • param 传递给被抛出函数的参数
    • delay 延时时间(tick)
  • 返回值

    • signed char 0 post成功 -1 post失败

event post

event post接口会抛出事件,事件定义为一个unsigned short整形,建议通过宏定义所有事件

void ceventPost(unsigned short event);
  • 参数

    • event 事件

event export

event post接口会静态注册一个事件监听,注意,此接口实际上为定义一个全局的常量,所以需要写在函数体外

CEVENT_EXPORT(_event, _func, ...)
  • 参数

    • _event 被监听的事件
    • _func 事件发生时,执行的函数
    • ... 需要传递给_func函数的参数