Compare commits

..

21 Commits

Author SHA1 Message Date
James Edwards
484d5d48d4 Change extraction protocol to http. 2018-06-13 10:56:31 -05:00
James Edwards
cb75f9faeb Update README.md 2018-03-11 19:47:51 -05:00
James Adrian Edwards
95c6ddd586 Update ROCm 1.7 support information. 2017-12-19 14:53:48 -06:00
James Adrian Edwards
3b73215554 Update ROCm 1.7 support information. 2017-12-19 14:51:45 -06:00
James Adrian Edwards
39ebe697ba Update ROCm 1.7 support information. 2017-12-18 15:29:30 -06:00
James Adrian Edwards
b6c6392ee4 Update ROCm 1.7 support information. 2017-12-18 14:57:03 -06:00
James Adrian Edwards
6e5b253e67 Update ROCm 1.7 support information. 2017-12-18 14:33:33 -06:00
Gregory Stoner
a93a3fe488 Update README.md 2017-10-15 10:24:02 -05:00
Gregory Stoner
dfff4e0f40 Merge pull request #155 from RadeonOpenCompute/notice-incompatibility-15-16
Add warning to inform users about incompatibilities between 1.5 and 1.6
2017-09-02 07:31:52 -05:00
Wen-Heng (Jack) Chung
8bd9db4e8e Add warning to inform users about incompatibilities between 1.5 and 1.6 2017-07-07 11:30:29 -05:00
Gregory Stoner
bb158e9d7f Update README.md 2017-06-30 09:57:32 -05:00
Gregory Stoner
3387f5b9d8 Update README.md 2017-06-30 09:54:07 -05:00
Gregory Stoner
42ed737183 Update README.md 2017-06-30 09:53:29 -05:00
Gregory Stoner
eab9718cb8 Update README.md 2017-06-30 09:53:04 -05:00
James Edwards
4c7d3cdd4c Merge pull request #137 from RadeonOpenCompute/roc-1.6.0
ROCm 1.6 updates.
2017-06-30 00:43:22 -05:00
James Edwards
2a0d469a95 ROCm 1.6 updates. 2017-06-29 22:23:25 -05:00
Gregory Stoner
67197a8232 Update README.md 2017-05-22 12:05:29 -05:00
James Edwards
38a3c6dbcf Update README.md 2017-05-03 10:00:07 -05:00
James Edwards
a0e3f8b827 Merge pull request #113 from VincentSC/patch-1
Feedback from updating 1.4 to 1.5 on Ubuntu 16.04
2017-05-03 09:57:54 -05:00
Gregory Stoner
274fe660e7 Update README.md 2017-05-03 07:45:10 -05:00
VincentSC
47b44a6256 Feedback from updating 1.4 to 1.5 on Ubuntu 16.04
- 1.4 needed to be removed with `sudo apt remove hsa-rocr-dev hsa-ext-rocr-dev rocm-smi hsakmt-roct-dev`
- The name of the opencl-rocm and opencl-rocm-dev changed to rocm-opencl and rocm-opencl-dev
2017-05-03 13:18:19 +02:00
2 changed files with 56 additions and 95 deletions

149
README.md
View File

@@ -38,7 +38,7 @@ Southbridge PCIe I/O controller. If you motherboard is part of this category,
please do not use this connector for your GPUs, if you intend to exploit ROCm.
Our GFX8 GPU's (Fiji & Polaris Family) use PCIe Gen 3 and PCIe Atomics.
Our GFX8 GPU's (Fiji & Polaris Family) and GFX9 (Vega) use PCIe Gen 3 and PCIe Atomics.
Current CPUs which support PCIe Gen3 + PCIe Atomics are:
* Intel Xeon E5 v3 or newer CPUs;
@@ -50,7 +50,7 @@ Upcoming CPUs which will support PCIe Gen3 + PCIe Atomics are:
* AMD Naples Server CPUs;
* Cavium Thunder X Server Processor.
Our GFX7 GPUs Radeon R9 290, R9 390, AMD FirePro S9150, S9170 do not support or
Experimental support for our GFX7 GPUs Radeon R9 290, R9 390, AMD FirePro S9150, S9170 note they do not support or
take advantage of PCIe Atomics. However, we still recommend that you use a CPU
from the list provided above.
@@ -81,7 +81,14 @@ APUs. Just like you, we still waiting for access to them! Once we have the first
boards in the lab we will detail our experiences via our blog, as well as build
a list of motherboard that are qualified for use with ROCm.
### New Features to ROCm
### New Features to ROCm 1.7
#### DKMS driver installation
* New driver installation uses Dynamic Kernel Module Support (DKMS)
* Only amdkfd and amdgpu kernel modules are installed to support AMD hardware
* Currently only Debian packages are provided for DKMS (no Fedora suport available)
* See the [ROCT-Thunk-Interface](https://github.com/RadeonOpenCompute/ROCT-Thunk-Interface/tree/roc-1.7.x) and [ROCK-Kernel-Driver](https://github.com/RadeonOpenCompute/ROCK-Kernel-Driver/tree/roc-1.7.x) for additional documentation on driver setup
#### Developer preview of the new OpenCL 1.2 compatible language runtime and compiler
@@ -89,45 +96,51 @@ a list of motherboard that are qualified for use with ROCm.
runtime
* Supports offline ahead of time compilation today;
during the Beta phase we will add in-process/in-memory compilation.
* Binary Package support for Ubuntu 16.04 and Fedora 24
* Dropping binary package support for Ubuntu 14.04 and Fedora 23
* Binary Package support for Ubuntu 16.04
* Binary Package support for Fedora 24 is not currently available
* Dropping binary package support for Ubuntu 14.04, Fedora 23
#### IPC support
### The latest ROCm platform - ROCm 1.5
### The latest ROCm platform - ROCm 1.7
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.5.0 or rocm-1.5.0 tag
the ROCm platform have been released and are available under the roc-1.7.x or rocm-1.7.x tag
of the following GitHub repositories:
* [ROCK-Kernel-Driver](https://github.com/RadeonOpenCompute/ROCK-Kernel-Driver/tree/roc-1.5.0)
* [ROCR-Runtime](https://github.com/RadeonOpenCompute/ROCR-Runtime/tree/roc-1.5.0)
* [ROCT-Thunk-Interface](https://github.com/RadeonOpenCompute/ROCT-Thunk-Interface/tree/roc-1.5.0)
* [ROC-smi](https://github.com/RadeonOpenCompute/ROC-smi/tree/roc-1.5.0)
* [HCC compiler](https://github.com/RadeonOpenCompute/hcc/tree/rocm-1.5.0)
* [compiler-runtime](https://github.com/RadeonOpenCompute/compiler-rt/tree/rocm-1.5.0)
* [HIP](https://github.com/GPUOpen-ProfessionalCompute-Tools/HIP/tree/roc-1.5.0)
* [HIP-Examples](https://github.com/GPUOpen-ProfessionalCompute-Tools/HIP-Examples/tree/roc-1.5.0)
* [ROCK-Kernel-Driver](https://github.com/RadeonOpenCompute/ROCK-Kernel-Driver/tree/roc-1.7.x)
* [ROCR-Runtime](https://github.com/RadeonOpenCompute/ROCR-Runtime/tree/roc-1.7.x)
* [ROCT-Thunk-Interface](https://github.com/RadeonOpenCompute/ROCT-Thunk-Interface/tree/roc-1.7.x)
* [ROC-smi](https://github.com/RadeonOpenCompute/ROC-smi/tree/roc-1.7.x)
* [HCC compiler](https://github.com/RadeonOpenCompute/hcc/tree/roc-1.7.x)
* [compiler-runtime](https://github.com/RadeonOpenCompute/compiler-rt/tree/roc-1.7.x)
* [HIP](https://github.com/GPUOpen-ProfessionalCompute-Tools/HIP/tree/roc-1.7.x)
* [HIP-Examples](https://github.com/GPUOpen-ProfessionalCompute-Tools/HIP-Examples/tree/roc-1.7.x)
* [atmi](https://github.com/RadeonOpenCompute/atmi/tree/0.3.7)
Additionally, the following mirror repositories that support the HCC compiler
are also available on GitHub, and frozen for the rocm-1.5.0 release:
are also available on GitHub, and frozen for the rocm-1.7.0 release:
* [llvm](https://github.com/RadeonOpenCompute/llvm/tree/rocm-1.5.0)
* [lld](https://github.com/RadeonOpenCompute/lld/tree/rocm-1.5.0)
* [hcc-clang-upgrade](https://github.com/RadeonOpenCompute/hcc-clang-upgrade/tree/rocm-1.5.0)
* [ROCm-Device-Libs](https://github.com/RadeonOpenCompute/ROCm-Device-Libs/tree/rocm-1.5.0)
* [llvm](https://github.com/RadeonOpenCompute/llvm/tree/roc-1.7.x)
* [lld](https://github.com/RadeonOpenCompute/lld/tree/roc-1.7.x)
* [hcc-clang-upgrade](https://github.com/RadeonOpenCompute/hcc-clang-upgrade/tree/roc-1.7.x)
* [ROCm-Device-Libs](https://github.com/RadeonOpenCompute/ROCm-Device-Libs/tree/roc-1.7.x)
#### Supported Operating Systems
The ROCm platform has been tested on the following operating systems:
The ROCm 1.7 platform has been tested on the following operating systems:
* Ubuntu 16.04
* Fedora 24 (Hawaii based GPUs, i.e. Radeon R9 290, R9 390, AMD FirePro S9150, S9170, are not supported)
### Installing from AMD ROCm repositories
AMD is hosting both debian and rpm repositories for the ROCm 1.5 packages. The
packages in the Debian repository have been signed to ensure package integrity.
AMD is hosting only debian repositories for the ROCm 1.7 packages at this time. It is expected
that an rpm repository will be available in the next point release.
The packages in the Debian repository have been signed to ensure package integrity.
Directions for each repository are given below:
#### Packaging server update
The packaging server has been changed from the old http://packages.amd.com
to the new repository site http://repo.radeon.com.
#### Debian repository - apt-get
##### Add the ROCm apt repository
@@ -135,30 +148,25 @@ For Debian based systems, like Ubuntu, configure the Debian ROCm repository as
follows:
```shell
wget -qO - http://packages.amd.com/rocm/apt/debian/rocm.gpg.key | sudo apt-key add -
sudo sh -c 'echo deb [arch=amd64] http://packages.amd.com/rocm/apt/debian/ xenial main > /etc/apt/sources.list.d/rocm.list'
wget -qO - http://repo.radeon.com/rocm/apt/debian/rocm.gpg.key | sudo apt-key add -
sudo sh -c 'echo deb [arch=amd64] http://repo.radeon.com/rocm/apt/debian/ xenial main > /etc/apt/sources.list.d/rocm.list'
```
The gpg key might change, so it may need to be updated when installing a new
release.
release. The current rocm.gpg.key is not avialable in a standard key ring distribution,
but has the following sha1sum hash:
f0d739836a9094004b0a39058d046349aacc1178 rocm.gpg.key
##### Install or Update
Next, update the apt-get repository list and install/update the rocm package:
>**Warning**: Before proceeding, make sure to completely
>[uninstall any pre-release ROCm packages](https://github.com/RadeonOpenCompute/ROCm#removing-pre-release-packages):
>[uninstall any previous ROCm package](https://github.com/RadeonOpenCompute/ROCm#removing-pre-release-packages):
```shell
sudo apt-get update
sudo apt-get install rocm
sudo apt-get install rocm-dkms
```
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.
@@ -167,16 +175,16 @@ We recommend you [verify your installation](https://github.com/RadeonOpenCompute
##### Start by following the instruction of installing ROCm with Debian repository:
at the step "sudo apt-get install rocm" replace it with:
at the step "sudo apt-get install rocm-dkms" replace it with:
```shell
sudo apt-get install rocm opencl-rocm
sudo apt-get install rocm-dkms rocm-opencl
```
To install the development kit for OpenCL, which includes the OpenCL header files, execute this installation command instead:
To install the development kit for OpenCL, which includes the OpenCL header files, execute this installation command:
```shell
sudo apt-get install rocm opencl-rocm-dev
sudo apt-get install rocm-opencl-dev
```
Then follow the direction for Debian Repository
@@ -205,7 +213,7 @@ g++ -I /opt/rocm/opencl/include/ ./HelloWorld.cpp -o HelloWorld -L/opt/rocm/open
To un-install the entire rocm development package execute:
```shell
sudo apt-get autoremove rocm
sudo apt-get autoremove rocm-dkms
```
##### Installing development packages for cross compilation
@@ -236,54 +244,7 @@ If possible, we would recommend starting with a fresh OS install.
#### RPM repository - dnf (yum)
A dnf (yum) repository 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 individually.
To uninstall the packages execute:
```shell
sudo dnf remove rocm
```
Just like Ubuntu installs, the ROCm kernel must be the default kernel used at boot time.
#### Manual installation steps for Fedora
A fully functional Fedora installation requires a few manual steps to properly
setup, including:
* [Building compatible libc++ and libc++abi libraries for Fedora](https://github.com/RadeonOpenCompute/hcc/wiki#fedora)
#### Verify installation
To verify that the ROCm stack completed successfully you can execute to HSA
vectory\_copy sample application (we do recommend that you copy it to a
separate folder and invoke make therein):
```shell
cd /opt/rocm/hsa/sample
make
./vector_copy
```
A repository containing rpm packages is currently no available for the ROCm 1.7 release.
#### Closed source components
The ROCm platform relies on a few closed source components to provide legacy
@@ -295,10 +256,10 @@ made available in the following packages:
* hsa-ext-rocr-dev
### Getting ROCm source code
Modifications can be made to the ROCm 1.5 components by modifying the open
Modifications can be made to the ROCm 1.7 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.5 manifest file to download the entire ROCm 1.5 source code.
and the ROCm 1.7 manifest file to download the entire ROCm 1.7 source code.
#### Installing repo
Google's repo tool allows you to manage multiple git repositories
@@ -313,11 +274,11 @@ 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.5.0
repo init -u https://github.com/RadeonOpenCompute/ROCm.git -b roc-1.7.0
repo sync
```
These series of commands will pull all of the open source code associated with
the ROCm 1.5 release. Please ensure that ssh-keys are configured for the
the ROCm 1.7 release. Please ensure that ssh-keys are configured for the
target machine on GitHub for your GitHub ID.
* OpenCL Runtime and Compiler will be submitted to the Khronos Group, prior to

View File

@@ -6,7 +6,7 @@
<remote name="pctools-github"
fetch="http://git@github.com/GPUOpen-ProfessionalCompute-Tools/" />
<default revision="roc-1.5.x"
<default revision="roc-1.7.x"
remote="roc-github"
sync-j="4" />