get_digital_inputs(bit_list)

기능

컨트롤러의 디지털 입력 복수 개의 접점에서 신호를 불러오기 위한 명령문입니다. bit_list에 정의된 접점들의 디지털 신호를 한 번에 입력할 수 있습니다.

인수

인수명

자료형

기본값

설명

index

list (int)

-

복수 개로 읽어들일 input 접점 list

1 ~ 16까지의 숫자이며, 컨트롤러에 장착된 I/O 접점 번호

리턴

값

설명

int (>=0)

한번에 읽은 복수 개의 접점 값

(bit_list의 첫번째 값=LSB, bit_list의 마지막 값=MSB 가 되는 비트 조합의 값)

음수 값

실패

예외

예외	설명
DR_Error (DR_ERROR_TYPE)	인수들의 데이터형 오류 시
DR_Error (DR_ERROR_VALUE)	인수의 값이 유효하지 않을 시
DR_Error (DR_ERROR_RUNTIME)	C Extension 모듈 에러 발생 시
DR_Error (DR_ERROR_STOP)	프로그램 강제 종료 시

예제

PY

# input 접점: 1번=OFF, 2번=OFF, 3번=ON, 4번=ON인 경우 
res = get_digital_inputs(bit_list=[1,2,3,4])
#res 기대값 = 0b1100(이진수), 12(십진수), 0x0C(16진수) 

# input 접점: 5번=ON, 6번=ON, 7번=OFF, 8번=ON인 경우
res = get_digital_inputs([5,6,7,8]) 
#res 기대값 = 0b1011(이진수), 11(십진수), 0x0B(16진수)