Copyright (c) 2014-2017 Advanced Micro Devices, Inc. All rights reserved.
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWAREGIM (GPU-IOV Module) is a Linux kernel module for AMD SR-IOV based HW Virtualization (MxGPU) product. It can support KVM, open source Xen and any other Linux kernel based hypervisors with necessary kernel compatibility modification. GIM is reponsible for but not limits to: GPU IOV initialization, virtual function configuration and enablement, GPU scheduling for world switch, hung detection and virtual function level reset (FLR), PF/VF hand shake and other GPU utilities.
Currently only AMD S7150 series are supported.
All documents are listed in SRC_ROOT/docs
- The tested host OS for GIM is Ubuntu16.04.2. All other hypervisor SW(KVM, XEN, QEMU, LIBVIRT) versions are aligned with default version of OS.
GIM supports KVM in Ubuntu16.04, and supports XEN in CentOS7.3.
| Host OS | Kernel | KVM/Xen | QEMU | libvirt |
|---|---|---|---|---|
| Ubuntu 16.04.2 server | 4.4.0-75-generic | KVM 4.4 | 2.5.0 | 1.3.1 |
- The tested guest OS
| Guest OS | Distributions |
|---|---|
| Linux | Ubuntu16.04 LTS 64bit; CentOS7.3 64 bit |
| Windows | Win7 64bit; Win10 TH2 64bit |
- The patches for Linux host OS For some legacy Linux kernels, there are some issues to enable pci sriov. Take Ubuntu 4.4.0-75-generic kernel, there is a patch for iov module under SRC_ROOT/patch.
All driver source codes are under SRC_ROOT/drv.
- Typing command "make" in terminal under SRC_ROOT/drv can generate gim.ko.
- Typing command "make install" in terminal under SRC_ROOT/drv can install gim.ko to /lib/modules/$(KERNELRELEASE)/GIM/.
- Generally, Just run helper SRC_ROOT/gim.sh in a command terminal also can completed build and installation. And gim.sh -help can display usages.
- Typing command "modprobe gim " in terminal can load gim driver
- Usually, Typing command "lsmod | grep gim " and "lspci | grep AMD" in terminal can help to check if gim driver is loaded
Read this section carefully. New configuration options would be added in each release, and odd problems will turn up if the configuration files are not set up as expected.
-
Alternative configuration commands are
CONFIG_GIM_HEARTBEAT_TIMER Heartbeat timer provides a useful way to display statistics of GIM periodically for debug purpose. Currently, it only counts the number of scheduler timer ticks and world switches, if the configuration is defined. -
Edit configuraiton in Makefile
GIM is a external kernel driver module. The driver configuration is different from upstream kernel driver. Now, Edit "KBUILD_CFLAGS" in Makefile is preferred to pass the configuraiton to GIM codes.
- 1.0 (2017/07/20) The original release support AMD S7150 series.