DmaChannel.hpp

Go to the documentation of this file.

#ifndef SOURCE_CHIP_STM32_PERIPHERALS_DMAV2_INCLUDE_DISTORTOS_CHIP_DMACHANNEL_HPP_
#define SOURCE_CHIP_STM32_PERIPHERALS_DMAV2_INCLUDE_DISTORTOS_CHIP_DMACHANNEL_HPP_

#include "distortos/assert.h"

#include "estd/EnumClassFlags.hpp"

#include <utility>

#include <cerrno>
#include <cstddef>
#include <cstdint>

namespace distortos
{

namespace chip
{

enum class DmaChannelFlags : uint32_t
{
    transferCompleteInterruptDisable = 0 << 4,
    transferCompleteInterruptEnable = 1 << 4,

    dmaFlowController = 0 << 5,
    peripheralFlowController = 1 << 5,

    peripheralToMemory = 0 << 6,
    memoryToPeripheral = 1 << 6,

    peripheralFixed = 0 << 9,
    peripheralIncrement = 1 << 9,

    memoryFixed = 0 << 10,
    memoryIncrement = 1 << 10,

    peripheralDataSize1 = 0 << 11,
    peripheralDataSize2 = 1 << 11,
    peripheralDataSize4 = 2 << 11,

    memoryDataSize1 = 0 << 13,
    memoryDataSize2 = 1 << 13,
    memoryDataSize4 = 2 << 13,

    lowPriority = 0 << 16,
    mediumPriority = 1 << 16,
    highPriority = 2 << 16,
    veryHighPriority = 3 << 16,

    peripheralBurstSize1 = 0 << 21,
    peripheralBurstSize4 = 1 << 21,
    peripheralBurstSize8 = 2 << 21,
    peripheralBurstSize16 = 3 << 21,

    memoryBurstSize1 = 0 << 23,
    memoryBurstSize4 = 1 << 23,
    memoryBurstSize8 = 2 << 23,
    memoryBurstSize16 = 3 << 23,

    dataSize1 = peripheralDataSize1 | memoryDataSize1,
    dataSize2 = peripheralDataSize2 | memoryDataSize2,
    dataSize4 = peripheralDataSize4 | memoryDataSize4,

    burstSize1 = peripheralBurstSize1 | memoryBurstSize1,
    burstSize4 = peripheralBurstSize4 | memoryBurstSize4,
    burstSize8 = peripheralBurstSize8 | memoryBurstSize8,
    burstSize16 = peripheralBurstSize16 | memoryBurstSize16,
};

}   // namespace chip

}   // namespace distortos

namespace estd
{

template<>
struct isEnumClassFlags<distortos::chip::DmaChannelFlags> : std::true_type
{

};

}   // namespace estd

namespace distortos
{

namespace chip
{

class DmaChannelFunctor;
class DmaChannelPeripheral;
class DmaPeripheral;

class DmaChannel
{
    friend class DmaChannelHandle;

public:

    using Flags = DmaChannelFlags;

    constexpr DmaChannel(const DmaPeripheral& dmaPeripheral, const DmaChannelPeripheral& dmaChannelPeripheral) :
            dmaPeripheral_{dmaPeripheral},
            dmaChannelPeripheral_{dmaChannelPeripheral},
            functor_{},
            request_{}
    {

    }

    ~DmaChannel()
    {
        assert(functor_ == nullptr);
    }

    void interruptHandler();

private:

    size_t getTransactionsLeft() const;

    void release();

    int reserve(uint8_t request, DmaChannelFunctor& functor);

    void startTransfer(uintptr_t memoryAddress, uintptr_t peripheralAddress, size_t transactions, Flags flags) const;

    void stopTransfer() const;

    const DmaPeripheral& dmaPeripheral_;

    const DmaChannelPeripheral& dmaChannelPeripheral_;

    DmaChannelFunctor* functor_;

    uint8_t request_;
};

}   // namespace chip

}   // namespace distortos

#endif  // SOURCE_CHIP_STM32_PERIPHERALS_DMAV2_INCLUDE_DISTORTOS_CHIP_DMACHANNEL_HPP_