RKH_QUEUE_T Struct Reference

Defines the data structure used to maintain information about the queue. More...

#include <rkhqueue.h>

Data Fields
RKH_QUENE_T	nelems
	Number of elements.
RKH_QUENE_T	qty
	Number of elements currently in the queue.
void **	pout
	Points to the free next place in the storage area.
void **	pin
	Points to the next place of queued item.
const void **	pstart
	Points to beginning of the queue storage area.
void **	pend
	Points to the end of the queue storage area.
const struct RKH_SMA_T *	sma
	Points to the associated SMA (a.k.a Active Object) that receives the enqueued events. More...
RKH_QUENE_T	nmin
	Minimum number of free elements ever in this queue. The nmin low-watermark provides valuable empirical data for proper sizing of the queue.
RKH_QUEI_T	rqi
	Performance information. This member is optional, thus it could be eliminated in compile-time with RKH_CFG_QUE_GET_INFO_EN.

Detailed Description

Defines the data structure used to maintain information about the queue.

The queue is a buffer-like object through which state machine applications (SMA) and ISRs send and receive messages to communicate and synchornize with data. It temporarily holds pointer to messages from a sender until the intended receiver is ready to read them.

The number of messages a queue can hold depends on its message size (pointer size) and the size of the memory area supplied during creation. To calculate the total message capacity of the queue, divide the number of bytes in each message into the total number of bytes in the supplied

The memory area for buffering messages is specified during queue creation. It can be located anywhere in the target's address space. This is an important feature because it gives the application considerable flexibility.

Note

RKH prohibits an application from explicitly modifying the RKH_QUEUE_T structure. The RKH's queue structures can be located anywhere in memory, but it is most common to make it a global structure by defining it outside the scope of any function. An RKH queue is created when an queue (copy by reference) is declared with the RKH_QUEUE_T data type. The following listing declares "gsmque" timer:

RKH_QUEUE_T gsmque;

Definition at line 169 of file rkhqueue.h.

Field Documentation

sma

const struct RKH_SMA_T* sma

Points to the associated SMA (a.k.a Active Object) that receives the enqueued events.

Note

If sma is set to NULL they never block.

Definition at line 215 of file rkhqueue.h.

---

The documentation for this struct was generated from the following file:

• rkhqueue.h