Install Zivid + HALCON for Linux

Zivid 提供两种与 HALCON 接口的方式：

通过 Zivid SDK，利用 HALCON 提供的 C++/C# 库。我们同时提供 C++ 和 C# 。（推荐）
直接使用 Zivid 软件附带的 GenICam GenTL producer 。

要选择第二种方案，请按照以下步骤操作。要开始使用推荐方案，请按照您首选编程语言的示例进行操作。

安装 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

备注

自 SDK 2.10 起，移除了对 Ubuntu 18.04 的支持。如需查看早期 SDK 版本的 Ubuntu 18.04 说明，请更改左上角的知识库版本。
Jetson
备注

如果您使用 JetPack，则您使用的 JetPack SDK 版本决定了需要安装哪些 Zivid deb 包。

Zivid SDK

Jetson

Ubuntu [1]

最低 Jetson Linux 版本

最低 JetPack SDK 版本

2.12 - 2.17

Orin

20.04

35.4.1 - 35.6.4

5.1.2 - 5.1.6

2.18 及更高版本

Orin

22.04

36.3 及更高版本

6.0 及更高版本

2.18 及更高版本

Orin 和 Thor

24.04

39.2 及更高版本

7.2 及更高版本

[1]
主要 Jetson Linux 版本所基于的 Ubuntu 版本，例如 Nvidia Jetson Linux 35 基于 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

备注

自 SDK 2.18 起，移除了对 Ubuntu 20.04 的支持。如需查看早期 SDK 版本的 Ubuntu 20.04 说明，请更改左上角的知识库版本。
小心

对 GenICam/HALCON 的支持尚处于实验阶段。

为了使设置生效，您必须注销并重新登录 linux 或键入：

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

安装 HALCON

访问 MVTec download page 并登录以下载 MVTec Software Manager。使用 Software Manager 选择 HALCON，选择一个版本，并为 Linux 安装。我们建议您使用经过 Zivid 测试的 HALCON 版本。

重要

在 Software Manager 中选择 GenICamTL 图像采集包（GenTL Consumer）。该包是可选的，安装较新的 HALCON 版本并不会将其从旧版本中带过来。如果没有它，HALCON 只能检测到 File 和 DirectFile 接口，Zivid 相机将保持隐藏状态。请参阅仅检测到 File 和 DirectFile 接口。

设置环境变量

安装 Zivid 和 HALCON 后，必须设置或修改以下环境变量才能使 HALCON 正常工作。应根据 HALCON 的安装指南来设置环境。下面是 HALCON 21.05 的示例。

调整环境变量时，您应该在一个 login 脚本或 shell 资源脚本中设置变量，例如，cshrc、profile 或 bashrc。将以下 shell 脚本示例粘贴到文件底部：

# 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	添加了对 Ubuntu 26.04 的支持。移除了 Jetson 上对 Ubuntu 20.04 的支持。
2.15.0	添加了 Jetson 的安装说明。