stm32_dma.c File Reference

Implementation of stm32 DMA functionality. More...

#include "stm32_dma.h"
#include "no_os_error.h"
#include "no_os_alloc.h"
#include "stm32_irq.h"

Include dependency graph for stm32_dma.c:

Functions
int	stm32_dma_config_xfer (struct no_os_dma_ch *channel, struct no_os_dma_xfer_desc *xfer)
	Configure a DMA channel for a transfer. More...
int	stm32_dma_init (struct no_os_dma_desc **desc, const struct no_os_dma_init_param *param)
	Initialize a DMA controller. More...
int	stm32_dma_xfer_start (struct no_os_dma_desc *desc, struct no_os_dma_ch *chan)
	Start a DMA transfer for a specific channel . More...
int	stm32_dma_xfer_abort (struct no_os_dma_desc *desc, struct no_os_dma_ch *chan)
	Disable a DMA channel. More...
int	stm32_dma_remove (struct no_os_dma_desc *desc)
	Free the resources allocated for a DMA descriptor. More...

Variables
const struct no_os_dma_platform_ops	stm32_dma_ops
	stm32 platform specific DMA platform ops structure More...

Detailed Description

Implementation of stm32 DMA functionality.

Author

Janani Sunil (janan.nosp@m.i.su.nosp@m.nil@a.nosp@m.nalo.nosp@m.g.com)

Copyright 2024(c) Analog Devices, Inc.

All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

• Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
• Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
• Neither the name of Analog Devices, Inc. nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
• The use of this software may or may not infringe the patent rights of one or more patent holders. This license does not release you from the requirement that you obtain separate licenses from these patent holders to use this software.
• Use of the software either in source or binary form, must be run on or directly connected to an Analog Devices Inc. component.

THIS SOFTWARE IS PROVIDED BY ANALOG DEVICES "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, NON-INFRINGEMENT, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL ANALOG DEVICES BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, INTELLECTUAL PROPERTY RIGHTS, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Function Documentation

stm32_dma_config_xfer()

int stm32_dma_config_xfer	(	struct no_os_dma_ch *	channel,
		struct no_os_dma_xfer_desc *	xfer
	)

Configure a DMA channel for a transfer.

Parameters

channel	- The DMA channel descriptor.
xfer	- Descriptor for the transfer.

Returns

0 in case of success, negative error codes otherwise

stm32_dma_init()

int stm32_dma_init	(	struct no_os_dma_desc **	desc,
		const struct no_os_dma_init_param *	param
	)

Initialize a DMA controller.

Parameters

desc	- Descriptor to be initialized.
param	- Initialization parameter for the decriptor.

Returns

0 in case of success -ENOMEM if there is not enough free memory

stm32_dma_remove()

int stm32_dma_remove

(

struct no_os_dma_desc *

desc

)

Free the resources allocated for a DMA descriptor.

Parameters

desc	- Descriptor to be freed.

Returns

0 in case of success, negative error code otherwise

stm32_dma_xfer_abort()

int stm32_dma_xfer_abort	(	struct no_os_dma_desc *	desc,
		struct no_os_dma_ch *	chan
	)

Disable a DMA channel.

Parameters

desc	- Descriptor for the DMA controller.
chan	- The DMA Channel

Returns

0 in case of success, negative error codes otherwise

stm32_dma_xfer_start()

int stm32_dma_xfer_start	(	struct no_os_dma_desc *	desc,
		struct no_os_dma_ch *	chan
	)

Start a DMA transfer for a specific channel .

Parameters

desc	- Descriptor for the DMA controller.
chan	- The DMA Channel

Returns

0 in case of success, negative error codes otherwise

Variable Documentation

stm32_dma_ops

const struct no_os_dma_platform_ops stm32_dma_ops

Initial value:

= {
    .dma_init = stm32_dma_init,
    .dma_config_xfer = stm32_dma_config_xfer,
    .dma_xfer_start = stm32_dma_xfer_start,
    .dma_xfer_abort = stm32_dma_xfer_abort,
    .dma_remove = stm32_dma_remove
}

stm32 platform specific DMA platform ops structure