rkhrq.h

Go to the documentation of this file.

/*
 *  --------------------------------------------------------------------------
 *
 *                                Framework RKH
 *                                -------------
 *
 *            State-machine framework for reactive embedded systems
 *
 *                      Copyright (C) 2010 Leandro Francucci.
 *          All rights reserved. Protected by international copyright laws.
 *
 *
 *  RKH is free software: you can redistribute it and/or modify it under the
 *  terms of the GNU General Public License as published by the Free Software
 *  Foundation, either version 3 of the License, or (at your option) any
 *  later version.
 *
 *  RKH is distributed in the hope that it will be useful, but WITHOUT ANY
 *  WARRANTY; without even the implied warranty of MERCHANTABILITY or
 *  FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
 *  more details.
 *
 *  You should have received a copy of the GNU General Public License along
 *  with RKH, see copying.txt file.
 *
 *  Contact information:
 *  RKH web site:   http://sourceforge.net/projects/rkh-reactivesys/
 *  e-mail:         francuccilea@gmail.com
 *  ---------------------------------------------------------------------------
 */

/* -------------------------- Development history -------------------------- */
/*
 *  2015.10.24  LeFr  v2.4.05  Initial version
 */

/* -------------------------------- Authors -------------------------------- */
/*
 *  LeFr  Leandro Francucci  francuccilea@gmail.com
 */

/* --------------------------------- Notes --------------------------------- */
/* --------------------------------- Module -------------------------------- */
#ifndef __RKHRQ_H__
#define __RKHRQ_H__

/* ----------------------------- Include files ----------------------------- */
#include "rkhcfg.h"
#include "rkhtype.h"

/* ---------------------- External C language linkage ---------------------- */
#ifdef __cplusplus
extern "C" {
#endif

/* --------------------------------- Macros -------------------------------- */
#define RKH_RQ_IS_EMPTY(q) \
    (rbool_t)(rkh_rq_get_num((RKH_RQ_T *)(q)) == 0)

/* -------------------------------- Constants ------------------------------ */
/* ------------------------------- Data types ------------------------------ */
#if RKH_CFG_RQ_SIZEOF_NELEM == 8
typedef rui8_t RKH_RQNE_T;
#elif RKH_CFG_RQ_SIZEOF_NELEM == 16
typedef rui16_t RKH_RQNE_T;
#elif RKH_CFG_RQ_SIZEOF_NELEM == 32
typedef rui32_t RKH_RQNE_T;
#else
typedef rui8_t RKH_RQNE_T;
#endif

typedef enum
{
    RKH_RQ_OK, RKH_RQ_EMPTY, RKH_RQ_FULL
} RKH_RQCODE_T;

typedef struct RKH_QINFO_T
{
    rui16_t nputs;      /*  # of put requests */
    rui16_t ngets;      /*  # of get requests */
    rui16_t nreads;     /*  # of queue read requests */
    rui16_t nempty;     /*  # of queue empty retrieves */
    rui16_t nfull;      /*  # of queue full retrieves */
} RKH_RQI_T;

typedef struct RKH_RQ_T
{
    RKH_RQNE_T nelems;

    RKH_RQNE_T qty;

    void **pout;

    void **pin;

    const void **pstart;

    void **pend;

    const struct RKH_SMA_T *sma;

#if RKH_CFG_RQ_GET_LWMARK_EN == RKH_ENABLED
    RKH_RQNE_T nmin;
#endif

#if RKH_CFG_RQ_GET_INFO_EN == RKH_ENABLED
    RKH_RQI_T rqi;
#endif
} RKH_RQ_T;

/* -------------------------- External variables --------------------------- */
/* -------------------------- Function prototypes -------------------------- */
void rkh_rq_init(RKH_RQ_T *q, const void * *sstart, RKH_RQNE_T ssize,
                 const struct RKH_SMA_T *sma);

rbool_t rkh_rq_is_full(RKH_RQ_T *q);

RKH_RQNE_T rkh_rq_get_num(RKH_RQ_T *q);

RKH_RQNE_T rkh_rq_get_lwm(RKH_RQ_T *q);

void *rkh_rq_get(RKH_RQ_T *q);

void rkh_rq_put_fifo(RKH_RQ_T *q, const void *pe);

void rkh_rq_put_lifo(RKH_RQ_T *q, const void *pe);

void rkh_rq_deplete(RKH_RQ_T *q);

ruint rkh_rq_read(RKH_RQ_T *q, void *pe);

void rkh_rq_get_info(RKH_RQ_T *q, RKH_RQI_T *pqi);

void rkh_rq_clear_info(RKH_RQ_T *q);

/* -------------------- External C language linkage end -------------------- */
#ifdef __cplusplus
}
#endif

/* ------------------------------ Module end ------------------------------- */
#endif

/* ------------------------------ End of file ------------------------------ */