3.7.1 3.7.0 3.6.0 3.5.0 3.4.0 3.3.0 3.2.2 3.2.1 3.2.0 Korean English Chinese Czech Dutch French German Hungarian Italian Japanese Polish Portuguese Spanish
3.7.1 3.7.0 3.6.0 3.5.0 3.4.0 3.3.0 3.2.2 3.2.1 3.2.0 Korean English Chinese Czech Dutch French German Hungarian Italian Japanese Polish Portuguese Spanish

set_modbus_output()

Definition

set_modbus_output(iobus, val, time=None, val2=None)

Features

This function sends the signal to an external Modbus system.

Function Code 05 Write Single Coil Register

Function Code 06 Write Single Holding Register

If time and val2 are specified, val is written first, and val2 is written to the same signal after time (sec) elapses.

Parameters

Parameter Name

Data Type

Default Value

Description

iobus

string

-

modbus name (set in the TP)

val

int

-

Output value (Range: 0~65535)

  • Modbus coil register: ON(1) / OFF(0)

  • Modbus holding register: register value

time

int or float

None

Delay time (sec) before val2 is written. Must be 0 or greater.

val2 must be specified when time is specified.

val2

int

None

Value to be written after the delay time (Range: 0~65535)

Note

  • When registered as a multiple signal, it is available by adding "_address" to the signal name. (e.g. "multi" with start address 10 → "multi_10", "multi_11")

  • When time is specified, the program proceeds to the next command without waiting for val2 to be written.

Return

Value

Description

0

Success

Exception

Exception

Description

DR_Error (DR_ERROR_TYPE)

Parameter data type error occurred

DR_Error (DR_ERROR_VALUE)

Parameter value is invalid

DR_Error (DR_ERROR_RUNTIME)

C extension module error occurred

DR_Error (DR_ERROR_STOP)

Program terminated forcefully

Example

Python
#Modbus Coil Registers are registered as "do1" and "do2".
set_modbus_output("do1", ON)
set_modbus_output("do2", OFF)

#Modbus Holding Registers are registered as "reg1" and "reg2".
set_modbus_output("reg1", 10)
set_modbus_output("reg2", 24)

#Modbus multiple signal is registered as "multi"(start address=10, cnt=2).
#"multi_10" & "multi_11" available
set_modbus_output("multi_10", 24)
set_modbus_output("multi_11", 65535)

#Delayed output: write 100 to "reg1", then change it to 50 after 3 sec
set_modbus_output("reg1", 100, 3, 50)
#Keyword arguments: write 50 to "reg2", then change it to 5 after 1 sec
set_modbus_output("reg2", 50, time=1, val2=5)

Keyword

set_ / modbus / set_modbus / modbus_output