Skip to content

Home

Jump to bottom
Andrew Chapman edited this page Apr 17, 2017 · 31 revisions

hipBLAS is a thin interface that can be called from HIP on hcc or nvcc platforms. hipBLAS is configured for the appropriate platform using the command hipconfig to detect if it is hcc or nvcc. When you compile and link your HIP code to hipBLAS the hipcc compiler detects the platform is hcc if the macro __HIP_PLATFORM_HCC__ is defined, and nvcc if the macro __HIP_PLATFORM_NVCC__ is defined.

Operating Systems

Linux only

Choose platform

hipBLAS is written with HiP so it can run with AMD's ROCM or NVIDIA's CUDA hardware.

For AMD platform and Ubuntu, ROCM can be installed with sudo apt-get install rocm. For other platforms, see install ROCM. HIP is contained in ROCM.

To verify the installation of ROCM see install ROCM

Alternatively, for either AMD or NVIDIA, install HIP. To check that HIP is installed, enter the command hipconfig. This should output information on the HIP installation.

Dependencies

CMake 2.8 or later

On Ubuntu you can install cmake, cmake-gui, and ccmake with the following:

sudo apt-get update
sudo apt-get install cmake
sudo apt-get install cmake-gui
sudo apt-get install cmake-curses-gui

rocBLAS

hipBLAS needs to access the include file /opt/rocm/rocblas/include/rocblas.h. Install rocBLAS in /opt/rocm/rocblas. Installation instructions are at the Wiki.

Download

Clone hipBLAS with the following commands: (Here it is assumed you will clone hipBLAS into the directory ~/repos/hipBLAS. You can choose to clone into any directory of your choice.)

cd ~; mkdir -p repos; cd repos
git clone -b master https://github.com/AMDComputeLibraries/hipBLAS.git

Configure

Configure using ccmake with the following:

mkdir ~/repos/hipBLAS-build
cd ~/repos/hipBLAS-build

cmake ../hipBLAS -DBUILD_LIBRARY=ON -DCMAKE_BUILD_TYPE=Release -DCMAKE_CXX_FLAGS=-fPIC

Build

Build with

cd ~/repos/hipBLAS-build
make VERBOSE=1 >& make.lib.out

Install

Install with the following:

cd ~/repos/hipBLAS-build/library-build
make install

After installing, the library libhipblas-hcc.a will be in the directory ~/repos/hipBLAS-build/library-package/lib. The include file hipblas.h will be in the directory ~/repos/hipBLAS-build/library-package/include. If you need the package installed in /opt/rocm/hipblas, copy with the following commands:

sudo mkdir -p /opt/rocm/hipblas
sudo cp -r ~/repos/hipBLAS-build/library-package /opt/rocm/hipblas

Build hipblas

Clone this wiki locally