引入
在V5.0版本以后,之前的没注意看。发现定时器官方例程中,并未有发现初始化定时器时初始化到了哪个定时器编号上,对于习惯与硬件进行强联系的工程师来说有点不适应,题主也是纠结了挺久决定看源代码看看新版的ESP-IDF做了什么。
官方说明
官方的迁移说明:
https://docs.espressif.com/projects/esp-idf/zh_CN/stable/esp32/migration-guides/release-5.x/5.0/peripherals.html#id7
文档说明在新版本中,用于识别定时器的 timer_group_t
和 timer_idx_t
已被删除。在新驱动中,定时器用参数 gptimer_handle_t
表示。而恰恰 timer_idx_t
是用于配置定时器号的。
GPTime例子分析
在新的GPTime例子中:
位置:examples/peripherals/timer_group/gptimer/main
使用了 gptimer_new_timer
函数直接注册了定时器,它的原型:
esp_err_t gptimer_new_timer(const gptimer_config_t *config, gptimer_handle_t *ret_timer)
{
#if CONFIG_GPTIMER_ENABLE_DEBUG_LOG
esp_log_level_set(TAG, ESP_LOG_DEBUG);
#endif
esp_err_t ret = ESP_OK;
gptimer_t *timer = NULL;
ESP_RETURN_ON_FALSE(config && ret_timer, ESP_ERR_INVALID_ARG, TAG, "invalid argument");
ESP_RETURN_ON_FALSE(config->resolution_hz, ESP_ERR_INVALID_ARG, TAG, "invalid timer resolution:%"PRIu32, config->resolution_hz);
if (config->intr_priority) {
ESP_RETURN_ON_FALSE(1 << (config->intr_priority) & GPTIMER_ALLOW_INTR_PRIORITY_MASK, ESP_ERR_INVALID_ARG,
TAG, "invalid interrupt priority:%d", config->intr_priority);
}
timer = heap_caps_calloc(1, sizeof(gptimer_t), GPTIMER_MEM_ALLOC_CAPS);
ESP_GOTO_ON_FALSE(timer, ESP_ERR_NO_MEM, err, TAG, "no mem for gptimer");
// register timer to the group (because one group can have several timers)
ESP_GOTO_ON_ERROR(gptimer_register_to_group(timer), err, TAG, "register timer failed");
gptimer_group_t *group = timer->group;
int group_id = group->group_id;
int timer_id = timer->timer_id;
....
}
可以见到 register timer to the group (because one group can have several timers) 注释,它调用了gptimer_register_to_group
函数,获得了一个定时器组和定时器号,即group_id
和timer_id
。
进一步,我们看看gptimer_register_to_group
函数原型:
static esp_err_t gptimer_register_to_group(gptimer_t *timer)
{
gptimer_group_t *group = NULL;
int timer_id = -1;
for (int i = 0; i < SOC_TIMER_GROUPS; i++) {
group = gptimer_acquire_group_handle(i);
ESP_RETURN_ON_FALSE(group, ESP_ERR_NO_MEM, TAG, "no mem for group (%d)", i);
// loop to search free timer in the group
portENTER_CRITICAL(&group->spinlock);
for (int j = 0; j < SOC_TIMER_GROUP_TIMERS_PER_GROUP; j++) {
if (!group->timers[j]) {
timer_id = j;
group->timers[j] = timer;
break;
}
}
portEXIT_CRITICAL(&group->spinlock);
if (timer_id < 0) {
gptimer_release_group_handle(group);
} else {
timer->timer_id = timer_id;
timer->group = group;
break;
}
}
ESP_RETURN_ON_FALSE(timer_id != -1, ESP_ERR_NOT_FOUND, TAG, "no free timer");
return ESP_OK;
}
可以看到函数内部做了一个空闲定时器判定,如果用完了就会报no free timer
。
小结
新版的写法会给人一种1个定时器绑定多个定时任务的错觉。但从以上代码分析可以看出,新版的EDP-IDF自动找到了空闲的定时器进行初始化,不再需要用户自定义定时器编号,即每个被定义的gptimer_handle_t
类只指向唯一的定时号,那么gptimer_handle_t
定义数比定时器号数量多时,就会报错。
这种新机制写法,虽然弱化了用户与硬件的交流,但基于ESP32的几个定时器硬件特性一致,那么这种写法也是没有问题的,如果像STM32这种有通用和高级定时器之分,可能则需要分开初始化了。