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"
}
🤖 AI assistants / automation: start with the Agent Development Guide and Pre-generation Checklist (Chinese); machine-readable entry: /llms.txt; plain-text version: swap .html for .md in the URL