From f6076b0e0621b13f8d76f51dc703024347af00f3 Mon Sep 17 00:00:00 2001 From: hathach Date: Fri, 2 Nov 2018 17:28:07 +0700 Subject: [PATCH] add mutex support (optional) for tu_fifo --- src/common/tusb_common.h | 1 - src/common/tusb_fifo.c | 72 +++++++++++++++++++++++++++------------- src/common/tusb_fifo.h | 58 +++++++++++--------------------- 3 files changed, 68 insertions(+), 63 deletions(-) diff --git a/src/common/tusb_common.h b/src/common/tusb_common.h index 85bd15d4..3c5402e5 100644 --- a/src/common/tusb_common.h +++ b/src/common/tusb_common.h @@ -66,7 +66,6 @@ #include "tusb_verify.h" #include "binary.h" #include "tusb_error.h" -#include "tusb_fifo.h" #include "tusb_timeout.h" #include "tusb_types.h" diff --git a/src/common/tusb_fifo.c b/src/common/tusb_fifo.c index 818f4e9c..e0b3d0aa 100644 --- a/src/common/tusb_fifo.c +++ b/src/common/tusb_fifo.c @@ -36,24 +36,51 @@ */ /**************************************************************************/ -#include "tusb_fifo.h" -#include "common/tusb_verify.h" // for ASSERT +#include +#include "osal/osal.h" +#include "tusb_fifo.h" + +// implement mutex lock and unlock +// For OSAL_NONE: if mutex is locked by other, function return immediately (since there is no task context) +// For Real RTOS: fifo lock is a blocking API #if CFG_FIFO_MUTEX -#define mutex_lock_if_needed(_ff) if (_ff->mutex) tu_fifo_mutex_lock(_ff->mutex) -#define mutex_unlock_if_needed(_ff) if (_ff->mutex) tu_fifo_mutex_unlock(_ff->mutex) +static bool tu_fifo_lock(tu_fifo_t *f) +{ + if (f->mutex) + { +#if CFG_TUSB_OS == OPT_OS_NONE + // There is no subtask context for blocking mutex, we will check and return if cannot lock the mutex + if ( !osal_mutex_lock_notask(f->mutex) ) return false; +#else + uint32_t err; + (void) err; + osal_mutex_lock(f->mutex, OSAL_TIMEOUT_WAIT_FOREVER, &err); +#endif + } + + return true; +} + +static void tu_fifo_unlock(tu_fifo_t *f) +{ + if (f->mutex) + { + osal_mutex_unlock(f->mutex); + } +} #else -#define mutex_lock_if_needed(_ff) -#define mutex_unlock_if_needed(_ff) +#define tu_fifo_lock(_ff) true +#define tu_fifo_unlock(_ff) #endif -void tu_fifo_config(tu_fifo_t *f, void* buffer, uint16_t depth, uint16_t item_size, bool overwritable) +bool tu_fifo_config(tu_fifo_t *f, void* buffer, uint16_t depth, uint16_t item_size, bool overwritable) { - mutex_lock_if_needed(f); + if ( !tu_fifo_lock(f) ) return false; f->buffer = (uint8_t*) buffer; f->depth = depth; @@ -62,7 +89,9 @@ void tu_fifo_config(tu_fifo_t *f, void* buffer, uint16_t depth, uint16_t item_si f->rd_idx = f->wr_idx = f->count = 0; - mutex_unlock_if_needed(f); + tu_fifo_unlock(f); + + return true; } @@ -86,7 +115,7 @@ bool tu_fifo_read(tu_fifo_t* f, void * p_buffer) { if( tu_fifo_empty(f) ) return false; - mutex_lock_if_needed(f); + if ( !tu_fifo_lock(f) ) return false; memcpy(p_buffer, f->buffer + (f->rd_idx * f->item_size), @@ -94,7 +123,7 @@ bool tu_fifo_read(tu_fifo_t* f, void * p_buffer) f->rd_idx = (f->rd_idx + 1) % f->depth; f->count--; - mutex_unlock_if_needed(f); + tu_fifo_unlock(f); return true; } @@ -122,8 +151,6 @@ uint16_t tu_fifo_read_n (tu_fifo_t* f, void * p_buffer, uint16_t count) /* Limit up to fifo's count */ if ( count > f->count ) count = f->count; - mutex_lock_if_needed(f); - /* Could copy up to 2 portions marked as 'x' if queue is wrapped around * case 1: ....RxxxxW....... * case 2: xxxxxW....Rxxxxxx @@ -138,8 +165,6 @@ uint16_t tu_fifo_read_n (tu_fifo_t* f, void * p_buffer, uint16_t count) p_buf += f->item_size; } - mutex_unlock_if_needed(f); - return len; } @@ -189,10 +214,9 @@ bool tu_fifo_peek_at(tu_fifo_t* f, uint16_t pos, void * p_buffer) /******************************************************************************/ bool tu_fifo_write (tu_fifo_t* f, const void * p_data) { -// if ( tu_fifo_full(f) && !f->overwritable ) return false; - TU_ASSERT( !(tu_fifo_full(f) && !f->overwritable) ); + if ( tu_fifo_full(f) && !f->overwritable ) return false; - mutex_lock_if_needed(f); + if ( !tu_fifo_lock(f) ) return false; memcpy( f->buffer + (f->wr_idx * f->item_size), p_data, @@ -209,7 +233,7 @@ bool tu_fifo_write (tu_fifo_t* f, const void * p_data) f->count++; } - mutex_unlock_if_needed(f); + tu_fifo_unlock(f); return true; } @@ -233,7 +257,7 @@ uint16_t tu_fifo_write_n (tu_fifo_t* f, const void * p_data, uint16_t count) { if ( count == 0 ) return 0; - uint8_t* p_buf = (uint8_t*) p_data; + uint8_t const* p_buf = (uint8_t const*) p_data; uint16_t len = 0; while( (len < count) && tu_fifo_write(f, p_buf) ) @@ -253,11 +277,13 @@ uint16_t tu_fifo_write_n (tu_fifo_t* f, const void * p_data, uint16_t count) Pointer to the FIFO buffer to manipulate */ /******************************************************************************/ -void tu_fifo_clear(tu_fifo_t *f) +bool tu_fifo_clear(tu_fifo_t *f) { - mutex_lock_if_needed(f); + if ( !tu_fifo_lock(f) ) return false; f->rd_idx = f->wr_idx = f->count = 0; - mutex_unlock_if_needed(f); + tu_fifo_unlock(f); + + return true; } diff --git a/src/common/tusb_fifo.h b/src/common/tusb_fifo.h index 1ddf3bd9..70dc087c 100644 --- a/src/common/tusb_fifo.h +++ b/src/common/tusb_fifo.h @@ -43,42 +43,17 @@ #ifndef _TUSB_FIFO_H_ #define _TUSB_FIFO_H_ -#define CFG_FIFO_MUTEX 0 +#define CFG_FIFO_MUTEX 1 #include #include -#include #ifdef __cplusplus extern "C" { #endif #if CFG_FIFO_MUTEX - -#include "osal/osal.h" - -#if CFG_TUSB_OS == OPT_OS_NONE -// Since all fifo read/write is done in thread mode, there should be -// no conflict except for osal queue which will be address seperatedly. -// Therefore there may be no need for mutex with internal use of fifo - -#define _ff_mutex_def(mutex) - -#else -#define tu_fifo_mutex_t struct os_mutex - -#define tu_fifo_mutex_lock(m) os_mutex_pend(m, OS_TIMEOUT_NEVER) -#define tu_fifo_mutex_unlock(m) os_mutex_release(m) - -/* Internal use only */ -#define _mutex_declare(m) .mutex = m - -#endif - -#else - -#define _mutex_declare(m) - +#define tu_fifo_mutex_t osal_mutex_t #endif @@ -98,24 +73,29 @@ typedef struct bool overwritable ; #if CFG_FIFO_MUTEX - tu_fifo_mutex_t * const mutex; + tu_fifo_mutex_t mutex; #endif } tu_fifo_t; -#define TU_FIFO_DEF(_name, _depth, _type, _overwritable) /*, irq_mutex)*/ \ - uint8_t _name##_buf[_depth*sizeof(_type)];\ - tu_fifo_t _name = {\ - .buffer = _name##_buf,\ - .depth = _depth,\ - .item_size = sizeof(_type),\ - .overwritable = _overwritable,\ - /*.irq = irq_mutex*/\ - _mutex_declare(_mutex)\ +#define TU_FIFO_DEF(_name, _depth, _type, _overwritable) \ + uint8_t _name##_buf[_depth*sizeof(_type)]; \ + tu_fifo_t _name = { \ + .buffer = _name##_buf, \ + .depth = _depth, \ + .item_size = sizeof(_type), \ + .overwritable = _overwritable, \ } -void tu_fifo_clear(tu_fifo_t *f); -void tu_fifo_config(tu_fifo_t *f, void* buffer, uint16_t depth, uint16_t item_size, bool overwritable); +bool tu_fifo_clear(tu_fifo_t *f); +bool tu_fifo_config(tu_fifo_t *f, void* buffer, uint16_t depth, uint16_t item_size, bool overwritable); + +#if CFG_FIFO_MUTEX +static inline void tu_fifo_config_mutex(tu_fifo_t *f, tu_fifo_mutex_t mutex_hdl) +{ + f->mutex = mutex_hdl; +} +#endif bool tu_fifo_write (tu_fifo_t* f, void const * p_data); uint16_t tu_fifo_write_n (tu_fifo_t* f, void const * p_data, uint16_t count);