tusb_tasks.h File Reference

#include "esp_err.h"

Include dependency graph for tusb_tasks.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions
esp_err_t	tusb_run_task (void)
	This helper function creates and starts a task which wraps tud_task().
esp_err_t	tusb_stop_task (void)
	This helper function stops and destroys the task created by tusb_run_task().

Function Documentation

tusb_run_task()

esp_err_t tusb_run_task

(

void

)

This helper function creates and starts a task which wraps tud_task().

The wrapper function basically wraps tud_task and some log. Default parameters: stack size and priority as configured, argument = NULL, not pinned to any core. If you have more requirements for this task, you can create your own task which calls tud_task as the last step.

Return values

ESP_OK	run tinyusb main task successfully
ESP_FAIL	run tinyusb main task failed of internal error
ESP_ERR_INVALID_STATE	tinyusb main task has been created before

Definition at line 29 of file tusb_tasks.c.

{
    // This function is not garanteed to be thread safe, if invoked multiple times without calling `tusb_stop_task`, will cause memory leak
    // doing a sanity check anyway
    ESP_RETURN_ON_FALSE(!s_tusb_tskh, ESP_ERR_INVALID_STATE, TAG, "TinyUSB main task already started");
    // Create a task for tinyusb device stack:
    xTaskCreate(tusb_device_task, "TinyUSB", CONFIG_TINYUSB_TASK_STACK_SIZE, NULL, CONFIG_TINYUSB_TASK_PRIORITY, &s_tusb_tskh);
    ESP_RETURN_ON_FALSE(s_tusb_tskh, ESP_FAIL, TAG, "create TinyUSB main task failed");
    return ESP_OK;
}

References ESP_OK, s_tusb_tskh, TAG, and tusb_device_task().

Referenced by tinyusb_driver_install().

Here is the call graph for this function:

Here is the caller graph for this function:

tusb_stop_task()

esp_err_t tusb_stop_task

(

void

)

This helper function stops and destroys the task created by tusb_run_task().

Return values

ESP_OK	stop and destory tinyusb main task successfully
ESP_ERR_INVALID_STATE	tinyusb main task hasn't been created yet

Definition at line 40 of file tusb_tasks.c.

{
    ESP_RETURN_ON_FALSE(s_tusb_tskh, ESP_ERR_INVALID_STATE, TAG, "TinyUSB main task not started yet");
    vTaskDelete(s_tusb_tskh);
    s_tusb_tskh = NULL;
    return ESP_OK;
}

References ESP_OK, s_tusb_tskh, and TAG.