Breadcrumbs

set_digital_outputs()

set_digital_outputs(bit_list)

기능

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

인수

인수명

자료형

기본값

설명

bit_list

list (int)

-

복수 개 출력하고자 하는 접점 list

  • 양수의 접점 번호는 ON 출력: 1~16

  • 음수의 접점 번호는 OFF 출력: -1~-16

리턴

설명

0

성공

음수값

실패

예외

예외

설명

DR_Error (DR_ERROR_TYPE)

인수들의 데이터형 오류 시

DR_Error (DR_ERROR_VALUE)

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

DR_Error (DR_ERROR_RUNTIME)

C Extension 모듈 에러 발생 시

DR_Error (DR_ERROR_STOP)

프로그램 강제 종료 시

예제

Python
set_digital_outputs(bit_list=[1,2,3,4,5,6,7,8]) #1번~8번 접점 ON 
set_digital_outputs([-1,-2,-3,-4,-5,-6,-7,-8]) #1번~8번 접점 OFF
set_digital_outputs([1,-2,3]) #1번접점 ON, 2번 접점 OFF, 3번 접점 ON 
set_digital_outputs([4,-9,-12]) #4번접점 ON, 9번 접점 OFF, 12번 접점 OFF


set_digital_outputs(bit_start, bit_end, val)

기능

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

인수

인수명

자료형

기본값

설명

bit_start

int

-

출력 신호 시작 접점 번호 (1~16)

bit_end

int

-

출력 신호 끝 접점 번호 (1~16)

val

int

-

출력 값

알아두기

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

  • val 은 bit_start =LSB, bit_end=MSB 가 되는 비트 조합의 값 입니다.
    Ex) bit_start =1, bit_end=4, val=0b1010 # 4번=ON, 3번=OFF, 2번=ON, 1번=OFF    

리턴

설명

0

성공

음수값

실패

예외

예외

설명

DR_Error (DR_ERROR_TYPE)

인수들의 데이터형 오류 시

DR_Error (DR_ERROR_VALUE)

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

DR_Error (DR_ERROR_RUNTIME)

C Extension 모듈 에러 발생 시

DR_Error (DR_ERROR_STOP)

프로그램 강제 종료 시

예제

Python
# 접점1=ON, 접점2=ON, 접점3=OFF, 접점4=OFF 출력
set_digital_outputs(bit_start=1, bit_end=4, val=0b0011) #0b는 2진수 의미

# 접점3=ON, 접점4=OFF 출력 
set_digital_outputs(bit_start=3, bit_end=4, val=0b01) #0b는 2진수 의미

# 접점1 ~ 접점8까지 모두 ON 출력
set_digital_outputs(1, 8, 0xff) #0x는 16진수 의미