Breadcrumbs

get_digital_inputs()

get_digital_inputs(bit_list)

기능

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

인수

인수명

자료형

기본값

설명

bit_list

list (int)

-

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

1 ~ 20 까지의 정수이며, 컨트롤러에 장착된 I/O 접점 번호

  • 17 ~ 20은 SI1 - SI4 단자의 입력입니다.

리턴

값

설명

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)

프로그램 강제 종료 시

예제

Python
# 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진수)


get_digital_inputs(bit_start, bit_end)

기능

컨트롤러의 디지털 입력 시작 접점(start_index)부터 마지막 접점(end_index)까지 한 번에 복수 신호를 불러오기 위한 명령문입니다.

인수

인수명

자료형

기본값

설명

bit_start

int

-

입력 신호 시작 접점 번호 (1~20)

bit_end

int

-

입력 신호 끝 접점 번호 (1~20)

알아두기

  • bit_end는 bit_start 보다 큰 값 이어야 합니다.

  • 17 ~ 20은 SI1 - SI4 단자의 입력입니다.

리턴

값

설명

int (>=0)

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

bit_start =LSB, bit_end=MSB 가 되는 비트 조합의 값

음수 값

실패

예외

예외

설명

DR_Error (DR_ERROR_TYPE)

인수들의 데이터형 오류 시

DR_Error (DR_ERROR_VALUE)

인수의 값이 유효하지 않을 시

DR_Error (DR_ERROR_RUNTIME)

C Extension 모듈 에러 발생 시

DR_Error (DR_ERROR_STOP)

프로그램 강제 종료 시

예제

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