2019-03-20 10:11:42 +01:00
|
|
|
/*
|
|
|
|
* The MIT License (MIT)
|
|
|
|
*
|
2019-05-14 06:48:05 +02:00
|
|
|
* Copyright (c) 2019 Ha Thach (tinyusb.org)
|
2019-03-20 10:11:42 +01:00
|
|
|
*
|
|
|
|
* Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
|
|
* of this software and associated documentation files (the "Software"), to deal
|
|
|
|
* in the Software without restriction, including without limitation the rights
|
|
|
|
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
|
|
* copies of the Software, and to permit persons to whom the Software is
|
|
|
|
* furnished to do so, subject to the following conditions:
|
|
|
|
*
|
|
|
|
* The above copyright notice and this permission notice shall be included in
|
|
|
|
* all copies or substantial portions of the Software.
|
|
|
|
*
|
|
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
|
|
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
|
|
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
|
|
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
|
|
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
|
|
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
|
|
|
* THE SOFTWARE.
|
|
|
|
*
|
|
|
|
* This file is part of the TinyUSB stack.
|
|
|
|
*/
|
2013-02-03 18:03:08 +01:00
|
|
|
|
|
|
|
#ifndef _TUSB_OSAL_FREERTOS_H_
|
|
|
|
#define _TUSB_OSAL_FREERTOS_H_
|
|
|
|
|
2019-03-20 17:12:12 +01:00
|
|
|
// FreeRTOS Headers
|
2021-09-25 11:16:55 +02:00
|
|
|
#include TU_INCLUDE_PATH(CFG_TUSB_OS_INC_PATH,FreeRTOS.h)
|
|
|
|
#include TU_INCLUDE_PATH(CFG_TUSB_OS_INC_PATH,semphr.h)
|
|
|
|
#include TU_INCLUDE_PATH(CFG_TUSB_OS_INC_PATH,queue.h)
|
|
|
|
#include TU_INCLUDE_PATH(CFG_TUSB_OS_INC_PATH,task.h)
|
2013-02-03 18:03:08 +01:00
|
|
|
|
2013-02-08 06:12:10 +01:00
|
|
|
#ifdef __cplusplus
|
|
|
|
extern "C" {
|
|
|
|
#endif
|
|
|
|
|
2022-04-20 09:37:42 +02:00
|
|
|
TU_ATTR_ALWAYS_INLINE static inline uint32_t _osal_ms2tick(uint32_t msec)
|
|
|
|
{
|
|
|
|
if (msec == OSAL_TIMEOUT_WAIT_FOREVER) return portMAX_DELAY;
|
|
|
|
if (msec == 0) return 0;
|
|
|
|
|
|
|
|
uint32_t ticks = pdMS_TO_TICKS(msec);
|
|
|
|
|
|
|
|
// configTICK_RATE_HZ is less than 1000 and 1 tick > 1 ms
|
|
|
|
// we still need to delay at least 1 tick
|
|
|
|
if (ticks == 0) ticks =1 ;
|
|
|
|
|
|
|
|
return ticks;
|
|
|
|
}
|
|
|
|
|
2013-02-03 18:03:08 +01:00
|
|
|
//--------------------------------------------------------------------+
|
|
|
|
// TASK API
|
|
|
|
//--------------------------------------------------------------------+
|
2022-04-20 08:25:38 +02:00
|
|
|
TU_ATTR_ALWAYS_INLINE static inline void osal_task_delay(uint32_t msec)
|
2013-04-25 11:41:00 +02:00
|
|
|
{
|
2018-03-29 13:03:04 +02:00
|
|
|
vTaskDelay( pdMS_TO_TICKS(msec) );
|
2013-04-25 11:41:00 +02:00
|
|
|
}
|
|
|
|
|
2013-02-03 18:03:08 +01:00
|
|
|
//--------------------------------------------------------------------+
|
|
|
|
// Semaphore API
|
|
|
|
//--------------------------------------------------------------------+
|
2018-05-17 13:22:30 +02:00
|
|
|
typedef StaticSemaphore_t osal_semaphore_def_t;
|
2018-03-30 11:57:18 +02:00
|
|
|
typedef SemaphoreHandle_t osal_semaphore_t;
|
2013-02-04 11:13:26 +01:00
|
|
|
|
2022-04-20 08:25:38 +02:00
|
|
|
TU_ATTR_ALWAYS_INLINE static inline osal_semaphore_t osal_semaphore_create(osal_semaphore_def_t* semdef)
|
2018-03-01 05:17:11 +01:00
|
|
|
{
|
2018-05-17 13:22:30 +02:00
|
|
|
return xSemaphoreCreateBinaryStatic(semdef);
|
2018-03-01 05:17:11 +01:00
|
|
|
}
|
2013-02-04 11:13:26 +01:00
|
|
|
|
2022-04-20 08:25:38 +02:00
|
|
|
TU_ATTR_ALWAYS_INLINE static inline bool osal_semaphore_post(osal_semaphore_t sem_hdl, bool in_isr)
|
2013-02-04 12:05:22 +01:00
|
|
|
{
|
2020-07-21 16:06:10 +02:00
|
|
|
if ( !in_isr )
|
|
|
|
{
|
2020-07-19 22:55:35 +02:00
|
|
|
return xSemaphoreGive(sem_hdl) != 0;
|
|
|
|
}
|
2020-07-21 16:06:10 +02:00
|
|
|
else
|
|
|
|
{
|
|
|
|
BaseType_t xHigherPriorityTaskWoken;
|
|
|
|
BaseType_t res = xSemaphoreGiveFromISR(sem_hdl, &xHigherPriorityTaskWoken);
|
|
|
|
|
2021-03-09 11:29:07 +01:00
|
|
|
#if CFG_TUSB_MCU == OPT_MCU_ESP32S2 || CFG_TUSB_MCU == OPT_MCU_ESP32S3
|
2022-02-18 07:07:21 +01:00
|
|
|
// not needed after https://github.com/espressif/esp-idf/commit/c5fd79547ac9b7bae06fa660e9f814d18d3390b7
|
2020-07-21 16:06:10 +02:00
|
|
|
if ( xHigherPriorityTaskWoken ) portYIELD_FROM_ISR();
|
2020-07-19 22:55:35 +02:00
|
|
|
#else
|
2020-07-21 16:06:10 +02:00
|
|
|
portYIELD_FROM_ISR(xHigherPriorityTaskWoken);
|
2020-07-19 22:55:35 +02:00
|
|
|
#endif
|
2020-07-21 16:06:10 +02:00
|
|
|
|
|
|
|
return res != 0;
|
|
|
|
}
|
2013-02-04 12:05:22 +01:00
|
|
|
}
|
|
|
|
|
2022-04-20 08:25:38 +02:00
|
|
|
TU_ATTR_ALWAYS_INLINE static inline bool osal_semaphore_wait (osal_semaphore_t sem_hdl, uint32_t msec)
|
2013-02-04 12:05:22 +01:00
|
|
|
{
|
2022-04-20 09:37:42 +02:00
|
|
|
return xSemaphoreTake(sem_hdl, _osal_ms2tick(msec));
|
2013-02-04 12:05:22 +01:00
|
|
|
}
|
|
|
|
|
2022-04-20 08:25:38 +02:00
|
|
|
TU_ATTR_ALWAYS_INLINE static inline void osal_semaphore_reset(osal_semaphore_t const sem_hdl)
|
2013-04-24 12:53:43 +02:00
|
|
|
{
|
2018-11-02 09:45:27 +01:00
|
|
|
xQueueReset(sem_hdl);
|
2013-04-24 12:53:43 +02:00
|
|
|
}
|
|
|
|
|
2013-07-04 08:24:54 +02:00
|
|
|
//--------------------------------------------------------------------+
|
|
|
|
// MUTEX API (priority inheritance)
|
|
|
|
//--------------------------------------------------------------------+
|
2018-11-02 09:45:27 +01:00
|
|
|
typedef StaticSemaphore_t osal_mutex_def_t;
|
2018-03-30 11:57:18 +02:00
|
|
|
typedef SemaphoreHandle_t osal_mutex_t;
|
2013-07-04 08:24:54 +02:00
|
|
|
|
2022-04-20 08:25:38 +02:00
|
|
|
TU_ATTR_ALWAYS_INLINE static inline osal_mutex_t osal_mutex_create(osal_mutex_def_t* mdef)
|
2013-07-04 08:24:54 +02:00
|
|
|
{
|
2018-11-02 09:45:27 +01:00
|
|
|
return xSemaphoreCreateMutexStatic(mdef);
|
2013-07-04 08:24:54 +02:00
|
|
|
}
|
|
|
|
|
2022-04-20 08:25:38 +02:00
|
|
|
TU_ATTR_ALWAYS_INLINE static inline bool osal_mutex_lock (osal_mutex_t mutex_hdl, uint32_t msec)
|
2019-04-02 11:18:36 +02:00
|
|
|
{
|
|
|
|
return osal_semaphore_wait(mutex_hdl, msec);
|
|
|
|
}
|
2018-11-02 09:45:27 +01:00
|
|
|
|
2022-04-20 08:25:38 +02:00
|
|
|
TU_ATTR_ALWAYS_INLINE static inline bool osal_mutex_unlock(osal_mutex_t mutex_hdl)
|
2013-07-04 08:24:54 +02:00
|
|
|
{
|
2018-11-02 09:45:27 +01:00
|
|
|
return xSemaphoreGive(mutex_hdl);
|
2013-07-04 08:24:54 +02:00
|
|
|
}
|
|
|
|
|
2018-11-02 11:26:35 +01:00
|
|
|
//--------------------------------------------------------------------+
|
|
|
|
// QUEUE API
|
|
|
|
//--------------------------------------------------------------------+
|
2018-12-05 11:01:19 +01:00
|
|
|
|
2022-04-20 08:25:38 +02:00
|
|
|
// _int_set is not used with an RTOS
|
2022-02-23 12:42:32 +01:00
|
|
|
#define OSAL_QUEUE_DEF(_int_set, _name, _depth, _type) \
|
2018-11-02 11:26:35 +01:00
|
|
|
static _type _name##_##buf[_depth];\
|
|
|
|
osal_queue_def_t _name = { .depth = _depth, .item_sz = sizeof(_type), .buf = _name##_##buf };
|
|
|
|
|
|
|
|
typedef struct
|
|
|
|
{
|
|
|
|
uint16_t depth;
|
|
|
|
uint16_t item_sz;
|
|
|
|
void* buf;
|
|
|
|
|
|
|
|
StaticQueue_t sq;
|
|
|
|
}osal_queue_def_t;
|
|
|
|
|
|
|
|
typedef QueueHandle_t osal_queue_t;
|
|
|
|
|
2022-04-20 08:25:38 +02:00
|
|
|
TU_ATTR_ALWAYS_INLINE static inline osal_queue_t osal_queue_create(osal_queue_def_t* qdef)
|
2018-11-02 11:26:35 +01:00
|
|
|
{
|
|
|
|
return xQueueCreateStatic(qdef->depth, qdef->item_sz, (uint8_t*) qdef->buf, &qdef->sq);
|
|
|
|
}
|
|
|
|
|
2022-04-20 08:25:38 +02:00
|
|
|
TU_ATTR_ALWAYS_INLINE static inline bool osal_queue_receive(osal_queue_t qhdl, void* data, uint32_t msec)
|
2018-11-02 11:26:35 +01:00
|
|
|
{
|
2022-04-20 09:37:42 +02:00
|
|
|
return xQueueReceive(qhdl, data, _osal_ms2tick(msec));
|
2018-11-02 11:26:35 +01:00
|
|
|
}
|
|
|
|
|
2022-04-20 08:25:38 +02:00
|
|
|
TU_ATTR_ALWAYS_INLINE static inline bool osal_queue_send(osal_queue_t qhdl, void const * data, bool in_isr)
|
2018-11-02 11:26:35 +01:00
|
|
|
{
|
2020-07-21 16:06:10 +02:00
|
|
|
if ( !in_isr )
|
|
|
|
{
|
2020-07-19 22:55:35 +02:00
|
|
|
return xQueueSendToBack(qhdl, data, OSAL_TIMEOUT_WAIT_FOREVER) != 0;
|
|
|
|
}
|
2020-07-21 16:06:10 +02:00
|
|
|
else
|
|
|
|
{
|
|
|
|
BaseType_t xHigherPriorityTaskWoken;
|
|
|
|
BaseType_t res = xQueueSendToBackFromISR(qhdl, data, &xHigherPriorityTaskWoken);
|
|
|
|
|
2021-03-09 11:29:07 +01:00
|
|
|
#if CFG_TUSB_MCU == OPT_MCU_ESP32S2 || CFG_TUSB_MCU == OPT_MCU_ESP32S3
|
2022-02-18 07:07:21 +01:00
|
|
|
// not needed after https://github.com/espressif/esp-idf/commit/c5fd79547ac9b7bae06fa660e9f814d18d3390b7
|
2020-07-21 16:06:10 +02:00
|
|
|
if ( xHigherPriorityTaskWoken ) portYIELD_FROM_ISR();
|
2020-07-19 22:55:35 +02:00
|
|
|
#else
|
2020-07-21 16:06:10 +02:00
|
|
|
portYIELD_FROM_ISR(xHigherPriorityTaskWoken);
|
2020-07-19 22:55:35 +02:00
|
|
|
#endif
|
2020-07-21 16:06:10 +02:00
|
|
|
|
|
|
|
return res != 0;
|
|
|
|
}
|
2020-05-20 08:38:41 +02:00
|
|
|
}
|
|
|
|
|
2022-04-20 08:25:38 +02:00
|
|
|
TU_ATTR_ALWAYS_INLINE static inline bool osal_queue_empty(osal_queue_t qhdl)
|
2020-05-20 08:38:41 +02:00
|
|
|
{
|
2020-05-20 10:21:11 +02:00
|
|
|
return uxQueueMessagesWaiting(qhdl) == 0;
|
2018-11-02 11:26:35 +01:00
|
|
|
}
|
|
|
|
|
2013-02-03 18:03:08 +01:00
|
|
|
#ifdef __cplusplus
|
|
|
|
}
|
|
|
|
#endif
|
|
|
|
|
2022-02-18 07:07:21 +01:00
|
|
|
#endif
|