cmcPmStSetPosition¶

SYNOPSYS¶

VT_I4 cmcPmStSetPosition ([in] VT_I4 BoardID,  [in] VT_I4 NodeId, [in] VT_I4 Channel,
[in] VT_I4 Target, [in] VT_R8 Position )

DESCRIPTION¶

cmcPmStSetPosition () 함수는 지정한 축의 지정한 카운터의 값을 새로이 설정합니다. 단, 이때 지정하는 카운터 값의 단위는 “Unit distance” 에 의해 정의되는 논리적 단위 거리입니다. 이 함수는 카운터의 값을 지정하는 매개 변수가 논리적 단위 거리라는 것을 제외하고는 cmcPmStSetCount() 함수와 동일합니다.

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

PARAMETER¶

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

▶ NodeId : 노드 번호. 노드 번호는 3부터 시작합니다.

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

▶ Target : 설정할 카운터 번호. cmcPmStSetCount() 함수의 인자이며, 다음의 4가지 값 중의 하나이어야 합니다.

Value	Meaning
0(cmcCNT_COMM)	Command Counter
1(cmcCNT_FEED)	Feedback Counter
2(cmcCNT_DEV)	Deviation Counter: Command 와 Feedback counter의 편차 카운터
3(cmcCNT_GEN)	General Counter: 사용자의 정의에 따라 여러 가지 용도로 사용될 수 있는 카운터

▶ Source : 대상 카운터 번호. cmcPmStGetCount() 함수의 인자이며, 이 값은 다음의 4 가지 값 중의 하나이어야 합니다.

Value	Meaning
0(cmcCNT_COMM)	Command Counter
1(cmcCNT_FEED)	Feedback Counter
2(cmcCNT_DEV)	Deviation Counter
3(cmcCNT_GEN)	General Counter

▶ Position : 대상 카운터에 설정 혹은 반환될 값. 단, 이 값은 논리적 단위 거리 입니다.

RETURN VALUE¶

Value	Meaning
음수	수행 실패
ERR_NONE	수행 성공

REFERENCE¶

논리적 단위 거리는 cmcPmCfgSetUnitDist() 함수에 의해 결정됩니다.

EXAMPLE¶

   C/C++
   #include “ComiMLink3_SDK.h”
   #include “ComiMLink3_SDK_Def.h”
   long BoardID = 0;
   //0번 축의 Command Position을 0으로 설정합니다.
   cmcPmStSetPosition(BoardID, 3, ccmcX1, cmcCNT_COMM, 0 );
   //0번 축의 Feedback Position을 0으로 설정합니다.
   cmcPmStSetPosition(BoardID, 3, ccmcX1, cmcCNT_FEED, 0 );
   long nCmdPosition = 0;
   long nFdbPosition = 0;
   //0번 축의 Command Position값을 반환합니다.
   cmcPmStGetPosition(BoardID, 3, ccmcX1, cmcCNT_COMM, &nCmdPosition );
   //0번 축의 Feedback Position값을 반환합니다.
   cmcPmStGetPosition(BoardID, 3, ccmcX1, cmcCNT_FEED, &nFdbPosition );