6.1.5. ecNet_SetAlState


Hint

Fast Function(_FF) 사용 가능

SYNOPSYS

t_cmdidx ecNet_SetAlState(
  t_i32 NetID,
  t_ui8 AlState,
  t_i32 *ErrCode)

DESCRIPTION

  • 마스터의 AL-STATE 를 설정합니다. AL-STATE 는 EtherCAT 통신에서 EtherCAT Machine State를 의미합니다.

  • 이 Machine State에는 아래 매개변수 표와 같은 상태들이 있는데 각 상태는 의미하는 바가 다르고 통신 상태도 각각 다릅니다. (아래 링크 참조)

  • 마스터의 AL-STATE가 바뀌면 마스터는 연결된 모든 슬레이브의 AL-STATE도 마스터의 AL-STATE와 같은 값으로 바꿔줍니다.ecNet_SetAlState함수는 마스터 보드의 AlState를 설정 합니다.

PARAMETER

  • NetID : 사용자가 사용 할 Network 번호

  • AlState : ecNet_SetAlState(), ecNet_SetAlState_FF() 함수의 인자이며, AlState 값입니다.

  • ErrCode : 이 매개 변수를 통하여 현재의 에러 코드를 반환합니다. 단, 이 매개 변수에 NULL을 전달하면 에러 코드를 반환하지 않습니다.

RETURN VALUE

  • ComiECAT SDK라이브러리에서 발생시킨 명령들의 일련 번호인 CmdIdx를 반환합니다. 단, 이 값이 0이면 함수의 수행이 실패했음을 의미합니다.

See also

ecNet_GetAlState