跳转到内容

安装 VisualApplets#

软件要求#

VisualApplets 以及一些附加软件需要安装在您用于开发 Applet 的 PC 上。这通常与您在图像处理应用中用作主机 PC 的 PC 不同。

Applet 开发所需的软件安装以及图像采集所需的安装

您需要在要用于 Applet 开发的 PC 上安装以下软件：

VisualApplets 程序本身（提供为 *.exe 安装程序文件）

  1. VisualApplets IDE 许可证（位于 USB 加密狗上）
  2. Xilinx Design Suite（ISE 或 Vivado），构建 Applet 所需
  3. C++ 编译器（编译 SDK 示例所需）
  4. Framegrabber SDK 软件

VisualApplets 的系统要求#

系统要求可能会因 VisualApplets 版本而异，因此请参阅 发行说明 获取具体的系统要求。

逐步安装 VisualApplets#

要安装 VisualApplets，您必须执行以下步骤（将在以下各节中介绍）：

  • 安装 VisualApplets 软件
  • 安装所需的 Xilinx 工具
  • 为在 Build 期间访问 Xilinx 工具配置 VisualApplets

请注意：若要安装 VisualApplets 软件：

  1. 运行 VisualApplets DVD 中自带的安装程序，或者双击程序图标执行 VisualApplets 安装文件 VAsetup3.x.exe。

    Select Setup Install Mode 对话框随即打开：

    Select Setup Install Mode 对话框

    • 如果您没有电脑的管理员权限，请选择 Install for me only。因此，您将无法选择 All users 或 选择附加任务 对话框（参见步骤 8），并且无法在以下目录下安装 VisualApplets： C:\Program Files.
    • 如果您拥有管理员权限，可以选择 Install for all users (recommended)。

  2. Select Setup Language 对话框随即打开：

    Select Setup Language 对话框

    选择安装向导所需的语言，并点击 OK 确认。

  3. Legal Disclaimer - Disclaimer for using OpenSSL 对话框随即打开。

    安装 - 使用 OpenSSL 的法律声明

    在此对话框中，您必须接受使用密码学软件（如 OpenSSL）的法律条款和条件，以启用 Basler 的版本控制工具。此工具将创建与 Basler 服务器的安全 SSL/TLS 连接。由于在某些国家/地区出口和使用密码学软件是非法的，因此在接受这些条款时，请确保您的行为不违反当地法律。如果您不确定，请点击 Decline。

    • 如果您选择 Accept 并点击 Next，您将可以使用更新功能，该功能允许您通过点击鼠标检查新版本的 VisualApplets（GUI：菜单 Help > Check for Updates），或者将 VisualApplets 配置为在每次程序启动时自动检查较新版本的 VisualApplets（GUI：菜单 Settings > System Settings > Common > Updates）。随后将下载两个 OpenSSL 库，用于打开与 Basler 服务器的安全 SSL/TLS 连接。

      信息

      要使用更新功能，请确保您具备：

      • 能正常工作的互联网连接
      • 适当的防火墙例外。

    安装 - 下载附加文件

    如果您接受使用 OpenSSL，安装程序会立即检查是否有比您即将安装的版本更新的版本可用。

    • 如果您已经在安装最新版本，您将收到一条相应的消息。点击 下一步 以继续。
      • 如果有较新的 VisualApplets 版本可用，您可以决定是否要
        • 切换到安装此较新版本（通过点击其中一个链接），或者
        • 继续安装您刚刚启动的安装程序版本（通过点击 Skip）。

    如果您决定安装较新版本，相应的安装程序将被自动下载并启动。

    • 如果您选择 Decline 并点击 Next，则不会启用 Basler 的版本控制工具。

  4. 将打开 License Agreement 对话框，其中包含 VisualApplets 最终用户许可协议 (EULA)。

    安装 - 包含 VisualApplets EULA 的许可协议

    要继续安装，您必须选择 I accept the agreement 并点击 Next。

  5. 将打开 Select Destination Location 对话框。

    安装 - 选择目标位置

    选择要安装 VisualApplets 的目录。

    单击下一步。

  6. 将打开 Select Components 对话框。根据预定义的安装配置文件选择安装组件：

    安装 - 选择组件

    • 您只需使用 Full installation 配置文件即可。
    • 如果您想减少安装体积：
      1. 选择 Custom installation 配置文件。
      2. 在 Hardware platform 下，取消勾选您不打算为其编写 Applet 的所有平台的支持。
      3. 在 Target operating systems for applets 下，取消勾选您确定绝不会在您为其编写 Applet 的图像处理系统的宿主机 PC 上使用的所有操作系统（Windows 32bit、Windows 64bit、Linux 32bit 或 Linux 64bit）。

    安装 - 选择组件：目标操作系统

    信息

    LightBridge 2 是一款通过 Thunderbolt 认证的产品。此认证仅适用于 Windows 操作系统。尽管如此，由于 kernel.org 的最新内核已提供对 Thunderbolt 的支持，Lightbridge 2 也许能在 Linux 环境下运行。由于目前不提供对 Linux 的支持，因此需自行承担风险。

    信息

    必须安装 Microsoft Visual Studio Redistribution Package。如果您想接收 Microsoft Visual Studio Redistribution Package 的自动更新，请在 Windows 设置的 Windows > Settings > Update & Security > Windows Update > Advanced options 下激活 Receive update for other Microsoft products when you update Windows 选项。

  7. 将打开 Select Start Menu Folder 对话框。在 Start Menu 文件夹中为该组定义一个名称：

    安装 - 选择“开始”菜单文件夹

    单击下一步。

  8. 将打开 Select Additional Tasks 对话框。选择其他安装选项：

    安装 - 选择附加任务

    选项：

    • All users/Current user：根据 Windows 系统用户帐户，文件 VisualApplets.ini 将写入相应的 Windows 文件夹 All Users 或 Current User。All users 选项仅在您于安装对话框 Select Setup Install Mode 中选择了选项 Install for all users (recommended) 时可用（参见第 1 步）。
    • Portable：所有程序和配置数据都将写入 VisualApplets 安装文件夹。
    • 如果您想在桌面上创建 VisualApplets 图标，请勾选复选框 Create a desktop shortcut。

  9. 点击 Next 确认。系统将列出您的完整安装配置文件：

    安装程序 - 准备安装

    • 如果要编辑列表，请使用 Back 按钮在相应的对话框窗口中更改设置。
    • 要开始安装，请点击 Install 按钮。进度条显示当前安装的状态：

    安装程序 - 正在安装

    当出现以下屏幕时，表示安装已完成：

    完成 VisualApplets 安装向导

  10. 点击 Finish。

安装 Xilinx 工具链#

在构建您在 VisualApplets 中创建的设计（即为您的设备创建硬件 applet）之前，您需要安装 Xilinx ISE 或 Xilinx Vivado 工具链。

您需要哪个工具以及哪个工具版本（以及相应的许可证是否免费）取决于您正在为其进行开发的的目标采集卡。

此外，在大多数情况下，提供 30 天的评估许可证。

下表列出了所有 Basler 目标硬件以及所需的 Xilinx ISE 和/或 Vivado 许可证。

从 Vivado Design Suite 2026.1 开始，AMD 提供了多个许可层级（Basic、Core、PRO、Enterprise 和 Gold）。对于 imaFlex CXP-12 Quad、imaFlex CXP-12 Penta 和 imaFlex 2 Dual 100，您至少需要 Vivado Design Suite 的 Core 层级。同时也支持更高层级（PRO、Enterprise 或 Gold）。免费的 Basic 层级则无法满足要求。有关可用许可层级的概述，请参见 AMD Vivado Licensing Options。

为了针对 mE5 marathon 采集卡构建设计，Basler 强烈建议使用 Xilinx Vivado。使用 Xilinx Vivado，构建过程会快得多，并且可以将更复杂的设计适配到 FPGA 上。

信息

请确保将 Xilinx 工具链安装在目录结构中不包含任何空格的目录中，例如直接安装在 C:\Xilinx。请 不 在以下位置安装 Xilinx： C:\Program Files\Xilinx.

哪个采集卡平台应使用哪个 Xilinx 工具链和版本？#

Basler 采集卡型号 WebPack / Vivado Design Suite（免费许可证） ISE Design Suite Logic Edition
(购买版ab)		 Vivado Design Suite
(购买版a)
mE5 marathon VCX-QP ISE 14.7 版本，
Vivado 2016.1 至 2020.1 之间的版本，或 2021.2 至 2023.2 之间的版本cdef		 版本 14.7 2016.1 至 2020.1 之间的版本，或 2021.2 至 2023.2 之间的版本cdef
mE5 marathon VCL ISE 14.7 版本，
Vivado 2016.1 至 2020.1 之间的版本，或 2021.2 至 2023.2 之间的版本cdef		 版本 14.7 2016.1 至 2020.1 之间的版本，或 2021.2 至 2023.2 之间的版本cdef
mE5 marathon VCLx 2016.1 至 2020.1 之间的版本，或 2021.2 至 2023.2 之间的版本cdef
imaFlex CXP-12 Quad 不支持 ISE
2023.2 至 2024.2 之间的 Vivado 版本def		 2023.2 至 2024.2 之间的版本，或者 2026.1 及更高版本（自 2026.1 起：Core 层级或更高）defg
imaFlex CXP-12 Penta 不支持 ISE
2023.2 至 2024.2 之间的 Vivado 版本def		 2023.2 至 2024.2 之间的版本，或者 2026.1 及更高版本（自 2026.1 起：Core 层级或更高）defg
imaFlex 2 Dual 100 不支持 ISE
不支持免费的 Vivado Design Suite 许可证		 2025.2 或更高版本（自 2026.1 起：Core 层级或更高）g

  1. 提供为期 30 天的免费评估许可证。 ↩↩

  2. Xilinx ISE 官方不支持 Windows 11。如果您的平台需要使用 Xilinx ISE 进行构建，请在 Windows 10 操作系统上安装 VisualApplets。在此论坛讨论中，您可以找到一些在 Windows 11 下安装 ISE 的变通方法，尽管官方并不支持此操作。 ↩

  3. 无法使用 Vivado 2020.2 到 2021.1 之间的版本构建适用于 microEnable 5 marathon VCL 和 microEnable 5 marathon VCLx 平台的 Applet；请参阅 VisualApplets Release 3.7.0 已知问题中 Xilinx 部分的工单 ID 217879 条目。 ↩↩↩↩↩

  4. Vivado 2024.1 版本可能会导致 VisualApplets 3.4.0 或更低版本发生冻结。该问题已在 VisualApplets 3.4.1 版本中修复。然而，经测试此版本的 VisualApplets 与 Vivado 2023.2 配合工作效果最佳，因此 Basler 不建议使用更高版本的 Vivado。另请参阅 VisualApplets 3.4.0 已知问题和VisualApplets 3.4.1 的更改和修复。 ↩↩↩↩↩↩↩↩↩

  5. Vivado 2024.2 版本可能会导致 VisualApplets 3.5.0 或更低版本发生崩溃。该问题已在 VisualApplets 3.5.1 版本中修复。然而，经测试此版本的 VisualApplets 与 Vivado 2023.2 配合工作效果最佳，因此 Basler 不建议使用更高版本的 Vivado。另请参阅 VisualApplets 3.5.0 已知问题和VisualApplets 3.5.1 的更改和修复。 ↩↩↩↩↩↩↩↩↩

  6. VisualApplets 禁止使用 Vivado 2025.1 和 2025.2 为 CXP-12 平台构建设计，因为使用这些版本构建的设计无法正常工作。另请参见 Changes and Fixed Issues in VisualApplets 3.8.0。 ↩↩↩↩↩↩↩↩↩

  7. 从 Vivado Design Suite 2026.1 开始，AMD 提供了多个许可层级。对于 imaFlex CXP-12 Quad、imaFlex CXP-12 Penta 和 imaFlex 2 Dual 100，您至少需要 Vivado Design Suite 的 Core 层级。同时也支持更高层级（PRO、Enterprise 或 Gold）。免费的 Basic 层级则无法满足要求。请参见 AMD Vivado Licensing Options。 ↩↩↩

下载 Xilinx 工具链#

选择要安装的软件包，并从 Xilinx 网站下载。

获取 Xilinx 工具链许可证#

30 天评估许可证#

您可以从 Xilinx Licensing Solution Center 获取 30 天的评估许可证。

WebPack（Vivado 2025.2 及更早版本）#

WebPack 是针对 Vivado 2025.2 及更早版本的免费许可证。大多数采集卡的 Applet 可以使用 WebPack 许可证进行构建（请参见 Which Xilinx Toolchain and Version for Which Frame Grabber Platform?）。

已购许可证#

您可以按照 Xilinx Licensing Solution Center 上的说明获取已购产品的许可证。

从 Vivado Design Suite 2026.1 开始，AMD 提供了多个付费许可层级（Core、PRO、Enterprise 和 Gold）。对于 imaFlex CXP-12 Quad、imaFlex CXP-12 Penta 和 imaFlex 2 Dual 100，您至少需要 Vivado Design Suite 的 Core 层级。同时也支持更高层级。有关可用许可层级的概述，请参见 AMD Vivado Licensing Options。

信息

Xilinx ISE Design Suite 是 Xilinx Vivado Design Suite 的前身。ISE 由 Xilinx 与 Vivado 一起分发，因此如果您购买了 Vivado Design Suite 许可证，也会自动获得 ISE 的许可。

生成并注册许可证#

若要使用 Xilinx 工具链，您必须在 Xilinx Licensing Solution Center 上生成并注册您的许可证。Xilinx 提供了有关生成许可证密钥和安装许可证的说明：

在 VisualApplets 中将 Xilinx 工具链配置为构建工具的生成设置#

在使用 Xilinx 工具链构建第一个 Applet 之前，您应配置 VisualApplets Build Settings，以便按需调用工具。有关设置构建设置的说明，请参见 VisualApplets User's Guide。

安装 Framegrabber SDK#

为了运行 VisualApplets，必须在宿主机 PC 上安装 Framegrabber SDK。

使用 VisualApplets 所需的最小 Framegrabber SDK 版本：imaFlex 平台为 5.11.1 版，所有其他平台为 5.9 版。

信息

Basler 建议您在开始安装当前版本之前，卸载 PC 上的所有 Framegrabber SDK 安装。

有关安装 Basler Framegrabber SDK 的说明，请参见 Installing the Framegrabber SDK。

安装许可证#

有关安装 VisualApplets 许可证的说明，请参见 VisualApplets Licensing。