Skip to content

Modbus

1. Host Sets Modbus Master Parameters

Command: 0x7300

Parameter List

ParameterTypeRequiredDescription
masterStationobjectYesMaster station parameters, including RTU and TCP parameters
startAddressboolNoAddress offset; true means address unchanged, false means address auto-decrement by 1

masterStation Parameters

ParameterTypeRequiredDescription
typestringYesMaster station type; values "TCP", "RTU"
processNumberintYesProcess number to set; range [1,9]
RTUobjectNoRTU parameters
TCPobjectNoTCP parameters

RTU Parameters

ParameterTypeRequiredDescription
baudrateintYesBaud rate
checkBitstringYesCheck bit; values "N", "E", "O"
dataBitintYesData bit; range [5,8]
portintYesPort number
slaveIdintYesSlave ID; range [0,65535]
stopBitintYesStop bit; range [0,1]

TCP Parameters

ParameterTypeRequiredDescription
IPstringYesIP address
endian_typeintYesFloat endianness; 0 means AB CD, 1 means CD AB, 2 means BA DC, 3 means DC BA
portintYesPort number; range [0,65535]

Request Example

json
{
  "masterStation": {
    "RTU": {
      "baudrate": 115200,
      "checkBit": "E",
      "dataBit": 5,
      "port": 2,
      "slaveId": 1,
      "stopBit": 1
    },
    "TCP": {
      "IP": "192.168.1.14",
      "endian_type": 1,
      "port": 503
    },
    "processNumber": 1,
    "type": "TCP"
  },
  "startAddress": false
}

2. Host Queries Modbus Parameters

Command: 0x7301

Parameter List

ParameterTypeRequiredDescription
processNumberintYesProcess number to query; range [1,9]

Request Example

json
{
  "processNumber": 1
}

3. Controller Replies Host Modbus Parameters

Command: 0x7302

Parameter List

ParameterTypeRequiredDescription
typestringYesMaster station type; values "TCP", "RTU"
RTUobjectNoRTU parameters
TCPobjectNoTCP parameters
modbus_stateboolYesModbus connection status; true means connected, false means not connected
response_time_outintYesRead/write response time; unit ms
startAddressboolYesAddress offset; true means address unchanged, false means address auto-decrement by 1

RTU Parameters

ParameterTypeRequiredDescription
baudrateintYesBaud rate
checkBitstringYesCheck bit; values "N", "E", "O"
dataBitintYesData bit; range [5,8]
portintYesPort number
slaveIdintYesSlave ID; range [0,65535]
stopBitintYesStop bit; range [0,1]

TCP Parameters

ParameterTypeRequiredDescription
IPstringYesIP address
endian_typeintYesFloat endianness; 0 means AB CD, 1 means CD AB, 2 means BA DC, 3 means DC BA
portintYesPort number; range [0,65535]

Response Example

json
{
  "RTU": {
    "baudrate": 115200,
    "checkBit": "E",
    "dataBit": 5,
    "port": 2,
    "slaveId": 1,
    "stopBit": 1
  },
  "TCP": {
    "IP": "192.168.1.14",
    "endian_type": 1,
    "port": 503
  },
  "modbus_state": false,
  "response_time_out": 100,
  "startAddress": false,
  "type": "TCP"
}

4. Host Queries Modbus Connection Status

Command: 0x7303

Request Example

json
{}

5. Controller Replies Host Modbus Connection Status

Command: 0x7304

Parameter List

ParameterTypeRequiredDescription
ModbusConnectboolYesModbus connection status; true means connected, false means not connected

Response Example

json
{
  "ModbusConnect": false
}

6. Host Sets Modbus Slave Parameters

Command: 0x7305

Parameter List

ParameterTypeRequiredDescription
typestringYesCommunication method; values "TCP", "RTU"
RTUobjectNoRTU parameters
TCPobjectNoTCP parameters
master-slaveintYesModbus communication master/slave mode; 0 means master, 1 means slave
scancycleintYesScan cycle; range [8,1000]ms
stoprunintYesOperation on communication disconnect; 0 means no stop, 1 means stop

RTU Parameters

ParameterTypeRequiredDescription
baudrateintYesBaud rate
portintYesPort number
slaveIdintYesSlave ID; range [0,65535]

TCP Parameters

ParameterTypeRequiredDescription
IPstringYesIP address (default value)
endian_typeintYesFloat endianness; 0 means AB CD, 1 means CD AB, 2 means BA DC, 3 means DC BA
portintYesPort number; range [0,65535]

Request Example

json
{
  "RTU": {
    "baudrate": 115200,
    "port": 2,
    "slaveId": 1
  },
  "TCP": {
    "IP": "192.168.1.11",
    "endian_type": 0,
    "port": 502
  },
  "master-slave": 1,
  "scancycle": 100,
  "stoprun": 0,
  "type": "TCP"
}

7. Host Queries Modbus Slave Parameters

Command: 0x7306

Request Example

json
{}

8. Controller Replies Host Modbus Slave Parameters

Command: 0x7307

Parameter List

ParameterTypeRequiredDescription
typestringYesCommunication method; values "TCP", "RTU"
RTUobjectNoRTU parameters
TCPobjectNoTCP parameters
enableboolYesConnection enable
master-slaveintYesModbus communication master/slave mode; 0 means master, 1 means slave
scancycleintYesScan cycle; range [8,1000]ms
stoprunintYesOperation on communication disconnect; 0 means no stop, 1 means stop

RTU Parameters

ParameterTypeRequiredDescription
baudrateintYesBaud rate
portintYesPort number
slaveIdintYesSlave ID; range [0,65535]

TCP Parameters

ParameterTypeRequiredDescription
IPstringYesIP address (default value)
endian_typeintYesFloat endianness; 0 means AB CD, 1 means CD AB, 2 means BA DC, 3 means DC BA
portintYesPort number; range [0,65535]

Response Example

json
{
  "RTU": {
    "baudrate": 115200,
    "port": 2,
    "slaveId": 1
  },
  "TCP": {
    "IP": "192.168.1.11",
    "endian_type": 0,
    "port": 502
  },
  "enable": false,
  "master-slave": 1,
  "scancycle": 100,
  "stoprun": 0,
  "type": "TCP"
}

9. Host Sets Modbus Slave Connection Enable

Command: 0x7308

Parameter List

ParameterTypeRequiredDescription
enableboolYesModbus slave connection enable

Request Example

json
{
  "enable": true
}

10. Host Sets Modbus Slave Heartbeat Detection Enable

Command: 0x7309

Parameter List

ParameterTypeRequiredDescription
checkheartboolYesHeartbeat detection enable

Request Example

json
{
  "checkheart": true
}

11. Host Queries Modbus Slave Heartbeat Detection Enable

Command: 0x703A

Request Example

json
{}

12. Controller Replies Host Modbus Slave Heartbeat Detection Enable

Command: 0x703B

Parameter List

ParameterTypeRequiredDescription
checkheartboolYesHeartbeat detection enable

Response Example

json
{
  "checkheart": true
}

13. Host Sets Modbus Program

Command: 0x703C

Parameter List

ParameterTypeRequiredDescription
jobnamestringYesSelected program name
programidintYesProgram number; range [1,300]
robotintYesCurrent robot number

Request Example

json
{
  "jobname": "AA",
  "programid": 1,
  "robot": 1
}

14. Host Queries Modbus Program

Command: 0x703D

Parameter List

ParameterTypeRequiredDescription
numintYesQuery count; fixed at 10
robotintYesCurrent robot number
startprogramidintYesStarting program number for query sequence; range [1,30]

Request Example

json
{
  "num": 10,
  "robot": 1,
  "startprogramid": 1
}

15. Controller Replies Host Modbus Program

Command: 0x703E

Parameter List

ParameterTypeRequiredDescription
jobnamelistarrayYesProgram name list; length 10
robotintYesCurrent robot number
startprogramidintYesStarting program number for sequence; range [1,30]
sumintYesTotal number of available programs

Response Example

json
{
  "jobnamelist": ["AA", "", "", "", "", "", "", "", "", ""],
  "robot": 1,
  "startprogramid": 1,
  "sum": 300
}