ESP8266学习笔记（4）——定时器接口使用（NONOS SDK）

一、软件定时器

1.1 简介

以下软件定时器接口位于 /ESP8266_NONOS_SDK/include/osapi.h。请注意，以下接口使用的定时器由软件实现，定时器的函数在任务中被执行。因为任务可能被中断，或者被其他高优先级的任务延迟，因此以下 os_timer 系列的接口并不能保证定时器精确执行。

如果需要精确的定时，例如，周期性操作某 GPIO，请使用硬件中断定时器，具体可参考hw_timer.c，硬件定时器的执行函数在中断里被执行。

注意：
• 对于同一个 timer， os_timer_arm 或 os_timer_arm_us 不能重复调用，必须先os_timer_disarm。
• os_timer_setfn 必须在 timer 未使能的情况下调用，在 os_timer_arm 或os_timer_arm_us 之前或者 os_timer_disarm 之后。

1.2 使用步骤

①、先宏定义一个定时器结构体。

// 定时器结构体 
static os_timer_t os_timer;

②、对于同一个定时器不能同时使用，所以在初始化前先关闭该定时器。

// 关闭该定时器 
os_timer_disarm( &os_timer );

③、初始化定时器的回调函数，即每次定时任务函数。

// 配置该定时器回调函数 
os_timer_setfn( &os_timer, (os_timer_func_t *) func_callback, NULL );

④、启动定时器。

// 启动该定时器 
os_timer_arm( &os_timer, 500, true );

注意： os_timer_arm()的时间参数的单位是ms，1s =1000ms，第三个参数是boolean值，false是不重复，true是重复执行。但是os_timer_arm_us()时间参数的单位是us，1s =1000ms =1000 000 us;

1.3 微秒级定时器

1.4 例子

LED闪烁：检查有无手机设备连接ESP8266 AP，有则LED慢闪，无则LED熄灭。

/**
 @brief 查询设备加入定时器回调函数
 @param 无
 @return 无
*/
LOCAL void ICACHE_FLASH_ATTR
check_station_callback(void)
{
    uint8 wifi_mode = wifi_get_opmode();                            // 获取WIFI当前工作模式
    uint8 get_station_num = wifi_softap_get_station_num();          // 获取AP模式下已连接设备数

    if (wifi_mode == STATIONAP_MODE)
    {
        if (0 == get_station_num)                                   // 连上设备数为 0
        {
            user_link_led_timer_slow_done();                        // 取消LED慢闪定时器定时
            user_link_led_output(LED_OFF);                          // LED灯灭
        }
        else
        {
            user_link_led_timer_slow_init();                        // 启动LED慢闪定时器，闪烁周期:1s
        }
    }
}

/**
 @brief 初始化查询设备加入定时器
 @param 无
 @return 无
*/
void ICACHE_FLASH_ATTR
check_station_timer_init(void)
{
    os_printf("check_station_timer_init\n");
    os_timer_disarm(&check_station_join_timer);
    os_timer_setfn(&check_station_join_timer,
            (os_timer_func_t *) check_station_callback, NULL);      // 设置查询设备加入定时器回调函数
    os_timer_arm(&check_station_join_timer, 1000, true);            // 启动定时器，周期:1s
}

/**
 @brief 关闭查询设备加入定时器
 @param 无
 @return 无
*/
void ICACHE_FLASH_ATTR
check_station_timer_done(void)
{
    os_printf("check_station_timer_done\n");
    os_timer_disarm(&check_station_join_timer);                     // 取消查询加入设备定时器
}

二、硬件定时器

2.1 简介

以下硬件中断定时器接口位于 /ESP8266_NONOS_SDK/examples/driver_lib/hw_timer.c。用户可根据 driver_lib 文件夹下的 readme.txt 文件使用。

注意：
• 如果使用 NMI 中断源，且为自动填装的定时器，调用 hw_timer_arm 时参数 val 必须大于 100。
• 如果使用 NMI 中断源，那么该定时器将为最高优先级，可打断其他 ISR。
• 如果使用 FRC1 中断源，那么该定时器无法打断其他 ISR。
• hw_timer.c 的接口不能跟 PWM 驱动接口函数同时使用，因为两者共用了同一个硬件定时器。
• 硬件中断定时器的回调函数定义，请勿添加 ICACHE_FLASH_ATTR 宏。
• 使用 hw_timer.c 的接口，请勿调用 wifi_set_sleep_type(LIGHT_SLEEP); 将自动睡眠模式设置为 Light-sleep。因为 Light-sleep 在睡眠期间会停 CPU，停 CPU 期间不能响应 NMI 中断。

2.2 使用步骤

①、初始化硬件定时器。

②、设置定时器的回调函数。

③、启动定时器。

2.3 例子

#define REG_READ(_r) (*(volatile    uint32  *)(_r))
#define WDEV_NOW() REG_READ(0x3ff20c00)

uint32 tick_now2 = 0;

void hw_test_timer_cb(void)
{
  static uint16 j = 0;
  j++;
  if( (WDEV_NOW() - tick_now2) >= 1000000 )
  {
    static u32 idx = 1; 
    tick_now2 = WDEV_NOW();
    os_printf("b%u:%d\n",idx++,j);
    j = 0;
  }
}

void ICACHE_FLASH_ATTR user_init(void)
{
  hw_timer_init(FRC1_SOURCE,1);
  hw_timer_set_func(hw_test_timer_cb);
  hw_timer_arm(100);
}

---

• 由 Leung 写于 2018 年 11 月 16 日

• 参考：ESP8266 Non-OS SDK API参考[7qq6]
　　　　Esp8266学习之旅③ 利用 " 软件定时器 "或“硬件定时器” 定时0.5秒闪烁点亮一盏LED