cmcAiGetDigit

SYNOPSYS

VT_I4 cmcAiGetDigit ([in] VT_I4 BoardID, [in] VT_I4 Axis, [in] VT_I4 Channel, [out] VT_PI4 Digit )

DESCRIPTION

  • 대상 아날로그 입력 채널에 대하여 A/D 변환을 수행하고, 그 값을 Digit 값으로 반환합니다.

  • 이 함수의 사용과 호출에 있어, 제공된 ㈜커미조아의 함수 헤더 Visual Basic 에서는 함수의 첨두어 cmc 가 붙지 않습니다.

PARAMETER

▶ BoardID: 사용자가 설정한 디바이스(보드) ID.

▶ Axis: Axis 번호(Axis는 3번부터 시작합니다.)

▶ Channel : 채널 번호. 통합 채널로 관리되는 채널 번호를 의미하며, 상수 값으로 0 (Zero Based) 이상, 최대 통합 채널수 - 1 이하의 값을 채널 번호로 설정할 수 있습니다.

▶ Digit : A/D 결과값을 Digit 값으로 반환합니다. 13Bit Straight Binery (0~8192)로 구성되어 있습니다.

Warning

단, 전압 입력 범위(Range) 모드가 5번 모드(1~5V), 6번 모드(1~5V, 4~20mA) 모드인 경우는 입력 전압이 1V 보다 낮은 경우, Digit 값으로 구분해서 표시하기 위해 Digit 값과 Voltage값의 관계 직선에서 0~1V 에 해당되는 음의 Digit 값을 선형적으로 계산해서 반환합니다.

../../../_images/12-1.jpg

RETURN VALUE

Value

Meaning

음수

수행 실패

0(ERR_NONE)

수행 성공

EXAMPLE

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
   C/C++
   #include “ComiMLink3_SDK.h”
   #include “ComiMLink3_SDK_Def.h”
   #define AI_CHANNEL  5
   Long BoardID = 0;
   long nDigit = 0;
   // 5번 채널의 A/D 결과값을 Digit 값으로 반환합니다.
   if(cmcAiGetDigit (BoardID, 3, AI_CHANNEL, &nDigit ) != ERR_NONE )
   {
   OutputDebugString ( " cmcAiGetDigit function Fail" );
   }