Skip to content

HSA Platforms & Installation

jedwards-AMD edited this page Sep 29, 2014 · 18 revisions

Target Platforms

Target versions should support AMD's HSA driver set and user-mode libraries, but have not been verified and are not officially supported. Extensive testing of the HSA software stack has been performed on the Tested Version.

Characteristic Target Version Tested Version dmidecode key
Operating Systems Ubuntu 14.04 (Trusty Tahr) & Fedora 21 Ubuntu 14.04 (Trusty Tahr) & Fedora 21
Mother board Any ASUS A88X with FM2+ socket ASUS A88X-PRO with FM2+ socket baseboard-product-name
APU Any AMD 7000 series APU AMD A10-7850 APU with Radeon(TM) R7 Graphics processor-version
System BIOS Latest version available* 0904 or greater bios-version

*Note that some System BIOS versions may not support HSA topology information, and will not support HSA device detection.

Use the dmidecode command with the -s option and the appropriate key to determine the targeted platform characteristic. For example 'dmidecode -s bios-version' will display the current system bios.

In addition to the above requirements, no discrete GPU can be installed in the system.

Installation Overview

Installation of the HSA software stack on a target platform consists of the following steps:

  1. Check the target platform's characteristics to determine if the target platform is a valid HSA platform.
  2. Enable IOMMU in the system BIOS settings. This can usually be found in the Advanced\ CPU Configuration > IOMMU field of the UEFI BIOS Utility.
  3. Install and configure the kernel supporting the Linux HSA drivers and image, available in the HSA-Drivers-Linux-AMD repository. Installation and configuration instructions can be found in the projects README. Be sure to verify driver installation by running the kfd_check_installation.sh script, available in the package.
  4. After rebooting the system, obtain the HSA runtime and header files from the HSA-Runtime-AMD repository. Installation and configuration instructions can be found in the projects README.
  5. Verify the compatibility of the HSA Runtime and the HSA drivers by running the vector-copy sample provided with the HSA Runtime.