명령줄 도구 mE5 Board Settings#

mE5 Board Settings 명령줄 도구를 사용하면 PoCL 켜기/끄기 옵션을 제공하는 프레임 그래버에서 명령줄을 통해 Power over Camera Link(PoCL)를 활성화/비활성화할 수 있습니다.

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

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을 활성화할 필요가 없습니다.

앱릿 세트 버전 1.x의 acquisition applets 또는
VisualApplets 3.0.4 이하 버전으로 빌드된 커스텀 앱릿)

mE5 marathon ACL 또는 mE5 marathon VCL.

개요#

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

프레임 그래버 모델	애플릿 세트 버전(표준 애플릿)	VisualApplets 버전(커스텀 애플릿)	Framegrabber SDK 버전	PoCL 작동을 위해 PoCL 활성화 필요	PoCL 활성화 도구
mE5 marathon VCLx	모든 애플릿 세트 1.0 이상	3.1 이상	5.6 이상	예, 이 보드에는 항상 필요함	명령줄 도구 mE5 Board Settings, microDiagnostics
mE5 marathon ACLmE5 marathon VCL	2.0 이상	3.0.6 이상	5.5.1 이상	예	명령줄 도구 mE5 Board Settings, microDiagnostics
mE5 marathon ACLmE5 marathon VCL	2.0 이상	3.0.6 이상	5.5 이하	예	명령줄 도구 mE5 Board Settings
mE5 marathon ACLmE5 marathon VCL	1.x	3.0.5(이하)	any	no

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

사전 요구 사항:

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

시스템에서 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 활성화 및 비활성화#

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

프레임 grabber를 사용하는 모든 애플리케이션을 닫습니다.
명령 프롬프트 해석기(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 명령줄 도구에 다음 메시지가 표시됩니다.

Message	의미
`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 지원이 성공적으로 활성화/비활성화되었습니다. 그러나 재구성에 실패했습니다(예: 보드에서 crash protection이 활성화되었기 때문이며, Crash Protection 참조). 호스트 컴퓨터를 재부팅(Power cycle)해야 합니다.
`Ignored: Feature already enabled`	정확히 동일한 값으로 설정을 덮어쓰려고 하면 이 메시지가 표시됩니다. 프레임 그래버가 이미 원하는 대로 구성되어 있습니다.
`Ignored: Board feature not supported by board type`	선택한 프레임 grabber 보드가 Camera Link 보드가 아니므로 PoCL을 사용할 수 없습니다.
`Warning: Board features not supported by firmware; Ok`	보드에 플래시된 애플릿(펌웨어 포함)은 기본적으로 PoCL 지원이 활성화되어 있습니다. 이는 Acquisition Applets 버전 1.7 이하 및 VisualApplets 버전 3.0.5 이하로 빌드된 모든 커스텀 애플릿에 해당합니다. 이러한 애플릿을 사용할 때는 PoCL 지원을 별도로 설정할 필요가 없습니다. 그러나 버전 2.0 이상의 표준 애플릿 또는 VisualApplets 3.0.6 이상으로 빌드된 애플릿을 플래시하는 순간부터는 보드의 PoCL 설정이 중요해집니다. 메시지 출력 결과: `OK`, PoCL 지원이 성공적으로 활성화/비활성화되었기 때문입니다.
`Warning: Board features not supported by firmware; Ignored: Feature already enabled`	보드에 플래시된 애플릿(펌웨어 포함)은 기본적으로 PoCL 지원이 활성화되어 있습니다. 이는 Acquisition Applets 버전 1.7 이하 및 VisualApplets 버전 3.0.5 이하로 빌드된 모든 커스텀 애플릿에 해당합니다. 이러한 애플릿을 사용할 때는 PoCL 지원을 별도로 설정할 필요가 없습니다. 그러나 버전 2.0 이상의 표준 애플릿 또는 VisualApplets 3.0.6 이상으로 빌드된 애플릿을 플래시하는 순간부터는 보드의 PoCL 설정이 중요해집니다. 프레임 그래버가 이미 원하는 대로 구성되어 있습니다. 따라서 정확히 동일한 값으로 설정을 덮어쓰려는 시도는 무시됩니다.