Skip to content
This repository contains binary images for AMD's HSA Linux kernel driver - amdkfd http://devgurus.amd.com/community/hsa
C Assembly C++ Makefile Objective-C Perl Other
Find file

README.md

AMD Heterogenous System Architecture (HSA) - Linux amdkfd v1.6.1 release for Kaveri & Carrizo

Installation and Configuration guide

What's New in kfd v1.6.1

  • Fix BUG when faulting a PROT_NONE VMA

What's New in kfd v1.6

  • Fix debug unregister procedure on process termination
  • Change the unmap latency and queue preempt timeout
  • Minor fix in libhsathunk for KFDMemory test
  • Fix mutex acquisition order under HSADebug
  • Fixes for process termination and cleanup
    • Better handling of Ctrl-C for long running kernels
  • Enabled per-process CU masking
  • Enable segfault for GPU accesses to unmapped ATC memory
  • Add flat scratch support for Carrizo
  • Pre-built Fedora 21 builds currently unavailble for this release
Known issues in this release
  • GPU reset on Kaveri can cause system hangs
    • Disable GPU reset through the linux boot string parameter radeon.lockup_timeout=0
    • If needed, corresponding parameter for Carrizo is amdgpu.lockup_timeout=0
  • Individual wavefronts (not kernels) which execute for >4s may fail

What's New in kfd v1.4

  • Based on kernel 4.0.0
  • Add support for Carrizo APU
  • Uses new AMD's kernel graphic driver, amdgpu, for Carrizo
  • Supports Ubuntu 14.04 and Fedora 21

What's New in kfd v1.2

  • Based on kernel 3.19.0
  • Improved Kaveri microcode
  • Various bug fixes
  • Supports Ubuntu 14.04 and Fedora 21
Known issues in this release
  • SDMA queues are not working

What's New in kfd v1.0

  • Based on newer kernel 3.17.2
  • Based on amdkfd code, which is expected to be part of Linux kernel 3.19
  • Added two new kernel module parameters:
    • Number of HSA processes - default is 32 and maximum is 512
    • Number of queues per HSA process - default is 128 and maximum is 1024
  • Improved Kaveri microcode
  • Various bug fixes
  • Supports Ubuntu 14.04 and Fedora 21

What's New in kfd v0.9

  • Driver now supports over-subscription of queues and processes. This means that each HSA application can open up to 1024 queues, and there can be up to 512 HSA applications simultaneously, compared to a total of 23 queues and 8 HSA processes in previous versions.
  • Better support for H/W debug
  • New Kaveri microcode which supports AQL queues
  • Various bug fixes
  • Supports Ubuntu 14.04 and Fedora 21 (with older kernel)

What's New in kfd v0.8

  • Based on kernel 3.14.11
  • Supports HSA signals (kfd events)
  • Enable allocating memory from GPU local memory for HSA apps
  • Supports Graphics interop (sharing objects between graphic apps and HSA apps)
  • Supports SDMA queues
  • Supports AQL queue creation
  • Add H/W debug support
  • Various bug fixes
  • Supports Ubuntu 14.04 and Fedora 21 (with older kernel)

What's New in kfd v0.6.1

  • Based on kernel 3.14.4
  • Various bug fixes
  • Supports Ubuntu 14.04 and Fedora 21

What's New in kfd v0.5.1

  • Fix bug in topology code that prevented kfd to load on some Motherboards

What's New in kfd v0.5

  • Based on kernel 3.14.0
  • Supports running HSA applications in 32bit mode
  • Various bug fixes
  • Supports both Ubuntu 13.10 and Ubuntu 14.04

What's New in Alpha 2

  • Supports wider range of Kaveri APU types
  • Kernel image built with Ubuntu 13.10 stock configuration file
  • Improved stability

Package Contents

The Linux drivers archive contains :

  • Ubuntu images:

    • linux-headers-4.0.0-100050_4.0.0-100050.201509161230_all.deb
    • linux-headers-4.0.0-100050-generic_4.0.0-100050.201509161230_amd64.deb
    • linux-image-4.0.0-100050-generic_4.0.0-100050.201509161230_amd64.deb
    • linux-image-extra-4.0.0-100050-generic_4.0.0-100050.201509161230_amd64.deb
    • radeon-firmware_410-604_all.deb
  • Fedora images:

    • Fedora release is currently unavailable for KFD 1.6
  • Userspace wrapper library called libhsakmt:

    • libhsakmt_1.6.0_amd64.deb
  • A bash script which checks if kfd is installed correctly

The kernel image is built from a source tree based on the 4.0.0 upstream release plus :

  • Features in the HSA kernel driver ("amdkfd") that are not yet upstreamed to the mainline Linux kernel.
  • The new AMD kernel graphic driver ("amdgpu") that is not yet upstreamed to the mainline Linux kernel.
  • Minor changes to "amd_iommu_v2" kernel driver, which are only present in later linux kernel versions
Note regarding libhsakmt compatibility

Please note that the libhsakmt library in this repository is NOT compatible with amdkfd that is distributed as part of the mainline Linux kernel from 3.19 and onward.

If you prefer to work with the upstreamed amdkfd in the mainline Linux kernel, you can get the corresponding libhsakmt from:

http://cgit.freedesktop.org/~gabbayo/libhsakmt/

Target Platform

This release is intended for use with any hardware configuration that contains a Kaveri or Carrizo APU.

The motherboards must support run latest BIOS version and have the IOMMU enabled in the BIOS.

The following is a reference hardware configuration that was used for testing purposes:

  • APU: AMD A10-7850K APU
  • Motherboard: ASUS A88X-PRO motherboard (ATX form factor)
  • Memory: G.SKILL Ripjaws X Series 16GB (2 x 8GB) 240-Pin DDR3 SDRAM DDR3 2133
  • OS: Ubuntu 14.04 64-bit edition
  • No discrete GPU present in the system

Installing and configuring the kernel

  • Downloading the kernel binaries from the repo
    git clone -b kfd-v1.6.x https://github.com/HSAFoundation/HSA-Drivers-Linux-AMD.git

  • Go to the top of the repo:
    cd HSA-Drivers-Linux-AMD

  • Configure udev to allow any user to access /dev/kfd. As root, use a text editor to create /etc/udev/rules.d/kfd.rules containing one line: KERNEL=="kfd", MODE="0666", Or you could use the following command:
    echo "KERNEL==\"kfd\", MODE=\"0666\"" | sudo tee /etc/udev/rules.d/kfd.rules

  • For Ubuntu, install the linux-image kernel package using:
    sudo dpkg -i kfd-1.6/ubuntu/*.deb

  • Reboot the system to install the new kernel and enable the HSA kernel driver:
    sudo reboot

  • Check the HSA driver installation: cd HSA-Drivers-Linux-AMD; ./kfd_check_installation.sh

Obtaining kernel and libhsakmt source code
  • Source code used to build the kernel can be found under the src/ folder:

    • src/kernel/
    • src/libhsakmt/
  • For Ubuntu, the kernel images were built using Ubuntu mainline kernel PPA patches, are availble:

    • src/kernel/0001-base-packaging.patch
    • src/kernel/0002-debian-changelog.patch
    • src/kernel/0003-configs-based-on-Ubuntu-4.0.0-1.1.patch
    • src/kernel/0004-amd-config-for-ubuntu.patch
  • Use the instructions in the following wiki page to built the Ubuntu kernel images: https://help.ubuntu.com/community/Kernel/Compile

  • Use the instructions in the following wiki page to built the Fedora kernel images:
    https://fedoraproject.org/wiki/Building_a_custom_kernel

Obtaining firmware binary files
  • Firmware binary files for Carrizo and Kaver are included in radeon-firmware_410-604_all.deb

LICENSE

The following lists the different licenses that apply to the different components in this repository:

  • the Linux kernel images are covered by the modified GPL license in COPYING
  • libhsakmt is covered by the X11 license in LICENSE.libhsakmt
  • the firmware image is covered by the license in LICENSE.ucode
Something went wrong with that request. Please try again.