GIET-VM / DMA Driver

The dma_driver.c​ and dma_driver.h​ files define the DMA driver.

This vci_multi_dma component is a multi-channels DMA controller, that can be replicated in all clusters (internal peripheral).

There is (NB_CLUSTERS * NB_DMA_CHANNELS) channels, indexed by a global index:

dma_id = cluster_xy * NB_DMA_CHANNELS + local_index

It is exclusively used by the kernel to speedup data transfers. As the kernel uses a polling policy on the DMA_STATUS register to detect transfer completion, the DMA IRQ is not used.

The virtual base address of the segment associated to a channel is:

vbase = SEG_DMA_BASE + cluster_xy * PERI_CLUSTER_INCREMENT + DMA_SPAN * local_index

The SEG_DMA_BASE virtual address and PERI_CLUSTER_INCREMENT values must be defined in the hard_config.h file.

The addressable registers map, and the status possible values are defined here​.

Low level access functions

void _dma_disable_irq( unsigned int cluster_xy, unsigned int channel_id )

This function disables interrupts for one DMA channel in one cluster. In case of error (illegal DMA channel), an error message is displayed on TTY0, and system crash.

void _dma_reset_channel( unsigned int cluster_xy, unsigned int channel_id )

This function re-initialises one DMA channel in one cluster after transfer completion. It actually forces the channel to return in IDLE state. In case of error (illegal DMA channel), an error message is displayed on TTY0, and system crash.

void _dma_get_status( unsigned int cluster_xy, unsigned int channel_id , unsigned int * status );

This function returns the status of a DMA channel in a given cluster. In case of error (illegal DMA channel), an error message is displayed on TTY0, and system crash.

void _dma_start_transfer( unsigned int cluster_xy, unsigned int channel_id, unsigned long long dst_paddr, unsigned long long src_paddr, unsigned int size )

This function sets the physical address (including 64 bits extension) of the source and destination buffers for a DMA channel in a given cluster, and sets the transfer size to lauch the transfer. In case of error (illegal DMA channel), an error message is displayed on TTY0, and system crash.

High level access functions

void _dma_copy( unsigned int cluster_xy, unsigned int channel_id, unsigned int dst_vaddr, unsigned int src_vaddr, unsigned int size )

This function copies a source memory buffer to a destination memory buffer, using virtual addresses. This requires a virtual to physical address translation for both addresses. The source and destination buffers base addresses must be word aligned, and the buffer's size must be multiple of 4. In case of error (buffer unmapped, unaligned, or DMA_STATUS error), an error message is displayed on TTY0, and system crash.

void _dma_physical_copy( unsigned int cluster_xy, unsigned int channel_id, unsigned long long dst_paddr, unsigned long long src_paddr, unsigned int size )

This function copies a source memory buffer to a destination memory buffer, using physical addresses. This blocking function is supposed to be used by the kernel only, and uses a polling policy on DMA_STATUS register to detect completion. Therefore, the DMA_IRQ is NOT used. The source and destination buffers base addresses must be word aligned, and the buffer's size must be multiple of 4. In case of error (buffer unmapped, unaligned, or DMA_STATUS error), an error message is displayed on TTY0, and system crash.

void _dma_isr( unsigned int irq_type, unsigned int irq_id, unsigned int channel )

This Interrupt Service Routine is not implemented yet, because the DMA is only used by the kernel in the boot phase, with a polling strategy.