Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

misc: mic: Add mic bus and dma driver documentation

Added an overview of mic bus and dma driver.

Reviewed-by: Ashutosh Dixit <ashutosh.dixit@intel.com>
Reviewed-by: Nikhil Rao <nikhil.rao@intel.com>
Reviewed-by: Sudeep Dutt <sudeep.dutt@intel.com>
Signed-off-by: Siva Yerramreddy <yshivakrishna@gmail.com>
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>

authored by

Siva Yerramreddy and committed by
Greg Kroah-Hartman
a8035843 ddddda9b

+41 -26
+41 -26
Documentation/mic/mic_overview.txt
··· 17 17 the standard virtio framework for network, disk and console devices, 18 18 though in our case the virtio framework is used across a PCIe bus. 19 19 20 + MIC PCIe card has a dma controller with 8 channels. These channels are 21 + shared between the host s/w and the card s/w. 0 to 3 are used by host 22 + and 4 to 7 by card. As the dma device doesn't show up as PCIe device, 23 + a virtual bus called mic bus is created and virtual dma devices are 24 + created on it by the host/card drivers. On host the channels are private 25 + and used only by the host driver to transfer data for the virtio devices. 26 + 20 27 Here is a block diagram of the various components described above. The 21 28 virtio backends are situated on the host rather than the card given better 22 29 single threaded performance for the host compared to MIC, the ability of 23 30 the host to initiate DMA's to/from the card using the MIC DMA engine and 24 31 the fact that the virtio block storage backend can only be on the host. 25 32 26 - | 27 - +----------+ | +----------+ 28 - | Card OS | | | Host OS | 29 - +----------+ | +----------+ 30 - | 31 - +-------+ +--------+ +------+ | +---------+ +--------+ +--------+ 32 - | Virtio| |Virtio | |Virtio| | |Virtio | |Virtio | |Virtio | 33 - | Net | |Console | |Block | | |Net | |Console | |Block | 34 - | Driver| |Driver | |Driver| | |backend | |backend | |backend | 35 - +-------+ +--------+ +------+ | +---------+ +--------+ +--------+ 36 - | | | | | | | 37 - | | | |User | | | 38 - | | | |------|------------|---------|------- 39 - +-------------------+ |Kernel +--------------------------+ 40 - | | | Virtio over PCIe IOCTLs | 41 - | | +--------------------------+ 42 - +--------------+ | | 43 - |Intel MIC | | +---------------+ 44 - |Card Driver | | |Intel MIC | 45 - +--------------+ | |Host Driver | 46 - | | +---------------+ 47 - | | | 48 - +-------------------------------------------------------------+ 49 - | | 50 - | PCIe Bus | 51 - +-------------------------------------------------------------+ 33 + | 34 + +----------+ | +----------+ 35 + | Card OS | | | Host OS | 36 + +----------+ | +----------+ 37 + | 38 + +-------+ +--------+ +------+ | +---------+ +--------+ +--------+ 39 + | Virtio| |Virtio | |Virtio| | |Virtio | |Virtio | |Virtio | 40 + | Net | |Console | |Block | | |Net | |Console | |Block | 41 + | Driver| |Driver | |Driver| | |backend | |backend | |backend | 42 + +-------+ +--------+ +------+ | +---------+ +--------+ +--------+ 43 + | | | | | | | 44 + | | | |User | | | 45 + | | | |------|------------|---------|------- 46 + +-------------------+ |Kernel +--------------------------+ 47 + | | | Virtio over PCIe IOCTLs | 48 + | | +--------------------------+ 49 + +-----------+ | | | +-----------+ 50 + | MIC DMA | | | | | MIC DMA | 51 + | Driver | | | | | Driver | 52 + +-----------+ | | | +-----------+ 53 + | | | | | 54 + +---------------+ | | | +----------------+ 55 + |MIC virtual Bus| | | | |MIC virtual Bus | 56 + +---------------+ | | | +----------------+ 57 + | | | | | 58 + | +--------------+ | +---------------+ | 59 + | |Intel MIC | | |Intel MIC | | 60 + +---|Card Driver | | |Host Driver | | 61 + +--------------+ | +---------------+-----+ 62 + | | | 63 + +-------------------------------------------------------------+ 64 + | | 65 + | PCIe Bus | 66 + +-------------------------------------------------------------+