docs/hal_html/hal__uart__dma_8h_source.html

#ifndef HAL_SPI_DMA_H

#define HAL_SPI_DMA_H


#include "hal_dma.h"

#include "hal_uart.h"


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


typedef struct _uart_dma_handle uart_dma_handle_t;


typedef void (*uart_dma_transfer_callback_t)(UART_Type *base,

    uart_dma_handle_t *handle,

    enum uart_status status,

    void *user_data);


struct _uart_dma_handle {

    UART_Type *base;

    uart_dma_transfer_callback_t callback;

    void *user_data;

    uint32_t rx_data_size_all;

    uint32_t tx_data_size_all;

    dma_handle_t *tx_dma_handle;

    dma_handle_t *rx_dma_handle;

    dma_descriptor_t *tx_desc;

    dma_descriptor_t *rx_desc;


    volatile uint8_t tx_state;

    volatile uint8_t rx_state;

};


#if defined(__cplusplus)

extern "C" {

#endif


void UART_TransferCreateHandleDMA(UART_Type *base,

    uart_dma_handle_t *handle,

    uart_dma_transfer_callback_t callback,

    void *user_data, dma_handle_t *tx_dma_handle,

    dma_handle_t *rx_dma_handle);


enum uart_status UART_TransferSendDMA(UART_Type *base,

    uart_dma_handle_t *handle, struct uart_transfer *xfer);


enum uart_status UART_TransferReceiveDMA(UART_Type *base,

    uart_dma_handle_t *handle, struct uart_transfer *xfer);


void UART_TransferAbortSendDMA(UART_Type *base, uart_dma_handle_t *handle);


void UART_TransferAbortReceiveDMA(UART_Type *base, uart_dma_handle_t *handle);


static inline void UART_WaitWhileActive(UART_Type *base)

{

    /* Ожидание завершения передачи */

    while (base->USR & UART_USR_BUSY_Msk);

}


static inline void UART_DMADescriptorInitTX(UART_Type *base,

    dma_descriptor_t *desc, uint32_t count, uint32_t data_size,

    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       = DMA_Incr,

        .dst_incr       = DMA_NoChange,

        .src_data_width = data_width,

        .dst_data_width = data_width,

        .src_addr       = src_addr,

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

        .int_en         = true

    };


    DMA_InitMultiblockDescriptor(desc, &config);

}


static inline void UART_DMADescriptorInitRX(UART_Type *base,

    dma_descriptor_t *desc, uint32_t count, uint32_t data_size,

    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       = DMA_Incr,

        .src_data_width = data_width,

        .dst_data_width = data_width,

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

        .dst_addr       = dst_addr,

        .int_en         = true

    };


    DMA_InitMultiblockDescriptor(desc, &config);

}


#if defined(__cplusplus)

}

#endif


#endif  /* HAL_UART_DMA_H */


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_Incr
@ DMA_Incr
Definition hal_dma.h:163

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

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

UART_TransferSendDMA
enum uart_status UART_TransferSendDMA(UART_Type *base, uart_dma_handle_t *handle, struct uart_transfer *xfer)
Функция осуществляющая передачу данных по UART, данные в буфер попадают через DMA канал

UART_WaitWhileActive
static void UART_WaitWhileActive(UART_Type *base)
Ожидание завершения передачи. Выход из функции будет осуществлен по окончании UART транзакций
Definition hal_uart_dma.h:131

UART_TransferAbortSendDMA
void UART_TransferAbortSendDMA(UART_Type *base, uart_dma_handle_t *handle)
Функция прерывающая передачу данных между UART(TX) и DMA.

UART_DMADescriptorInitRX
static void UART_DMADescriptorInitRX(UART_Type *base, dma_descriptor_t *desc, uint32_t count, uint32_t data_size, uint32_t data_width, void *dst_addr)
Инициализация дескрипторов DMA для многоблочной передачи TX.
Definition hal_uart_dma.h:181

UART_TransferReceiveDMA
enum uart_status UART_TransferReceiveDMA(UART_Type *base, uart_dma_handle_t *handle, struct uart_transfer *xfer)
Функция осуществляющая передачу данных по UART, данные в буфер попадают через DMA канал

UART_TransferCreateHandleDMA
void UART_TransferCreateHandleDMA(UART_Type *base, uart_dma_handle_t *handle, uart_dma_transfer_callback_t callback, void *user_data, dma_handle_t *tx_dma_handle, dma_handle_t *rx_dma_handle)
Функция для инициализации полей дескриптора UART-DMA.

UART_TransferAbortReceiveDMA
void UART_TransferAbortReceiveDMA(UART_Type *base, uart_dma_handle_t *handle)
Функция прерывающая передачу данных между UART(RX) и DMA.

uart_dma_transfer_callback_t
void(* uart_dma_transfer_callback_t)(UART_Type *base, uart_dma_handle_t *handle, enum uart_status status, void *user_data)
Функция обратного вызова
Definition hal_uart_dma.h:27

uart_status
uart_status
Статусы драйвера UART.
Definition hal_uart.h:45

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

hal_uart.h
Интерфейс драйвера UART.

_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

_uart_dma_handle
Дескриптор UART-DMA передачи
Definition hal_uart_dma.h:35

_uart_dma_handle::rx_state
volatile uint8_t rx_state
Definition hal_uart_dma.h:50

_uart_dma_handle::rx_data_size_all
uint32_t rx_data_size_all
Definition hal_uart_dma.h:40

_uart_dma_handle::base
UART_Type * base
Definition hal_uart_dma.h:36

_uart_dma_handle::rx_dma_handle
dma_handle_t * rx_dma_handle
Definition hal_uart_dma.h:44

_uart_dma_handle::tx_dma_handle
dma_handle_t * tx_dma_handle
Definition hal_uart_dma.h:43

_uart_dma_handle::tx_data_size_all
uint32_t tx_data_size_all
Definition hal_uart_dma.h:41

_uart_dma_handle::user_data
void * user_data
Definition hal_uart_dma.h:39

_uart_dma_handle::tx_state
volatile uint8_t tx_state
Definition hal_uart_dma.h:49

_uart_dma_handle::callback
uart_dma_transfer_callback_t callback
Definition hal_uart_dma.h:38

uart_transfer
Указатель на буфер приема или передачи
Definition hal_uart.h:193