三、计数器函数

xTimerStart（xTimer，xTicksToWait)

BaseType_t xTimerStart（ TimerHandle_t xTimer， TickType_t xTicksToWait ）;计时器功能由定时服务/守护程序任务提供。许多公共 FreeRTOS 计时器 API 函数通过称为计时器命令队列的队列将命令发送到定时服务任务。timer 命令队列是内核本身的专用代码，应用程序代码无法直接访问。计时器命令队列的长度由configTIMER_QUEUE_LENGTH配置常量设置。xTimerStart（） 启动以前使用 xTimerCreate（） API 函数创建的计时器。如果计时器已经启动并且已经处于活动状态，则 xTimerStart（） 具有与 xTimerReset（） API 函数等效的功能。启动计时器可确保计时器处于活动状态。如果计时器同时未停止、删除或重置，则在调用 xTimerStart（） 后，与计时器关联的回调函数将调用“n”个时钟周期，其中“n”是计时器定义的时间段。在调度程序启动之前调用 xTimerStart（） 是有效的，但是当这样做时，计时器在调度程序启动之前不会实际启动，并且计时器到期时间将相对于调度程序启动的时间，而不是相对于调用 xTimerStart（） 的时间。configUSE_TIMERS配置常量必须设置为 1 才能使用 xTimerStart（）。用法示例：请参阅 xTimerCreate（） API 函数示例使用场景。

参数xTimer– 正在启动/重新启动的计时器的句柄。xTicksToWait– 指定调用任务应保持在“已阻止”状态以等待启动命令成功发送到计时器命令队列的时间（以刻度为单位），如果调用 xTimerStart（） 时队列已满。如果在调度程序启动之前调用了 xTimerStart（），则忽略 xTicksToWait。

返回如果启动命令无法发送到计时器命令队列，即使 xTicksToWait 时钟周期已过去，也将返回 pdFAIL。如果命令已成功发送到计时器命令队列，将返回 pdPASS。实际处理命令的时间将取决于定时服务/守护程序任务相对于系统中其他任务的优先级，尽管计时器到期时间相对于实际调用 xTimerStart（） 的时间。定时服务/守护程序任务优先级由configTIMER_TASK_PRIORITY配置常量设置。

xTimerStop（xTimer，xTicksToWait)

BaseType_txTimerStop（ TimerHandle_t xTimer， TickType_t xTicksToWait ）;计时器功能由定时服务/守护程序任务提供。许多公共 FreeRTOS 计时器 API 函数通过称为计时器命令队列的队列将命令发送到定时服务任务。timer 命令队列是内核本身的专用代码，应用程序代码无法直接访问。计时器命令队列的长度由configTIMER_QUEUE_LENGTH配置常量设置。xTimerStop（） 停止以前使用 xTimerStart（）、xTimerReset（）、xTimerStartFromISR（）、xTimerResetFromISR（）、xTimerChangePeriod（） 或 xTimerChangePeriodFromISR（） API 函数启动的计时器。停止计时器可确保计时器不处于活动状态。configUSE_TIMERS配置常量必须设置为 1 才能使用xTimerStop（）。用法示例：请参阅 xTimerCreate（） API 函数示例使用场景。

参数xTimer– 正在停止的计时器的句柄。xTicksToWait– 指定调用任务应保持在“已阻止”状态以等待停止命令成功发送到计时器命令队列的时间（以刻度为单位），如果调用xTimerStop（） 时队列已满。如果在调度程序启动之前调用了 xTimerStop（），则忽略 xTicksToWait。

返回如果停止命令无法发送到计时器命令队列，即使 xTicksToWait 时钟周期已经过去了，也会返回 pdFAIL。如果命令已成功发送到计时器命令队列，将返回 pdPASS。实际处理命令的时间将取决于定时服务/守护程序任务相对于系统中其他任务的优先级。定时服务/守护程序任务优先级由configTIMER_TASK_PRIORITY配置常量设置。

xTimerDelete（xTimer，xTicksToWait)

BaseType_t xTimerDelete（ TimerHandle_t xTimer， TickType_t xTicksToWait ）;计时器功能由定时服务/守护程序任务提供。许多公共 FreeRTOS 计时器 API 函数通过称为计时器命令队列的队列将命令发送到定时服务任务。timer 命令队列是内核本身的专用代码，应用程序代码无法直接访问。计时器命令队列的长度由configTIMER_QUEUE_LENGTH配置常量设置。xTimerDelete（） 删除以前使用 xTimerCreate（） API 函数创建的计时器。configUSE_TIMERS配置常量必须设置为 1 才能使用 xTimerDelete（）。用法示例：请参阅 xTimerChangePeriod（） API 函数示例使用场景。

参数xTimer– 要删除的计时器的句柄。xTicksToWait– 指定调用任务应保持在“已阻止”状态以等待删除命令成功发送到计时器命令队列的时间（以刻度为单位），前提是调用 xTimerDelete（） 时队列已满。如果在调度程序启动之前调用 xTimerDelete（），则忽略 xTicksToWait。

返回如果删除命令无法发送到计时器命令队列，即使 xTicksToWait 时钟周期已经过去了，也会返回 pdFAIL。如果命令已成功发送到计时器命令队列，将返回 pdPASS。实际处理命令的时间将取决于定时服务/守护程序任务相对于系统中其他任务的优先级。定时服务/守护程序任务优先级由configTIMER_TASK_PRIORITY配置常量设置。

xTimerReset（xTimer，xTicksToWait)

BaseType_t xTimerReset（ TimerHandle_t xTimer， TickType_t xTicksToWait ）;计时器功能由定时服务/守护程序任务提供。许多公共 FreeRTOS 计时器 API 函数通过称为计时器命令队列的队列将命令发送到定时服务任务。timer 命令队列是内核本身的专用代码，应用程序代码无法直接访问。计时器命令队列的长度由configTIMER_QUEUE_LENGTH配置常量设置。xTimerReset（） 重新启动以前使用 xTimerCreate（） API 函数创建的计时器。如果计时器已经启动并且已经处于活动状态，则 xTimerReset（） 将导致计时器重新评估其到期时间，使其相对于调用 xTimerReset（） 的时间。如果计时器处于休眠状态，则 xTimerReset（） 具有与 xTimerStart（） API 函数等效的功能。重置计时器可确保计时器处于活动状态。如果计时器没有同时停止、删除或重置，则在调用 xTimerReset（） 后，与计时器关联的回调函数将被称为 'n' 刻度，其中 'n' 是计时器定义的时间段。在调度程序启动之前调用 xTimerReset（） 是有效的，但是当这样做时，计时器在调度程序启动之前不会真正启动，并且计时器到期时间将相对于调度程序启动的时间，而不是相对于调用 xTimerReset（） 的时间。configUSE_TIMERS配置常量必须设置为 1 才能使用 xTimerReset（）。

参数

xTimer– 正在重置/启动/重新启动的计时器的句柄。xTicksToWait– 指定调用任务应保持在“已阻止”状态以等待重置命令成功发送到计时器命令队列的时间（以刻度为单位），如果在调用 xTimerReset（） 时队列已满。如果在调度程序启动之前调用了 xTimerReset（），则忽略 xTicksToWait。

返回

如果重置命令无法发送到计时器命令队列，即使 xTicksToWait 时钟周期已经过去了，也会返回 pdFAIL。如果命令已成功发送到计时器命令队列，将返回 pdPASS。实际处理命令的时间将取决于定时服务/守护程序任务相对于系统中其他任务的优先级，尽管计时器到期时间相对于实际调用 xTimerStart（） 的时间。定时服务/守护程序任务优先级由configTIMER_TASK_PRIORITY配置常量设置。

用法示例：

// When a key is pressed, an LCD back-light is switched on.  If 5 seconds pass// without a key being pressed, then the LCD back-light is switched off.  In// this case, the timer is a one-shot timer.TimerHandle_t xBacklightTimer = NULL;// The callback function assigned to the one-shot timer.  In this case the// parameter is not used.void vBacklightTimerCallback( TimerHandle_t pxTimer ){// The timer expired, therefore 5 seconds must have passed since a key// was pressed.  Switch off the LCD back-light.vSetBacklightState( BACKLIGHT_OFF );}// The key press event handler.void vKeyPressEventHandler( char cKey ){// Ensure the LCD back-light is on, then reset the timer that is// responsible for turning the back-light off after 5 seconds of// key inactivity.  Wait 10 ticks for the command to be successfully sent// if it cannot be sent immediately.vSetBacklightState( BACKLIGHT_ON );if( xTimerReset( xBacklightTimer, 100 ) != pdPASS ){// The reset command was not executed successfully.  Take appropriate// action here.}// Perform the rest of the key processing here.}void main( void ){int32_t x;// Create then start the one-shot timer that is responsible for turning// the back-light off if no keys are pressed within a 5 second period.xBacklightTimer = xTimerCreate( "BacklightTimer",           // Just a text name, not used by the kernel.( 5000 / portTICK_PERIOD_MS), // The timer period in ticks.pdFALSE,                    // The timer is a one-shot timer.0,                          // The id is not used by the callback so can take any value.vBacklightTimerCallback     // The callback function that switches the LCD back-light off.);if( xBacklightTimer == NULL ){// The timer was not created.}else{// Start the timer.  No block time is specified, and even if one was// it would be ignored because the scheduler has not yet been// started.if( xTimerStart( xBacklightTimer, 0 ) != pdPASS ){// The timer could not be set into the Active state.}}// ...// Create tasks here.// ...// Starting the scheduler will start the timer running as it has already// been set into the active state.vTaskStartScheduler();// Should not reach here.for( ;; );}

/*定时器中断函数*/
void esp_timer_cb(void *arg){printf("TIME start \n");
}
void key_createTimer(){TimerHandle_t xTimerBPL ;xTimerBPL = xTimerCreate("xTimerCreate",(BPL_CHECK_TIME/portTICK_PERIOD_MS)  //毫秒,pdTRUE //周期执行,( void * ) BPL_pvTimerID //执行ID,esp_timer_cb);if( xTimerBPL == NULL ) ESP_LOGE(TAG,"%s",esp_err_to_name(-1));if( xTimerStart( xTimerBPL, 0 ) != pdPASS ) ESP_LOGE(TAG,"%s",esp_err_to_name(-1));
}