Skip to content

Job File Settings

1. Job File Execution Status Settings

1.1 Job File Execution Mode

Mode ValueMode NameDescription
0stepStep mode
1stopStop mode
2restartRestart mode

1.2 Set Job File Execution Mode

Command: 0x2401 JOBEXE_MODE_SET

ParameterTypeRequiredDescription
typeintYesJob file execution status: 0=step, 1=stop
robotintYesRobot number, range [1, 4]

Request Example:

json
{
  "type": 0,
  "robot": 1
}

1.3 Run Without File

Command: 0x2402 RUNJOB_NOFILE

ParameterTypeRequiredDescription
robotintYesRobot number, range [1, 4]

Request Example:

json
{
  "robot": 1
}

1.4 Reverse Run

Command: 0x2403 REVERSEORDER_RUN

ParameterTypeRequiredDescription
switchboolYesfalse=forward, true=reverse

Request Example:

json
{
  "switch": true
}

1.5 Query Forward/Reverse Status

Command: 0x2405 REVERSEORDER_RUN_INQUIRE

Request Example:

json
{}

Response Command: 0x2406 REVERSEORDER_RUN_RESPOND

ParameterTypeRequiredDescription
switchboolYesfalse=forward, true=reverse

Response Example:

json
{
  "switch": false
}

2. Start Running Job File

2.1 Send Start Run Command

Command: 0x2501 JOBSEND_DONE

ParameterTypeRequiredDescription
robotintYesRobot number, range [1, 4]
jobnamestringYesJob file name
lineintYesJob file instruction line number, cannot be zero, cannot exceed total line count
globalStartboolYesWhether it is multi-robot mode
continueRunintYes1=continue running, 0=do not continue running
startOverintYes1=run from beginning, 0=continue running

continueRun and startOver Combination Description:

continueRunstartOverExecution Method
1falseResume from breakpoint
0trueRun from beginning
0falseRun from current line

Request Example:

json
{
  "robot": 1,
  "jobname": "aaa",
  "line": 1,
  "globalStart": false,
  "continueRun": 0,
  "startOver": 0
}

2.2 Stop Running Job File

Command: 0x2503 STOP_JOB_RUN

ParameterTypeRequiredDescription
robotintYesRobot number, range [1, 4]

Request Example:

json
{
  "robot": 1
}

3. Current Line Run Settings and Query

3.1 Set Current Line Run

Command: 0x9104 CURRENTROWRUN_SET

ParameterTypeRequiredDescription
robotintYesRobot number, range [1, 4]
jobfilenamestringYesJob file name
numintYesLine number

Request Example:

json
{
  "robot": 1,
  "jobfilename": "AAA",
  "num": 1
}

3.2 Query Current Line

Command: 0x9105 CURRENTROWRUN_INQUIRE

ParameterTypeRequiredDescription
robotintYesRobot number, range [1, 4]

Request Example:

json
{
  "robot": 1
}

3.3 Robot Run Status Response

Command: 0x9106 CURRENTROWRUN_RESPOND

ParameterTypeRequiredDescription
robotintYesRobot number, range [1, 4]
jobfilenamestringYesJob file name
numintYesLine number

Response Example:

json
{
  "robot": 1,
  "jobfilename": "AAA",
  "num": 1
}

3.4 Clear Run Status

Description: After the program is successfully imported, the teach pendant sends this protocol request to reset the program run status

Command: 0x9107 CLEARCONTINUERUN

Request Example:

json
{}

Response Command: 0x9108 CLEARCONTINUERUN_RESPOND

Response Example:

json
{}

4. Cycle Count

4.1 Set Robot Cycle Count

Command:

  • 0x2304 DEADMAN_MODE_SET
  • 0x5011 CYCLE_INDEX_SET
ParameterTypeRequiredDescription
robotintYesRobot number, range [1, 4]
indexintYesCycle count index

Request Example:

json
{
  "robot": 1,
  "index": 1
}

4.2 Query Robot Cycle Count

Command: 0x5012 CYCLE_COUNT_INQUIRE

ParameterTypeRequiredDescription
robotintYesRobot number, range [1, 4]

Request Example:

json
{
  "robot": 1
}

4.3 Cycle Count Response

Command: 0x5013 CYCLE_COUNT_RESPOND

ParameterTypeRequiredDescription
robotintYesRobot number, range [1, 4]
countintYesCurrent run count
indexintYesCycle count index (0=infinite loop)

Response Example:

json
{
  "robot": 1,
  "count": 0,
  "index": 1
}

5. Run Time

5.1 Query Robot Run Time

Command: 0x5022 RUNNING_TIME_INQUIRE

ParameterTypeRequiredDescription
robotintYesRobot number, range [1, 4]

Request Example:

json
{
  "robot": 1
}

5.2 Run Time Response

Command: 0x5023 RUNNING_TIME_RESPOND

ParameterTypeRequiredDescription
robotintYesRobot number, range [1, 4]
timeintYesCurrent run time

Response Example:

json
{
  "robot": 1,
  "time": 0
}

6. Program Instruction Sequence

6.1 Query Instruction List

Command: 0x5092 COMMAND_LIST_INQUIRE

ParameterTypeRequiredDescription
robotintYesRobot number

Request Example:

json
{
  "robot": 1
}

6.2 Return Instruction Count

Command: 0x5093 COMMAND_LIST_RESPOND

Description: There are at most two return signals

ParameterTypeRequiredDescription
jobnamearrayYesFile name list
numarrayYesLine number list
sendednumintYesNumber sent
totalnumintYesTotal count

Response Example:

json
{
  "jobname": ["SSS", "SSS"],
  "num": [2, 1],
  "sendednum": 2,
  "totalnum": 2
}

7. Global Background Auto-Start

7.1 Set Global Background Auto-Start

Command: 0x50c1 GLOBAL_PTHREAD_SELFSTART_SET

ParameterTypeRequiredDescription
robotintYesRobot number
namestringYesGlobal background name

Request Example:

json
{
  "robot": 1,
  "name": "Q1"
}

7.2 Query Global Background Auto-Start

Command: 0x50c2 GLOBAL_PTHREAD_SELFSTART_INQUIRE

ParameterTypeRequiredDescription
robotintYesRobot number

Request Example:

json
{
  "robot": 1
}

7.3 Global Background Auto-Start Response

Command: 0x50c3 GLOBAL_PTHREAD_SELFSTART_RESPOND

ParameterTypeRequiredDescription
robotintYesRobot number
namestringYesGlobal background name

Response Example:

json
{
  "robot": 1,
  "name": "Q1"
}

7.4 Start Global Background Auto-Start

Command: 0x50c4 GLOBAL_PTHREAD_RUN_CONTROL

ParameterTypeRequiredDescription
robotintYesRobot number
typeintYes1=start, 0=stop

Request Example:

json
{
  "robot": 1,
  "type": 1
}

7.5 Query Global Background Auto-Start Status

Command: 0x50c5 GLOBAL_PTHREAD_RUNSTATUS_INQUIRE

ParameterTypeRequiredDescription
robotintYesCurrent robot number
hasRunboolYesAuto-start status, true=started, false=stopped
runNameintYes1=get global background run status

Request Example:

json
{
  "robot": 1,
  "hasRun": true,
  "runName": 1
}

7.6 Global Background Auto-Start Status Response

Command: 0x50c6 GLOBAL_PTHREAD_RUNSTATUS_RESPOND

ParameterTypeRequiredDescription
robotintYesCurrent robot number
hasRunboolYesAuto-start status, true=started, false=stopped

Response Example:

json
{
  "robot": 1,
  "hasRun": false
}

8. Get Currently Opened Program

8.1 Request to Get Currently Opened Program

Command: 0x3a04

Sent by the upper computer to get the currently opened program

ParameterTypeRequiredDescription
robotintYesRobot number, range [1, 4]

Request Example:

json
{
  "robot": 1
}

8.2 Controller Response

Command: 0x3a05

Sent by the controller after receiving the 0x3a04 command

ParameterTypeRequiredDescription
openedJobNamestringYesCurrently opened job file

Response Example:

json
{
  "openedJobName": "asd"
}