一、软件定时器
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