정의
get_digital_inputs(bit_list)
기능
컨트롤러의 디지털 입력 복수 개의 접점에서 신호를 불러오기 위한 명령문입니다. bit_list에 정의된 접점들의 디지털 신호를 한 번에 입력할 수 있습니다.
인수
|
인수명 |
자료형 |
기본값 |
설명 |
|---|---|---|---|
|
bit_list |
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) |
프로그램 강제 종료 시 |
예제
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진수)