queue.hpp

/****************************************************************************
 *
 *  Copyright (c) 2017, Michael Becker (michael.f.becker@gmail.com)
 *
 *  This file is part of the FreeRTOS Add-ons project.
 *
 *  Source Code:
 *  https://github.com/michaelbecker/freertos-addons
 *
 *  Project Page:
 *  http://michaelbecker.github.io/freertos-addons/
 *
 *  On-line Documentation:
 *  http://michaelbecker.github.io/freertos-addons/docs/html/index.html
 *
 *  Permission is hereby granted, free of charge, to any person obtaining a
 *  copy of this software and associated documentation files
 *  (the "Software"), to deal in the Software without restriction, including
 *  without limitation the rights to use, copy, modify, merge, publish,
 *  distribute, sublicense, and/or sell copies of the Software, and to
 *  permit persons to whom the Software is furnished to do so,subject to the
 *  following conditions:
 *
 *  + The above copyright notice and this permission notice shall be included
 *    in all copies or substantial portions of the Software.
 *  + Credit is appreciated, but not required, if you find this project
 *    useful enough to include in your application, product, device, etc.
 *
 *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
 *  OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
 *  MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
 *  IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
 *  CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
 *  TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
 *  SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 *
 ***************************************************************************/
 
 
#include "freertos-config.h"
 
#ifndef QUEUE_HPP_
#define QUEUE_HPP_
 
#ifndef CPP_FREERTOS_NO_EXCEPTIONS
#include <exception>
#include <cstdio>
#include <string>
#ifdef CPP_FREERTOS_NO_CPP_STRINGS
#error "FreeRTOS-Addons require C++ Strings if you are using exceptions"
#endif
#endif
#include "FreeRTOS.h"
#include "queue.h"
 
 
namespace cpp_freertos {
 
 
#ifndef CPP_FREERTOS_NO_EXCEPTIONS
class QueueCreateException : public std::exception {
 
    public:
        QueueCreateException()
        {
            sprintf(errorString, "Queue Constructor Failed");
        }
 
        explicit QueueCreateException(const char *info)
        {
            snprintf(errorString, sizeof(errorString),
                        "Queue Constructor Failed %s", info);
        }
 
        virtual const char *what() const throw()
        {
            return errorString;
        }
 
    private:
        char errorString[80];
};
#endif
 
 
class Queue {
 
    //
    //  Public API
    //
    public:
        Queue(UBaseType_t maxItems, UBaseType_t itemSize);
 
        virtual ~Queue();
 
        virtual bool Enqueue(const void *item);
 
        virtual bool Enqueue(const void *item, TickType_t Timeout);
 
        bool Dequeue(void *item, TickType_t Timeout = portMAX_DELAY);
 
        bool Peek(void *item, TickType_t Timeout = portMAX_DELAY);
 
        virtual bool EnqueueFromISR(const void *item, BaseType_t *pxHigherPriorityTaskWoken);
 
        bool DequeueFromISR(void *item, BaseType_t *pxHigherPriorityTaskWoken);
 
        bool PeekFromISR(void *item);
 
        bool IsEmpty();
 
        bool IsFull();
 
        void Flush();
 
        UBaseType_t NumItems();
 
        UBaseType_t NumSpacesLeft();
 
    //
    //  Protected API
    //  Not intended for use by application code.
    //
    protected:
        QueueHandle_t handle;
};
 
 
class Deque : public Queue {
 
    //
    //  Public API
    //
    public:
        Deque(UBaseType_t maxItems, UBaseType_t itemSize);
 
        bool EnqueueToFront(void *item, TickType_t Timeout = portMAX_DELAY);
 
        bool EnqueueToFrontFromISR(void *item, BaseType_t *pxHigherPriorityTaskWoken);
};
 
 
class BinaryQueue : public Queue {
 
    //
    //  Public API
    //
    public:
        explicit BinaryQueue(UBaseType_t itemSize);
 
        virtual bool Enqueue(void *item);
 
        virtual bool EnqueueFromISR(void *item, BaseType_t *pxHigherPriorityTaskWoken);
};
 
 
}
#endif