VisualApplets 설치#
Software Requirements#

어플리케이션 개발에 사용할 PC에 다음 소프트웨어를 설치해야 합니다.
실제 VisualApplets 프로그램(*.exe 설치 파일로 제공됨)
- VisualApplets IDE 라이선스(USB 동글에 포함)
- Xilinx Design Suite(ISE 또는 Vivado, 어플리케이션 빌드에 필요)
- C++ 컴파일러(SDK 예제 컴파일에 필요)
- Framegrabber SDK 소프트웨어
VisualApplets 시스템 요구 사항#
시스템 요구 사항은 VisualApplets 버전에 따라 다를 수 있으므로, 자세한 시스템 요구 사항은 Release Notes에서 확인하실 수 있습니다.
VisualApplets 단계별 설치#
VisualApplets를 설치하려면 (아래 섹션에 설명된) 다음 단계를 거쳐야 합니다.
- VisualApplets 소프트웨어 설치
- 필수 Xilinx 도구 설치
- 빌드 중 Xilinx 도구에 액세스하도록 VisualApplets 구성
참고: VisualApplets 소프트웨어를 설치하려면:
-
VisualApplets DVD에 포함된 설치 프로그램을 실행하거나 프로그램 아이콘을 더블클릭하여 VisualApplets 설치 파일 VAsetup3.x.exe를 실행합니다.
Select Setup Install Mode 대화 상자가 열립니다.

- PC에 대한 관리자 권한이 없는 경우 Install for me only를 선택합니다. 그 결과 All users (으)로 추가 작업 선택 대화 상자(8단계 참조)를 사용할 수 없으며, VisualApplets를 다음 위치에 설치할 수 없습니다.
C:\Program Files. - 관리자 권한이 있는 경우 Install for all users (recommended)를 선택할 수 있습니다.
- PC에 대한 관리자 권한이 없는 경우 Install for me only를 선택합니다. 그 결과 All users (으)로 추가 작업 선택 대화 상자(8단계 참조)를 사용할 수 없으며, VisualApplets를 다음 위치에 설치할 수 없습니다.
-
Select Setup Language 대화 상자가 열립니다.

설치 마법사에서 사용할 언어를 선택하고 OK를 눌러 확인합니다.
-
Legal Disclaimer - Disclaimer for using OpenSSL 대화 상자가 열립니다.

이 대화 상자에서는 Basler의 버전 제어 도구를 활성화하기 위해 OpenSSL과 같은 암호화 소프트웨어 사용에 대한 법적 약관에 동의해야 합니다. 이 도구는 Basler 서버와의 SSL/TLS 보안 연결을 생성합니다. 일부 국가에서는 암호화 소프트웨어의 수출 및 사용이 불법이므로, 본 약관에 동의할 때 현지 법률을 위반하지 않는지 확인하십시오. 확실하지 않은 경우 Decline을 클릭하세요.
-
Accept를 선택하고 Next를 클릭하면 마우스 클릭으로 새로운 VisualApplets 버전을 확인할 수 있는 Update 기능을 사용할 수 있습니다(GUI: 메뉴 Help > Check for Updates). 또는 프로그램이 시작될 때마다 최신 VisualApplets 버전을 자동으로 확인하도록 VisualApplets를 구성할 수 있습니다(GUI: 메뉴 Settings > System Settings > Common > Updates). 그러면 Basler 서버와의 SSL/TLS 보안 연결을 여는 데 사용되는 두 개의 OpenSSL 라이브러리가 다운로드됩니다.
정보
업데이트 기능을 사용하려면 다음 사항이 충족되었는지 확인하십시오.
- 작동하는 인터넷 연결
- 적절한 방화벽 예외 설정

OpenSSL 사용에 동의하면 설치 프로그램은 즉시 설치하려는 버전보다 더 최신 버전을 사용할 수 있는지 확인합니다.
- 이미 최신 버전을 설치 중인 경우 관련 메시지가 표시됩니다. 클릭 다음 계속 진행합니다.
- 더 최신 VisualApplets 버전을 사용할 수 있는 경우 다음 중 하나를 결정할 수 있습니다.
- 링크 중 하나를 클릭하여 이 최신 버전 설치로 전환하거나,
- (Skip을 클릭하여) 방금 시작한 설치 프로그램의 버전 설치를 진행합니다.
- 더 최신 VisualApplets 버전을 사용할 수 있는 경우 다음 중 하나를 결정할 수 있습니다.
최신 버전을 설치하기로 결정하면, 해당 설치 프로그램이 다운로드되고 자동으로 실행됩니다.
- Decline을 선택하고 Next를 클릭하면 Basler의 버전 제어 도구가 활성화되지 않습니다.
-
-
VisualApplets 최종 사용자 사용권 계약(EULA)과 함께 License Agreement 대화 상자가 열립니다.

설치를 계속하려면 I accept the agreement를 선택하고 Next를 클릭해야 합니다.
-
Select Destination Location 대화 상자가 열립니다.

VisualApplets를 설치할 디렉터리를 선택합니다.
Next를 클릭합니다.
-
Select Components 대화 상자가 열립니다. 미리 정의된 설치 프로필에 따라 설치 구성 요소를 선택합니다.

- Full installation 프로필을 간편하게 사용할 수 있습니다.
- 설치 용량을 줄이려면:
- Custom installation 프로필을 선택합니다.
- Hardware platform 아래에서, 애플릿을 작성할 계획이 없는 모든 플랫폼에 대한 지원을 해제합니다.
- Target operating systems for applets 아래에서, 애플릿을 작성할 이미지 처리 시스템의 호스트 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 옵션을 활성화하십시오.
-
Select Start Menu Folder 대화 상자가 열립니다. Start Menu 폴더에서 그룹 이름을 정의합니다:

Next를 클릭합니다.
-
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 확인란을 선택하세요.
-
Next(으)로 확인합니다. 전체 설치 프로필이 나열됩니다.

- 목록을 편집하려면 Back 버튼을 사용하여 해당 대화상자 창에서 설정을 변경하세요.
- 설치를 시작하려면 Install 버튼을 클릭하세요. 진행률 표시줄에 현재 설치 상태가 표시됩니다.

다음 화면이 나타나면 설치가 완료된 것입니다.

-
Finish(을)를 클릭합니다.
Xilinx Toolchain 설치#
VisualApplets에서 생성한 디자인을 빌드하기 전에, 즉 장치용 하드웨어 앱릿을 생성하기 전에 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 라이선스 옵션을 참조하십시오.
mE5 marathon 프레임 그래버용 디자인을 빌드하기 위해 Basler는 Xilinx Vivado 사용을 강력히 권장합니다. Xilinx Vivado를 사용하면 빌드 프로세스가 훨씬 빨라지고 더 복잡한 디자인을 FPGA에 구현할 수 있습니다.
정보
디렉터리 이름에 공백이 포함되지 않는 디렉터리 구조에 Xilinx 툴체인을 설치해야 합니다. 예를 들어 다음 바로 아래에 설치하세요. C:\Xilinx. Do 포함되지 다음 위치에 Xilinx 설치 C:\Program Files\Xilinx.
어떤 프레임 그래버 플랫폼에 어떤 Xilinx 툴체인과 버전이 필요합니까?#
| Basler Frame Grabber 모델 | 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 |
-
Xilinx ISE는 공식적으로 Windows 11을 지원하지 않습니다. 플랫폼을 Xilinx ISE로 빌드해야 하는 경우 Windows 10 운영 체제에 VisualApplets를 설치하세요. 공식적으로 지원되지는 않지만 이 포럼 토론에서 Windows 11에 ISE를 설치하는 몇 가지 방법을 찾을 수 있습니다. ↩
-
microEnable 5 marathon VCL 및 microEnable 5 marathon VCLx 플랫폼용 Applet은 2020.2와 2021.1 사이의 Vivado 버전에서는 빌드할 수 없습니다. Xilinx 섹션의 티켓 ID 217879 항목인 Known Issues VisualApplets Release 3.7.0을 참조하십시오. ↩↩↩↩↩
-
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도 참조하십시오. ↩↩↩↩↩↩↩↩↩
-
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도 참조하십시오. ↩↩↩↩↩↩↩↩↩
-
VisualApplets는 Vivado 2025.1 및 2025.2로 빌드된 디자인이 작동하지 않기 때문에 이 버전으로 CXP-12 플랫폼용 디자인을 빌드하는 것을 금지합니다. Changes and Fixed Issues in VisualApplets 3.8.0도 참조하세요. ↩↩↩↩↩↩↩↩↩
-
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 라이선스 옵션을 참조하십시오. ↩↩↩
Xilinx Toolchain 다운로드#
설치할 패키지를 선택하고 Xilinx 웹사이트에서 다운로드하세요.
Xilinx Toolchain 라이선스 획득#
30일 평가판 라이선스#
Xilinx Licensing Solution Center에서 30일 평가판 라이선스를 발급받을 수 있습니다.
WebPack (Vivado 2025.2 및 이전 버전)#
WebPack은 Vivado 2025.2 및 이전 버전을 위한 무료 라이선스입니다. 대부분의 프레임 그래버용 앱릿은 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 User Guide: Release Notes, Installation, and Licensing
- ISE Design Suite 14: Release Notes, Installation, and Licensing
빌드 도구로서의 Xilinx Toolchain을 위해 VisualApplets에서 빌드 설정 구성하기#
Xilinx 툴체인으로 첫 번째 앱릿을 빌드하기 전에 툴이 원하는 대로 호출되도록 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에서 확인할 수 있습니다.