정의
set_modbus_output(iobus, val, time=None, val2=None)
기능
외부 Modbus 장치에 신호를 내보내기 위한 명령어입니다.
Function Code 05 Write Single Coil Register
Function Code 06 Write Single Holding Register
time과 val2를 지정하면 먼저 val을 출력하고, time(초)이 지난 뒤 같은 신호에 val2를 출력합니다.
인수
|
인수명 |
자료형 |
기본값 |
설명 |
|
iobus |
string |
- |
modbus 이름(TP에서 설정) |
|
val |
int |
- |
출력 값 (범위: 0~65535)
|
|
time |
int 또는 float |
None |
val2를 출력하기까지의 지연 시간(초), 0 이상의 값 time을 지정하면 val2도 반드시 지정해야 합니다. |
|
val2 |
int |
None |
지연 시간 후 출력할 값 (범위: 0~65535) |
알아두기
-
다중 신호로 등록된 경우 신호 이름에 "_주소"를 붙여 사용할 수 있습니다. (예: 시작 주소 10인 "multi" → "multi_10", "multi_11")
-
time을 지정해도 val2가 출력될 때까지 기다리지 않고 바로 다음 명령어를 실행합니다.
리턴
|
값 |
설명 |
|---|---|
|
0 |
성공 |
예외
|
예외 |
설명 |
|---|---|
|
DR_Error (DR_ERROR_TYPE) |
인수들의 데이터형 오류 시 |
|
DR_Error (DR_ERROR_VALUE) |
인수의 값이 유효하지 않을 시 |
|
DR_Error (DR_ERROR_RUNTIME) |
C Extension 모듈 에러 발생 시 |
|
DR_Error (DR_ERROR_STOP) |
프로그램 강제 종료 시 |
예제
# Modbus Coil Register "do1", "do2"가 등록되어 있는 경우
set_modbus_output("do1", ON)
set_modbus_output("do2", OFF)
# Modbus Holding Register "reg1", "reg2"가 등록되어 있는 경우
set_modbus_output("reg1", 10)
set_modbus_output("reg2", 24)
# 다중 신호 "multi"(시작 주소=10, cnt=2)가 등록되어 있는 경우
# "multi_10", "multi_11" 사용 가능
set_modbus_output("multi_10", 24)
set_modbus_output("multi_11", 65535)
# 지연 출력: "reg1"에 100을 출력하고, 3초 후 50으로 변경
set_modbus_output("reg1", 100, 3, 50)
# 키워드 인수로 지정: "reg2"에 50을 출력하고, 1초 후 5로 변경
set_modbus_output("reg2", 50, time=1, val2=5)
Keyword
set_ / modbus / set_modbus / modbus_output