1.. SPDX-License-Identifier: BSD-3-Clause 2 Copyright 2024 ZTE Corporation 3 4GDTC Rawdev Driver 5================== 6 7The ``gdtc`` rawdev driver is an implementation of the rawdev API, 8that provides communication between two separate hosts. 9This is achieved via using the GDMA controller of Dinghai SoC, 10which can be configured through exposed MPF device. 11 12Device Setup 13------------ 14 15Using the GDTC PMD driver does not require the MPF device 16to bind additional user-space IO driver. 17 18Before performing actual data transmission, 19it is necessary to call ``rte_rawdev_queue_setup()`` 20to obtain an available queue ID. 21 22For data transfer, utilize the standard ``rte_rawdev_enqueue_buffers()`` API. 23The data transfer status can be queried via ``rte_rawdev_dequeue_buffers()``, 24which will return the number of successfully transferred data items. 25 26Initialization 27-------------- 28 29The ``gdtc`` rawdev driver needs to work in IOVA PA mode. 30Consider using ``--iova-mode=pa`` in the EAL options. 31 32Platform Requirement 33~~~~~~~~~~~~~~~~~~~~ 34 35This PMD is only supported on ZTE Neo Platforms: 36- Neo X510/X512 37