qmpool.hpp

Go to the documentation of this file.

 
#ifndef QMPOOL_HPP
#define QMPOOL_HPP
 
#ifndef QF_MPOOL_SIZ_SIZE
    #define QF_MPOOL_SIZ_SIZE 2U
#endif
 
#ifndef QF_MPOOL_CTR_SIZE
    #define QF_MPOOL_CTR_SIZE 2
#endif
 
namespace QP {
#if (QF_MPOOL_SIZ_SIZE == 1U)
    using QMPoolSize = std::uint8_t;
#elif (QF_MPOOL_SIZ_SIZE == 2U)
    using QMPoolSize = std::uint16_t;
#elif (QF_MPOOL_SIZ_SIZE == 4U)
    using QMPoolSize = std::uint32_t;
#else
    #error "QF_MPOOL_SIZ_SIZE defined incorrectly, expected 1U, 2U, or 4U"
#endif
 
#if (QF_MPOOL_CTR_SIZE == 1U)
    using QMPoolCtr = std::uint8_t;
#elif (QF_MPOOL_CTR_SIZE == 2U)
    using QMPoolCtr = std::uint16_t;
#elif (QF_MPOOL_CTR_SIZE == 4U)
    using QMPoolCtr = std::uint32_t;
#else
    #error "QF_MPOOL_CTR_SIZE defined incorrectly, expected 1U, 2U, or 4U"
#endif
 
//****************************************************************************
class QMPool {
private:
 
    void *m_start;
 
    void *m_end;
 
    void * volatile m_free_head;
 
    QMPoolSize m_blockSize;
 
    QMPoolCtr m_nTot;
 
    QMPoolCtr volatile m_nFree;
 
    QMPoolCtr m_nMin;
 
public:
    QMPool(void); 
 
    void init(void * const poolSto, std::uint_fast32_t poolSize,
              std::uint_fast16_t blockSize) noexcept;
 
    void *get(std::uint_fast16_t const margin,
              std::uint_fast8_t const qs_id) noexcept;
 
    void put(void * const b, std::uint_fast8_t const qs_id) noexcept;
 
    QMPoolSize getBlockSize(void) const noexcept {
        return m_blockSize;
    }
 
// duplicated API to be used exclusively inside ISRs (useful in some QP ports)
#ifdef QF_ISR_API
    void *getFromISR(std::uint_fast16_t const margin,
                     std::uint_fast8_t const qs_id) noexcept;
    void putFromISR(void * const b,
                    std::uint_fast8_t const qs_id) noexcept;
#endif // QF_ISR_API
 
private:
    QMPool(QMPool const &) = delete;
 
    QMPool &operator=(QMPool const &) = delete;
 
    friend class QF;
    friend class QS;
};
 
} // namespace QP
 
#define QF_MPOOL_EL(type_) \
    struct { void *sto_[((sizeof(type_) - 1U)/sizeof(void*)) + 1U]; }
 
#endif  // QMPOOL_HPP