DMA Local Copy

This sample illustrates how to locally copy memory with DMA from one buffer to another on the DPU.

This sample should be run on the DPU.

The sample logic includes:

Locates the DOCA device.
Initializes the necessary DOCA core structures.
Populates the DOCA memory map with two relevant buffers.
Allocates an element in the DOCA buffer inventory for each buffer.
Initializes the DOCA DMA memory copy task object.
Submits the DMA task.
Handles task completion once it is done.
Checks the task result.
Destroys all DMA and DOCA core structures.

References

dma_local_copy_sample.c
dma_local_copy_main.c
meson.build

DMA Copy Host

Note: This sample should be run first. It is user responsibility to transfer the two configuration files (descriptor and buffer) to the DPU and provide their path to the DMA Copy DPU sample.

This sample illustrates how to allow memory copy with DMA from the x86 host into the DPU.

This sample should be run on the host.

The sample logic includes

Locates the DOCA device.
Initializes the necessary DOCA core structures.
Populates the DOCA memory map with the source buffer.
Exports the memory map.
Saves the export descriptor and local DMA buffer information into files. These files should be transferred to the DPU before running the DPU sample.
Waits until the DPU DMA sample has finished.
Destroys all DMA and DOCA core structures.

References

dma_copy_host_sample.c
dma_copy_host_main.c
meson.build

DMA Copy DPU

Note: This sample should be run only after the DMA Copy Host sample has been run and the required configuration files (descriptor and buffer) have been copied to the DPU.

This sample illustrates how to copy memory (containing user-defined text) with DMA from the x86 host into the DPU.

This sample should be executed on the DPU.

The sample logic includes

Locates the DOCA device.
Initializes the necessary DOCA core structures.
Reads configuration files and saves their content into local buffers.
Allocates the local destination buffer in which the host text will be saved.
Populates the DOCA memory map with the destination buffer.
Creates the remote memory map using the export descriptor file.
Creates a memory map to the remote buffer.
Allocates an element in the DOCA buffer inventory for each buffer.
Initializes the DOCA DMA memory copy task object.
Submits the DMA task.
Handles task completion once it is done.
Checks the DMA task result.
If the DMA task ends successfully, prints the text that has been copied to the log.
Prints a log message indicating that the host-side sample can be closed.
Destroys all DMA and DOCA core structures.

References

dma_copy_dpu_sample.c
dma_copy_dpu_main.c
meson.build