mirror of
https://github.com/ROCm/ROCm.git
synced 2026-01-09 22:58:17 -05:00
Compare commits
14 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
950acca11d | ||
|
|
f0241829b7 | ||
|
|
833c03cbde | ||
|
|
8988c7793e | ||
|
|
615624a501 | ||
|
|
fe416dcebd | ||
|
|
a683987259 | ||
|
|
fd180dec60 | ||
|
|
0b5c594cd1 | ||
|
|
828cbe0346 | ||
|
|
533e5ee1c7 | ||
|
|
a2b8abc1f5 | ||
|
|
91e2ed4368 | ||
|
|
6c3531809f |
105
README.md
105
README.md
@@ -12,7 +12,7 @@ Initiative with three core foundation elements:
|
||||
* HIP acknowledging the need for platform choice when utilizing GPU computing
|
||||
API
|
||||
|
||||
Using our knowledge of the HSA Standards and, more importantly, the HSA 1.0
|
||||
Using our knowledge of the HSA Standards and, more importantly, the HSA 1.1
|
||||
Runtime we have been able to successfully extended support to the dGPU with
|
||||
critical features for NUMA class acceleration. As a result, the ROCK driver is
|
||||
composed of several components based on our efforts to develop the
|
||||
@@ -21,28 +21,42 @@ the Kernel Fusion Driver (KFD), the HSA+ Runtime and an LLVM based compilation
|
||||
stack for the building of key language support. This support starts with AMD’s
|
||||
FIJI Family of dGPU, but support is planned to expand to include future ASICS.
|
||||
|
||||
### The Latest ROCm Platform - ROCm 1.0
|
||||
### The Latest ROCm Platform - ROCm 1.1
|
||||
The latest tested version of the drivers, tools, libraries and source code for
|
||||
the ROCm platform have been released and are available under the roc-1.0.0 tag
|
||||
the ROCm platform have been released and are available under the roc-1.1.0 tag
|
||||
of the following GitHub repositories:
|
||||
|
||||
* [ROCK-Kernel-Driver](https://github.com/RadeonOpenCompute/ROCK-Kernel-Driver/tree/dev)
|
||||
* [ROCR-Runtime](https://github.com/RadeonOpenCompute/ROCR-Runtime/tree/dev)
|
||||
* [ROCT-Thunk-Interface](https://github.com/RadeonOpenCompute/ROCT-Thunk-Interface/tree/dev)
|
||||
* [HCC compiler](https://github.com/RadeonOpenCompute/hcc/tree/roc-1.0)
|
||||
* [LLVM-AMDGPU-Assembler-Extra](https://github.com/RadeonOpenCompute/LLVM-AMDGPU-Assembler-Extra/tree/master)
|
||||
* [ROCK-Kernel-Driver](https://github.com/RadeonOpenCompute/ROCK-Kernel-Driver/tree/roc-1.1.0)
|
||||
* [ROCR-Runtime](https://github.com/RadeonOpenCompute/ROCR-Runtime/tree/roc-1.1.0)
|
||||
* [ROCT-Thunk-Interface](https://github.com/RadeonOpenCompute/ROCT-Thunk-Interface/tree/roc-1.1.0)
|
||||
* [HCC compiler](https://github.com/RadeonOpenCompute/hcc/tree/roc-1.1.0)
|
||||
* [LLVM-AMDGPU-Assembler-Extra](https://github.com/RadeonOpenCompute/LLVM-AMDGPU-Assembler-Extra/tree/roc-1.1.0)
|
||||
* [ROC-smi](https://github.com/RadeonOpenCompute/ROC-smi/tree/roc-1.1.0)
|
||||
* [ROCnRDMA](https://github.com/RadeonOpenCompute/ROCnRDMA/tree/roc-1.1.0)
|
||||
* [HIP](https://github.com/GPUOpen-ProfessionalCompute-Tools/HIP/tree/roc-1.1.0)
|
||||
* [HIP-Examples](https://github.com/GPUOpen-ProfessionalCompute-Tools/HIP-Examples/tree/roc-1.1.0)
|
||||
|
||||
In addition the following mirror repositories that support the HCC compiler are
|
||||
also available on GitHub, and frozen for the roc-1.0.0 release:
|
||||
also available on GitHub, and frozen for the roc-1.1.0 release:
|
||||
|
||||
* [llvm](https://github.com/RadeonOpenCompute/llvm/tree/roc-1.0)
|
||||
* [clang](https://github.com/RadeonOpenCompute/clang/tree/roc-1.0)
|
||||
* [llvm](https://github.com/RadeonOpenCompute/llvm/tree/roc-1.1.0)
|
||||
* [clang](https://github.com/RadeonOpenCompute/clang/tree/roc-1.1.0)
|
||||
|
||||
### Installing from AMD ROCm Repositories
|
||||
AMD is hosting both debian and rpm repositories for the ROCm 1.0 packages. The
|
||||
AMD is hosting both debian and rpm repositories for the ROCm 1.1 packages. The
|
||||
packages in both repositories have been signed to ensure package integrity.
|
||||
Directions for each repository are given below:
|
||||
|
||||
#### Supported Operating Systems
|
||||
|
||||
The ROCm platform has been tested on the following operating systems:
|
||||
* Ubuntu 14.04.04
|
||||
* Fedora 23
|
||||
|
||||
There is experimental support for the following operating systems:
|
||||
* Ubuntu 16.04
|
||||
* Fedora 22
|
||||
|
||||
#### Debian repository - apt-get
|
||||
|
||||
##### Add the ROCm apt repository
|
||||
@@ -64,6 +78,17 @@ Next, update the apt-get repository list and install/update the rocm package:
|
||||
sudo apt-get update
|
||||
sudo apt-get install rocm
|
||||
```
|
||||
Then, make the ROCm kernel your default kernel. If using grub2 as your
|
||||
bootloader, you can edit the `GRUB_DEFAULT` variable in the following file:
|
||||
|
||||
```shell
|
||||
sudo vi /etc/default/grub
|
||||
sudo update-grub
|
||||
```
|
||||
|
||||
Once complete, reboot your system.
|
||||
|
||||
We recommend you [verify your installation](https://github.com/RadeonOpenCompute/ROCm#verify-installation) to make sure everything completed successfully.
|
||||
|
||||
##### Un-install
|
||||
To un-install the entire rocm-dev development package execute:
|
||||
@@ -92,19 +117,53 @@ need to be manually un-installed:
|
||||
|
||||
```shell
|
||||
sudo apt-get purge libhsakmt
|
||||
```
|
||||
```shell
|
||||
for package in $(dpkg -l | grep 'kfd\|rocm' | grep linux | grep -v libc | awk '{print $2}');do
|
||||
echo "=== Removing $package ==="
|
||||
sudo apt-get purge $package
|
||||
done
|
||||
sudo apt-get purge radeon-firmware
|
||||
sudo apt-get purge $(dpkg -l | grep 'kfd\|rocm' | grep linux | grep -v libc | awk '{print $2}')
|
||||
```
|
||||
|
||||
If possible, we would recommend starting with a fresh OS install.
|
||||
|
||||
#### RPM repository - dnf (yum)
|
||||
|
||||
The RPM repository is still under construction but will be available soon.
|
||||
A dnf (yum) repostiory is also available for installation of rpm packages. To configure a
|
||||
system to use the ROCm rpm directory create the file /etc/yum.repos.d/rocm.repo with
|
||||
the following contents:
|
||||
|
||||
```shell
|
||||
[remote]
|
||||
|
||||
name=ROCm Repo
|
||||
|
||||
baseurl=http://packages.amd.com/rocm/yum/rpm/
|
||||
|
||||
enabled=1
|
||||
|
||||
gpgcheck=0
|
||||
```
|
||||
Execute the following commands:
|
||||
|
||||
```shell
|
||||
sudo dnf clean all
|
||||
sudo dnf install rocm
|
||||
```
|
||||
|
||||
As with the debian packages, it is possible to install rocm-dev or rocm-kernel individually.
|
||||
To uninstall the packages execute:
|
||||
|
||||
```shell
|
||||
sudo dnf remove rocm
|
||||
```
|
||||
|
||||
#### Verify Installation
|
||||
|
||||
To verify that the ROCm stack completed successfully you can execute to HSA
|
||||
vectory\_copy sample application:
|
||||
|
||||
```shell
|
||||
cd /opt/rocm/hsa/sample
|
||||
make
|
||||
./vector_copy
|
||||
```
|
||||
|
||||
#### Closed Source Components
|
||||
The ROCm platform relies on a few closed source components to provide legacy
|
||||
@@ -116,10 +175,10 @@ made available in the following packages:
|
||||
* hsa-ext-rocr-dev
|
||||
|
||||
### Getting ROCm Source Code
|
||||
Modifications can be made to the ROCm 1.0 components by modifying the open
|
||||
Modifications can be made to the ROCm 1.1 components by modifying the open
|
||||
source code base and rebuilding the components. Source code can be cloned from
|
||||
each of the GitHub repositories using git, or users can use the repo command
|
||||
and the ROCm 1.0 manifest file to download the entire ROCm 1.0 source code.
|
||||
and the ROCm 1.1 manifest file to download the entire ROCm 1.1 source code.
|
||||
|
||||
#### Installing repo
|
||||
Google's repo tool allows you to manage multiple git repositories
|
||||
@@ -134,9 +193,9 @@ Note: make sure ~/bin exists and it is part of your PATH
|
||||
#### Cloning the code
|
||||
```shell
|
||||
mkdir ROCm && cd ROCm
|
||||
repo init -u https://github.com/RadeonOpenCompute/ROCm.git -b roc-1.0.0
|
||||
repo init -u https://github.com/RadeonOpenCompute/ROCm.git -b roc-1.1.0
|
||||
repo sync
|
||||
```
|
||||
|
||||
These series of commands will pull all of the open source code associated with
|
||||
the ROCm 1.0 release.
|
||||
the ROCm 1.1 release.
|
||||
|
||||
18
default.xml
18
default.xml
@@ -1,21 +1,25 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<manifest>
|
||||
|
||||
<remote name="llvm.org"
|
||||
fetch="http://llvm.org/git/" />
|
||||
<remote name="roc-github"
|
||||
fetch="https://github.com/RadeonOpenCompute/" />
|
||||
fetch="http://git@github.com/RadeonOpenCompute/" />
|
||||
<remote name="pctools-github"
|
||||
fetch="https://github.com/GPUOpen-ProfessionalCompute-Tools/" />
|
||||
fetch="http://git@github.com/GPUOpen-ProfessionalCompute-Tools/" />
|
||||
|
||||
<default revision="refs/tags/roc-1.0.0"
|
||||
<default revision="refs/tags/roc-1.1.0"
|
||||
remote="roc-github"
|
||||
sync-j="4" />
|
||||
|
||||
<project path="llvm" remote="llvm.org" name="llvm" revision="master" />
|
||||
<project path="llvm/tools/lld" remote="llvm.org" name="lld" revision="master" />
|
||||
<project path="llvm" name="llvm" />
|
||||
<project path="llvm-amdgpu-assembler-extra" name="LLVM-AMDGPU-Assembler-Extra" />
|
||||
<project path="clang" name="clang" />
|
||||
|
||||
<project path="hcc" name="hcc" />
|
||||
<project path="ROCT-Thunk-Interface" name="ROCT-Thunk-Interface" />
|
||||
<project path="ROCK-Kernel-Driver" name="ROCK-Kernel-Driver" />
|
||||
<project path="ROC-smi" name="ROC-smi" />
|
||||
<project path="ROCnRDMA" name="ROCnRDMA" />
|
||||
<project path="rdma-perftest" name="rdma-perftest" />
|
||||
<project path="ROCR-Runtime" name="ROCR-Runtime" />
|
||||
<project path="HIP" remote="pctools-github" name="HIP" />
|
||||
<project path="HIP-Examples" remote="pctools-github" name="HIP-Examples" />
|
||||
|
||||
Reference in New Issue
Block a user