Maneesh Gupta
107 lignes
4.5 KiB
Markdown
107 lignes
4.5 KiB
Markdown
## Table of Contents
|
|
|
|
<!-- toc -->
|
|
|
|
- [Installing pre-built packages](#installing-pre-built-packages)
|
|
* [Prerequisites](#prerequisites)
|
|
* [AMD-hcc](#amd-hcc)
|
|
* [NVIDIA-nvcc](#nvidia-nvcc)
|
|
* [Verify your installation](#verify-your-installation)
|
|
- [Building HIP from source](#building-hip-from-source)
|
|
* [HCC Options](#hcc-options)
|
|
+ [Using HIP with the AMD Native-GCN compiler.](#using-hip-with-the-amd-native-gcn-compiler)
|
|
|
|
<!-- tocstop -->
|
|
|
|
# Installing pre-built packages
|
|
|
|
HIP can be easily installed using pre-built binary packages using the package manager for your platform.
|
|
|
|
## Prerequisites
|
|
HIP code can be developed either on AMD ROCm platform using hcc compiler, or a CUDA platform with nvcc installed:
|
|
|
|
## AMD-hcc
|
|
|
|
* Install the [rocm](http://gpuopen.com/getting-started-with-boltzmann-components-platforms-installation/) packages. Rocm will install all of the necessary components, including the kernel driver, runtime software, HCC compiler, and HIP.
|
|
|
|
* Default paths and environment variables:
|
|
|
|
* By default HIP looks for hcc in /opt/rocm/hcc (can be overridden by setting HCC_HOME environment variable)
|
|
* By default HIP looks for HSA in /opt/rocm/hsa (can be overridden by setting HSA_PATH environment variable)
|
|
* By default HIP is installed into /opt/rocm/hip (can be overridden by setting HIP_PATH environment variable).
|
|
* Optionally, consider adding /opt/rocm/bin to your path to make it easier to use the tools.
|
|
|
|
|
|
## NVIDIA-nvcc
|
|
* Configure the additional package server as described [here](http://gpuopen.com/getting-started-with-boltzmann-components-platforms-installation/).
|
|
* Install the "hip_nvcc" package. This will install CUDA SDK and the HIP porting layer.
|
|
```
|
|
apt-get install hip_nvcc
|
|
```
|
|
|
|
* Default paths and environment variables:
|
|
* By default HIP looks for CUDA SDK in /usr/local/cuda (can be overriden by setting CUDA_PATH env variable)
|
|
* By default HIP is installed into /opt/rocm/hip (can be overridden by setting HIP_PATH environment variable).
|
|
* Optionally, consider adding /opt/rocm/bin to your path to make it easier to use the tools.
|
|
|
|
|
|
## Verify your installation
|
|
Run hipconfig (instructions below assume default installation path) :
|
|
```shell
|
|
/opt/rocm/bin/hipconfig --full
|
|
```
|
|
|
|
Compile and run the [square sample](https://github.com/GPUOpen-ProfessionalCompute-Tools/HIP/tree/master/samples/0_Intro/square).
|
|
|
|
|
|
# Building HIP from source
|
|
HIP source code is available and the project can be built from source on the HCC platform.
|
|
|
|
1. Follow the above steps to install and validate the binary packages.
|
|
2. Download HIP source code (from the [GitHub repot](https://github.com/GPUOpen-ProfessionalCompute-Tools/HIP).)
|
|
3. Build and install HIP (This is the simple version assuming default paths ; see below for additional options.)
|
|
```
|
|
cd HIP
|
|
mkdir build
|
|
cd build
|
|
cmake ..
|
|
make
|
|
make install
|
|
```
|
|
|
|
* Default paths:
|
|
* By default cmake looks for hcc in /opt/rocm/hcc (can be overridden by setting ```-DHCC_HOME=/path/to/hcc``` in the cmake step).*
|
|
* By default cmake looks for HSA in /opt/rocm/hsa (can be overridden by setting ```-DHSA_PATH=/path/to/hsa``` in the cmake step).*
|
|
* By default cmake installs HIP to /opt/rocm/hip (can be overridden by setting ```-DCMAKE_INSTALL_PREFIX=/where/to/install/hip``` in the cmake step).*
|
|
|
|
Here's a richer command-line that overrides the default paths:
|
|
|
|
```shell
|
|
cd HIP
|
|
mkdir build
|
|
cd build
|
|
cmake -DHSA_PATH=/path/to/hsa -DHCC_HOME=/path/to/hcc -DCMAKE_INSTALL_PREFIX=/where/to/install/hip -DCMAKE_BUILD_TYPE=Release ..
|
|
make
|
|
make install
|
|
```
|
|
|
|
* After installation, make sure HIP_PATH is pointed to `/where/to/install/hip`.
|
|
|
|
## HCC Options
|
|
|
|
### Using HIP with the AMD Native-GCN compiler.
|
|
AMD recently released a direct-to-GCN-ISA target. This compiler generates GCN ISA directly from LLVM, without going through an intermediate compiler
|
|
IR such as HSAIL or PTX.
|
|
The native GCN target is included with upstream LLVM, and has also been integrated with HCC compiler and can be used to compiler HIP programs for AMD.
|
|
Binary packages for the direct-to-isa package are included with the [rocm](http://gpuopen.com/getting-started-with-boltzmann-components-platforms-installation/) package.
|
|
Alternatively, this sections describes how to build it from source:
|
|
|
|
1. Install the rocm packages as described above.
|
|
2. Follow the instructions [here](https://github.com/RadeonOpenCompute/HCC-Native-GCN-ISA/wiki)
|
|
* In the make step for HCC, we recommend setting -DCMAKE_INSTALL_PREFIX.
|
|
* Set HCC_HOME environment variable before compiling HIP program to point to the native compiler:
|
|
```shell
|
|
export HCC_HOME=/path/to/native/hcc
|
|
```
|
|
|