Skip to content

Commit 6c125e0

Browse files
author
Oded Gabbay
committed
Update README.md to match kfd-v1.2 release
Signed-off-by: Oded Gabbay <oded.gabbay@amd.com>
1 parent 35d8591 commit 6c125e0

File tree

1 file changed

+42
-27
lines changed

1 file changed

+42
-27
lines changed

README.md

+42-27
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,18 @@
1-
### AMD Heterogenous System Architecture (HSA) - Linux amdkfd v1.0 release for Kaveri
1+
### AMD Heterogenous System Architecture (HSA) - Linux amdkfd v1.2 release for Kaveri
22

33
### Installation and Configuration guide
44

5+
#### What's New in kfd v1.2
6+
7+
* Based on kernel 3.19.0
8+
* Improved Kaveri microcode
9+
* Various bug fixes
10+
* Supports Ubuntu 14.04 and Fedora 21
11+
12+
##### Known issues in this release
13+
14+
* SDMA queues are not working
15+
516
#### What's New in kfd v1.0
617

718
* Based on newer kernel 3.17.2
@@ -64,39 +75,43 @@
6475
The Linux drivers archive contains :
6576

6677
* Ubuntu images:
67-
* linux-headers-3.17.2-031450_3.17.2-031450.201412060000_all.deb
68-
* linux-headers-3.17.2-031450-generic_3.17.2-031450.201412060000_amd64.deb
69-
* linux-image-3.17.2-031450-generic_3.17.2-031450.201412060000_amd64.deb
70-
* linux-image-extra-3.17.2-031450-generic_3.17.2-031450.201412060000_amd64.deb
71-
* radeon-firmware_391_all.deb
78+
* linux-headers-3.19.0-031950_3.19.0-031950.201503241132_all.deb
79+
* linux-headers-3.19.0-031950-generic_3.19.0-031950.201503241132_amd64.deb
80+
* linux-image-3.19.0-031950-generic_3.19.0-031950.201503241132_amd64.deb
81+
* linux-image-extra-3.19.0-031950-generic_3.19.0-031950.201503241132_amd64.deb
82+
* radeon-firmware_396_all.deb
7283

7384
* Fedora images:
74-
* kernel-3.17.2-300.amdkfd.fc21.x86_64.rpm
75-
* kernel-core-3.17.2-300.amdkfd.fc21.x86_64.rpm
76-
* kernel-headers-3.17.2-300.amdkfd.fc21.x86_64.rpm
77-
* kernel-modules-3.17.2-300.amdkfd.fc21.x86_64.rpm
78-
* kernel-modules-extra-3.17.2-300.amdkfd.fc21.x86_64.rpm
79-
* linux-firmware-20141013-41.git0e5f6377.fc21.amdkfd.391.noarch.rpm
85+
* kernel-3.19.0-1.amdkfd.fc21.x86_64.rpm
86+
* kernel-core-3.19.0-1.amdkfd.fc21.x86_64.rpm
87+
* kernel-headers-3.19.0-1.amdkfd.fc21.x86_64.rpm
88+
* kernel-modules-3.19.0-1.amdkfd.fc21.x86_64.rpm
89+
* kernel-modules-extra-3.19.0-1.amdkfd.fc21.x86_64.rpm
90+
* linux-firmware-20150213-43.git17657c35.fc21.amdkfd.396.noarch.rpm
8091

8192
* Userspace wrapper library called libhsakmt:
82-
* lnx/libhsakmt.so.1
83-
* lnx64a/libhsakmt.so.1
93+
* libhsakmt.so.1
8494

8595
* A bash script which checks if kfd is installed correctly
8696

87-
The kernel image is built from a source tree based on the 3.17.2 upstream
97+
The kernel image is built from a source tree based on the 3.19.0 upstream
8898
release plus :
8999

90-
* The HSA kernel driver ("amdkfd"), which works with the radeon
91-
graphics driver.
92-
* Fixes and improvements to the radeon and amd_iommu(v2) drivers, mm and
93-
mmu_notifier code.
100+
* Features in the HSA kernel driver ("amdkfd") that are not yet upstreamed to
101+
the mainline Linux kernel.
94102

95103
##### Note regarding libhsakmt compatibility
96104
Please note that the libhsakmt library in this repository is NOT compatible
97105
with amdkfd that is distributed as part of the mainline Linux kernel
98106
from 3.19 and onward.
99107

108+
If you prefer to work with the upstreamed amdkfd in the mainline Linux kernel,
109+
you can get the corresponding libhsakmt from:
110+
111+
kernel 3.19 - http://cgit.freedesktop.org/~gabbayo/libhsakmt/tag/?id=v3.19
112+
113+
kernel 4.0 - http://cgit.freedesktop.org/~gabbayo/libhsakmt/tag/?id=v4.0
114+
100115
#### Target Platform
101116

102117
This release is intended for use with any hardware configuration that
@@ -128,10 +143,10 @@ KERNEL=="kfd", MODE="0666", Or you could use the following command:
128143
`echo "KERNEL==\"kfd\", MODE=\"0666\"" | sudo tee /etc/udev/rules.d/kfd.rules`
129144

130145
* For Ubuntu, install the linux-image kernel package using:
131-
`sudo dpkg -i kfd-1.0/ubuntu/*.deb`
146+
`sudo dpkg -i kfd-1.2/ubuntu/*.deb`
132147

133148
* For Fedora, install the kernel package and update initramfs using:
134-
`sudo yum install kfd-1.0/fedora/*.rpm ; sudo dracut --force --add-drivers "amd_iommu_v2 amdkfd" "/boot/initramfs-3.17.2-300.amdkfd.fc21.x86_64.img" 3.17.2-300.amdkfd.fc21.x86_64`
149+
`sudo yum install kfd-1.2/fedora/*.rpm ; sudo dracut --force --add-drivers "amd_iommu_v2 amdkfd" "/boot/initramfs-3.19.0-1.amdkfd.fc21.x86_64.img" 3.19.0-1.amdkfd.fc21.x86_64`
135150

136151
* Reboot the system to install the new kernel and enable the HSA kernel driver:
137152
`sudo reboot`
@@ -144,33 +159,33 @@ KERNEL=="kfd", MODE="0666", Or you could use the following command:
144159

145160
* Source code used to build the kernel can be downloaded with the following
146161
command :
147-
`git clone -b v1.0 git://people.freedesktop.org/~gabbayo/linux.git`
162+
`git clone -b v1.2 git://people.freedesktop.org/~gabbayo/linux.git`
148163

149164
* The kernel config file used to create the debian packages is located at:
150-
http://people.freedesktop.org/~gabbayo/kfd-v1.0/config-3.17.2-031450-generic
165+
http://people.freedesktop.org/~gabbayo/kfd-v1.2/config-3.19.0-031950-generic
151166

152167
* Source code used to build the libhsakmt library can be downloaded with the
153168
following command :
154-
`git clone -b v1.0 git://people.freedesktop.org/~gabbayo/libhsakmt`
169+
`git clone -b v1.2 git://people.freedesktop.org/~gabbayo/libhsakmt`
155170

156171
* For Ubuntu, the kernel images were built using Ubuntu mainline kernel
157172
PPA patches, which can be downloaded with the following command :
158-
`wget http://people.freedesktop.org/~gabbayo/kfd-v1.0/0001-base-packaging.patch ; wget http://people.freedesktop.org/~gabbayo/kfd-v1.0/0002-debian-changelog.patch ; wget http://people.freedesktop.org/~gabbayo/kfd-v1.0/0003-configs-based-on-Ubuntu-3.17.0-0.0.patch ; wget http://people.freedesktop.org/~gabbayo/kfd-v1.0/0004-kfd-changelog.patch`
173+
`wget http://people.freedesktop.org/~gabbayo/kfd-v1.2/0001-base-packaging.patch ; wget http://people.freedesktop.org/~gabbayo/kfd-v1.2/0002-debian-changelog.patch ; wget http://people.freedesktop.org/~gabbayo/kfd-v1.2/0003-configs-based-on-Ubuntu-3.19.0-3.3.patch ; wget http://people.freedesktop.org/~gabbayo/kfd-v1.2/0004-kfd-changelog.patch`
159174

160175
* Use the instructions in the following wiki page to built the Ubuntu kernel images:
161176
https://help.ubuntu.com/community/Kernel/Compile
162177

163178
* For Fedora, the kernel images were built using Fedora kernel srpm,
164179
which can be downloaded with the following command :
165-
`wget http://people.freedesktop.org/~gabbayo/kfd-v1.0/kernel-3.17.2-300.amdkfd.fc21.src.rpm`
180+
`wget http://people.freedesktop.org/~gabbayo/kfd-v1.2/kernel-3.19.0-1.amdkfd.fc21.src.rpm`
166181

167182
* Use the instructions in the following wiki page to built the Fedora kernel images:
168183
https://fedoraproject.org/wiki/Building_a_custom_kernel
169184

170185
#####Obtaining firmware binary files
171186

172187
* Firmware binary files for kaveri can be downloaded with the following command :
173-
`wget http://people.freedesktop.org/~gabbayo/kfd-v1.0/radeon_ucode.tar.gz`
188+
`wget http://people.freedesktop.org/~gabbayo/kfd-v1.2/radeon_ucode.tar.gz`
174189

175190
###LICENSE
176191

0 commit comments

Comments
 (0)