get_analog_input

이 함수는 로봇 컨트롤러 컨트롤 박스의 지정한 아날로그 포트에서 현재 아날로그 입력 신호를 읽습니다. 입력 모드(전류 또는 전압)에 따라 측정한 신호 값을 해당 물리 단위로 반환합니다.

주로 로봇 컨트롤러에 연결된 외부 센서, 전위차계, 기타 아날로그 장치를 모니터링할 때 사용합니다.

버전 참고
- DRCF 버전 = 2이면 이 함수는 내부적으로 _get_analog_input()을 호출합니다.
- DRCF 버전 = 3이면 확장된 아날로그 정밀도와 범위를 지원하는 _get_analog_input_ex()를 호출합니다.
현재 DRCF 버전은 get_library_version으로 확인하세요.

정의
DRFLEx.h, CDRFLEx 클래스의 public 섹션

#if DRCF_VERSION == 2
float get_analog_input(GPIO_CTRLBOX_ANALOG_INDEX eGpioIndex) {
    return _get_analog_input(_rbtCtrl, eGpioIndex);
};
#elif DRCF_VERSION == 3
float get_analog_input(GPIO_CTRLBOX_ANALOG_INDEX eGpioIndex) {
    return _get_analog_input_ex(_rbtCtrl, eGpioIndex);
};
#endif

매개변수

매개변수 이름	자료형	기본값	설명
eGpioIndex	GPIO_CTRLBOX_ANALOG_INDEX		컨트롤 박스의 아날로그 입력 포트 번호입니다.

반환값

값	설명
float	아날로그 입력 신호 값입니다. - 전류 모드: 4.0 – 20.0 [mA] - 전압 모드: 0.0 – 10.0 [V]

예제

// 아날로그 입력 #1 모드를 전류(mA)로 설정
drfl.set_mode_analog_output(GPIO_CTRLBOX_ANALOG_INDEX_1, GPIO_ANALOG_TYPE_CURRENT);

// 채널 #1의 현재 아날로그 입력값 읽기
float fCurrent = drfl.get_analog_input(GPIO_CTRLBOX_ANALOG_INDEX_1);

printf("Analog input #1 current value: %.2f mA\n", fCurrent);

이 예제는 아날로그 입력 채널 1번을 전류 모드로 설정하고, 연결된 센서의 실시간 신호 값(밀리암페어 단위)을 읽습니다. 전압 모드이면 볼트(0.0–10.0 V) 단위 값을 반환합니다.