docs/hal_html/hal__spi__dma_8h_source.html

#ifndef HAL_SPI_DMA_H

#define HAL_SPI_DMA_H


#include "hal_dma.h"

#include "hal_spi.h"


#define HAL_SPI_DMA_DRIVER_VERSION (MAKE_VERSION(1, 0, 0))


typedef struct _spi_dma_handle spi_dma_handle_t;


typedef void (*spi_dma_callback_t)(SPI_Type *base, spi_dma_handle_t *handle,

    void *user_data, dma_irq_t inttype);


struct _spi_dma_handle {

    volatile bool tx_in_progress;

    volatile bool rx_in_progress;

    dma_handle_t *tx_handle;

    dma_descriptor_t *tx_desc;

    dma_handle_t *rx_handle;

    dma_descriptor_t *rx_desc;

    uint8_t bytes_per_frame;

    spi_dma_callback_t callback;

    void *user_data;

    enum spi_trans_status state;

    size_t transfer_size;

    void *dummy_data;

};


#if defined(__cplusplus)

extern "C" {

#endif


enum spi_status SPI_MasterTransferCreateHandleDMA(SPI_Type *base,

    spi_dma_callback_t callback, void *user_data, spi_dma_handle_t *handle,

    dma_handle_t *tx_handle, dma_handle_t *rx_handle);


enum spi_status SPI_MasterTransferDMA(SPI_Type *base,

    spi_dma_handle_t *handle, spi_transfer_t *xfer);


enum spi_status SPI_MasterHalfDuplexTransferDMA(SPI_Type *base,

    spi_dma_handle_t *handle, spi_half_duplex_transfer_t *xfer);


static inline enum spi_status SPI_SlaveTransferCreateHandleDMA(

    SPI_Type *base, spi_dma_callback_t callback, void *user_data,

    spi_dma_handle_t *handle, dma_handle_t *tx_handle, dma_handle_t *rx_handle)

{

    return SPI_MasterTransferCreateHandleDMA(base, callback, user_data,

            handle, tx_handle, rx_handle);

}


static inline enum spi_status SPI_SlaveTransferDMA(SPI_Type *base,

    spi_dma_handle_t *handle, spi_transfer_t *xfer)

{

    return SPI_MasterTransferDMA(base, handle, xfer);

}


void SPI_MasterTransferAbortDMA(spi_dma_handle_t *handle);


static inline void SPI_SlaveTransferAbortDMA(spi_dma_handle_t *handle)

{

    SPI_MasterTransferAbortDMA(handle);

}


static inline void SPI_DMADescriptorInitTX(SPI_Type *base,

    dma_descriptor_t *desc, uint32_t count, uint32_t data_size,

    uint8_t src_incr, uint32_t data_width, void *src_addr)

{

    dma_multiblock_config_t config = {

        .count          = count,

        .data_size      = data_size,

        .transfer_type  = DMA_MemoryToPeripheral_DMA,

        .scatter_en     = false,

        .gather_en      = false,

        .src_burst_size = DMA_BurstSize32,

        .dst_burst_size = DMA_BurstSize1,

        .src_incr       = src_incr,

        .dst_incr       = DMA_NoChange,

        .src_data_width = data_width,

        .dst_data_width = data_width,

        .src_addr       = src_addr,

        .dst_addr       = (void *) &base->DR0,

        .int_en         = true

    };


    DMA_InitMultiblockDescriptor(desc, &config);

}


static inline void SPI_DMADescriptorInitRX(SPI_Type *base,

    dma_descriptor_t *desc, uint32_t count, uint32_t data_size,

    uint8_t dst_incr, uint32_t data_width, void *dst_addr)

{

    dma_multiblock_config_t config = {

        .count          = count,

        .data_size      = data_size,

        .transfer_type  = DMA_PeripheralToMemory_DMA,

        .scatter_en     = false,

        .gather_en      = false,

        .src_burst_size = DMA_BurstSize1,

        .dst_burst_size = DMA_BurstSize32,

        .src_incr       = DMA_NoChange,

        .dst_incr       = dst_incr,

        .src_data_width = data_width,

        .dst_data_width = data_width,

        .src_addr       = (void *) &base->DR0,

        .dst_addr       = dst_addr,

        .int_en         = true

    };


    DMA_InitMultiblockDescriptor(desc, &config);

}


#if defined(__cplusplus)

}

#endif


#endif /* HAL_SPI_DMA_H */


dma_irq_t
enum _dma_int dma_irq_t
Источники прерываний DMA.

DMA_InitMultiblockDescriptor
void DMA_InitMultiblockDescriptor(dma_descriptor_t *desc, dma_multiblock_config_t *config)
Функция, инициализирующая DMA дескрипторы многоблочной передачи.

DMA_NoChange
@ DMA_NoChange
Definition hal_dma.h:165

DMA_PeripheralToMemory_DMA
@ DMA_PeripheralToMemory_DMA
Definition hal_dma.h:213

DMA_MemoryToPeripheral_DMA
@ DMA_MemoryToPeripheral_DMA
Definition hal_dma.h:212

DMA_BurstSize1
@ DMA_BurstSize1
Definition hal_dma.h:149

DMA_BurstSize32
@ DMA_BurstSize32
Definition hal_dma.h:153

SPI_MasterHalfDuplexTransferDMA
enum spi_status SPI_MasterHalfDuplexTransferDMA(SPI_Type *base, spi_dma_handle_t *handle, spi_half_duplex_transfer_t *xfer)
Функция приема/передачи данных в полудуплексном режиме через DMA каналы в порт SPI.

spi_trans_status
spi_trans_status
Состояния приемо-передачи SPI.
Definition hal_spi.h:324

SPI_MasterTransferCreateHandleDMA
enum spi_status SPI_MasterTransferCreateHandleDMA(SPI_Type *base, spi_dma_callback_t callback, void *user_data, spi_dma_handle_t *handle, dma_handle_t *tx_handle, dma_handle_t *rx_handle)
Функция инициализации дескриптора SPI-DMA.

SPI_DMADescriptorInitTX
static void SPI_DMADescriptorInitTX(SPI_Type *base, dma_descriptor_t *desc, uint32_t count, uint32_t data_size, uint8_t src_incr, uint32_t data_width, void *src_addr)
Инициализация дескрипторов DMA для многоблочной передачи TX.
Definition hal_spi_dma.h:169

SPI_MasterTransferDMA
enum spi_status SPI_MasterTransferDMA(SPI_Type *base, spi_dma_handle_t *handle, spi_transfer_t *xfer)
Функция для SPI master приема/передачи данных в полнодуплексном режиме через DMA каналы в порт SPI.

SPI_SlaveTransferDMA
static enum spi_status SPI_SlaveTransferDMA(SPI_Type *base, spi_dma_handle_t *handle, spi_transfer_t *xfer)
Функция для SPI slave приема/передачи данных в полнодуплексном режиме через DMA каналы в порт SPI.
Definition hal_spi_dma.h:136

SPI_SlaveTransferCreateHandleDMA
static enum spi_status SPI_SlaveTransferCreateHandleDMA(SPI_Type *base, spi_dma_callback_t callback, void *user_data, spi_dma_handle_t *handle, dma_handle_t *tx_handle, dma_handle_t *rx_handle)
Функция инициализации дескриптора SPI-DMA.
Definition hal_spi_dma.h:115

SPI_DMADescriptorInitRX
static void SPI_DMADescriptorInitRX(SPI_Type *base, dma_descriptor_t *desc, uint32_t count, uint32_t data_size, uint8_t dst_incr, uint32_t data_width, void *dst_addr)
Инициализация дескрипторов DMA для многоблочной передачи RX.
Definition hal_spi_dma.h:203

spi_status
spi_status
Статусы возврата из функций для драйвера SPI.
Definition hal_spi.h:49

SPI_MasterTransferAbortDMA
void SPI_MasterTransferAbortDMA(spi_dma_handle_t *handle)
Прекращение передачи SPI.

SPI_SlaveTransferAbortDMA
static void SPI_SlaveTransferAbortDMA(spi_dma_handle_t *handle)
Прекращение передачи SPI.
Definition hal_spi_dma.h:154

spi_dma_callback_t
void(* spi_dma_callback_t)(SPI_Type *base, spi_dma_handle_t *handle, void *user_data, dma_irq_t inttype)
Функция обратного вызова
Definition hal_spi_dma.h:27

hal_dma.h
Интерфейс драйвера прямого доступа к памяти

hal_spi.h
Интерфейс драйвера модуля SPI.

_dma_descriptor
Описатель следующего блока DMA (LLI)
Definition hal_dma.h:222

_dma_handle
Управляющая структура передачи
Definition hal_dma.h:296

_dma_multiblock_config
Конфигурация многоблочной передачи
Definition hal_dma.h:306

_dma_multiblock_config::count
uint32_t count
Definition hal_dma.h:307

_spi_dma_handle
Дескриптор SPI-DMA.
Definition hal_spi_dma.h:33

_spi_dma_handle::tx_in_progress
volatile bool tx_in_progress
Definition hal_spi_dma.h:34

_spi_dma_handle::rx_desc
dma_descriptor_t * rx_desc
Definition hal_spi_dma.h:39

_spi_dma_handle::transfer_size
size_t transfer_size
Definition hal_spi_dma.h:44

_spi_dma_handle::user_data
void * user_data
Definition hal_spi_dma.h:42

_spi_dma_handle::state
enum spi_trans_status state
Definition hal_spi_dma.h:43

_spi_dma_handle::rx_handle
dma_handle_t * rx_handle
Definition hal_spi_dma.h:38

_spi_dma_handle::dummy_data
void * dummy_data
Definition hal_spi_dma.h:45

_spi_dma_handle::tx_desc
dma_descriptor_t * tx_desc
Definition hal_spi_dma.h:37

_spi_dma_handle::rx_in_progress
volatile bool rx_in_progress
Definition hal_spi_dma.h:35

_spi_dma_handle::tx_handle
dma_handle_t * tx_handle
Definition hal_spi_dma.h:36

_spi_dma_handle::callback
spi_dma_callback_t callback
Definition hal_spi_dma.h:41

_spi_dma_handle::bytes_per_frame
uint8_t bytes_per_frame
Definition hal_spi_dma.h:40

spi_half_duplex_transfer_t
Структура SPI для полудуплексной приемо-передачи в режиме Master.
Definition hal_spi.h:386

spi_transfer_t
Структура SPI для приемо-передачи
Definition hal_spi.h:377