LINUX 用 Zivid + HALCON をインストールする

Zivid は HALCON と連携するための 2 つの方法を提供しています。

Zivid SDK を通じて、HALCON で利用可能な C++/C# ライブラリを活用します。 C++ と C# 両方のサンプルを提供しています。（推奨）
Zivid Software に付属する GenICam GenTL プロデューサーを介して直接行います。

2 番目のオプションを選択する場合は、以下の手順に従ってください。推奨オプションを開始するには、お好みのプログラミング言語のサンプルを参照してください。

Zivid SDK をインストールする

このページソフトウェアのインストールの手順に従って、Zivid SDK をインストールしてください。推奨されているすべてのパッケージをインストールすると、GenICamTL もインストールされます。

GenICamTL パッケージのインストール

GenICamTL パッケージ以外のすべての Zivid パッケージをインストール済みの場合、以下の手順に従ってください。

まず、キーボードの Ctrl + Alt + T キーを押してターミナルウィンドウを開きます。
まだ作成していない場合は、一時フォルダーを作成し、そのフォルダーに移動します。
mkdir Zivid && cd Zivid

GenICamTL パッケージをダウンロードしてインストールしてください。

Ubuntu 26.04
wget https://downloads.zivid.com/sdk/releases/2.18.0+1b44dbef-1/u26/amd64/zivid-genicam_2.18.0+1b44dbef-1_amd64.deb
sudo apt install ./zivid-genicam_2.18.0+1b44dbef-1_amd64.deb
Ubuntu 24.04
wget https://downloads.zivid.com/sdk/releases/2.18.0+1b44dbef-1/u24/amd64/zivid-genicam_2.18.0+1b44dbef-1_amd64.deb
sudo apt install ./zivid-genicam_2.18.0+1b44dbef-1_amd64.deb
Ubuntu 22.04
wget https://downloads.zivid.com/sdk/releases/2.18.0+1b44dbef-1/u22/amd64/zivid-genicam_2.18.0+1b44dbef-1_amd64.deb
sudo apt install ./zivid-genicam_2.18.0+1b44dbef-1_amd64.deb
Ubuntu 20.04
wget https://downloads.zivid.com/sdk/releases/2.18.0+1b44dbef-1/u20/amd64/zivid-genicam_2.18.0+1b44dbef-1_amd64.deb
sudo apt install ./zivid-genicam_2.18.0+1b44dbef-1_amd64.deb
Ubuntu 18.04

注釈

Ubuntu 18.04 のサポートは SDK 2.10 以降削除されました。以前の SDK バージョンの Ubuntu 18.04 の手順を確認するには、左上隅にあるナレッジベースのバージョンを変更します。

Jetson
注釈

JetPack を使用している場合、使用する JetPack SDK のバージョンによって、インストールする Zivid deb パッケージが決まります。

Zivid SDK

Jetson

Ubuntu [1]

Min. Jetson Linux

Min. JetPack SDK

2.12 - 2.17

Orin

20.04

35.4.1 - 35.6.4

5.1.2 - 5.1.6

2.18 & later

Orin

22.04

36.3 & later

6.0 & later

2.18 & later

Orin and Thor

24.04

39.2 & later

7.2 & later

[1]
Ubuntu version that the major Jetson Linux version is based on, e.g. Nvidia Jetson Linux 35 is based on Ubuntu 20.04.
Ubuntu 24.04
wget https://downloads.zivid.com/sdk/releases/2.18.0+1b44dbef-1/u24/arm64/zivid-genicam_2.18.0+1b44dbef-1_arm64.deb
sudo apt install ./zivid-genicam_2.18.0+1b44dbef-1_arm64.deb
Ubuntu 22.04
wget https://downloads.zivid.com/sdk/releases/2.18.0+1b44dbef-1/u22/arm64/zivid-genicam_2.18.0+1b44dbef-1_arm64.deb
sudo apt install ./zivid-genicam_2.18.0+1b44dbef-1_arm64.deb
Ubuntu 20.04

注釈

Support for Ubuntu 20.04 is removed since SDK 2.18. To see Ubuntu 20.04 instructions for an earlier SDK version, change the Knowledge Base version in the top left corner.
注意

GenICam/HALCON のサポートは試験段階です。

セットアップを有効にするには、Linux でログアウトして再度ログインするか、次のように入力する必要があります。

source /etc/profile.d/zivid-genicam-gentl.sh

HALCON をインストールする

Visit MVTec download page and under Product choose HALCON. Choose an appropriate version and select Linux as operating system. Download and install HALCON according to their documentation. We recommend that you use a HALCON version that has been tested by Zivid.

HALCON をインストールする際は、GenICamTL パッケージ（GenTL Consumer）も必ずインストールしてください。

環境変数を設定する

Zivid と HALCON のインストール後、HALCON が動作するために次の環境変数を設定または変更する必要があります。HALCON のインストールガイドに従って環境を設定してください。HALCON 21.05 の例は次のとおりです。

環境変数を調整するには、ログインスクリプトまたはシェルリソーススクリプト（cshrc、profile、または bashrc など）で変数を設定する必要があります。次のサンプルシェルスクリプトをファイルの下部に貼り付けます。

# Sample shell script for HALCON environment settings
# (sh syntax)
# If you are using the Bourne shell source this file with the following
# command:
# source .profile_halcon
HALCONARCH=x64-linux; export HALCONARCH
HALCONROOT="/opt/halcon"; export HALCONROOT
HALCONEXAMPLES=${HALCONROOT}/examples; export HALCONEXAMPLES
HALCONIMAGES=${HALCONROOT}/examples/images; export HALCONIMAGES
PATH=${HALCONROOT}/bin/${HALCONARCH}:${PATH}; export PATH
if [ ${LD_LIBRARY_PATH} ] ; then
    LD_LIBRARY_PATH=${HALCONROOT}/lib/${HALCONARCH}:${LD_LIBRARY_PATH}; export LD_LIBRARY_PATH
else
    LD_LIBRARY_PATH=${HALCONROOT}/lib/${HALCONARCH}; export LD_LIBRARY_PATH
fi

その後、 LD_LIBRARY_PATH が正しく設定されていることを確認します。

echo $LD_LIBRARY_PATH

始めましょう！

これで HALCON サンプルを試す準備ができました！HALCON を起動するには、ターミナルウィンドウを開いて、次のコマンドを実行します。

hdevelop&

バージョン履歴

SDK	変更点
2.18.0	Added support for Ubuntu 26.04. Dropped support for Ubuntu 20.04 on Jetson.
2.15.0	Jetson のインストール手順を追加しました。