dma.c File Reference

DMA mappings. More...

#include <assert.h>
#include <errno.h>
#include <ipxe/dma.h>

Go to the source code of this file.

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
	PROVIDE_DMAAPI_INLINE (flat, dma_map)
	PROVIDE_DMAAPI_INLINE (flat, dma_unmap)
	PROVIDE_DMAAPI_INLINE (flat, dma_alloc)
	PROVIDE_DMAAPI_INLINE (flat, dma_free)
	PROVIDE_DMAAPI_INLINE (flat, dma_umalloc)
	PROVIDE_DMAAPI_INLINE (flat, dma_ufree)
	PROVIDE_DMAAPI_INLINE (flat, dma_set_mask)
	PROVIDE_DMAAPI_INLINE (flat, dma_phys)
static int	dma_op_map (struct dma_device *dma, struct dma_mapping *map, physaddr_t addr, size_t len, int flags)
	Map buffer for DMA. More...
static void	dma_op_unmap (struct dma_mapping *map)
	Unmap buffer. More...
static void *	dma_op_alloc (struct dma_device *dma, struct dma_mapping *map, size_t len, size_t align)
	Allocate and map DMA-coherent buffer. More...
static void	dma_op_free (struct dma_mapping *map, void *addr, size_t len)
	Unmap and free DMA-coherent buffer. More...
static userptr_t	dma_op_umalloc (struct dma_device *dma, struct dma_mapping *map, size_t len, size_t align)
	Allocate and map DMA-coherent buffer from external (user) memory. More...
static void	dma_op_ufree (struct dma_mapping *map, userptr_t addr, size_t len)
	Unmap and free DMA-coherent buffer from external (user) memory. More...
static void	dma_op_set_mask (struct dma_device *dma, physaddr_t mask)
	Set addressable space mask. More...
	PROVIDE_DMAAPI (op, dma_map, dma_op_map)
	PROVIDE_DMAAPI (op, dma_unmap, dma_op_unmap)
	PROVIDE_DMAAPI (op, dma_alloc, dma_op_alloc)
	PROVIDE_DMAAPI (op, dma_free, dma_op_free)
	PROVIDE_DMAAPI (op, dma_umalloc, dma_op_umalloc)
	PROVIDE_DMAAPI (op, dma_ufree, dma_op_ufree)
	PROVIDE_DMAAPI (op, dma_set_mask, dma_op_set_mask)
	PROVIDE_DMAAPI_INLINE (op, dma_phys)

Detailed Description

DMA mappings.

Definition in file dma.c.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

PROVIDE_DMAAPI_INLINE() [1/9]

PROVIDE_DMAAPI_INLINE	(	flat	,
		dma_map
	)

PROVIDE_DMAAPI_INLINE() [2/9]

PROVIDE_DMAAPI_INLINE	(	flat	,
		dma_unmap
	)

PROVIDE_DMAAPI_INLINE() [3/9]

PROVIDE_DMAAPI_INLINE	(	flat	,
		dma_alloc
	)

PROVIDE_DMAAPI_INLINE() [4/9]

PROVIDE_DMAAPI_INLINE	(	flat	,
		dma_free
	)

PROVIDE_DMAAPI_INLINE() [5/9]

PROVIDE_DMAAPI_INLINE	(	flat	,
		dma_umalloc
	)

PROVIDE_DMAAPI_INLINE() [6/9]

PROVIDE_DMAAPI_INLINE	(	flat	,
		dma_ufree
	)

PROVIDE_DMAAPI_INLINE() [7/9]

PROVIDE_DMAAPI_INLINE	(	flat	,
		dma_set_mask
	)

PROVIDE_DMAAPI_INLINE() [8/9]

PROVIDE_DMAAPI_INLINE	(	flat	,
		dma_phys
	)

dma_op_map()

static int dma_op_map ( struct dma_device *  dma, struct dma_mapping *  map, physaddr_t  addr, size_t  len, int  flags  )

static

Map buffer for DMA.

Parameters

dma	DMA device
map	DMA mapping to fill in
addr	Buffer address
len	Length of buffer
flags	Mapping flags

Return values

rc	Return status code

Definition at line 69 of file dma.c.

                                                                 {
        struct dma_operations *op = dma->op;

        if ( ! op )
                return -ENODEV;
        return op->map ( dma, map, addr, len, flags );
}

References addr, dma(), ENODEV, flags, len, map, and op.

dma_op_unmap()

static void dma_op_unmap ( struct dma_mapping *  map )

static

Unmap buffer.

Parameters

map	DMA mapping

Definition at line 83 of file dma.c.

                                                     {
        struct dma_device *dma = map->dma;

        assert ( dma != NULL );
        assert ( dma->op != NULL );
        dma->op->unmap ( dma, map );
}

References assert(), dma_mapping::dma, dma(), map, and NULL.

dma_op_alloc()

static void* dma_op_alloc ( struct dma_device *  dma, struct dma_mapping *  map, size_t  len, size_t  align  )

static

Allocate and map DMA-coherent buffer.

Parameters

dma	DMA device
map	DMA mapping to fill in
len	Length of buffer
align	Physical alignment

Return values

addr	Buffer address, or NULL on error

Definition at line 100 of file dma.c.

                                                        {
        struct dma_operations *op = dma->op;

        if ( ! op )
                return NULL;
        return op->alloc ( dma, map, len, align );
}

References align, dma(), len, map, NULL, and op.

dma_op_free()

static void dma_op_free ( struct dma_mapping *  map, void *  addr, size_t  len  )

static

Unmap and free DMA-coherent buffer.

Parameters

map	DMA mapping
addr	Buffer address
len	Length of buffer

Definition at line 116 of file dma.c.

                                                                            {
        struct dma_device *dma = map->dma;

        assert ( dma != NULL );
        assert ( dma->op != NULL );
        dma->op->free ( dma, map, addr, len );
}

References addr, assert(), dma_mapping::dma, dma(), len, map, and NULL.

dma_op_umalloc()

static userptr_t dma_op_umalloc ( struct dma_device *  dma, struct dma_mapping *  map, size_t  len, size_t  align  )

static

Allocate and map DMA-coherent buffer from external (user) memory.

Parameters

dma	DMA device
map	DMA mapping to fill in
len	Length of buffer
align	Physical alignment

Return values

addr	Buffer address, or NULL on error

Definition at line 133 of file dma.c.

                                                             {
        struct dma_operations *op = dma->op;

        if ( ! op )
                return UNULL;
        return op->umalloc ( dma, map, len, align );
}

References align, dma(), len, map, op, and UNULL.

dma_op_ufree()

static void dma_op_ufree ( struct dma_mapping *  map, userptr_t  addr, size_t  len  )

static

Unmap and free DMA-coherent buffer from external (user) memory.

Parameters

map	DMA mapping
addr	Buffer address
len	Length of buffer

Definition at line 150 of file dma.c.

                                        {
        struct dma_device *dma = map->dma;

        assert ( dma != NULL );
        assert ( dma->op != NULL );
        dma->op->ufree ( dma, map, addr, len );
}

References addr, assert(), dma_mapping::dma, dma(), len, map, and NULL.

dma_op_set_mask()

static void dma_op_set_mask ( struct dma_device *  dma, physaddr_t  mask  )

static

Set addressable space mask.

Parameters

dma	DMA device
mask	Addressable space mask

Definition at line 165 of file dma.c.

                                                                        {
        struct dma_operations *op = dma->op;

        if ( op )
                op->set_mask ( dma, mask );
}

References dma(), and op.

PROVIDE_DMAAPI() [1/7]

PROVIDE_DMAAPI	(	op	,
		dma_map	,
		dma_op_map
	)

PROVIDE_DMAAPI() [2/7]

PROVIDE_DMAAPI	(	op	,
		dma_unmap	,
		dma_op_unmap
	)

PROVIDE_DMAAPI() [3/7]

PROVIDE_DMAAPI	(	op	,
		dma_alloc	,
		dma_op_alloc
	)

PROVIDE_DMAAPI() [4/7]

PROVIDE_DMAAPI	(	op	,
		dma_free	,
		dma_op_free
	)

PROVIDE_DMAAPI() [5/7]

PROVIDE_DMAAPI	(	op	,
		dma_umalloc	,
		dma_op_umalloc
	)

PROVIDE_DMAAPI() [6/7]

PROVIDE_DMAAPI	(	op	,
		dma_ufree	,
		dma_op_ufree
	)

PROVIDE_DMAAPI() [7/7]

PROVIDE_DMAAPI	(	op	,
		dma_set_mask	,
		dma_op_set_mask
	)

PROVIDE_DMAAPI_INLINE() [9/9]

PROVIDE_DMAAPI_INLINE	(	op	,
		dma_phys
	)