ESP-IDF-V5.0以上初始化时硬件定时器(TIM)编号绑定问题

引入

在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这种有通用和高级定时器之分，可能则需要分开初始化了。