ROCm 6.1.0+ - updates (#153)
* Package updates
* RHEL Updates
* Find LibDRM - Fix for rocm failure to install
* Fix dependencies
* Deps Updates
* Jenkins - Add make test to test phase
* Jenkins - Install amdgpu-dkms on CI
* Jenkins - Fix test
* Test - Release build
* Readme - Updates
[ROCm/rocdecode commit: fd27e268f0]
This commit is contained in:
Kiriti Gowda
GitHub
@@ -9,33 +9,32 @@ rocDecode is a high performance video decode SDK for AMD GPUs. rocDecode API let
|
||||
## Prerequisites
|
||||
|
||||
* Linux distribution
|
||||
* Ubuntu - `20.04` / `22.04`
|
||||
+ Ubuntu - `20.04` / `22.04`
|
||||
+ RHEL - `8` / `9`
|
||||
+ SLES - `15-SP4`
|
||||
|
||||
* [ROCm supported hardware](https://rocm.docs.amd.com/en/latest/release/gpu_os_support.html)
|
||||
|
||||
* Install [ROCm 5.5 or later](https://rocmdocs.amd.com/en/latest/deploy/linux/installer/install.html) with `--usecase=graphics,rocm --no-32`
|
||||
### To install package
|
||||
|
||||
* [ROCm 6.1.0 or later](https://rocm.docs.amd.com/projects/install-on-linux/en/latest/how-to/native-install/index.html) - Follow below steps from the installation via native package manager on ROCm installation documentation
|
||||
* Registering repositories
|
||||
* Register kernel-mode driver
|
||||
* Register ROCm packages
|
||||
* Install kernel driver
|
||||
|
||||
### To build from source
|
||||
|
||||
* Install [ROCm 5.6.1 or later](https://rocmdocs.amd.com/en/latest/deploy/linux/installer/install.html) with `--usecase=multimediasdk,rocm --no-32`
|
||||
|
||||
* CMake `3.5` or later
|
||||
|
||||
* libva-dev `2.7` or later
|
||||
**NOTE:** Ubuntu 22.04 - Install `libstdc++-12-dev`
|
||||
```shell
|
||||
sudo apt install libstdc++-12-dev
|
||||
```
|
||||
|
||||
```shell
|
||||
sudo apt install libva-dev
|
||||
```
|
||||
|
||||
* libdrm-dev `2.4` or later
|
||||
|
||||
```shell
|
||||
sudo apt install libdrm-dev
|
||||
```
|
||||
|
||||
* libstdc++-12-dev
|
||||
|
||||
```shell
|
||||
sudo apt install libstdc++-12-dev
|
||||
```
|
||||
|
||||
### Prerequisites setup script for Linux
|
||||
#### Prerequisites setup script for Linux
|
||||
For the convenience of the developer, we provide the setup script [rocDecode-setup.py](rocDecode-setup.py) which will install all the dependencies required by this project.
|
||||
|
||||
**Usage:**
|
||||
@@ -45,30 +44,43 @@ For the convenience of the developer, we provide the setup script [rocDecode-set
|
||||
```
|
||||
**NOTE:** This script only needs to be executed once.
|
||||
|
||||
## Build instructions
|
||||
## Build and Install instructions
|
||||
|
||||
Please follow the instructions below to build and install the rocDecode library.
|
||||
### Package install
|
||||
Install rocDecode runtime, development, and test packages. Runtime package - `rocdecode` only provides the rocdecode library `librocdecode.so`, development package `rocdecode-dev`/`rocdecode-devel` provides the library, header files, and samples. `rocdecode-test` package provides ctest to verify installation. Package install will auto install all dependencies.
|
||||
|
||||
* Install packages on `Ubuntu`
|
||||
```shell
|
||||
cd rocDecode
|
||||
mkdir build; cd build
|
||||
cmake ..
|
||||
make -j8
|
||||
sudo make install
|
||||
sudo apt install rocdecode rocdecode-dev rocdecode-test
|
||||
```
|
||||
|
||||
* Install packages on `RHEL` / `SLES`
|
||||
```shell
|
||||
sudo yum install rocdecode rocdecode-devel rocdecode-test
|
||||
```
|
||||
|
||||
* run tests - Requires `FFMPEG` install
|
||||
### Source build and install
|
||||
|
||||
```shell
|
||||
git clone https://github.com/ROCm/rocDecode.git
|
||||
cd rocDecode
|
||||
mkdir build && cd build
|
||||
cmake ../
|
||||
make -j8
|
||||
sudo make install
|
||||
```
|
||||
|
||||
* run tests - Requires `FFMPEG` dev install
|
||||
|
||||
```shell
|
||||
make test
|
||||
```
|
||||
|
||||
**NOTE:** run tests with verbose option `make test ARGS="-VV"`
|
||||
|
||||
* make package
|
||||
|
||||
```shell
|
||||
sudo make test package
|
||||
sudo make package
|
||||
```
|
||||
|
||||
## Verify Installation
|
||||
@@ -88,7 +100,7 @@ cmake /opt/rocm/share/rocdecode/samples/videoDecode/
|
||||
make -j8
|
||||
./videodecode -i /opt/rocm/share/rocdecode/video/AMD_driving_virtual_20-H265.mp4
|
||||
```
|
||||
**NOTE:** FFMPEG install required to run samples
|
||||
**NOTE:** FFMPEG dev install required to run samples
|
||||
|
||||
## Samples
|
||||
|
||||
@@ -98,9 +110,11 @@ The tool provides a few samples to decode videos [here](samples/). Please refer
|
||||
|
||||
* [FFMPEG](https://ffmpeg.org/about.html) - required to run sample applications & make test
|
||||
|
||||
* On `Ubuntu`
|
||||
```shell
|
||||
sudo apt install ffmpeg libavcodec-dev libavformat-dev libavutil-dev
|
||||
```
|
||||
* On `RHEL`/`SLES` - install ffmpeg development packages manually or use `rocDecode-setup.py` script
|
||||
|
||||
## Docker
|
||||
|
||||
@@ -111,7 +125,6 @@ Docker files to build rocDecode containers are available [here](docker/)
|
||||
Run the steps below to build documentation locally.
|
||||
|
||||
* Sphinx
|
||||
|
||||
```shell
|
||||
cd docs
|
||||
pip3 install -r sphinx/requirements.txt
|
||||
@@ -119,7 +132,6 @@ python3 -m sphinx -T -E -b html -d _build/doctrees -D language=en . _build/html
|
||||
```
|
||||
|
||||
* Doxygen
|
||||
|
||||
```shell
|
||||
doxygen .Doxyfile
|
||||
```
|
||||
@@ -128,10 +140,10 @@ doxygen .Doxyfile
|
||||
|
||||
* Linux distribution
|
||||
* Ubuntu - `20.04` / `22.04`
|
||||
* RHEL - `8` / `9`
|
||||
* SLES - `15-SP4`
|
||||
* ROCm:
|
||||
* rocm-core - `5.6.1.50601-93`
|
||||
* amdgpu-core - `1:5.6.50601-1649308`
|
||||
* libva-dev - `2.7.0-2` / `2.14.0-1`
|
||||
* libdrm-dev - `2.4.107` / `2.4.113`
|
||||
* FFMPEG - `4.2.7` / `4.4.2-0`
|
||||
* rocDecode Setup Script - `V1.3`
|
||||
* rocDecode Setup Script - `V1.4`
|
||||
|
||||
Reference in New Issue
Block a user