Paparazzi UAS  v5.15_devel-230-gc96ce27
Paparazzi is a free software Unmanned Aircraft System.
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Modules Pages
hal_stm32_dma.c File Reference

STM32 DMA subsystem driver header. More...

#include "hal_stm32_dma.h"
+ Include dependency graph for hal_stm32_dma.c:

Go to the source code of this file.

Functions

static void dma_lld_serve_interrupt (DMADriver *dmap, uint32_t flags)
 DMA ISR service routine. More...
 
void dmaObjectInit (DMADriver *dmap)
 
bool dmaStart (DMADriver *dmap, const DMAConfig *cfg)
 Configures and activates the DMA peripheral. More...
 
void dmaStop (DMADriver *dmap)
 Deactivates the DMA peripheral. More...
 
bool dmaStartTransfert (DMADriver *dmap, volatile void *periphp, void *mem0p, const size_t size)
 Starts a DMA transaction. More...
 
bool dmaStartTransfertI (DMADriver *dmap, volatile void *periphp, void *mem0p, const size_t size)
 Starts a DMA transaction. More...
 
void dmaStopTransfert (DMADriver *dmap)
 Stops an ongoing transaction. More...
 
void dmaStopTransfertI (DMADriver *dmap)
 Stops an ongoing transaction. More...
 
msg_t dmaTransfertTimeout (DMADriver *dmap, volatile void *periphp, void *mem0p, const size_t size, sysinterval_t timeout)
 Performs a DMA transaction. More...
 
void dmaAcquireBus (DMADriver *dmap)
 Gains exclusive access to the DMA peripheral. More...
 
void dmaReleaseBus (DMADriver *dmap)
 Releases exclusive access to the DMA peripheral. More...
 
bool dma_lld_start (DMADriver *dmap)
 Configures and activates the DMA peripheral. More...
 
bool dma_lld_start_transfert (DMADriver *dmap, volatile void *periphp, void *mem0p, const size_t size)
 Starts a DMA transaction. More...
 
void dma_lld_stop_transfert (DMADriver *dmap)
 Stops an ongoing transaction. More...
 
void dma_lld_stop (DMADriver *dmap)
 Deactivates the DMA peripheral. More...
 

Detailed Description

STM32 DMA subsystem driver header.

Author
Alexandre Bustico Gautier Hattenberger gauti.nosp@m.er.h.nosp@m.atten.nosp@m.berg.nosp@m.er@en.nosp@m.ac.f.nosp@m.r

Definition in file hal_stm32_dma.c.

Function Documentation

static void dma_lld_serve_interrupt ( DMADriver dmap,
uint32_t  flags 
)
static

DMA ISR service routine.

DMA DMA ISR service routine.

Parameters
[in]dmappointer to the DMADriver object
[in]flagspre-shifted content of the ISR register

Definition at line 704 of file hal_stm32_dma.c.

References _dma_isr_error_code(), _dma_isr_full_code(), _dma_isr_half_code(), DMA_ACTIVE, DMA_ERR_DIRECTMODE_ERROR, DMA_ERR_FIFO_ERROR, DMA_ERR_TRANSFER_ERROR, and DMADriver::state.

Referenced by dma_lld_start().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

bool dma_lld_start ( DMADriver dmap)
bool dma_lld_start_transfert ( DMADriver dmap,
volatile void *  periphp,
void *  mem0p,
const size_t  size 
)

Starts a DMA transaction.

Parameters
[in]dmappointer to the DMADriver object

Definition at line 656 of file hal_stm32_dma.c.

References DMADriver::dmamode, DMADriver::dmastream, DMADriver::mem0p, and DMADriver::size.

Referenced by dmaStartTransfertI().

+ Here is the caller graph for this function:

void dma_lld_stop ( DMADriver dmap)

Deactivates the DMA peripheral.

Parameters
[in]dmappointer to the DMADriver object

Definition at line 688 of file hal_stm32_dma.c.

References DMADriver::dmastream.

Referenced by dmaStop().

+ Here is the caller graph for this function:

void dma_lld_stop_transfert ( DMADriver dmap)

Stops an ongoing transaction.

Parameters
[in]dmappointer to the DMADriver object

Definition at line 676 of file hal_stm32_dma.c.

References DMADriver::dmastream.

Referenced by _dma_isr_error_code(), _dma_isr_full_code(), dmaStopTransfert(), and dmaStopTransfertI().

+ Here is the caller graph for this function:

void dmaAcquireBus ( DMADriver dmap)

Gains exclusive access to the DMA peripheral.

This function tries to gain ownership to the DMA bus, if the bus is already being used then the invoking thread is queued.

Precondition
In order to use this function the option DMA_USE_MUTUAL_EXCLUSION must be enabled.
Parameters
[in]dmappointer to the DMADriver object

Definition at line 332 of file hal_stm32_dma.c.

void dmaObjectInit ( DMADriver dmap)

Definition at line 53 of file hal_stm32_dma.c.

References DMADriver::config, DMA_STOP, DMADriver::mem0p, and DMADriver::state.

Referenced by dshotStart(), and light_ws2812_arch_init().

+ Here is the caller graph for this function:

void dmaReleaseBus ( DMADriver dmap)

Releases exclusive access to the DMA peripheral.

Precondition
In order to use this function the option DMA_USE_MUTUAL_EXCLUSION must be enabled.
Parameters
[in]dmappointer to the DMADriver object

Definition at line 349 of file hal_stm32_dma.c.

bool dmaStart ( DMADriver dmap,
const DMAConfig cfg 
)

Configures and activates the DMA peripheral.

Parameters
[in]dmappointer to the DMADriver object
[in]configpointer to the DMAConfig object.
Returns
The operation result.
Return values
truedma driver is OK
falseincoherencies has been found in config

Definition at line 85 of file hal_stm32_dma.c.

References DMADriver::config, dma_lld_start(), DMA_READY, DMA_STOP, and DMADriver::state.

Referenced by dshotStart(), and light_ws2812_arch_init().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

bool dmaStartTransfert ( DMADriver dmap,
volatile void *  periphp,
void *  mem0p,
const size_t  size 
)

Starts a DMA transaction.

Starts one or many asynchronous dma transaction(s) depending on continuous field

Postcondition
The callbacks associated to the DMA config will be invoked on buffer fill and error events, and timeout events in case STM32_DMA_USE_ASYNC_TIMOUT == TRUE
Note
The datas are sequentially written into the buffer with no gaps.
Parameters
[in]dmappointer to the DMADriver object
[in,out]periphppointer to a peripheral register address
[in,out]mem0ppointer to the data buffer
[in]sizebuffer size. The buffer size must be one or an even number.

Definition at line 142 of file hal_stm32_dma.c.

References dmaStartTransfertI().

Referenced by dshotSendFrame(), and light_ws2812_arch_init().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

bool dmaStartTransfertI ( DMADriver dmap,
volatile void *  periphp,
void *  mem0p,
const size_t  size 
)

Starts a DMA transaction.

Starts one or many asynchronous dma transaction(s) depending on continuous field

Postcondition
The callbacks associated to the DMA config will be invoked on buffer fill and error events, and timeout events in case STM32_DMA_USE_ASYNC_TIMOUT == TRUE
Note
The datas are sequentially written into the buffer with no gaps.
Parameters
[in]dmappointer to the DMADriver object
[in,out]periphppointer to a peripheral register address
[in,out]mem0ppointer to the data buffer
[in]sizebuffer size. The buffer size must be one or an even number.

Definition at line 167 of file hal_stm32_dma.c.

References DMADriver::config, DMA_ACTIVE, DMA_COMPLETE, DMA_ERROR, dma_lld_start_transfert(), DMA_READY, DMAConfig::msize, DMAConfig::psize, and DMADriver::state.

Referenced by dmaStartTransfert(), and dmaTransfertTimeout().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

void dmaStop ( DMADriver dmap)

Deactivates the DMA peripheral.

Parameters
[in]dmappointer to the DMADriver object

Definition at line 107 of file hal_stm32_dma.c.

References DMADriver::config, dma_lld_stop(), DMA_READY, DMA_STOP, DMADriver::mem0p, and DMADriver::state.

+ Here is the call graph for this function:

void dmaStopTransfert ( DMADriver dmap)

Stops an ongoing transaction.

This function stops the currently ongoing transaction and returns the driver in the DMA_READY state. If there was no transaction being processed then the function does nothing.

Parameters
[in]dmappointer to the DMADriver object

Definition at line 232 of file hal_stm32_dma.c.

References _dma_reset_s, DMA_ACTIVE, dma_lld_stop_transfert(), DMA_READY, and DMADriver::state.

+ Here is the call graph for this function:

void dmaStopTransfertI ( DMADriver dmap)

Stops an ongoing transaction.

This function stops the currently ongoing transaction and returns the driver in the DMA_READY state. If there was no transaction being processed then the function does nothing.

Parameters
[in]dmappointer to the DMADriver object

Definition at line 260 of file hal_stm32_dma.c.

References _dma_reset_i, DMA_ACTIVE, DMA_COMPLETE, dma_lld_stop_transfert(), DMA_READY, and DMADriver::state.

Referenced by dmaTransfertTimeout().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

msg_t dmaTransfertTimeout ( DMADriver dmap,
volatile void *  periphp,
void *  mem0p,
const size_t  size,
sysinterval_t  timeout 
)

Performs a DMA transaction.

Performs one synchronous dma transaction

Note
The datas are sequentially written into the buffer with no gaps.
Parameters
[in]dmappointer to the DMADriver object
[in,out]periphppointer to a peripheral register address
[in,out]mem0ppointer to the data buffer
[in]sizebuffer size. The buffer size must be one or an even number.
[in]timeoutfunction will exit after timeout is transaction is not done can be TIME_INFINITE (but not TIME_IMMEDIATE)
Returns
The operation result.
Return values
MSG_OKTransaction finished.
MSG_RESETThe transaction has been stopped using dmaStopTransaction() or dmaStopTransactionI(), the result buffer may contain incorrect data.
MSG_TIMEOUTThe transaction has been stopped because of hardware error or timeout limit reach

Definition at line 303 of file hal_stm32_dma.c.

References dmaStartTransfertI(), dmaStopTransfertI(), and msg.

Referenced by dmaTransfert().

+ Here is the call graph for this function:

+ Here is the caller graph for this function: