安裝 VisualApplets

Software Requirements

您需要在用於開發 applet 的電腦上安裝 VisualApplets 以及一些額外的軟體。這通常與您在影像處理應用程式中作為主機 PC 使用的電腦不同。

您需要在想要用於開發 applet 的電腦上安裝以下軟體：

實際的 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 對話方塊：

   

   • 如果您沒有電腦的管理員權限，請選取 Install for me only因此，您將無法使用 All users 資料夾內的 選取其他工作 對話方塊（請參閱步驟 8），且您無法在以下路徑安裝 VisualApplets： C:\Program Files.
   • 如果您擁有管理員權限，可以選取 Install for all users (recommended)。

2. 將開啟 Select Setup Language 對話方塊：

   

   選取安裝精靈所需的語言，然後按一下 OK 確認。

3. 將開啟 Legal Disclaimer - 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 安全連線。

     資訊

     若要使用更新功能，請確保您具備：

     • 運作正常的網際網路連線
     • 適當的防火牆例外設定。

   

   如果您接受使用 OpenSSL，安裝程式會立即檢查是否有比您即將安裝的版本更新的版本可供使用。

   • 如果您已經在安裝最新版本，將會收到相應的訊息。按一下 下一頁 以繼續。
     • 如果有較新版本的 VisualApplets 可用，您可以決定是否要
       • 切換為安裝此較新版本（透過按一下其中一個連結），或
       • 繼續安裝您剛才啟動的安裝程式版本（透過按一下 Skip）。

   如果您決定安裝較新版本，將會自動下載並啟動相應的安裝程式。

   • 如果您選取 Decline 並按一下 Next，將不會啟用 Basler 的版本控制工具。

4. License Agreement 對話方塊隨即開啟，其中包含 VisualApplets 使用者授權合約 (EULA)。

   

   若要繼續安裝，您必須選取 I accept the agreement 並按一下 Next。

5. Select Destination Location 對話方塊隨即開啟。

   

   選取您要安裝 VisualApplets 的目錄。

   按一下 Next。

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 資料夾中為群組定義名稱：

   

   按一下 Next。

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 按鈕。進度列會顯示目前的安裝狀態：

   

   當出現以下畫面時，表示安裝已完成：

   

10. 按一下 Finish。

安裝 Xilinx Toolchain

在您建構 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.2cdef	14.7 版	版本 2016.1 至 2020.1，或版本 2021.2 至 2023.2cdef
mE5 marathon VCL	ISE 版本 14.7、 Vivado 版本 2016.1 至 2020.1，或版本 2021.2 至 2023.2cdef	14.7 版	版本 2016.1 至 2020.1，或版本 2021.2 至 2023.2cdef
mE5 marathon VCLx			版本 2016.1 至 2020.1，或版本 2021.2 至 2023.2cdef
imaFlex CXP-12 Quad	不支援 ISE Vivado 版本 2023.2 至 2024.2def		2023.2 至 2024.2 之間的版本，或 2026.1 及更新版本（自 2026.1 起：Core 等級或更高）defg
imaFlex CXP-12 Penta	不支援 ISE Vivado 版本 2023.2 至 2024.2def		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；請參閱 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。↩↩↩↩↩↩↩↩↩

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 Toolchain

選取您要安裝的套件，並從 Xilinx 網站加以下載。

取得 Xilinx Toolchain 的授權

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 與 Vivado 由 Xilinx 一同發布，因此若您購買了 Vivado Design Suite 授權，也會自動獲得 ISE 授權。

產生與註冊授權

若要使用 Xilinx 工具鏈，您必須在 Xilinx Licensing Solution Center 上產生並註冊您的授權。Xilinx 提供了產生授權金鑰與安裝授權的相關說明：

• Vivado Design Suite 使用者指南：版本資訊、安裝與授權
• ISE Design Suite 14：版本資訊、安裝與授權

在 VisualApplets 中將 Xilinx Toolchain 設定為建置工具的建置設定

在使用 Xilinx 工具鏈建立第一個 applet 之前，您應設定 VisualApplets Build Settings，以便根據需要呼叫工具。有關設定建置設定的說明，請參閱 VisualApplets User's Guide。

安裝 Framegrabber SDK

要在主機 PC 上執行 VisualApplets，必須安裝 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。