io_buffers_queue Struct Reference

Structure of a generic buffers queue. More...

#include <hal_buffers.h>

Collaboration diagram for io_buffers_queue:

Data Fields
threads_queue_t	waiting
	Queue of waiting threads.
bool	suspended
	Queue suspended state flag.
volatile size_t	bcounter
	Active buffers counter.
uint8_t *	bwrptr
	Buffer write pointer.
uint8_t *	brdptr
	Buffer read pointer.
uint8_t *	btop
	Pointer to the buffers boundary.
size_t	bsize
	Size of buffers.
size_t	bn
	Number of buffers.
uint8_t *	buffers
	Queue of buffer objects.
uint8_t *	ptr
	Pointer for R/W sequential access.
uint8_t *	top
	Boundary for R/W sequential access.
bqnotify_t	notify
	Data notification callback.
void *	link
	Application defined field.

Detailed Description

Structure of a generic buffers queue.

Definition at line 75 of file hal_buffers.h.

Field Documentation

waiting

threads_queue_t io_buffers_queue::waiting

Queue of waiting threads.

Definition at line 79 of file hal_buffers.h.

Referenced by ibqGetFullBufferTimeoutS(), ibqObjectInit(), ibqPostFullBufferI(), ibqResetI(), obqGetEmptyBufferTimeoutS(), obqObjectInit(), obqReleaseEmptyBufferI(), and obqResetI().

suspended

bool io_buffers_queue::suspended

Queue suspended state flag.

Definition at line 83 of file hal_buffers.h.

Referenced by ibqGetFullBufferTimeoutS(), ibqObjectInit(), obqGetEmptyBufferTimeoutS(), and obqObjectInit().

bcounter

volatile size_t io_buffers_queue::bcounter

Active buffers counter.

Definition at line 87 of file hal_buffers.h.

Referenced by ibqObjectInit(), ibqPostFullBufferI(), ibqReleaseEmptyBufferS(), ibqResetI(), obqObjectInit(), obqPostFullBufferS(), obqReleaseEmptyBufferI(), obqResetI(), and obqTryFlushI().

bwrptr

uint8_t* io_buffers_queue::bwrptr

Buffer write pointer.

Definition at line 91 of file hal_buffers.h.

Referenced by ibqGetEmptyBufferI(), ibqObjectInit(), ibqPostFullBufferI(), ibqResetI(), obqFlush(), obqGetEmptyBufferTimeoutS(), obqObjectInit(), obqPostFullBufferS(), obqResetI(), and obqTryFlushI().

brdptr

uint8_t* io_buffers_queue::brdptr

Buffer read pointer.

Definition at line 95 of file hal_buffers.h.

Referenced by ibqGetFullBufferTimeoutS(), ibqObjectInit(), ibqReleaseEmptyBufferS(), ibqResetI(), obqGetFullBufferI(), obqObjectInit(), obqReleaseEmptyBufferI(), and obqResetI().

btop

uint8_t* io_buffers_queue::btop

Pointer to the buffers boundary.

Definition at line 99 of file hal_buffers.h.

Referenced by ibqObjectInit(), ibqPostFullBufferI(), ibqReleaseEmptyBufferS(), obqObjectInit(), obqPostFullBufferS(), obqReleaseEmptyBufferI(), and obqTryFlushI().

bsize

size_t io_buffers_queue::bsize

Size of buffers.

Note

The buffer size must be not lower than sizeof(size_t) + 2 because the first bytes are used to store the used size of the buffer.

Definition at line 106 of file hal_buffers.h.

Referenced by ibqObjectInit(), ibqPostFullBufferI(), ibqReleaseEmptyBufferS(), obqGetEmptyBufferTimeoutS(), obqObjectInit(), obqPostFullBufferS(), obqPutTimeout(), obqReleaseEmptyBufferI(), obqTryFlushI(), and obqWriteTimeout().

bn

size_t io_buffers_queue::bn

Number of buffers.

Definition at line 110 of file hal_buffers.h.

Referenced by ibqObjectInit(), and obqObjectInit().

buffers

uint8_t* io_buffers_queue::buffers

Queue of buffer objects.

Definition at line 114 of file hal_buffers.h.

Referenced by ibqObjectInit(), ibqPostFullBufferI(), ibqReleaseEmptyBufferS(), ibqResetI(), obqObjectInit(), obqPostFullBufferS(), obqReleaseEmptyBufferI(), obqResetI(), and obqTryFlushI().

ptr

uint8_t* io_buffers_queue::ptr

Pointer for R/W sequential access.

Note

It is NULL if a new buffer must be fetched from the queue.

Definition at line 119 of file hal_buffers.h.

Referenced by ibqGetFullBufferTimeoutS(), ibqGetTimeout(), ibqObjectInit(), ibqReadTimeout(), ibqReleaseEmptyBufferS(), ibqResetI(), obqFlush(), obqGetEmptyBufferTimeoutS(), obqObjectInit(), obqPostFullBufferS(), obqPutTimeout(), obqResetI(), obqTryFlushI(), and obqWriteTimeout().

top

uint8_t* io_buffers_queue::top

Boundary for R/W sequential access.

Definition at line 123 of file hal_buffers.h.

Referenced by ibqGetFullBufferTimeoutS(), ibqGetTimeout(), ibqObjectInit(), ibqReadTimeout(), ibqResetI(), obqGetEmptyBufferTimeoutS(), obqObjectInit(), obqPutTimeout(), obqResetI(), and obqWriteTimeout().

notify

bqnotify_t io_buffers_queue::notify

Data notification callback.

Definition at line 127 of file hal_buffers.h.

Referenced by ibqObjectInit(), ibqReleaseEmptyBufferS(), obqObjectInit(), and obqPostFullBufferS().

link

void* io_buffers_queue::link

Application defined field.

Definition at line 131 of file hal_buffers.h.

Referenced by ibqObjectInit(), and obqObjectInit().