Command Line Tool mE5 Board Settings#

mE5 Board Settings 커맨드 라인 툴을 사용하면 PoCL 켜기/끄기 옵션을 제공하는 프레임 그래버에서 커맨드 라인을 통해 PoCL(Power over Camera Link)을 활성화/비활성화할 수 있습니다.

해당 프레임 그래버는 다음과 같습니다.

mE5 marathon ACL
mE5 marathon VCL
mE5 marathon VCLx

mE5 Board Settings 툴은 Basler Framegrabber SDK와 함께 설치됩니다. 이 툴은 Framegrabber SDK 설치 디렉토리의 하위 디렉토리인 bin(%BASLER_FG_SDK_DIR%\bin)에서 찾을 수 있습니다.

PoCL 지원을 활성화해야 하는 이유는 무엇입니까?#

Power over Camera Link (PoCL) 지원은 기본적으로 상술한 프레임 그래버에서 비활성화되어 있습니다. 이러한 프레임 그래버 중 하나에서 PoCL을 사용하려면, 프레임 그래버에서 PoCL 지원을 수동으로 활성화해야 합니다.

정보

예외:

다음의 경우에는 PoCL을 활성화할 필요가 없습니다.

applet set 버전 1.x의 acquisition applets 또는
VisualApplets 3.0.4 이하로 빌드된 커스텀 어플릿)

mE5 marathon ACL 또는 mE5 marathon VCL.

개요#

아래 표는 PoCL을 활성화해야 하는 시기와 각 상황에서 사용할 수 있는 도구를 보여줍니다.

프레임 그래버 모델	Applet Set Version (표준 어플릿)	VisualApplets Version (커스텀 어플릿)	Framegrabber SDK Version	PoCL 작동을 위해 PoCL 활성화 필요	PoCL 활성화 툴
mE5 marathon VCLx	모든 어플릿 세트 1.0 이상	3.1 이상	5.6 이상	예, 이 보드에는 항상 필요함	Command line tool mE5 Board Settings, microDiagnostics
mE5 marathon ACLmE5 marathon VCL	2.0 이상	3.0.6 이상	5.5.1 이상	yes	Command line tool mE5 Board Settings, microDiagnostics
mE5 marathon ACLmE5 marathon VCL	2.0 이상	3.0.6 이상	5.5 이하	yes	Command line tool mE5 Board Settings
mE5 marathon ACLmE5 marathon VCL	1.x	3.0.5 (또는 그 이하)	any	표시된 패킷 크기 값은 카메라에

Framegrabber SDK 버전 5.5.1 이상을 사용하는 경우, Framegrabber SDK에 포함된 GUI 도구인 microDiagnostics를 통해 보드에서 PoCL 지원을 대신 활성화할 수 있습니다. 방법에 대한 자세한 내용은 microDiagnostics 사용자 매뉴얼의 PoCL Support 섹션을 참조하십시오.

사전 요구 사항:

marathon Camera Link 프레임 그래버(mE5 marathon ACL, mE5 marathon VCL 또는 mE5 marathon VCLx)를 사용하는 경우.
카메라가 PoCL(Power Over Camera Link)을 지원합니다.
사용하고자 하는 경우
- marathon ACL/VCL의 어플릿 세트 버전 2.0(이상)1의 acquisition applets
- marathon VCLx의 applet set 버전 1.0(이상)의 acquisition applets 또는 VisualApplets 3.0.6(이상)으로 빌드된 커스텀 applets. VisualApplets 3.0.5 이하로 빌드된 applets에서는 PoCL 지원이 자동으로 활성화됩니다.
컴퓨터에 Basler Framegrabber SDK(버전 5.4 이상)가 설치되어 있고 정상적으로 작동합니다(Windows 또는 Linux).

시스템에서 PoCL을 사용하고 다음 구성 요소들을 함께 사용하려면 PoCL을 활성화해야 합니다:

프레임 그래버 모델	Applets	VisualApplets 기반 구축
mE5 marathon ACL	Standard Applets 2.0 (또는 그 이상) Custom Applet	3.0.6 이상
mE5 marathon VCL	Standard Applets 2.0 (또는 그 이상) Custom Applet	3.0.6 이상
mE5 marathon VCLx	Standard Applets 1.0 (또는 그 이상) Custom Applet	3.1 이상

PoCL 활성화 및 비활성화#

명령 줄 인터페이스를 통해 프레임 그래버에서 PoCL을 활성화 또는 비활성화하려면:

프레임 그래버를 사용하는 모든 애플리케이션을 닫으십시오.
명령줄 인터프리터를 엽니다(Windows의 경우 cmd.exe, Linux의 경우 대부분의 배포판에서 Terminal).
명령줄 인터프리터에서 Basler Framegrabber SDK가 설치된 bin 폴더로 이동합니다.
입력합니다 mE5BoardSettings, 수행하려는 작업에 따라 일부 파라미터를 차례로 입력합니다.
- 시스템에 있는 모든 보드의 설정에 대한 정보 얻기:
  
  입력합니다 mE5BoardSettings 파라미터 없이 실행합니다.
  
  시스템에 있는 모든 보드의 설정이 표시됩니다. 예: 다음 이미지에서는 보드 인덱스 0인 하나의 보드(mE5 marathon VCL)가 시스템에 설치되어 있는 것을 볼 수 있습니다. 이 보드에서는 PoCL이 비활성화되어 있습니다.
- 시스템의 모든 보드에 대해 PoCL 지원 활성화 및 비활성화:
  
  PoCL 지원을 활성화하려면 다음을 입력합니다 mE5BoardSettings -a -pocl enable -reconfigure.
  
  PoCL 지원을 비활성화하려면 다음을 입력합니다. mE5BoardSettings -a -pocl disable -reconfigure.
  
  -a 의미합니다 시스템의 모든 보드.
- 시스템의 특정 보드에 대해 PoCL 지원 활성화 및 비활성화:
  
  입력합니다 mE5BoardSettings -b <board index> -pocl enable -reconfigure.
- 시스템의 한 보드에 대해 PoCL 지원 비활성화하기:
  
  PoCL 지원을 활성화하려면 다음을 입력합니다 mE5BoardSettings -b <board index> -pocl enable -reconfigure.
  
  PoCL 지원을 비활성화하려면 다음을 입력합니다. mE5BoardSettings -b <board index> -pocl disable -reconfigure
  
  대신에 <board index>, PoCL 지원을 활성화하려는 보드의 실제 보드 인덱스를 입력합니다(예:
  
  mE5BoardSettings -b 0 -pocl enable -reconfigure 시스템의 보드 0을 구성하려는 경우.

PoCL 지원 활성화 또는 비활성화가 성공적으로 완료되면 다음 메시지가 표시됩니다.

Ok; Board reconfigured; Close all applications using the board.

보드를 사용하는 모든 애플리케이션을 닫습니다.

정보

Basler ClSerCOM Wrapper를 사용하여 가상 COM Port를 사용하는 경우, 기능을 활성화하려면 이 단계에서 항상 호스트 컴퓨터를 재시작해야 합니다.

이는 mE5 Board Settings 명령줄 도구에서 출력되는 메시지에 반영되지 않습니다.

예를 들어 보드에서 crash protection이 활성화되어 설정에 실패한 경우 다음과 같은 메시지가 표시됩니다.

Ok; Warning: Failed to reconfigure board; Powercycle required to activate board features.

이 경우 컴퓨터를 재부팅(전원 껐다 켜기)하십시오. 재부팅 후 프레임 그래버에서 PoCL이 활성화(또는 비활성화)됩니다.

구문 요약#

다음을 호출합니다 mE5 Board Settings 입력하여 명령줄 도구 mE5BoardSettings.

사용 가능한 파라미터는 다음과 같습니다:

-all 또는 -a

-board <board-index> 또는 -b <board-index>

-pocl enable|disable

-reconfigure

사용 가능한 명령은 다음과 같습니다.

도구 호출	보드 지정	PoCL Support 설정	재구성 시작
mE5BoardSettings	-b <board-index>	-pocl enable	-reconfigure
mE5BoardSetting	-b <board-index>	-pocl disable	-reconfigure
mE5BoardSetting	-board <board-index>	-pocl enable	-reconfigure
mE5BoardSetting	-board <board-index>	-pocl disable	-reconfigure
mE5BoardSetting	-a <board-index>	-pocl enable	-reconfigure
mE5BoardSetting	-a <board-index>	-pocl disable	-reconfigure
mE5BoardSetting	-all <board-index>	-pocl enable	-reconfigure
mE5BoardSetting	-all <board-index>	-pocl disable	-reconfigure

For <board-index>, enter the actual index number of the board you want to enable/disable PoCL support for. The index numbers of your frame grabber boards are displayed, for example, in microDiagnostics.

사용하는 경우 -a 또는 -all (대신에 -b <board-index> 또는 -board <board-index>), 시스템의 모든 프레임 그래버가 한 번에 설정됩니다.

설정을 활성화하려면 프레임 래버의 FPGA를 재구성해야 하며, 따라서 파라미터는 -reconfigure (이)가 명령줄 끝에 추가됩니다.

파라미터를 지정하지 않고 도구를 실행하면 시스템에 있는 모든 보드의 현재 설정이 표시됩니다.

출력 메시지#

mE5 Board Settings 명령줄 도구에 다음과 같은 메시지가 표시됩니다.

메시지	의미
`Ok; Board reconfigured; Close all applications using the board`	PoCL 지원을 성공적으로 활성화 또는 비활성화했으며 보드의 FPGA가 재구성되었습니다. 애플리케이션에서 변경 사항이 반영되도록 하려면 해당 보드를 사용하는 모든 애플리케이션을 닫았다가 다시 열어야 합니다.
`Ok; Reconfiguration or powercycle required to activate feature`	PoCL 지원이 성공적으로 활성화/비활성화되었습니다. 그러나 파라미터를 추가하지 않았습니다. `-reconfigure` 명령줄 끝에 입력합니다. 설정은 FPGA 재구성이 완료된 후에만 적용되므로, FPGA를 재구성하거나 호스트 컴퓨터를 재부팅하십시오.
`Ok; Warning: Failed to reconfigure board; Powercycle required to activate board features`	PoCL support가 성공적으로 활성화/비활성화되었습니다. 그러나 재구성에 실패했습니다(예: 보드에서 crash protection이 활성화되었기 때문이며, Crash Protection 참조). 호스트 컴퓨터를 재부팅해야 합니다.
`Ignored: Feature already enabled`	정확히 동일한 값으로 설정을 덮어쓰려고 하면 이 메시지가 표시됩니다. 프레임 래버가 이미 원하는 대로 설정되어 있습니다.
`Ignored: Board feature not supported by board type`	선택한 프레임 래버 보드가 Camera Link 보드가 아니므로 PoCL을 사용할 수 없습니다.
`Warning: Board features not supported by firmware; Ok`	보드에 플래시된 앱릿(펌웨어 포함)은 기본적으로 PoCL support가 활성화되어 있습니다. 이는 Acquisition Applets 세트 버전 1.7 이하 및 VisualApplets 버전 3.0.5 이하로 빌드된 모든 커스텀 앱릿에 적용됩니다. 이러한 앱릿을 사용할 때는 PoCL support를 따로 설정할 필요가 없습니다. 그러나 버전 2.0 이상의 표준 앱릿이나 VisualApplets 3.0.6 이상으로 빌드된 앱릿을 플래시하는 순간, 보드의 PoCL 설정이 중요해집니다. 메시지가 다음과 같이 출력됩니다. `OK`(PoCL 지원이 성공적으로 활성화/비활성화되었으므로).
`Warning: Board features not supported by firmware; Ignored: Feature already enabled`	보드에 플래시된 앱릿(펌웨어 포함)은 기본적으로 PoCL support가 활성화되어 있습니다. 이는 Acquisition Applets 세트 버전 1.7 이하 및 VisualApplets 버전 3.0.5 이하로 빌드된 모든 커스텀 앱릿에 적용됩니다. 이러한 앱릿을 사용할 때는 PoCL support를 따로 설정할 필요가 없습니다. 그러나 버전 2.0 이상의 표준 앱릿이나 VisualApplets 3.0.6 이상으로 빌드된 앱릿을 플래시하는 순간, 보드의 PoCL 설정이 중요해집니다. 프레임 그래버가 이미 원하는 대로 구성되어 있으므로, 정확히 동일한 값으로 설정을 덮어쓰려는 시도는 무시됩니다.