跳转到内容

安装 VisualApplets#

软件要求#

您需要在用于开发 applet 的 PC 上安装 VisualApplets 以及一些附加软件。这通常与用作图像处理应用程序中主机的 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 版本而异，因此请参阅 Release Notes 获取具体的系统要求。

逐步安装 VisualApplets#

要安装 VisualApplets，您必须执行以下步骤（在以下各节中有详细说明）：

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

请注意：要安装 VisualApplets 软件：

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

    将打开 Select Setup Install Mode 对话框：

    Select Setup Install Mode 对话框

    • 如果您在电脑上没有管理员权限，请选择 Install for me only。因此，您将无法选择 All users 表格中显示 Select Additional Tasks 对话框（见步骤 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 对话框随即打开。

    设置 - Legal Disclaimer for using OpenSSL

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

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

      信息

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

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

    设置 - Downloading Additional Files

    如果您接受使用 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 对话框随即打开。请选择其他安装选项：

    安装程序 - 选择附加任务

    选项：

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

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

    安装程序 - 准备安装

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

    安装程序 - 正在安装

    安装完成后，会出现以下屏幕：

    正在完成 VisualApplets 安装向导

  10. 点击 Finish。

安装 Xilinx 工具链#

在你能够构建你在……中创建的设计之前VisualApplets也就是说，在为设备创建硬件小程序之前，需要先安装…… Xilinx ISE 或Xilinx Vivado 工具链。

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

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

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

mE5 的建筑设计marathon Basler强烈建议使用帧采集卡。 Xilinx Vivado。使用Xilinx 使用 Vivado，构建过程速度更快，FPGA 可以适应更复杂的设计。

信息

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

哪种采集卡平台应配哪种 Xilinx 工具链和版本？#

Basler 采集卡型号 WebPack / Vivado ML Standard（免费许可证） ISE Design Suite Logic Edition
（购买版ab）		 Vivado Design Suite
（购买版a）
mE5 marathon VCX-QP ISE 14.7 版本、
2016.1 至 2020.1 之间的 Vivado 版本，或 2021.2 至 2023.2 之间的版本cdef		 14.7 版本 2016.1 至 2020.1 之间的版本，或 2021.2 至 2023.2 之间的版本cdef
mE5 marathon VCL ISE 14.7 版本、
2016.1 至 2020.1 之间的 Vivado 版本，或 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 及更高版本def
imaFlex CXP-12 Penta 不支持 ISE
2023.2 至 2024.2 之间的 Vivado 版本def		 2023.2 至 2024.2 之间的版本，或 2026.1 及更高版本def
imaFlex 2 Dual 100 不支持 ISE
不支持 Vivado ML Standard		 版本 2025.2 或更高版本

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

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

  3. 无法使用 2020.2 到 2021.1 之间的 Vivado 版本构建适用于 microEnable 5 marathon VCL 和 microEnable 5 marathon VCLx 平台的 applet；请参见 Known Issues 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。另请参见 Known Issues VisualApplets 3.4.0 和 Changes and Fixes VisualApplets 3.4.1。 ↩↩↩↩↩↩↩↩↩

  5. Vivado 2024.2 版本可能会导致 VisualApplets 3.5.0 或更低版本崩溃。该问题已在 VisualApplets 3.5.1 中得到修复。然而，经测试此版本的 VisualApplets 与 Vivado 2023.2 配合使用效果最佳，因此 Basler 不建议使用更高版本的 Vivado。另请参见 Known Issues VisualApplets 3.5.0 和 Changes and Fixes VisualApplets 3.5.1。 ↩↩↩↩↩↩↩↩↩

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

下载 Xilinx 工具链#

选择您要安装的软件包并从 Xilinx website 进行下载。

正在下载 Xilinx

获取 Xilinx 工具链许可证#

30 天评估许可证#

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

WebPack#

WebPack 是一项免费许可证。大多数采集卡的 applet 都可以使用 WebPack 许可证进行构建（参见 Which Xilinx Toolchain and Version for Which Frame Grabber Platform?）。

已购许可证#

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

信息

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

生成和注册许可证#

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

在 VisualApplets 中将 Xilinx 工具链配置为构建工具的 Build Settings#

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

安装 Framegrabber SDK#

必须在主机 PC 上安装 Framegrabber SDK 才能运行 VisualApplets。

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

信息

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

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

安装许可证#

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