esp32-idf eclipse 定时器的使用demo

esp32定时器的使用demo

1、介绍

ESP32芯片包含两个硬件定时器组。每组有两个通用硬件定时器。它们都是基于16位预分频器和64位自动重载功能的向上向下计数器的64位通用定时器。

2、API接口函数

创建定时器函数： esp_timer_create();

esp_err_t esp_timer_create (const esp_timer_create_args_t* create_args, esp_timer_handle_t* out_handle)

功能：

创建一个esp_timer实例

注意：

使用计时器完成后，请使用esp_timer_delete函数将其删除。

返回：

ESP_OK成功
如果某些create_args无效，则为ESP_ERR_INVALID_ARG
ESP_ERR_INVALID_STATE如果esp_timer库尚未初始化
如果内存分配失败，则为ESP_ERR_NO_MEM

参数：

create_args：指向带有计时器创建参数的结构的指针。未由库保存，可以在堆栈上分配。
[out] out_handle：输出，指向esp_timer_handle_t变量的指针，该变量将保存创建的计时器句柄。

esp_err_t esp_timer_start_once（esp_timer_handle_t timer，uint64_t timeout_us ）

功能：

启动单发计时器。

调用此函数时，计时器不应运行。

ESP_OK成功
ESP_ERR_INVALID_ARG如果句柄无效
ESP_ERR_INVALID_STATE，如果计时器已经在运行

参数：

timer：使用esp_timer_create创建的计时器句柄
timeout_us：计时器超时，相对于当前时刻，以微秒为单位

esp_err_t esp_timer_start_periodic（esp_timer_handle_t timer，uint64_t period ）

功能：

启动一个定期计时器。

调用此函数时，计时器不应运行。此功能将启动计时器，该计时器将触发每个“周期”微秒。

ESP_OK成功
ESP_ERR_INVALID_ARG如果句柄无效
ESP_ERR_INVALID_STATE，如果计时器已经在运行

参数：

timer：使用esp_timer_create创建的计时器句柄
period：计时器时间（以微秒为单位）

esp_err_t esp_timer_stop（esp_timer_handle_t timer ）

功能：

停止计时器。

此函数停止先前使用esp_timer_start_once或esp_timer_start_periodic启动的计时器。

ESP_OK成功
ESP_ERR_INVALID_STATE（如果计时器未运行）

参量

timer：使用esp_timer_create创建的计时器句柄

esp_err_t esp_timer_delete（esp_timer_handle_t timer ）

删除esp_timer实例。

删除前必须停止计时器。一次到期的单次计时器无需停止。

ESP_OK成功
ESP_ERR_INVALID_STATE，如果计时器正在运行

参量

timer：使用esp_timer_create分配的计时器句柄

int64_t esp_timer_get_time（ void ）

功能：

自启动以来获取时间（以微秒为单位）。

自从调用esp_timer_init以来的微秒数（这通常在应用程序启动期间的早期发生）。

3、代码demo:

#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "esp_system.h"
#include "esp_log.h"
#include "esp_timer.h"static const char *TAG = "myTimer";esp_timer_handle_t periodic_timer_handle = NULL;  //周期性的定时器句柄
esp_timer_handle_t onece_timer_handle = NULL;     //单次定时器句柄void periodic_timer_callback(void* arg)
{for(int i=0;i<10;i++){printf("<<<<<<<<<<<<<<<<<<<<<<<<<< periodic_timer_callback = %d \n",i);vTaskDelay(10 / portTICK_PERIOD_MS);}esp_timer_stop(periodic_timer_handle);    //停止定时器esp_timer_delete(periodic_timer_handle);  //删除定时器
}void onece_timer_callback(void* arg)
{printf("=============================  onece_timer_callback \n");vTaskDelay(500 / portTICK_PERIOD_MS);
}void app_main()
{uint32_t num = 0;esp_timer_init(); //定时器初始化+while (1){// 数值自加num++;ESP_LOGI(TAG,"---> num = %d",num);// 判断是否达到触发条件if (num == 10) {// 创建定时器//esp_timer_handle_t timer_handle = NULL;/** typedef struct {esp_timer_cb_t callback;        		//!< Function to call when timer expiresvoid* arg;                      		//!< Argument to pass to the callbackesp_timer_dispatch_t dispatch_method;   //!< Call the callback from task or from ISRconst char* name;               		//!< Timer name, used in esp_timer_dump functionbool skip_unhandled_events;     		//!< Skip unhandled events for periodic timers} esp_timer_create_args_t;+*/const esp_timer_create_args_t periodic_timer_args = {.callback = &periodic_timer_callback,.arg = NULL,.name = "my_periodic_timer"};esp_timer_create(&periodic_timer_args, &periodic_timer_handle);// 启动定时器const TickType_t delay_ms = 1000 / portTICK_PERIOD_MS;esp_timer_start_periodic(periodic_timer_handle, delay_ms * 1000);  //周期性的定时器，即定时器会以固定的时间间隔重复触发回调函数}//判断是否达到触发条件if(num == 15){const esp_timer_create_args_t once_timer_args = {.callback = &onece_timer_callback,.arg = NULL,.name = "my_onece_timer"};esp_timer_create(&once_timer_args, &onece_timer_handle);// 启动定时器const TickType_t delay_ms = 1000 / portTICK_PERIOD_MS;esp_timer_start_once(onece_timer_handle, delay_ms * 1000);  //启动一个一次性的定时器，即定时器只会触发一次回调函数，然后自动停止}if (num > 20) {// 定时器触发后退出循环break;}vTaskDelay(500 / portTICK_PERIOD_MS);  // 等待一段时间}ESP_LOGI(TAG,"app is out");
}