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)
|
|
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
#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