2. 开源代码
  3. [代码分享]一个简单好用的轮询延时器模块

[代码分享]一个简单好用的轮询延时器模块

admin 2017-5-24 3346


关键字：延时器；非阻塞自由延时


在一些按键或其它形式的命令响应中，要求严格的话通常会需要队列缓存命令，以防丢失。

但是我通常还会遇到一些要求非常不严格的场景，这些场景甚至要限制响应的次数或频率（这里指不能响应太快）。
比如（只是个例子），我的产品是一个根据接收到的串口命令来工作的。串口命令发送的速度是不确定的，有时候1秒
会发送10帧命令过来，有的时候1秒确能发送100帧，但是这个产品每秒只打算处理20帧命令。而且由于命令有多个，
对于有些命令码可能每秒响应40帧或30帧等，这种场景用多个延时器就很合适了。


延时器模块的接口函数一共3个，如下：

  1. /* Exported functions ------------------------------------------------------- */
  2. bool zl_poll_delay_set(uint8_t chUserId, uint16_t hwTime);
  3. bool zl_poll_delay_timeout(uint8_t chUserId);
  4. void zl_poll_delay_tick(void);
复制代码



看下接口函数的实现，很简单的

  1. /*   Z L _ P O L L _ D E L A Y _ S E T   */
  2. /*-------------------------------------------------------------------------
  3. 功能描述  : 设定延时时间，同时启动延时。
  4. 输入参数  : uint8_t chUserId  延时器ID
  5.              uint16_t hwTime   延时时间
  6. 输出参数  : 无
  7. 返 回 值  : 

  9. 修改历史      
  10.   1.日    期   : 2017年2月6日
  11.     作    者   : zys
  12.     修改内容   : 新生成函数,OK。

  14. -------------------------------------------------------------------------*/
  15. bool zl_poll_delay_set(uint8_t chUserId, uint16_t hwTime)
  16. {
  17.     if (chUserId >= ZL_POLL_DELAY_NUM) {
  18.         return false;
  19.     }

  21.     if (0 == hwTime) {
  22.         return false;
  23.     }

  25.     s_tPollBuf[chUserId].Time = hwTime;

  27.     return true;

  29. }


  32. /*   Z L _ P O L L _ D E L A Y _ T I M E O U T   */
  33. /*-------------------------------------------------------------------------
  34. 功能描述  : 查询给定ID的延时器是否超时。
  35. 输入参数  : uint8_t chUserId  
  36. 输出参数  : 无
  37. 返 回 值  : true 超时；false 未超时。

  39. 修改历史      
  40.   1.日    期   : 2017年5月22日
  41.     作    者   : zys
  42.     修改内容   : 新生成函数。

  44. -------------------------------------------------------------------------*/
  45. bool zl_poll_delay_timeout(uint8_t chUserId)
  46. {
  47.     if (chUserId >= ZL_POLL_DELAY_NUM) {
  48.         return false;
  49.     }

  51.     if ( !s_tPollBuf[chUserId].Time) {
  52.         return true;
  53.     }

  55.     return false;
  56. }


  59. /*   Z L _ P O L L _ D E L A Y _ T I C K   */
  60. /*-------------------------------------------------------------------------
  61. 功能描述  : 延时模块的驱动任务，在心跳中断里运行。
  62. 输入参数  : void  
  63. 输出参数  : 无
  64. 返 回 值  : 

  66. 修改历史      
  67.   1.日    期   : 2017年5月22日
  68.     作    者   : zys
  69.     修改内容   : 新生成函数。

  71. -------------------------------------------------------------------------*/
  72. void zl_poll_delay_tick(void)
  73. {
  74.     uint8_t i;


  77.     for ( i = 0 ; i < ZL_POLL_DELAY_NUM; i++ ) {
  78.         if (s_tPollBuf[i].Time) {
  79.             s_tPollBuf[i].Time--;
  80.         }
  81.     }
  82. }
复制代码



模块的使用
使用很简单，首先把模块源文件添加到工程中，然后把

  1. void zl_poll_delay_tick(void)
复制代码


放到心跳中断里，我一般用1ms的心跳中断。


现在就能使用

  1. bool zl_poll_delay_set(uint8_t chUserId, uint16_t hwTime)
复制代码


来设置延时器了，入参分别是延时器的ID和延时时间，延时时间单位和心跳中断有关，看自己需求了。。。


然后用

  1. bool zl_poll_delay_timeout(uint8_t chUserId)
复制代码


来查询延时器是否超时，入参是要查询的延时器ID号。


延时器的可用最大数量通过宏定义配置

  1. /* 定义可用的延时数量 */
  2. #define ZL_POLL_DELAY_NUM   5
复制代码





模拟一个应用场景演示代码



  3. /* 定义延时器信息，便于阅读修改 */
  4. #define DELAY_ID0           0
  5. #define DELAY_TIME0         50

  7. #define DELAY_ID1           1
  8. #define DELAY_TIME1         900



  12. /* 模拟一个应用场景 */
  13. void xxx_cmd_process(uint8_t chCmd)
  14. {
  15.     switch (chCmd) {
  16.     case CMD_LEFT:

  18.         /* 该命令执行间隔不能小于50ms */
  19.         if (zl_poll_delay_timeout(DELAY_ID0)) {
  20.             zl_poll_delay_set(DELAY_ID0, DELAY_TIME0);

  22.             cmd_do_left();
  23.         }
  24.         break;

  26.     case CMD_RIGHT:

  28.         /* 该命令执行间隔不能小于900ms */
  29.         if (zl_poll_delay_timeout(DELAY_ID1)) {
  30.             zl_poll_delay_set(DELAY_ID1, DELAY_TIME1);

  32.             cmd_do_left();
  33.         }
  34.         break;

  36.     case CMD_UP:

  38.         /* 该命令无限制，来就执行 */
  39.         cmd_do_up();
  40.         break;

  42.     case CMD_DOWN:
  43.         break;

  45.     default:
  46.         break;
  47.     }
  48. }


  51. /* 在1ms心跳（时基）中断里运行 */
  52. void st_systick_1ms_irq(void)
  53. {
  54.     zl_poll_delay_tick（）
  55. }
复制代码




延时器的用处还有很多，可以灵活。。。


上传的附件：
最新回复 [0]
返回
发新帖
作者最近主题：