add_modbus_signal()

Definition

add_modbus_signal(ip, port, name, reg_type, index, slaveid=255)

Starting with version 3.5, the value parameter of the add_modbus_signal function has been removed. Programs that previously used this function may encounter an error pop-up.

Features

This function registers the ModbusTCP signal. The Modbus I/O must be set in the Teach Pendant I/O set-up menu. Use this command only for testing if it is difficult to use the Teach Pendant. The Modbus menu is disabled in the Teach Pendant if it is set using this command.

Parameters

Parameter Name

Data Type

Default Value

Description

ip

string

-

IPv4 address of the ModbusTCP module

port

int

-

Port number of the ModbusTCP module (Range: 1 - 65535)

name

string

-

Modbus signal name (max 31 characters)

reg_type

int

-

Modbus signal type

  • DR_MODBUS_DIG_INPUT

  • DR_MODBUS_DIG_OUTPUT

  • DR_MODBUS_REG_INPUT

  • DR_MODBUS_REG_OUTPUT

index

int

-

Modbus signal index (Range: 0 - 65535)

slaveid

int

255

  • Slave ID of the ModbusTCP module
    (0 or 1-247 or 255)

0 : Broadcast address

255 : Default value for ModbusTCP

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
# An example of connecting two Modbus IO and allocating the contacts 
# Modbus IO 1 : IP address 192.168.137.254, port 502
Input Register Address 0 ~ 3, signal name “input1”~”input4”
Holding Register Addreess 0 ~ 3, signal name “output1”~”output4” 
# Modbus IO 2 : IP address 192.168.137.253, port 502
Input Register Address 0 ~ 3, signal name “input1”~”input4”
Holding Register Addreess 0 ~ 3, signal name “output1”~”output4” 
 
# set < Modbus IO 1 > “input1”~”input4”, “output1”~”output4”
add_modbus_signal(ip="192.168.137.254",port=502, name="input1", reg_type=DR_INPUT_REGISTER, index=0, slaveid=255)
add_modbus_signal(ip="192.168.137.254",port=502, name="input2", reg_type=DR_INPUT_REGISTER, index=1, slaveid=255)
add_modbus_signal(ip="192.168.137.254",port=502, name="input3", reg_type=DR_INPUT_REGISTER, index=2, slaveid=255)
add_modbus_signal(ip="192.168.137.254",port=502, name="input4", reg_type=DR_INPUT_REGISTER, index=3, slaveid=255)
 
add_modbus_signal(ip="192.168.137.254",port=502, name="output1", reg_type=DR_HOLDING_REGISTER, index=0, slaveid=255)
add_modbus_signal(ip="192.168.137.254",port=502, name=" output2", reg_type=DR_HOLDING_REGISTER, index=1, slaveid=255)
add_modbus_signal(ip="192.168.137.254",port=502, name=" output3", reg_type=DR_HOLDING_REGISTER, index=2, slaveid=255)
add_modbus_signal(ip="192.168.137.254",port=502, name=" output4", reg_type=DR_HOLDING_REGISTER, index=3, slaveid=255)
 
# set < Modbus IO 1 > “input5”~”input8”, “output5”~”output8”
add_modbus_signal(ip="192.168.137.253",port=502, name="input5", 
reg_type= DR_INPUT_REGISTER, index=0, slaveid=255)
add_modbus_signal(ip="192.168.137.253",port=502, name=" input6", 
reg_type= DR_INPUT_REGISTER, index=1, slaveid=255)
add_modbus_signal(ip="192.168.137.253",port=502, name=" input7", 
reg_type= DR_INPUT_REGISTER, index=2, slaveid=255)
add_modbus_signal(ip="192.168.137.253",port=502, name=" input8", 
reg_type= DR_INPUT_REGISTER, index=3, slaveid=255)
 
add_modbus_signal(ip="192.168.137.253",port=502, name=" output5", reg_type=DR_HOLDING_REGISTER, index=0, slaveid=255)
add_modbus_signal(ip="192.168.137.253",port=502, name=" output6", reg_type=DR_HOLDING_REGISTER, index=1, slaveid=255)
add_modbus_signal(ip="192.168.137.253",port=502, name=" output7", reg_type=DR_HOLDING_REGISTER, index=2, slaveid=255)
add_modbus_signal(ip="192.168.137.253",port=502, name=" output8", reg_type=DR_HOLDING_REGISTER, index=3, slaveid=255)

Keyword

add_ / add_modbus / modbus / modbus_ / modbus_signal