forked from Imagelibrary/rtems
Add a local context structure to the SMP lock API for acquire and release pairs. This context can be used to store the ISR level and profiling information. It may be later used to enable more sophisticated lock algorithms, e.g. MCS locks. There is only one lock that cannot be used with a local context. This is the per-CPU lock since here we would have to transfer the local context through a context switch which is very complicated.
58 lines
1.5 KiB
C
58 lines
1.5 KiB
C
/**
|
|
* @file
|
|
*
|
|
* @brief Simple Ring Buffer Functionality
|
|
*
|
|
* This file provides simple ring buffer functionality.
|
|
*/
|
|
|
|
|
|
#ifndef _RTEMS_RINGBUF_H
|
|
#define _RTEMS_RINGBUF_H
|
|
|
|
#include <rtems.h>
|
|
|
|
#ifndef RINGBUF_QUEUE_LENGTH
|
|
#define RINGBUF_QUEUE_LENGTH 128
|
|
#endif
|
|
|
|
typedef struct {
|
|
uint8_t buffer[RINGBUF_QUEUE_LENGTH];
|
|
volatile int head;
|
|
volatile int tail;
|
|
rtems_interrupt_lock lock;
|
|
} Ring_buffer_t;
|
|
|
|
#define Ring_buffer_Initialize( _buffer ) \
|
|
do { \
|
|
(_buffer)->head = (_buffer)->tail = 0; \
|
|
} while ( 0 )
|
|
|
|
#define Ring_buffer_Is_empty( _buffer ) \
|
|
( (_buffer)->head == (_buffer)->tail )
|
|
|
|
#define Ring_buffer_Is_full( _buffer ) \
|
|
( (_buffer)->head == ((_buffer)->tail + 1) % RINGBUF_QUEUE_LENGTH )
|
|
|
|
#define Ring_buffer_Add_character( _buffer, _ch ) \
|
|
do { \
|
|
rtems_interrupt_lock_context lock_context; \
|
|
\
|
|
rtems_interrupt_lock_acquire( &(_buffer)->lock, &lock_context ); \
|
|
(_buffer)->tail = ((_buffer)->tail+1) % RINGBUF_QUEUE_LENGTH; \
|
|
(_buffer)->buffer[ (_buffer)->tail ] = (_ch); \
|
|
rtems_interrupt_lock_release( &(_buffer)->lock, &lock_context ); \
|
|
} while ( 0 )
|
|
|
|
#define Ring_buffer_Remove_character( _buffer, _ch ) \
|
|
do { \
|
|
rtems_interrupt_lock_context lock_context; \
|
|
\
|
|
rtems_interrupt_lock_acquire( &(_buffer)->lock, &lock_context ); \
|
|
(_buffer)->head = ((_buffer)->head+1) % RINGBUF_QUEUE_LENGTH; \
|
|
(_ch) = (_buffer)->buffer[ (_buffer)->head ]; \
|
|
rtems_interrupt_lock_release( &(_buffer)->lock, &lock_context ); \
|
|
} while ( 0 )
|
|
|
|
#endif
|