VisualApplets
User Manual

하드웨어 애플릿을 실제로 생성(빌드)하기 위해, VisualApplets 는 백그라운드에서 작동하는 전체 툴체인을 사용합니다.

각 하드웨어 플랫폼에 대해, VisualApplets 는 해당 하드웨어 플랫폼에 최적화된 기본 빌드 설정을 제공합니다.

설계 설정에서 설계에 사용할 하드웨어 플랫폼을 선택하면, VisualApplets 에서 빌드에 대한 해당 기본 설정이 제안됩니다. 이 설정은 사용자가 변경할 수 없으나, 사용자 정의 설정으로 대체할 수 있습니다.

	다음과 같은 경우에는 기본 빌드 설정을 사용자 지정 설정으로 변경해야 합니다...
	microEnable 5 marathon 플랫폼용 디자인을 생성합니다. Xilinx Vivado를 사용합니다. 9.2보다 높은 버전의 Xilinx ISE를 사용합니다.

	Xilinx 용 추천 도구
	어떤 하드웨어 플랫폼용 애플릿을 빌드하는 데 어떤 Xilinx 도구가 필요한지에 대한 자세한 정보를 확인하려면, 각 프레임 그래버 플랫폼에 적합한 Xilinx 툴체인 및 버전을 참조하십시오. . mE5 marathon: ISE 14.7을 사용하여 mE5 marathon 용 애플릿을 빌드할 수는 있지만, Basler는 Vivado를 사용할 것을 권장합니다. Xilinx Vivado를 사용한 애플릿 빌드(합성)가 해당 플랫폼에서 훨씬 더 빠르기 때문입니다.

빌드 설정 정의

활성 구성으로 Parameter Set 하나 사용

프로그램이 빌드 단계를 수행할 때마다 특정 빌드 매개변수 세트가 사용됩니다.

VisualApplets 에는 여러 세트의 빌드 매개변수가 포함되어 있습니다. 사용자는 추가 세트를 더할 수 있습니다.

애플릿을 빌드할 때는 이 세트 중 하나를 “활성 구성”으로 지정해야 합니다. 이 구성이 사용되며, 툴체인은 이에 따라 제어됩니다.

모든 설정 정보는 사용자의 로컬 설치 폴더에 있는 “SynthesizeSettings.xml” 파일에 저장됩니다.

활성화된 매개변수 세트 및 현재 매개변수 세트

‘빌드 설정’ 대화 상자를 열려면 다음을 클릭하십시오. 설정 → 빌드 설정을 클릭하십시오. 대화 상자가 열립니다. 활성화된 매개변수 세트가 다음과 같이 표시됩니다: 활성화된 매개변수 세트는 ‘빌드 설정’ 대화 상자의 왼쪽 패널에 녹색 체크 표시로 나타납니다. 활성화된 매개변수 세트는 빌드에 사용됩니다. 활성화된 매개변수 세트는 표시할 다른 매개변수 세트를 선택하더라도 계속 활성화된 상태로 유지됩니다. (매개변수 세트를 표시하려면, ‘빌드 설정’ 대화 상자의 왼쪽 패널에서 해당 이름을 클릭하십시오. 선택한 매개변수 세트는 빌드 설정 대화 상자의 오른쪽 패널에 표시됩니다.) 표시된 매개변수 세트는 편집, 복사, 저장 또는 삭제가 가능합니다( 아래 참조). 이하에서는 표시된 매개변수 세트를 “현재 매개변수 세트”라고 칭하겠습니다.

새 파라미터 세트 정의

이 매개변수 집합 자체는 워크플로우의 특정 단계를 수행하는 외부 애플리케이션(Xilinx 도구)을 시작하는 데 필요한 매개변수와, 이러한 도구를 제어하는 데 필요한 매개변수로 구성됩니다. “활성 구성”을 선택하여 특정 세트를 기본 구성(현재 설계의 빌드 시작용)으로 정의할 수 있으며, 이 특정 세트의 용도를 설명하는 주석을 추가할 수도 있습니다.

1. ‘빌드 설정’ 대화 상자를 열려면 메뉴를 클릭하세요 설정 → 빌드 설정을 클릭하십시오.

   대화 상자가 열립니다. 활성화된 매개변수 세트가 표시됩니다.

   	첫 번째 대체 매개변수 세트를 추가하기 전에
   	설계 대상 하드웨어에 대해 설정된 추가 매개변수가 생성되지 않은 한, 기본 빌드 설정이 표시됩니다. 이 기본 설정은 변경할 수 없으므로, 모든 입력 필드가 비활성화되어 있습니다. 또한 “활성 구성”의 선택 항목을 해제할 수 없는데, 이는 아직 기본값을 대체할 대안이 없기 때문입니다.

2. 클릭 '추가'를 클릭하여 을 클릭하여 새로운 매개변수 세트를 생성합니다.

   하드웨어 플랫폼 정보를 입력하라는 메시지가 표시됩니다. 여기에서 자신만의 매개변수 세트를 생성하기 위한 기반으로 어떤 매개변수 세트를 불러올지 지정할 수 있습니다. 대부분의 경우, 여기에서 설계의 대상 하드웨어를 선택하는 것이 가장 합리적입니다.

   

   그림 143. 하드웨어 플랫폼 선정

   
   

3. 클릭 '확인'.

   이제 첫 번째 필드를 편집할 수 있습니다.

그림 144. 빌드 설정 창

4. 이름: 식별을 위해 새로운 속성 집합에 이름을 지정하십시오. 이 이름은 구성 대화 상자와 빌드 프로토콜에 표시됩니다.

5. 활성 구성: 애플릿을 빌드할 때 이 매개변수 세트를 사용하려면 [ 활성 구성] 확인란을 선택하십시오.

   	활성 구성
   	다음과 같이 정의한 매개변수 집합 활성 구성 로 정의한 매개변수 세트는 빌드를 실행할 때마다 사용됩니다. 설계의 대상 하드웨어 플랫폼으로 선택한 하드웨어 플랫폼을 변경할 경우 이 새로운 플랫폼에 대한 새로운 빌드 설정을 정의하십시오.

6. 전제 조건 확인: 기본 모드에서는 전제 조건 검사가 활성화되어 있습니다. 전제 조건 검사는 설계의 대상 하드웨어에 있는 FPGA 유형이 Xilinx 툴 체인에서 지원되는지 확인합니다. 또한, mE5 marathon 플랫폼용 모든 설계의 경우: 이 확인란이 선택되어 있으면, 각 빌드 시마다 AppletProperties 연산자의 정보가 업데이트됩니다. 즉, BuildTime 및 AppletUid 필드가 업데이트됩니다. 따라서 빌드가 완료된 후, 빌드 과정에서 operator AppletProperties의 매개변수 값이 변경되었기 때문에 설계는 "저장되지 않은" 상태가 됩니다.

   	AppletProperties 업데이트 방지
   	특정 상황에서는 빌드 시 AppletProperties 연산자를 업데이트하지 않으려는 경우가 있을 수 있습니다. 이 경우, ‘선행 조건 확인’ 확인란의 선택을 해제하기만 하면 됩니다.

7. Xilinx ISE/Xilinx Vivado: 사용할 Xilinx 툴 체인을 선택하십시오. Vivado는 모든 marathon 플랫폼에서 지원됩니다. 오픈 디자인의 대상 하드웨어에서 Vivado가 지원되지 않는 경우, 이는 GUI에 직접 표시됩니다:

   

   그림 145. 대상 하드웨어 설계에서 지원되는 Vivado

   
   
   

   그림 146. 대상 하드웨어 설계에서 Vivado 미지원

   
   

8. 빌드 환경:

   • 최신 버전의 Xilinx 도구를 사용할 때(즉, Xilinx Vivado 또는 Xilinx ISE 9.2보다 높은 버전으로 개발할 때):

     • “시스템 환경 사용” 확인란의 선택을 해제하고,

     • 파일 시스템에서 외부 도구를 실행하도록 환경을 설정하는 Xilinx 설정 배치 파일을 선택하십시오. 외부 도구를 실행하도록 환경을 설정하는

     Xilinx 문서를 참고하여 가장 적합한 선택을 하시기 바랍니다.

     Xilinx 설치 폴더에서 해당 배치 파일을 찾을 수 있습니다:

     • ISE: \Xilinx\14.7\ISE_DS\settings64.bat.

     • Vivado: \Xilinx\Vivado\2020.2\settings64.bat.

     Basler는 microEnable 5 플랫폼용 애플릿을 개발할 때 64비트 Windows 운영 체제를 사용할 것을 권장합니다. 사용 중인 운영 체제에 맞는 배치 파일을 선택해야 합니다. 예를 들어, 64비트 Windows 운영 체제용 파일인 "settings64.bat"를 선택하십시오.

   • 구버전의 Xilinx ISE(버전 9.2 이하)를 사용하는 경우 그리고 운영 체제에서 모든 환경 변수가 설정되어 있는 경우, “시스템 환경 사용” 확인란을 선택하십시오.

9. 빌드 흐름: '빌드 흐름' 아래의 모든 옵션을 활성화하십시오. 일반적으로 모든 단계는 활성화되어 있어야 합니다.

   Basler는 시스템을 ‘Multi place ’ 모드로 설정하고 반복 횟수를 20회로 설정할 것을 권장합니다.

   명령 모드를 ‘플랫폼 사용’ 기본값으로 유지하십시오.

10. 애플릿 생성: 애플릿 생성을 활성화합니다.

11. 댓글: 방금 생성한 매개변수 세트를 설명하는 주석을 입력하십시오. 여기에 입력한 내용은 실제 빌드 과정에는 아무런 영향을 미치지 않습니다.

12. 다음 버튼을 클릭하세요 '확인' 버튼을 클릭하십시오.

예: microEnable 5 marathon 용으로 개발할 때는 다음 매개변수 값을 설정해야 합니다:

그림 147. 매개변수 세트 예시: microEnable 5용 개발 marathon

빌드 흐름 단계 비활성화

기본적으로 모든 빌드 흐름 단계(번역, 매핑 등)가 활성화되어 있습니다: 그림 148. 기본 설정: 모든 빌드 흐름 단계 활성화됨 개별 단계를 선택 해제할 수 있습니다. 하지만 빌드 단계들은 서로 의존 관계를 맺고 있습니다. 이러한 단계들은 의존 관계의 순서대로 나열되어 있습니다: 번역은 언제나 실행할 수 있는 첫 번째 단계입니다. '변환' 단계가 먼저 실행된 경우에만 매핑을 실행할 수 있습니다. ‘매핑’ 단계가 먼저 실행된 경우에만 배치 및 배선 단계가 실행될 수 있으며, 이와 같은 순서로 진행됩니다. 그림 149. 후속 빌드 단계 비활성화 그러나 이전 단계는 반드시 동일한 빌드 실행 내에서 수행될 필요는 없습니다. 이전 빌드 실행에서 수행되었을 수도 있습니다. 이전 빌드 실행 중에 생성된 파일(추적 파일)이 여전히 사용 가능한 한, “빌드 흐름” 목록에서 앞쪽에 위치한 단계를 비활성화하고 목록 뒤쪽에 위치한 단계를 활성화할 수 있습니다. 이전 빌드 실행의 추적 파일을 보관하려면: 메뉴로 이동 설정 → 시스템 설정 → 전체 빌드로 이동합니다. ‘빌드 추적 파일’ 섹션에서 ‘빌드 추적 파일 유지’를 활성화합니다. ‘빌드 추적 파일 압축’은 비활성화합니다. 그림 150. 개별 빌드 단계별 빌드 파일 보관 빌드 추적 파일을 보관하고 있으며, 이전의 모든 빌드 흐름 단계를 한 번이라도 수행한 적이 있다면, 이후 단계만 활성화할 수도 있습니다. 예를 들어: 그림 151. 개별 빌드 단계별 빌드 파일 보관

명령 모드 옵션

다음 설정을 변경할 수 있습니다. 명령 모드을 변경할 수 있습니다. 다음 설정을 변경하려면 명령 모드를 변경하려면, 빌드 흐름 영역의 오른쪽 상단 모서리에 있는 명령 모드로 이동하십시오. 그림 152. 명령 모드 옵션 목록에는 세 가지 다른 옵션이 있습니다: 플랫폼의 기본값 사용 (기본값) 플랫폼 기본값에 추가 플랫폼의 기본값 덮어쓰기 ---------- 플랫폼 기본값 사용 (기본값): 이 옵션을 유지하거나 선택하면, ‘ VisualApplets ’는 오픈 디자인의 대상 플랫폼으로 지정한 하드웨어 플랫폼에 권장되는 기본값을 표시합니다. VisualApplets Xilinx 도구를 실행할 때도 이러한 기본값을 사용합니다. (즉, 열려 있는 설계 데이터를 바탕으로 실제 애플릿이 빌드(합성)될 때입니다.) 기본 설정은 수정할 수 없으므로, ‘플랫폼 기본값 사용’ 모드에서는‘인수’ 필드를 편집할 수 없습니다. 그림 153. 명령 모드 “플랫폼 기본값 사용” 플랫폼 기본값에 추가: 이 옵션을 선택하면, 매핑 및 배치 및 경로 설정 도구에 대한 정보를 VisualApplets 에서 제공하는 기본 인자에 추가할 수 있습니다. 빌드 과정에서 ‘ VisualApplets ’는 도구를 호출할 때 ‘Arguments’ 필드에 정의한 매개변수를 플랫폼의 기본값에 추가합니다. 이 설정은 숙련된 사용자 만을 위한 것입니다. 그림 154. 명령 모드 “플랫폼 기본값에 추가” 플랫폼 기본값 덮어쓰기: 이 옵션을 선택하면, 새 애플릿 세트를 생성한 직후 VisualApplets 에서 선택한 대상 하드웨어 플랫폼에 대한 매핑 및 배치 및 라우팅의 기본 인수가 표시됩니다. 여기서 명시된 매핑 및 배치 및 라우팅 인수를 정의(덮어쓰기)할 수 있습니다. VisualApplets 는 이제 도구를 호출할 때 이 ‘인수’ 필드에 지정된 매개변수만 사용합니다. 이 설정은 숙련된 사용자 전용입니다. 그림 155. 명령 모드 “플랫폼 기본값 덮어쓰기”

Parameter Set 재사용

'빌드 설정' 창에서는 매개변수 세트를 처리하기 위한 몇 가지 옵션이 제공됩니다:

그림 156. 처리 옵션

클릭하면

• 추가 을 클릭하면 (선택한 하드웨어 플랫폼에 따라) 원하는 대로 수정할 수 있는 새로운 매개변수 세트가 생성됩니다.

• 복사 현재 세트의 매개변수를 복사하고, 새로운 세트를 생성한 다음, 복사된 세트의 매개변수를 새로운 세트에 붙여넣습니다.

• 가져오기 특정 매개변수 세트를 현재 설치된 VisualApplets 로 가져올 수 있습니다.

• 선택한 항목 내보내기 현재 매개변수 세트를 파일로 저장합니다. 이 파일은 데이터를 다른 PC나 설치 환경으로 전송하거나 백업 목적으로 사용할 수 있습니다. 파일 이름과 저장 위치를 지정할 수 있는 대화 상자가 표시됩니다.

• 삭제 현재 설정된 매개변수 세트를 삭제합니다.

숙련된 사용자 전용: 동일한 빌드를 사용하여 다양한 운영 체제용 *.hap 파일 생성하기 (mE5 marathon)

mE5 marathon 의 경우, 다음 확인란 '전제 조건 확인' 체크박스는 다음과 같은 특정 기능을 제공합니다:

• 만약 '전제 조건 확인' 가 활성화된 경우, 합성(빌드)이 시작될 때마다 BuildTime 및 AppletUid 항목이 업데이트됩니다. 전체 빌드(넷리스트 생성부터 애플릿 생성까지)를 시작하려면 전제 조건 검증를 활성화해야 합니다. 그렇지 않으면, 나중에 (프레임 그래버에서 애플릿을 사용할 때) 로드된 애플릿을 런타임 환경에서 안정적으로 검증할 수 없습니다.

• 특정 옵션: 애플릿을 이미 완전히 빌드했지만, 다른 대상 운영 체제용으로 또 다른 *.hap 파일이 필요하다고 판단되는 경우: 완성된 빌드 결과를 바탕으로 새로운 OS 전용 hap 파일을 빌드하여 다른 대상 운영 체제(즉, 다른 대상 런타임)에서도 디자인을 사용할 수 있도록 할 수 있습니다. 다음 절차에 따라 진행하십시오:

  1. 메뉴에서 '설정'에서 시스템 설정를 선택합니다.

  2. 열리는 창에서 카테고리를 선택하세요 전역 빌드를 선택하십시오.

  3. 여기, '빌드 추적 파일 생성'에서 다음 옵션을 활성화하십시오 빌드 추적 파일 유지 를 활성화하고 경로를 지정하십시오.

  4. 메뉴로 이동 설정, 메뉴 항목 빌드 설정로 이동합니다.

  5. 비활성화 옵션 사전 조건 확인.

  6. 다음 항목 아래의 다른 모든 옵션을 비활성화하십시오. Xilinx 빌드 흐름아래의 다른 모든 옵션을 비활성화하십시오.

  7. 활성화 애플릿 생성.

  8. '기본값'에서 다음을 활성화하십시오. 활성 구성를 활성화하십시오.

  9. OS별 *.hap 파일의 빌드를 시작합니다.

  특히 복잡한 디자인의 경우, 이 옵션을 사용하면 시간을 절약할 수 있습니다.

VisualApplets 에서는 ‘빌드 설정’ 대화 상자에서 여러 개의 빌드 설정을 생성할 수 있으며, 이 설정들은 애플리케이션에 저장됩니다.

Xilinx 의 ‘Build Hardware Applets’ 대화 상자에서 ‘Build Settings’ 대화 상자에 정의한 빌드 설정 중 하나를 선택할 수 있습니다. 여기서 선택한 빌드 구성은 곧 시작할 빌드에 적용됩니다. 기본값은 ‘Build Settings’ 대화 상자에서 ‘Active configuration’으로 지정한 구성입니다.

그림 157. 애플릿 빌드용 빌드 구성 선택

동일한 ‘하드웨어 애플릿 빌드’ 대화 상자에서 필요한 대상 런타임을 지정할 수 있습니다. 기본적으로 디자인 파일의 대상 런타임이 선택되어 있습니다. ( ‘대상 런타임’ 참조) 그러나 때로는 애플릿이 여러 대상 런타임에서 사용되기도 합니다. 이 경우, 다음 그림에서 볼 수 있듯이 여러 대상 런타임을 선택할 수 있습니다. VisualApplets는 선택된 모든 대상 런타임에 대한 HAP 파일을 생성합니다.

그림 158. 애플릿 빌드 시 대상 런타임 선택

정의한 대상 런타임에 대한 설계 파일이 생성되면, 앞서 설명한 대로 지정된 디렉터리에 출력 파일이 저장됩니다. 이 출력 파일의 파일 이름은 *.va 설계 파일의 이름과 동일하며, 확장자만 *.hap으로 바뀝니다. Framegrabber SDK 가 설치되어 있는 경우, 이 파일은 Framegrabber SDK 설치 디렉터리로 복사됩니다.

모든 추가 출력 파일: ` VisualApplets `는 모든 추가 출력 파일의 파일 이름에 “_Linux_AMD64”, “_Linux_IA32” 등과 같은 대상 런타임 정보를 추가합니다. 이러한 추가 HAP 파일은 복사되지 않습니다Framegrabber SDK 설치 디렉터리로 복사되지 않습니다.

	나중에 다른 대상 런타임용으로 *.hap 파일을 다시 패키징하기
	나중에 전체 빌드 과정을 다시 시작하지 않고도 추가 대상 런타임용 새로운 *.hap 파일을 쉽게 생성할 수 있습니다. 재포장 작업은 몇 분밖에 걸리지 않으므로, 이를 통해 많은 시간을 절약할 수 있습니다. 추가 대상 런타임에 대해 *.hap 파일을 재포장하는 방법에 대한 자세한 내용은, '나중에 다른 운영 체제용 *.hap 파일 재포장' 섹션을 참조하십시오 .

imaFlex CXP-12 Quad 및 imaFlex CXP-12 Penta 플랫폼에는 다음과 같은 추가 빌드 설정이 하나 있습니다. 넷리스트 합성 엔진.

그림 159. imaFlex CXP-12 Quad의 빌드 설정 및 imaFlex CXP-12 Penta

이 설정은 빌드 속도와 장치 리소스에 영향을 미칩니다.

표준:

향상된:

Basler는 항상 Enhanced 넷리스트 합성 엔진을 사용할 것을 권장합니다.

빌드 프로세스는 항상 레벨 1 및 레벨 2 설계 규칙 검사를 수행합니다. 이 중 하나라도 실패하면 빌드 프로세스가 중단됩니다. 설계 규칙 검사에 대한 자세한 내용은 ‘설계 규칙 검사’를 참조하십시오.

또한, 빌드 과정에서 몇 가지 추가적인 오류가 발생할 수 있습니다. 가장 흔히 발생하는 오류는 리소스 오버맵 또는 타이밍 오류입니다. 애플릿에 논리 요소가 너무 많이 포함되어 있으면, 자일링스(XILINX) 툴은 필요한 모든 요소를 물리적으로 사용 가능한 요소에 매핑할 수 없습니다. 리소스 오버맵이 발생한 경우, FPGA에 설계가 들어갈 수 있도록 설계를 최적화해야 합니다.

타이밍 오류가 발생하면 XILINX 툴은 허용된 제약 조건 내에서 모든 신호를 라우팅할 수 없습니다. 이는 대부분 거의 모든 로직 리소스가 사용된 경우에 발생합니다. 이 경우 리소스 사용량을 줄이도록 설계를 최적화해야 합니다. 타이밍 오류가 있는 설계도 여전히 완료할 수 있습니다. 타이밍 조건을 충족하지 못한 하드웨어 애플릿은 정상적으로 작동하지 않을 수 있음을 유의하십시오. 이를 사용할 경우 타임아웃, 데이터 오류 또는 기타 예기치 않은 동작이 발생할 수 있습니다. 따라서 타이밍 조건이 충족되지 않은 애플릿은 신중하게 사용해야 하며, 사용 시 발생하는 모든 위험은 사용자가 감수해야 합니다. 설계의 필요 리소스가 100%보다 훨씬 적음에도 불구하고 타이밍 오류가 계속 발생한다면, Basler 지원팀에 문의하십시오.

그 밖의 오류는 XILINX가 잘못 설치되었거나 디스크 볼륨에 대한 액세스 권한 문제로 인해 발생할 수 있습니다.

빌드 과정이 완료되는 데 몇 시간이 소요될 수 있으니 유의하시기 바랍니다.

하드웨어 애플릿 파일(HAP)의 사용법 및 실행 방법은Framegrabber SDK 문서에 설명되어 있습니다. VisualApplets 의 SDK 생성기를 사용하면 애플릿 실행의 첫 단계를 수월하게 진행할 수 있습니다. 자세한 내용은 'Framegrabber SDK'을 참조하십시오.

microDisplay는 Framegrabber SDK 의 일부입니다. 이는 생성된 애플릿을 처음 테스트해 볼 수 있는 도구입니다. Framegrabber SDK 가 설치되어 있다면, VisualApplets 에서 빌드 → microDisplay ( F5 ). 또는 빌드 아이콘 바에 있는 microDisplay 아이콘을 사용할 수도 있습니다.

추가 항목을 생성할 수 있습니다. *.hap 파일 이미 존재하는 *.hap 파일. 이는 첫 번째 빌드 전에 지정하지 않았던 다른 운영 체제에서 애플릿을 사용하려는 경우 특히 유용합니다.

빌드 과정을 처음부터 다시 시작할 필요는 없습니다. 이렇게 하면 시간을 크게 절약할 수 있습니다. 재포장 작업은 몇 분밖에 걸리지 않습니다. 재포장 과정에서 원래 *.hap 파일 중 운영 체제별 구성 요소만 VisualApplets 로 대체됩니다 .

	전제 조건
	기존의 것을 다시 포장하려면 *.hap 새로운 운영 체제용 파일을 제출할 때는, 원래 애플릿을 빌드할 때 사용했던 것과 동일한 VisualApplets 버전을 사용해야 합니다 (VA 2.2 이상). 그렇지 않으면 해당 오류 메시지가 표시됩니다.

추가 항목을 생성하려면 *.hap 다른 운영 체제용 파일: