2026ef2c36
To prepare for STM32F2/F4 DMA support, introduce a new libmaple DMA API, and move some code around to make priority level and interrupt handling more generic. The new API is based on a new set of types (dma_tube, struct dma_tube_reg_map, enum dma_request_src, enum dma_cfg_flags, and struct dma_tube_config). The central abstraction is the dma_tube type. STM32F2/F4 use DMA streams to control dataflow, and STM32F1 uses channels. dma_tube stands for whichever is appropriate for the current target. Dealing with tubes allows for configuring and using DMA with opaque tube values in the same source, instead of (as with ST's firmware) requiring two separate codebases. The new API is also more user-friendly, as it doesn't require knowing which DMA address registers to set and which configuration register flags go along with them. It now suffices to specify the source and destination for the DMA transfer, along with their sizes. This avoids confusion (e.g. for memory-to-memory transfers, data flows from the peripheral address register to the memory register, which might be surprising on F2, which has two memory address registers). The old API (based on enum dma_mode_flags and dma_setup_transfer()) is still available on F1, but deprecate it. Signed-off-by: Marti Bolivar <mbolivar@leaflabs.com>
62 lines
2 KiB
C
62 lines
2 KiB
C
/******************************************************************************
|
|
* The MIT License
|
|
*
|
|
* Copyright (c) 2012 LeafLabs, LLC.
|
|
*
|
|
* Permission is hereby granted, free of charge, to any person
|
|
* obtaining a copy of this software and associated documentation
|
|
* files (the "Software"), to deal in the Software without
|
|
* restriction, including without limitation the rights to use, copy,
|
|
* modify, merge, publish, distribute, sublicense, and/or sell copies
|
|
* of the Software, and to permit persons to whom the Software is
|
|
* furnished to do so, subject to the following conditions:
|
|
*
|
|
* The above copyright notice and this permission notice shall be
|
|
* included in all copies or substantial portions of the Software.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
|
* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
|
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
|
|
* NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
|
|
* BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
|
|
* ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
|
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
* SOFTWARE.
|
|
*****************************************************************************/
|
|
|
|
#ifndef _LIBMAPLE_DMA_PRIVATE_H_
|
|
#define _LIBMAPLE_DMA_PRIVATE_H_
|
|
|
|
#include <libmaple/dma.h>
|
|
#include <libmaple/libmaple_types.h>
|
|
|
|
/*
|
|
* IRQ handling
|
|
*/
|
|
|
|
/* Wrap this in an ifdef to shut up GCC. (We provide DMA_GET_HANDLER
|
|
* in the series support files, which need dma_irq_handler().) */
|
|
#ifdef DMA_GET_HANDLER
|
|
static __always_inline void dma_irq_handler(dma_dev *dev, dma_tube tube) {
|
|
void (*handler)(void) = DMA_GET_HANDLER(dev, tube);
|
|
if (handler) {
|
|
handler();
|
|
dma_clear_isr_bits(dev, tube); /* in case handler doesn't */
|
|
}
|
|
}
|
|
#endif
|
|
|
|
/*
|
|
* Conveniences for dealing with tube sources/destinations
|
|
*/
|
|
|
|
enum dma_atype {
|
|
DMA_ATYPE_MEM,
|
|
DMA_ATYPE_PER,
|
|
DMA_ATYPE_OTHER,
|
|
};
|
|
|
|
enum dma_atype _dma_addr_type(__io void *addr);
|
|
|
|
#endif
|