Install OpenCL Drivers on Ubuntu

To install the OpenCL driver on Ubuntu, select your GPU vendor below and run the listed commands for your Ubuntu version.

Intel

  1. 키보드에서 Ctrl + Alt + T 키를 눌러 터미널 창을 열고 OpenCL 드라이버를 설치합니다.

    Ubuntu 26.04
    sudo apt update
sudo apt install intel-opencl-icd
    Ubuntu 24.04
    sudo apt update
sudo apt install intel-opencl-icd
    Ubuntu 22.04
    sudo apt update
sudo apt install intel-opencl-icd
    Ubuntu 20.04
    sudo apt update
sudo apt install intel-opencl-icd
    Ubuntu 18.04

    참고

    SDK 2.10부터 Ubuntu 18.04에 대한 지원이 종료되었습니다. 이전 SDK 버전에 대한 Ubuntu 18.04 지침을 보려면 왼쪽 상단 모서리에서 기술 자료 버전을 변경하십시오.

  2. Zivid Studio 를 열고 OpenCL 오류가 발생하지 않는지 확인하세요.

참고

If you get OpenCL errors, add your user to group Video.

NVIDIA

  1. 시스템에 NVIDIA GPU 드라이버 PPA를 추가합니다:

    키보드에서 Ctrl + Alt + T 키를 눌러 터미널 창을 엽니다.

    graphics-driver PPA를 추가합니다.

    sudo add-apt-repository ppa:graphics-drivers/ppa

    Adding the PPA prints the current long-lived branch release driver package name, e.g. nvidia-xxx.

    ../../../../_images/long-lived-branch-release-nvidia.png

  2. 시스템에 최신 최신 드라이버를 설치합니다:

    Ubuntu 26.04
    sudo apt update
sudo apt install nvidia-driver-xxx
    Ubuntu 24.04
    sudo apt update
sudo apt install nvidia-driver-xxx
    Ubuntu 22.04
    sudo apt update
sudo apt install nvidia-driver-xxx
    Ubuntu 20.04
    sudo apt update
sudo apt install nvidia-driver-xxx
    Ubuntu 18.04

    참고

    SDK 2.10부터 Ubuntu 18.04에 대한 지원이 종료되었습니다. 이전 SDK 버전에 대한 Ubuntu 18.04 지침을 보려면 왼쪽 상단 모서리에서 기술 자료 버전을 변경하십시오.

    드라이버를 설치한 후 시스템을 다시 시작합니다.

    sudo reboot

  3. Zivid Studio 를 열고 OpenCL 오류가 발생하지 않는지 확인하세요.

참고

If you get OpenCL errors, add your user to group Video.

AMD

경고

Support for using AMD compute devices/GPUs is removed due to low usage and OpenCL stability issues in the drivers. It is possible to opt in to run the SDK with an unsupported compute device, by enabling an option in the Config.yml file. However, such a setup can give unexpected results and errors, and is not tested by Zivid.

경고

Radeon은 일부 GPU에서 더 이상 SPIR을 지원하지 않습니다. GPU 드라이버가 Zivid 소프트웨어와 호환되도록 SPIR을 지원하는지 확인하십시오.

  1. Linux용의 알맞은 Radeon 소프트웨어를 다운로드하고 압축을 풉니다.

    키보드에서 Ctrl + Alt + T 키를 눌러 터미널 창을 엽니다.

    임시 폴더를 만들고 해당 폴더로 이동합니다.

    mkdir amd
cd amd
    Ubuntu 22.04

    AMD’s own release-notes page for this driver is no longer available. In the following instructions we will use a version that we have tested and that works. At the time of writing this is version 22.20.3. AMD has a /latest path, but this still points to 22.20, which is broken.

    wget --referer http://support.amd.com http://repo.radeon.com/amdgpu-install/22.20.3/ubuntu/jammy/amdgpu-install_22.20.50203-1_all.deb

    apt 를 사용하여 이 패키지를 설치합니다:

    sudo apt install ./amdgpu-install_22.20.50203-1_all.deb
sudo apt update
    Ubuntu 20.04

    Linux 커널 버전을 확인하십시오:

    uname -r
    Kernel 5.4

    Linux Kernel 버전 5.4(Ubuntu LTS)의 경우 Ubuntu 20.04용 Radeon Software 20.45를 다운로드하십시오.

    wget --referer http://support.amd.com https://drivers.amd.com/drivers/linux/amdgpu-pro-20.45-1188099-ubuntu-20.04.tar.xz

    내용을 추출합니다.

    tar -Jxvf amdgpu-pro-20.45-1188099-ubuntu-20.04.tar.xz
cd amdgpu-pro-20.45-1188099-ubuntu-20.04
    Kernel 5.8

    Linux Kernel 버전 5.8(Ubuntu LTS HWE 스택)의 경우 Linux 20.04용 Radeon Software 20.50을 다운로드하십시오.

    wget --referer http://support.amd.com https://drivers.amd.com/drivers/linux/amdgpu-pro-20.50-1234664-ubuntu-20.04.tar.xz

    내용을 추출합니다.

    tar -Jxvf amdgpu-pro-20.50-1234664-ubuntu-20.04.tar.xz
cd amdgpu-pro-20.50-1234664-ubuntu-20.04
    Ubuntu 18.04

    참고

    SDK 2.10부터 Ubuntu 18.04에 대한 지원이 종료되었습니다. 이전 SDK 버전에 대한 Ubuntu 18.04 지침을 보려면 왼쪽 상단 모서리에서 기술 자료 버전을 변경하십시오.

  2. graphics stack을 설치합니다.

    Ubuntu 22.04

    AMDs own instructions

    amdgpu-install --usecase=graphics,opencl --no-32 --no-dkms

    참고

    Secure Boot 이 필요한 경우 DKMS(위 command에서 --no-dkms 을 제거)를 포함해야 할 수 있습니다. 자세한 내용은 secure-boot-support 을 참조하십시오.

    이제 사용자를 render 그룹과 video 그룹의 구성원으로 추가합니다.

    sudo gpasswd -a $USER render
sudo gpasswd -a $USER video

    You may have to reboot for the changes to take effect.

    sudo reboot

    You can now try to open ZividStudio. If it fails then follow the next steps.

    ZividStudio
    Ubuntu 20.04

    AMDs own instructions .

    ./amdgpu-pro-install --opencl=pal

  3. Configure Secure Boot 단계를 따르십시오(메시지가 표시되는 경우).

    ../../../../_images/secure_boot_1.png
    ../../../../_images/secure_boot_2.png
    ../../../../_images/secure_boot_3.png

    부팅이 안될시 System Boot Error After AMD OpenCL Drivers Installation 를 참조하십시오.

  4. Zivid Studio 를 열고 OpenCL 오류가 발생하지 않는지 확인하세요.

참고

OpenCL 오류가 발생하는 경우 add your user to group Video 를 실행해야 할 수도 있습니다.