Skip to content

Secondary Development API(JobFiles,InstructionOperations)

This Chapter Covers Job File Management, instruction insertion, and run queue control interfaces.

Function Category Index

Job File Management

FunctionDescription
NRC_CreateJobfile/NRC_OpenJobfile/NRC_DeleteJobfileCreate/open/delete job file
NRC_JudgeJobIsExistCheck If Job File Exists
NRC_GetJobfileLineSumGet Job File Total Line Count
NRC_JobfileEraseCmdDelete Instruction At Specified Line In Job File

Job File Run Control

FunctionDescription
NRC_StartRunJobfileStart/continue running job file
NRC_PauseRunJobfilePause Running Job File
NRC_StopRunJobfileStop Running Job File(from the beginning)
NRC_StopRunJobfileNotPoweroffStop Running(without power off)
NRC_StepRunJobfileStep Run One Instruction Line
NRC_GetCurrentOrderRunsGet Execution Direction(forward/reverse)
NRC_GetDistanceToOldTrackGet Distance To Original Trajectory Stop Point
NRC_GetCycleIndex/NRC_GetCycleCount/NRC_GetCycleTimeSecCycle Count/time query
NRC_SetCycleIndexSet Cycle Count

Local Background Program

FunctionDescription
NRC_CreatePthreadJobfile/NRC_OpenPthreadJobfileCreate/open background program
NRC_DeletePthreadJobfile/NRC_JudgePthreadJobIsExistDelete/check background program

File-less run queue

FunctionDescription
NRC_CreateNoFlieRunqueueCreate File-less run queue
NRC_InsertNoFlieRunqueueInsert A Set Of Instructions Into Queue
NRC_StartRunNoFlieRunqueueStart Running File-less queue
NRC_PauseRunNoFlieRunqueuePause Running Queue
NRC_StopRunNoFlieRunqueueStop Running Queue
NRC_StopRunNoFlieRunqueueNotPoweroffStop(without power off)

Append Run Mode

FunctionDescription
NRC_OpenInstrAppendRunModeEnable Append Run Mode(auto power on)
NRC_CloseInstrAppendRunModeDisable Append Run Mode(auto power off)
NRC_AppendRunInstrAppend Run Instruction
NRC_PauseInstrAppendRun/NRC_PauseInstrAppendRunAsynchronousPause(sync/async)
NRC_RestartInstrAppendRunContinue Running
NRC_PauseInstrAppendedRunInBreakpoint/NRC_RestartInstrAppendRunInBreakpointBreak Point Mode Pause/continue
NRC_StopInstrAppendRunStop And Clear Queue
NRC_StopInstrAppendRunNotPoweroffStop(without power off)
NRC_GetIsInstrAppendRunModeGet Whether In Append Mode
NRC_GetRestAppendInstrNumGet Remaining Instruction Count
NRC_GetCurrentInstrRestPosNumGet Current Instruction Remaining Points

Job File Insert Instructions(ByType)

MotionInstructions:

FunctionDescription
NRC_JobfileInsertMOVJ/MOVL/MOVS/MOVC/IMOVJoint/linear/arc/incremental motion
NRC_JobfileInsertMOVJEXT/MOVLEXT/MOVCEXTMotion Instructions With External Axis
NRC_JobfileInsertPOSCALALLBulk Position Modify Instruction

IOandTimerInstructions:

FunctionDescription
NRC_JobfileInsertDOUTDigital Output
NRC_JobfileInsertTIMERDelay
NRC_JobfileInsertWAITWait Condition

FlowControlInstructions:

FunctionDescription
NRC_JobfileInsertUNTIL/NRC_JobfileInsertENDUNTILConditional Loop
NRC_JobfileInsertIF/NRC_JobfileInsertVarIFConditional Judgment(port/variable)
NRC_JobfileInsertELSEElse Branch
NRC_JobfileInsertENDIFCondition End
NRC_JobfileInsertWHILE/NRC_JobfileInsertVarWHILEWhile Loop
NRC_JobfileInsertENDWHILELoop End

ProgramControlInstructions:

FunctionDescription
NRC_JobfileInsertPAUSERUNPause Run
NRC_JobfileInsertCONTINUERUNContinue Running Specified Program
NRC_JobfileInsertSTOPRUNStop Run
NRC_JobfileInsertRESTARTRUNRestart Run
NRC_JobfileInsertPthreadStart/PthreadEndStart/end background program
NRC_JobfileInsertSETVARSet Variable
NRC_JobfileInsertOPCmdOperation Instruction
NRC_JobfileInsertCMDNOTEComment

PalletizingInstructions:

FunctionDescription
NRC_JobfileInsertPALON/PALOFFPallet I Zing On/off
NRC_JobfileInsertPALGRIPPER/PALCLEARGripper Switch/clear
NRC_JobfileInsertPALENTER/PALSHIFT/PALREALEnter/offset/place

WeldingInstructions:

FunctionDescription
NRC_JobfileInsertARCON/ARCOFFWelding Arc Start/end
NRC_JobfileInsertTOFFSETON/TOFFSETOFFTool Offset On/off

Custom:

FunctionDescription
NRC_JobfileInsertCustomInstructionInsert Custom Instruction

Run Queue Insert Instructions

Correspondingtojobfileinsertinstructions.UsetheNRC_RunqueueInsert*seriesoffunctionstoinsertinstructionsintothefile-lessrunqueue.Parametersareessentiallythesameasthejobfileversion(withoutthelineparameter).

Status Query

FunctionDescription
NRC_GetProgramRunStatusGet Program Run Status(0-stopped1-paused2-running)
NRC_GetRobotRunStatusGet Robot Motion Status
NRC_GetTeachBoxConnectStatusGet Teach Pendant Connection Status
NRC_GetOpenJobFileNameGet Currently Opened Job Filename
NRC_GetRunqueueCurrentRunLineGet Queue Current Running Line Number
NRC_GetJobfileCurrentRunLineGet Job File Current Running Line Number
NRC_GetCurrentInstrRestPosNumGet Current Instruction Remaining Points

Callback Functions

FunctionDescription
NRC_SetCompleteOneInstrCallBackSet Instruction Completion Callback(twooverloads:with/withoutparameters)

Detailed API Documentation

FunctionDescription
NRC_CreateJobfileCreate A Job File.
NRC_OpenJobfileOpen A Job File.
NRC_DeleteJobfileDelete A Job File.
NRC_JudgeJobIsExistCheck If A Job File Exists.
NRC_CreatePthreadJobfileCreate A Local Background Program.
NRC_OpenPthreadJobfileOpen A Local Background Program.
NRC_DeletePthreadJobfileDelete A Local Background Program.
NRC_JudgePthreadJobIsExistCheck If A Local Background Program Exists.
NRC_GetJobfileLineSumTotal Line Count Of The Currently Opened Job File.
NRC_StartRunJobfileStart/continue running a job file.
NRC_StepRunJobfileSingle-step run one line of instruction in a job file.
NRC_PauseRunJobfilePause Running A Job File.
NRC_StopRunJobfileStop Running A Job File.
NRC_GetDistanceToOldTrackGet The Distance From The Current Position To The Original Interpolation Trajectory Stop Point.
NRC_StopRunJobfileNotPoweroffStop Running A Job File Without Powering Off.
NRC_GetCurrentOrderRunsGet Whether The Current Program Execution Direction Is Forward Or Reverse.
NRC_CreateNoFlieRunqueueCreates A File-less run queue.
NRC_StartRunNoFlieRunqueueSingle-step run one line of instruction in a job file.
NRC_PauseRunNoFlieRunqueuePauses The File-less run queue.
NRC_StopRunNoFlieRunqueueStops The File-less run queue.
NRC_StopRunNoFlieRunqueueNotPoweroffMotionqueue:stopsrunningwithoutpoweringoff.
NRC_JobfileEraseCmdDeletes A Job File Instruction.
NRC_InsertNoFlieRunqueueInsert A Set Of Instruction Data Into The Run Queue.
NRC_OpenInstrAppendRunModeEnableappendrunmode;addingrunqueueswillexecuteimmediately.
NRC_CloseInstrAppendRunModeDisable Append Run Mode.
NRC_AppendRunInstrAdd Run Queue In Append Run Mode.
NRC_PauseInstrAppendRunPause Append Run.
NRC_PauseInstrAppendRunAsynchronousAsynchronously Pauses Append Run.
NRC_RestartInstrAppendRunRestart Append Run.
NRC_PauseInstrAppendedRunInBreakpointPauses Append Run In Break Point Mode.
NRC_RestartInstrAppendRunInBreakpointRestart Append Run In Break Point Mode.
NRC_StopInstrAppendRunStop Append Run.
NRC_StopInstrAppendRunNotPoweroffStop The Appended Run.
NRC_GetIsInstrAppendRunModeGet Whether Currently In Append Run Mode.
NRC_GetRestAppendInstrNumGet The Remaining Instruction Count In Append Run.
NRC_GetCurrentInstrRestPosNumGet The Remaining Point Count Of The Current Running Instruction.
NRC_SetCompleteOneInstrCallBackSetthecallbackfunctionwhenaninstructioncompletesexecution.Thiscallbackwillbecalledwhenaninstructionfinishesexecuting.
NRC_SetCompleteOneInstrCallBackSetthecallbackfunctionwhenaninstructioncompletesexecution.Thiscallbackwillbecalledwhenaninstructionfinishesexecuting.Thiscallbackfunctionacceptsuserparameters.
NRC_RunqueueInsertMOVJInsert Mo Vj Instruction Into Run Queue.
NRC_RunqueueInsertMOVLInsert Mo Vl Instruction Into Run Queue.
NRC_RunqueueInsertMOVSInsert Mo Vs Instruction Into Run Queue.
NRC_RunqueueInsertMOVCInsert Mo Vc Instruction Into Run Queue.
NRC_RunqueueInsertIMOVInsert Imov Instruction Into Run Queue.
NRC_RunqueueInsertDOUTInsert D Out Instruction Into Run Queue.
NRC_RunqueueInsertTIMERInsert Timer Instruction Into Run Queue.
NRC_RunqueueInsertWAITInsert Wait Instruction Into Run Queue.
NRC_RunqueueInsertUNTILInsert Until Instruction Into Run Queue.
NRC_RunqueueInsertENDUNTILInsert End Until Instruction Into Run Queue.
NRC_RunqueueInsertIFInsert If Instruction Into Run Queue.
NRC_RunqueueInsertWHILEInsert While Instruction Into Run Queue.
NRC_RunqueueInsertELSEInsert Else Instruction Into Run Queue.
NRC_RunqueueInsertENDWHILEInsert End While Instruction Into Run Queue.
NRC_RunqueueInsertENDIFInsert End If Instruction Into Run Queue.
NRC_RunqueueInsertPALONInsert Pal On Instruction Into Run Queue.
NRC_RunqueueInsertPALOFFInsert Pal Off Instruction Into Run Queue.
NRC_RunqueueInsertPALGRIPPERInsert Pal Gripper Instruction Into Run Queue.
NRC_RunqueueInsertPALCLEARInsert Pal Clear Instruction Into Run Queue.
NRC_RunqueueInsertPALENTERInsert Pal Enter Instruction Into Run Queue.
NRC_RunqueueInsertPALSHIFTInsert Pal Shift Instruction Into Run Queue.
NRC_RunqueueInsertPALREALInsert Pal Real Instruction Into Run Queue.
NRC_RunqueueInsertTOFFSETONInsert T Offset On Instruction Into Run Queue.
NRC_RunqueueInsertTOFFSETOFFInsert T Offset Off Instruction Into Run Queue.
NRC_RunqueueInsertARCONInsert Arc On Instruction Into Run Queue.
NRC_RunqueueInsertARCOFFInsert Arc Off Instruction Into Run Queue.
NRC_RunqueueInsertCustomInstructionInsert Custom Instruction Into Run Queue.
NRC_JobfileInsertMOVJInsert Mo Vj Instruction Into Job File.
NRC_JobfileInsertMOVLInsert Mo Vl Instruction Into Job File.
NRC_JobfileInsertMOVSInsert Mo Vs Instruction Into Job File.
NRC_JobfileInsertMOVCInsert Mo Vc Instruction Into Job File.
NRC_JobfileInsertIMOVInsert Imov Instruction Into Job File.
NRC_JobfileInsertDOUTInsert D Out Instruction Into Job File.
NRC_JobfileInsertTIMERInsert Timer Instruction Into Job File.
NRC_JobfileInsertWAITInsert Wait Instruction Into Job File.
NRC_JobfileInsertUNTILInsert Until Instruction Into Job File.
NRC_JobfileInsertENDUNTILInsert End Until Instruction Into Job File.
NRC_JobfileInsertIFInsert If Instruction Into Job File.
NRC_JobfileInsertVarIFInsert Parameterized If Instruction Into Job File.
NRC_JobfileInsertWHILEInsert While Instruction Into Job File.
NRC_JobfileInsertVarWHILEInsert Parameterized While Instruction Into Job File.
NRC_JobfileInsertELSEInsert Else Instruction Into Job File.
NRC_JobfileInsertENDWHILEInsert End While Instruction Into Job File.
NRC_JobfileInsertENDIFInsert End If Instruction Into Job File.
NRC_JobfileInsertPAUSERUNInsert Pause Run Instruction Into Job File.
NRC_JobfileInsertCONTINUERUNInsert Continue Run Instruction Into Job File.
NRC_JobfileInsertSTOPRUNInsert Stop Run Instruction Into Job File.
NRC_JobfileInsertRESTARTRUNInsert Restart Run Instruction Into Job File.
NRC_JobfileInsertCMDNOTEInsert Cm D Note Instruction Into Job File.
NRC_JobfileInsertPthreadStartInsertPTHREAD_STARTinstructionintojobfile.
NRC_JobfileInsertPthreadEndInsertPTHREAD_ENDinstructionintojobfile.
NRC_JobfileInsertSETVARInsert Set Var Instruction Into Job File.
NRC_JobfileInsertOPCmdInsert Opc Md Instruction Into Job File.
NRC_JobfileInsertPALONInsert Pal On Instruction Into Job File.
NRC_JobfileInsertPALOFFInsert Pal Off Instruction Into Job File.
NRC_JobfileInsertPALGRIPPERInsert Pal Gripper Instruction Into Job File.
NRC_JobfileInsertPALCLEARInsert Pal Clear Instruction Into Job File.
NRC_JobfileInsertPALENTERInsert Pal Enter Instruction Into Job File.
NRC_JobfileInsertPALSHIFTInsert Pal Shift Instruction Into Job File.
NRC_JobfileInsertPALREALInsert Pal Real Instruction Into Job File.
NRC_JobfileInsertTOFFSETONInsert T Offset On Instruction Into Job File.
NRC_JobfileInsertTOFFSETOFFInsert T Offset Off Instruction Into Job File.
NRC_JobfileInsertARCONInsert Arc On Instruction Into Job File.
NRC_JobfileInsertARCOFFInsert Arc Off Instruction Into Job File.
NRC_JobfileInsertCustomInstructionInsert Custom Instruction Into Job File.
NRC_GetRunqueueCurrentRunLineGet The Current Running Line Number Of The Run Queue.
NRC_GetJobfileCurrentRunLineGet The Current Running Line Number Of The Job File.
NRC_GetCycleIndexGet The Total Number Of Times The Current Job File Should Run.
NRC_GetCycleCountGet The Number Of Times The Current Job File Has Been Run.
NRC_GetCycleTimeSecGet The Time The Current Job File Has Been Running.
NRC_SetCycleIndexSet The Total Number Of Times The Current Job File Should Run.
NRC_RunqueueInsertMOVJEXTInsert Mo Vj Ext Instruction Into Run Queue.
NRC_JobfileInsertMOVJEXTInsert Mo Vj Ext Instruction Into Job File.
NRC_RunqueueInsertMOVLEXTInsert Mo Vl Ext Instruction Into Run Queue.
NRC_JobfileInsertMOVLEXTInsert Mo Vl Ext Instruction Into Job File.
NRC_RunqueueInsertMOVCEXTInsert M Ovce Xt Instruction Into Run Queue.
NRC_JobfileInsertMOVCEXTInsert M Ovce Xt Instruction Into Job File.
NRC_JobfileInsertPOSCALALLInsert Position Bulk Modify Instruction Into Job File.
NRC_RunqueueInsertPOSCALALLInsert Position Bulk Modify Instruction Into Run Queue.

NRC_CreateJobfile

Function PrototypeintNRC_CreateJobfile(std::stringjobname);
DescriptionCreate A Job File.
ParametersInputParameters:
jobnamenameofthejobfiletocreate
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesNone

NRC_OpenJobfile

Function PrototypeintNRC_OpenJobfile(std::stringjobname);
DescriptionOpen A Job File.
ParametersInputParameters:
jobnamenameofthejobfiletoopen
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesNone

NRC_DeleteJobfile

Function PrototypeintNRC_DeleteJobfile(std::stringjobname);
DescriptionDelete A Job File.
ParametersInputParameters:
jobnamenameofthejobfiletodelete
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesNone

NRC_JudgeJobIsExist

Function PrototypeintNRC_JudgeJobIsExist(std::stringjobname);
DescriptionCheck If A Job File Exists.
ParametersInputParameters:
jobnamenameofthejobfiletocheck
Return ValueReturnswhetherthequeriedjobfileexists
0Jobfiledoesnotexist
1Jobfileexists
NotesNone

NRC_CreatePthreadJobfile

Function PrototypeintNRC_CreatePthreadJobfile(std::stringjobname);
DescriptionCreate A Local Background Program.
ParametersInputParameters:
jobnamenameofthelocalbackgroundprogramtocreate
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBackgroundprogramscannotinsertanymotioninstructions;onlylogicaloperationsareallowed.

NRC_OpenPthreadJobfile

Function PrototypeintNRC_OpenPthreadJobfile(std::stringjobname);
DescriptionOpen A Local Background Program.
ParametersInputParameters:
jobnamenameofthelocalbackgroundprogramtoopen
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesNone

NRC_DeletePthreadJobfile

Function PrototypeintNRC_DeletePthreadJobfile(std::stringjobname);
DescriptionDelete A Local Background Program.
ParametersInputParameters:
jobnamenameofthelocalbackgroundprogramtodelete
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesNone

NRC_JudgePthreadJobIsExist

Function PrototypeintNRC_JudgePthreadJobIsExist(std::stringjobname);
DescriptionCheck If A Local Background Program Exists.
ParametersInputParameters:
jobnamenameofthelocalbackgroundprogramtocheck
Return ValueReturnswhetherthequeriedjobfileexists
0Localbackgroundprogramdoesnotexist
1Localbackgroundprogramexists
NotesNone

NRC_GetJobfileLineSum

Function PrototypeintNRC_GetJobfileLineSum();
DescriptionTotal Line Count Of The Currently Opened Job File.
ParametersNone
Return ValueReturns The Total Line Count Of The Currently Opened Job File.
NotesBeforecallingthisfunction,pleasefirstcall
NRC_CreateJobfile(std::stringjobname)orNRC_OpenJobfile(std::stringjobname)tocreateoropenajobfile.

NRC_StartRunJobfile

Function PrototypeintNRC_StartRunJobfile(conststd::string&jobname);
DescriptionStart/continue running a job file.
ParametersInputParameters:
jobnamenameofthejobfiletostartrunning, this parameter is invalid when continuing
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesThisfunctionisonlyvalidinrunmode!
Aftersuccessfullycallingthisfunction, therobotwillstartmoving.Pleaseensuresafety!

NRC_StepRunJobfile

Function PrototypeintNRC_StepRunJobfile(conststd::string&jobname,intline);
DescriptionSingle-step run one line of instruction in a job file.
ParametersInputParameters:
jobnamenameofthejobfiletosingle-step run, thisparameterisinvalidwhencontinuing
lineinstructionlinenumbertosingle-step run, this parameter is invalid when continuing
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesThisfunctionisonlyvalidinrunmode!
Aftersuccessfullycallingthisfunction, therobotwillstartmoving.Pleaseensuresafety!

NRC_PauseRunJobfile

Function PrototypeintNRC_PauseRunJobfile();
DescriptionPause Running A Job File.
ParametersNone
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesPausesthejobfile.CallNRC_StartRunJobfile()tocontinuerunning.

NRC_StopRunJobfile

Function PrototypeintNRC_StopRunJobfile();
DescriptionStop Running A Job File.
ParametersNone
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesStopsthejobfile.Afterexecution,callingNRC_StartRunJobfile(std::stringjobname)willrestartfromthebeginning.

NRC_GetDistanceToOldTrack

Function PrototypeintNRC_GetDistanceToOldTrack(introbot,double&distance);
DescriptionGet The Distance From The Current Position To The Original Interpolation Trajectory Stop Point.
ParametersInputParameters:
robotrobotnumber
distancethelineardistancebetweenthestoppointandthecurrentpoint
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesNone

NRC_StopRunJobfileNotPoweroff

Function PrototypeintNRC_StopRunJobfileNotPoweroff();
DescriptionStop Running A Job File Without Powering Off.
ParametersNone
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesStopsthejobfilewithoutpoweringoff.Afterexecution,callingNRC_StartRunJobfile(std::stringjobname)willrestartfromthebeginning.

NRC_GetCurrentOrderRuns

Function PrototypeintNRC_GetCurrentOrderRuns(bool&order);
DescriptionGet Whether The Current Program Execution Direction Is Forward Or Reverse.
ParametersOutputParameters:
orderexecutiondirection:true/false(forward/reverseexecution)
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesNone

NRC_CreateNoFlieRunqueue

Function PrototypeintNRC_CreateNoFlieRunqueue();
DescriptionCreates A File-less run queue.
ParametersNone
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesAfter Creating A File-less run queue, call the insert instruction function, then call the start running function to execute one or more instructions.

NRC_StartRunNoFlieRunqueue

Function PrototypeintNRC_StartRunNoFlieRunqueue();
DescriptionSingle-step run one line of instruction in a job file.
ParametersNone
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesAfter Starting, to add new run instructions, please recreate a new file-lessrunqueueafterthisrunfinishes.
Aftersuccessfullycallingthisfunction, therobotwillstartmoving.Pleaseensuresafety.

NRC_PauseRunNoFlieRunqueue

Function PrototypeintNRC_PauseRunNoFlieRunqueue();
DescriptionPauses The File-less run queue.
ParametersNone
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesPausesthefile-lessrunqueue.CallNRC_StartRunNoFlieRunqueue()tocontinuerunning.

NRC_StopRunNoFlieRunqueue

Function PrototypeintNRC_StopRunNoFlieRunqueue();
DescriptionStops The File-less run queue.
ParametersNone
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesAfter Stopping, to continue running, please recreate a new file-less run queue.

NRC_StopRunNoFlieRunqueueNotPoweroff

Function PrototypeintNRC_StopRunNoFlieRunqueueNotPoweroff();
DescriptionMotionqueue:stopsrunningfile-less run queue without powering off.
ParametersNone
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesAfter Stopping, to continue running, please recreate a new file-less run queue.

NRC_JobfileEraseCmd

Function PrototypeintNRC_JobfileEraseCmd(intline);
DescriptionDeletes A Job File Instruction.
ParametersInputParameters:
linelinenumberoftheinstructiontodelete,parameterrange:0<line<=NRC_GetJobfileLineSum()
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesNone

NRC_InsertNoFlieRunqueue

Function PrototypeintNRC_InsertNoFlieRunqueue(std::vector<NRC_InstrDataBase*>&instrVec);
DescriptionInsert A Set Of Instruction Data Into The Run Queue.
ParametersInputParameters:
instrVecthesetofinstructiondatatoinsert
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesExample:
std::vector<NRC_InstrDataBase*>instrVec;
//queuedoesnotneedtobecreated,itwillbecreatedautomatically
instrVec.push_back(newNRC_InstrDataMOVJ(50,pos1,5));
instrVec.push_back(newNRC_InstrDataMOVL(30,pos2,2));
instrVec.push_back(newNRC_InstrDataMOVC(20,pos0,3));
instrVec.push_back(newNRC_InstrDataMOVC(20,pos1,3));
NRC_InsertNoFlieRunqueue(instrVec);
//Instructionscanbeinsertedinmultiplegroups/batches.Laterinsertionswillbeappendedafterpreviousones.
instrVec.clear();
instrVec.push_back(newNRC_InstrDataIMOV(40,dev1,0));
instrVec.push_back(newNRC_InstrDataDOUT(5,1));
instrVec.push_back(newNRC_InstrDataTIMER(3.3));
instrVec.push_back(newNRC_InstrDataWAIT(newNRC_ConditionJudge(NRC_ConditionJudge::INT_,3,NRC_ConditionJudge::LESS,NRC_ConditionJudge::DOUBLE_,5),2.2));
instrVec.push_back(newNRC_InstrDataWAIT(newNRC_ConditionJudge(NRC_ConditionJudge::DIN_,2,NRC_ConditionJudge::EQUAL_TO,NRC_ConditionJudge::CONST_,1),0));
instrVec.push_back(newNRC_InstrDataMOVJ(30,pos1,1));
NRC_InsertNoFlieRunqueue(instrVec);
//startexecutingthequeue
NRC_StartRunNoFlieRunqueue();

NRC_OpenInstrAppendRunMode

Function PrototypeintNRC_OpenInstrAppendRunMode();
DescriptionEnableappendrunmode;addingrunqueueswillexecuteimmediately.
ParametersNone
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesAftersuccessfullycallingthisfunction,therobotwillauto-enable.Pleaseensuresafety.
Appendrunmodecanonlybeenabledwhenservoisinreadystate,i.e.,NRC_GetServoStatus()==1.
Inappendrunmode,ifservoerrors,runerrors,orparseerrorsoccur,itwillautomaticallyexitappendmodeanddisable.
Inappendrunmode,switchingtoteachorrunmodewillautomaticallyexitappendmodeanddisable.

NRC_CloseInstrAppendRunMode

Function PrototypeintNRC_CloseInstrAppendRunMode();
DescriptionDisable Append Run Mode.
ParametersNone
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesAftersuccessfullycallingthisfunction,therobotwillautomaticallydisable.
Onlywhentherunqueueisemptyorallrunqueueshavecompletedcandisableappendrunmode,i.e.,NRC_GetProgramRunStatus()==0

NRC_AppendRunInstr

Function PrototypeintNRC_AppendRunInstr(std::vector<NRC_InstrDataBase*>&instrVec);
DescriptionAdd Run Queue In Append Run Mode.
ParametersInputParameters:
instrVecthesetofinstructiondatatoinsert
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesAfteraddingtotherunqueue, therobotwillimmediatelyexecutetheaddedqueue.Pleaseensuresafety.
Onlyrobotmotioninstructionscanbeaddedtotherunqueue.

Example:
//Enableappendrunmode,robotauto-enables
NRC_OpenInstrAppendRunMode();
std::vector<NRC_InstrDataBase*>instrVec;
instrVec.push_back(newNRC_InstrDataMOVJ(50,pos1,5));
instrVec.push_back(newNRC_InstrDataMOVL(30,pos2,2));
//Afteraddingthequeue,therobotrunsdirectly
NRC_AppendRunInstr(instrVec);
......
instrVec.clear();
instrVec.push_back(newNRC_InstrDataMOVC(20,pos0,3));
instrVec.push_back(newNRC_InstrDataMOVC(20,pos1,3));
//Aftertherobotfinishesrunningthepreviouslyaddedqueue,itwillconnecttothisnewlyaddedqueue
NRC_AppendRunInstr(instrVec);
......
NRC_PauseInstrAppendRun();//pauserun
......
instrVec.clear();
instrVec.push_back(newNRC_InstrDataMOVJ(50,pos1,5));
instrVec.push_back(newNRC_InstrDataMOVL(30,pos2,2));
//Queueaddedduringpausecanalsorunnormallyaftercallingrestart
NRC_AppendRunInstr(instrVec);
......
NRC_RestartInstrAppendRun();//restart
......
//stoprunning,robotstops,andclearallqueues
NRC_StopInstrAppendRun();
//Disableappendrunmode,robotautomaticallydisablesservo
NRC_CloseInstrAppendRunMode();

NRC_PauseInstrAppendRun

Function PrototypeNRC_PauseInstrAppendRun();NRC_PauseInstrAppendRun();
DescriptionPause Append Run.
ParametersNone
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesAftersuccessfullycallingthisfunction,therobotwillpause.Thisfunctionwillexitaftertherobotstopsorcalls500mstoexit;callNRC_RestartInstrAppendRun()tocontinuerunning.
Therunqueueaddedduringpausewillnotrunimmediately;insteaditisplacedinacachequeueandwillonlyrunafterrestartiscalled.

NRC_PauseInstrAppendRunAsynchronous

Function PrototypeintNRC_PauseInstrAppendRunAsynchronous();
DescriptionAsynchronously Pauses Append Run.
ParametersNone
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesAftersuccessfullycallingthisfunction,therobotwillpause.Thisfunctionwillexitdirectly;callNRC_RestartInstrAppendRun()tocontinuerunning.
Therunqueueaddedduringpausewillnotrunimmediately;insteaditisplacedinacachequeueandwillonlyrunafterrestartiscalled.

NRC_RestartInstrAppendRun

Function PrototypeintNRC_RestartInstrAppendRun();
DescriptionRestart Append Run.
ParametersNone
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesWhen The Robot Is About To Pause, calling this function will allow the robot to continue running.

NRC_PauseInstrAppendedRunInBreakpoint

Function PrototypeintNRC_PauseInstrAppendedRunInBreakpoint();
DescriptionPauses Append Run In Break Point Mode.
ParametersNone
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesAftersuccessfullycallingthisfunction,,robotwill pause running,records the running statusatthecurrentbreakpoint,andpowersoff.Thisfunctionwilltakeabout500mstoexitaftertherobotstops.CallNRC_RestartInstrAppendRunInBreakpoint()tocontinuerunning.
Therunqueueaddedduringpausewillnotrunimmediately;insteaditisplacedinacachequeueandwillonlyrunafterrestartiscalled.

NRC_RestartInstrAppendRunInBreakpoint

Function PrototypeintNRC_RestartInstrAppendRunInBreakpoint();
DescriptionRestart Append Run In Break Point Mode.
ParametersNone
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesWhen The Robot Stops At A Break Point, calling this function can make the robot continue running

NRC_StopInstrAppendRun

Function PrototypeintNRC_StopInstrAppendRun();
DescriptionStop Append Run.
ParametersNone
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesAfter Successfully Calling This Function, the robot stops, clears all run queues, and exits append mode.

NRC_StopInstrAppendRunNotPoweroff

Function PrototypeintNRC_StopInstrAppendRunNotPoweroff();
DescriptionStop The Appended Run.
ParametersNone
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesAftersuccessfullycallingthisfunction,therobotstops,clearsallrunqueues,remainsinappendmode,anddoesnotpoweroff.
MustcallNRC_RestartInstrAppendRun()tocontinuerunningnewlyappendedqueues.

NRC_GetIsInstrAppendRunMode

Function PrototypeintNRC_GetIsInstrAppendRunMode();
DescriptionGet Whether Currently In Append Run Mode.
ParametersNone
Return ValueWhethercurrentlyinappendrunmode0-Notinappendrunmode1-Currently In Append Run Mode
NotesNone

NRC_GetRestAppendInstrNum

Function PrototypeintNRC_GetRestAppendInstrNum();
DescriptionGet The Remaining Instruction Count In Append Run.
ParametersNone
Return ValueCurrent Remaining Instruction Count
NotesForm Ov C Instructions, twoentriesformapair.Wheninserting, two are inserted, but during execution, they are counted as one

NRC_GetCurrentInstrRestPosNum

Function PrototypeintNRC_GetCurrentInstrRestPosNum();
DescriptionGet The Remaining Point Count Of The Current Running Instruction.
ParametersNone
Return ValueRemainingpointsofthecurrentrunninginstruction.
Whentheinstructionhasnotbeencalculated, returns-1.
NotesNone

NRC_SetCompleteOneInstrCallBack

Function PrototypeintNRC_SetCompleteOneInstrCallBack(void(*fun)());
DescriptionSetthecallbackfunctionwhenaninstructioncompletesexecution.Thiscallbackwillbecalledwhenaninstructionfinishesexecuting.
ParametersInputParameters:
funFunctionpointerofthecallbackfunction
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesThisfunctionandNRC_SetCompleteOneInstrCallBack(void(*fun)(NRC_InstrDataBase::NRC_UserParam)),onlythelastcalledfunctiontakeseffect
Thiscallbackfunctionmustnotcontaintime-consumingoperations,otherwiseitwillseriouslyaffectprogramexecution

NRC_SetCompleteOneInstrCallBack

Function PrototypeintNRC_SetCompleteOneInstrCallBack(void(*fun)(NRC_InstrDataBase::NRC_UserParam));
DescriptionSetthecallbackfunctionwhenaninstructioncompletesexecution.Thiscallbackwillbecalledwhenaninstructionfinishesexecuting.Thiscallbackfunctionacceptsuserparameters.
ParametersInputParameters:
funFunctionpointerofthecallbackfunction
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesThisfunctionandNRC_SetCompleteOneInstrCallBack(void(*fun)(NRC_InstrDataBase::NRC_UserParam)),onlythelastcalledfunctiontakeseffect
Thiscallbackfunctionmustnotcontaintime-consumingoperations,otherwiseitwillseriouslyaffectprogramexecution

NRC_RunqueueInsertMOVJ

Function PrototypeintNRC_RunqueueInsertMOVJ(intvel,intacc,intdec,constNRC_Position&target,intpl=0,inttm=0);
DescriptionInsert Mo Vj Instruction Into Run Queue.
ParametersInputParameters:
velRobotrunningspeedasapercentageofmaximumspeed, parameterrange:0<vel<=100
accRobotrunningaccelerationasapercentageofeachjoint'smaximumacceleration, parameterrange:0<vel<=100
decRobotrunningdecelerationasapercentageofeachjoint'smaximumdeceleration, parameterrange:0<vel<=100
targetRobotmotiontargetposition
plSmoothness;willsmoothlytransitionwiththenextmotioninstruction.Thelargerthevalue, the smoother, but the greater the trajectory deviation, parameterrange:0<=pl<=5
tmAdvanceexecutiontime;thenextinstructionstartsexecutingtmsecondsbeforethecurrentinstructionfinishes
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateNoFlieRunqueue()tocreateafile-lessrunqueue

NRC_RunqueueInsertMOVL

Function PrototypeintNRC_RunqueueInsertMOVL(intvel,intacc,intdec,constNRC_Position&target,intpl=0,inttm=0);
DescriptionInsert Mo Vl Instruction Into Run Queue.
ParametersInputParameters:
velRobotrunningspeedasapercentageofmaximumspeed, parameterrange:0<vel<=100
accRobotrunningaccelerationasapercentageofeachjoint'smaximumacceleration, parameterrange:0<vel<=100
decRobotrunningdecelerationasapercentageofeachjoint'smaximumdeceleration, parameterrange:0<vel<=100
targetRobotmotiontargetposition
plSmoothness;willsmoothlytransitionwiththenextmotioninstruction.Thelargerthevalue, the smoother, but the greater the trajectory deviation, parameterrange:0<=pl<=5
tmAdvanceexecutiontime;thenextinstructionstartsexecutingtmsecondsbeforethecurrentinstructionfinishes
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateNoFlieRunqueue()tocreateafile-lessrunqueue

NRC_RunqueueInsertMOVS

Function PrototypeintNRC_RunqueueInsertMOVS(intvel,intacc,intdec,constNRC_Position&target,intpl=0,inttm=0);
DescriptionInsert Mo Vs Instruction Into Run Queue.
ParametersInputParameters:
velRobotrunningspeedasapercentageofmaximumspeed, parameterrange:0<vel<=100
accRobotrunningaccelerationasapercentageofeachjoint'smaximumacceleration, parameterrange:0<vel<=100
decRobotrunningdecelerationasapercentageofeachjoint'smaximumdeceleration, parameterrange:0<vel<=100
targetRobotmotiontargetposition
plSmoothness;willsmoothlytransitionwiththenextmotioninstruction.Thelargerthevalue, the smoother, but the greater the trajectory deviation, parameterrange:0<=pl<=5
tmAdvanceexecutiontime;thenextinstructionstartsexecutingtmsecondsbeforethecurrentinstructionfinishes
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateNoFlieRunqueue()tocreateafile-lessrunqueue

NRC_RunqueueInsertMOVC

Function PrototypeintNRC_RunqueueInsertMOVC(intvel,intacc,intdec,constNRC_Position&target,intpl=0,inttm=0);
DescriptionInsert Mo Vc Instruction Into Run Queue.
ParametersInputParameters:
velRobotrunningspeedasapercentageofmaximumspeed, parameterrange:0<vel<=100
accRobotrunningaccelerationasapercentageofeachjoint'smaximumacceleration, parameterrange:0<vel<=100
decRobotrunningdecelerationasapercentageofeachjoint'smaximumdeceleration, parameterrange:0<vel<=100
targetRobotmotiontargetposition
plSmoothness;willsmoothlytransitionwiththenextmotioninstruction.Thelargerthevalue, the smoother, but the greater the trajectory deviation, parameterrange:0<=pl<=5
tmAdvanceexecutiontime;thenextinstructionstartsexecutingtmsecondsbeforethecurrentinstructionfinishes
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateNoFlieRunqueue()tocreateafile-lessrunqueue

NRC_RunqueueInsertIMOV

Function PrototypeintNRC_RunqueueInsertIMOV(intvel,intacc,intdec,constNRC_Position&deviation,intpl=0,inttm=0);
DescriptionInsert Imov Instruction Into Run Queue.
ParametersInputParameters:
velRobotrunningspeedasapercentageofmaximumspeed, parameterrange:0<vel<=100
accRobotrunningaccelerationasapercentageofeachjoint'smaximumacceleration, parameterrange:0<vel<=100
decRobotrunningdecelerationasapercentageofeachjoint'smaximumdeceleration, parameterrange:0<vel<=100
targetRobotmotiontargetposition
plSmoothness;willsmoothlytransitionwiththenextmotioninstruction.Thelargerthevalue, the smoother, but the greater the trajectory deviation, parameterrange:0<=pl<=5
tmAdvanceexecutiontime;thenextinstructionstartsexecutingtmsecondsbeforethecurrentinstructionfinishes
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateNoFlieRunqueue()tocreateafile-lessrunqueue

NRC_RunqueueInsertDOUT

Function PrototypeintNRC_RunqueueInsertDOUT(intport,intvalue,doubletime_sec);
DescriptionInsert D Out Instruction Into Run Queue.
ParametersInputParameters:
portdigitaloutputPortnumbertooutput, parameterrange:port>0
valuePortoutputstatus0-Lowlevel1-Highlevel
timeSecDurationofportoutputstatus
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateNoFlieRunqueue()tocreateafile-lessrunqueue

NRC_RunqueueInsertTIMER

Function PrototypeintNRC_RunqueueInsertTIMER(doubletimeSec);
DescriptionInsert Timer Instruction Into Run Queue.
ParametersInputParameters:
timeSecDelaytimeinseconds, parameterrange:timeSec>0
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateNoFlieRunqueue()tocreateafile-lessrunqueue

NRC_RunqueueInsertWAIT

Function PrototypeintNRC_RunqueueInsertWAIT(intport,intvalue,doubletimeoutSec,boolnow=false);
DescriptionInsert Wait Instruction Into Run Queue.
ParametersInputParameters:
portdigitaloutputPortnumbertooutput, parameterrange:port>0
valuePortoutputstatus0-Lowlevel1-Highlevel
timeoutSecTimeoutinseconds, parameterrange:timeSec>=0
nowWhetherPLiscontinuoustrue-continuous false-non-continuous
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateNoFlieRunqueue()tocreateafile-lessrunqueue

NRC_RunqueueInsertUNTIL

Function PrototypeintNRC_RunqueueInsertUNTIL(intport,intvalue);
DescriptionInsert Until Instruction Into Run Queue.
ParametersInputParameters:
portdigitalinputPortnumbertodetect, parameterrange:port>0
valuePortoutputstatus0-Lowlevel1-High Level
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateNoFlieRunqueue()tocreateafile-lessrunqueue

NRC_RunqueueInsertENDUNTIL

Function PrototypeintNRC_RunqueueInsertENDUNTIL();
DescriptionInsert End Until Instruction Into Run Queue.
ParametersNone
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateNoFlieRunqueue()tocreateafile-lessrunqueue
MustbeusedwithNRC_RunqueueInsertUNTIL(intport,intvalue)together

NRC_RunqueueInsertIF

Function PrototypeintNRC_RunqueueInsertIF(intport,intvalue);
DescriptionInsert If Instruction Into Run Queue.
ParametersInputParameters:
portdigitalinputPortnumbertodetect, parameterrange:port>0
valuePortoutputstatus0-Lowlevel1-High Level
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateNoFlieRunqueue()tocreateafile-lessrunqueue
MustbeusedwithNRC_RunqueueInsertENDIF()together

NRC_RunqueueInsertWHILE

Function PrototypeintNRC_RunqueueInsertWHILE();
DescriptionInsert While Instruction Into Run Queue.
ParametersNone
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateNoFlieRunqueue()tocreateafile-lessrunqueue
MustbeusedwithNRC_RunqueueInsertENDWHILE()together

NRC_RunqueueInsertELSE

Function PrototypeintNRC_RunqueueInsertELSE();
DescriptionInsert Else Instruction Into Run Queue.
ParametersNone
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateNoFlieRunqueue()tocreateafile-lessrunqueue
MustbeusedwithNRC_RunqueueInsertIF(intport,intvalue),NRC_RunqueueInsertENDIF()together

NRC_RunqueueInsertENDWHILE

Function PrototypeintNRC_RunqueueInsertENDWHILE();
DescriptionInsert End While Instruction Into Run Queue.
ParametersNone
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateNoFlieRunqueue()tocreateafile-lessrunqueue
MustbeusedwithNRC_RunqueueInsertWHILE(intport,intvalue)together

NRC_RunqueueInsertENDIF

Function PrototypeintNRC_RunqueueInsertENDIF();
DescriptionInsert End If Instruction Into Run Queue.
ParametersNone
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateNoFlieRunqueue()tocreateafile-lessrunqueue
MustbeusedwithNRC_RunqueueInsertIF(intport,intvalue)together

NRC_RunqueueInsertPALON

Function PrototypeintNRC_RunqueueInsertPALON(intid,inttype,intvar1=0,intvar2=0,intvar3=0);
DescriptionInsert Pal On Instruction Into Run Queue.
ParametersInputParameters:
idPalletizingprocessnumber, parameterrange:1<=id<=99
typePalletizingtype:0-Pallet I Zing, 1-Depalletizing
var1storecurrenttotalpalletizedworkpiececount, 0meansdonotstore, 1-100representsvariableGI001-GI100, parameterrange:0<=var1<=100
var2storescurrentpalletizedlayercount, 0meansdonotstore, 1-100representsvariableGI001-GI100, parameterrange:0<=var1<=100
var3storescurrentlayerworkpiececount, 0meansdonotstore, 1-100representsvariableGI001-GI100, parameterrange:0<=var1<=100
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateNoFlieRunqueue()tocreateafile-lessrunqueue
MustbeusedwithNRC_RunqueueInsertPALOFF(intid,intvar)together

NRC_RunqueueInsertPALOFF

Function PrototypeintNRC_RunqueueInsertPALOFF(intid,intvar=0);
DescriptionInsert Pal Off Instruction Into Run Queue.
ParametersInputParameters:
idPalletizingprocessnumber, parameterrange:1<=id<=99
varVariabletostorewhetherpalletizingisfinished, 0meansnotstored, 1-100meansvariablesGB001-GB100, parameterrange:0<=var<=100
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateNoFlieRunqueue()tocreateafile-lessrunqueue
MustbeusedwithNRC_RunqueueInsertPALON(intid,inttype,intvar1,intvar2,intvar3)together

NRC_RunqueueInsertPALGRIPPER

Function PrototypeintNRC_RunqueueInsertPALGRIPPER(intid,inttool);
DescriptionInsert Pal Gripper Instruction Into Run Queue.
ParametersInputParameters:
idPalletizingprocessnumber, parameterrange:1<=id<=99
toolGrippernumbertoswitchto, parameterrange:1<=id<=4
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateNoFlieRunqueue()tocreateafile-lessrunqueue

NRC_RunqueueInsertPALCLEAR

Function PrototypeintNRC_RunqueueInsertPALCLEAR(intid);
DescriptionInsert Pal Clear Instruction Into Run Queue.
ParametersInputParameters:
idPalletizingprocessnumber, parameterrange:1<=id<=99
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateNoFlieRunqueue()tocreateafile-lessrunqueue

NRC_RunqueueInsertPALENTER

Function PrototypeintNRC_RunqueueInsertPALENTER(intid,intmoveType,intvel,intacc,intdec,intpl);
DescriptionInsert Pal Enter Instruction Into Run Queue.
ParametersInputParameters:
idPalletizingprocessnumber,parameterrange:1<=id<=99
moveTypeInterpolationmethodforthisinstruction:1-jointinterpolation2-linearinterpolation3-arcinterpolation
velrobotrunningspeed,forjointinterpolation,aspercentageofrobotmaximumspeed,parameterrange:0<vel<=100,forlinearorarcinterpolation,asabsoluterunningspeedatrobotend-effector,unit:mm/s,parameterrange:vel>1
accrobotrunacceleration,parameterrange:0<vel<=100,for joint interpolationtoroboteachjointmaximumaccelerationpercentage,for linear or arc interpolationtorobotCartesianmaximumaccelerationpercentage
decrobotrundeceleration,parameterrange:0<vel<=100,for joint interpolationaspercentageofeachrobotjointmaximumdeceleration,for linear or arc interpolationaspercentageofrobotmaximumCartesiandeceleration
plSmoothness;willsmoothlytransitionwiththenextmotioninstruction.Thelargerthevalue,thesmoother,butthegreaterthetrajectorydeviation,parameterrange:0<=pl<=5
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateNoFlieRunqueue()tocreateafile-lessrunqueue

NRC_RunqueueInsertPALSHIFT

Function PrototypeintNRC_RunqueueInsertPALSHIFT(intid,intmoveType,intvel,intacc,intdec,intpl);
DescriptionInsert Pal Shift Instruction Into Run Queue.
ParametersInputParameters:
idPalletizingprocessnumber,parameterrange:1<=id<=99
moveTypeInterpolationmethodforthisinstruction:1-jointinterpolation2-linearinterpolation3-arcinterpolation
velrobotrunningspeed,forjointinterpolation,aspercentageofrobotmaximumspeed,parameterrange:0<vel<=100,forlinearorarcinterpolation,asabsoluterunningspeedatrobotend-effector,unit:mm/s,parameterrange:vel>1
accrobotrunacceleration,parameterrange:0<vel<=100,for joint interpolationtoroboteachjointmaximumaccelerationpercentage,for linear or arc interpolationtorobotCartesianmaximumaccelerationpercentage
decrobotrundeceleration,parameterrange:0<vel<=100,for joint interpolationaspercentageofeachrobotjointmaximumdeceleration,for linear or arc interpolationaspercentageofrobotmaximumCartesiandeceleration
plSmoothness;willsmoothlytransitionwiththenextmotioninstruction.Thelargerthevalue,thesmoother,butthegreaterthetrajectorydeviation,parameterrange:0<=pl<=5
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateNoFlieRunqueue()tocreateafile-lessrunqueue

NRC_RunqueueInsertPALREAL

Function PrototypeintNRC_RunqueueInsertPALREAL(intid,intmoveType,intvel,intacc,intdec,intpl);
DescriptionInsert Pal Real Instruction Into Run Queue.
ParametersInputParameters:
idPalletizingprocessnumber,parameterrange:1<=id<=99
moveTypeInterpolationmethodforthisinstruction:1-jointinterpolation2-linearinterpolation3-arcinterpolation
velrobotrunningspeed,forjointinterpolation,aspercentageofrobotmaximumspeed,parameterrange:0<vel<=100,forlinearorarcinterpolation,asabsoluterunningspeedatrobotend-effector,unit:mm/s,parameterrange:vel>1
accrobotrunacceleration,parameterrange:0<vel<=100,for joint interpolationtoroboteachjointmaximumaccelerationpercentage,for linear or arc interpolationtorobotCartesianmaximumaccelerationpercentage
decrobotrundeceleration,parameterrange:0<vel<=100,for joint interpolationaspercentageofeachrobotjointmaximumdeceleration,for linear or arc interpolationaspercentageofrobotmaximumCartesiandeceleration
plSmoothness;willsmoothlytransitionwiththenextmotioninstruction.Thelargerthevalue,thesmoother,butthegreaterthetrajectorydeviation,parameterrange:0<=pl<=5
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateNoFlieRunqueue()tocreateafile-lessrunqueue

NRC_RunqueueInsertTOFFSETON

Function PrototypeintNRC_RunqueueInsertTOFFSETON(constNRC_Position&data);
DescriptionInsert T Offset On Instruction Into Run Queue.
ParametersInputParameters:
dataOffsetvalue
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateNoFlieRunqueue()tocreateafile-lessrunqueue
MustbeusedwithNRC_RunqueueInsertTOFFSETOFF()together

NRC_RunqueueInsertTOFFSETOFF

Function PrototypeintNRC_RunqueueInsertTOFFSETOFF();
DescriptionInsert T Offset Off Instruction Into Run Queue.
ParametersNone
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateNoFlieRunqueue()tocreateafile-lessrunqueue
MustbeusedwithNRC_RunqueueInsertTOFFSETON(constNRC_Position&data)together

NRC_RunqueueInsertARCON

Function PrototypeintNRC_RunqueueInsertARCON(intid);
DescriptionInsert Arc On Instruction Into Run Queue.
ParametersInputParameters:
idpalletizingprocessnumber, parameterrange:1<=id<=99
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateNoFlieRunqueue()tocreateafile-lessrunqueue
MustbeusedwithNRC_RunqueueInsertARCOFF(intid)together

NRC_RunqueueInsertARCOFF

Function PrototypeintNRC_RunqueueInsertARCOFF(intid);
DescriptionInsert Arc Off Instruction Into Run Queue.
ParametersInputParameters:
idpalletizingprocessnumber, parameterrange:1<=id<=99
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateNoFlieRunqueue()tocreateafile-lessrunqueue
MustbeusedwithNRC_RunqueueInsertARCON(intid)together

NRC_RunqueueInsertCustomInstruction

Function PrototypeintNRC_RunqueueInsertCustomInstruction(intid,conststd::string&cmd_param="");
DescriptionInsert Custom Instruction Into Run Queue.
ParametersInputParameters:
idCustominstructionID
cmd_paramCustominstructionidentifier
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateNoFlieRunqueue()tocreateafile-lessrunqueue

NRC_JobfileInsertMOVJ

Function PrototypeintNRC_JobfileInsertMOVJ(intline,intvel,intacc,intdec,constNRC_Position&target,intpl=0,inttm=0);
DescriptionInsert Mo Vj Instruction Into Job File.
ParametersInputParameters:
lineInsertinstructionatthespecifiedline.Valuerange:0<line<=(NRC_GetJobfileLineSum()+1)
velRobotrunningspeedasapercentageofmaximumspeed,parameterrange:0<vel<=100
accRobotrunningaccelerationasapercentageofeachjoint'smaximumacceleration,parameterrange:0<vel<=100
decRobotrunningdecelerationasapercentageofeachjoint'smaximumdeceleration,parameterrange:0<vel<=100
targetRobotmotiontargetposition
plSmoothness;willsmoothlytransitionwiththenextmotioninstruction.Thelargerthevalue,thesmoother,butthegreaterthetrajectorydeviation,parameterrange:0<=pl<=5
tmAdvanceexecutiontime;thenextinstructionstartsexecutingtmsecondsbeforethecurrentinstructionfinishes
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateJobfile(std::stringjobname)orNRC_OpenJobfile(std::stringjobname)tocreateoropenajobfile.

NRC_JobfileInsertMOVL

Function PrototypeintNRC_JobfileInsertMOVL(intline,intvel,intacc,intdec,constNRC_Position&target,intpl=0,inttm=0);
DescriptionInsert Mo Vl Instruction Into Job File.
ParametersInputParameters:
lineInsertinstructionatthespecifiedline.Valuerange:0<line<=(NRC_GetJobfileLineSum()+1)
velRobotrunningspeedasapercentageofmaximumspeed,parameterrange:0<vel<=100
accRobotrunningaccelerationasapercentageofeachjoint'smaximumacceleration,parameterrange:0<vel<=100
decRobotrunningdecelerationasapercentageofeachjoint'smaximumdeceleration,parameterrange:0<vel<=100
targetRobotmotiontargetposition
plSmoothness;willsmoothlytransitionwiththenextmotioninstruction.Thelargerthevalue,thesmoother,butthegreaterthetrajectorydeviation,parameterrange:0<=pl<=5
tmAdvanceexecutiontime;thenextinstructionstartsexecutingtmsecondsbeforethecurrentinstructionfinishes
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateJobfile(std::stringjobname)orNRC_OpenJobfile(std::stringjobname)tocreateoropenajobfile.

NRC_JobfileInsertMOVS

Function PrototypeintNRC_JobfileInsertMOVS(intline,intvel,intacc,intdec,constNRC_Position&target,intpl=0,inttm=0);
DescriptionInsert Mo Vs Instruction Into Job File.
ParametersInputParameters:
lineInsertinstructionatthespecifiedline.Valuerange:0<line<=(NRC_GetJobfileLineSum()+1)
velRobotrunningspeedasapercentageofmaximumspeed,parameterrange:0<vel<=100
accRobotrunningaccelerationasapercentageofeachjoint'smaximumacceleration,parameterrange:0<vel<=100
decRobotrunningdecelerationasapercentageofeachjoint'smaximumdeceleration,parameterrange:0<vel<=100
targetRobotmotiontargetposition
plSmoothness;willsmoothlytransitionwiththenextmotioninstruction.Thelargerthevalue,thesmoother,butthegreaterthetrajectorydeviation,parameterrange:0<=pl<=5
tmAdvanceexecutiontime;thenextinstructionstartsexecutingtmsecondsbeforethecurrentinstructionfinishes
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateJobfile(std::stringjobname)orNRC_OpenJobfile(std::stringjobname)tocreateoropenajobfile.

NRC_JobfileInsertMOVC

Function PrototypeintNRC_JobfileInsertMOVC(intline,intvel,intacc,intdec,constNRC_Position&target,intpl=0,inttm=0);
DescriptionInsert Mo Vc Instruction Into Job File.
ParametersInputParameters:
lineInsertinstructionatthespecifiedline.Valuerange:0<line<=(NRC_GetJobfileLineSum()+1)
velRobotrunningspeedasapercentageofmaximumspeed,parameterrange:0<vel<=100
accRobotrunningaccelerationasapercentageofeachjoint'smaximumacceleration,parameterrange:0<vel<=100
decRobotrunningdecelerationasapercentageofeachjoint'smaximumdeceleration,parameterrange:0<vel<=100
targetRobotmotiontargetposition
plSmoothness;willsmoothlytransitionwiththenextmotioninstruction.Thelargerthevalue,thesmoother,butthegreaterthetrajectorydeviation,parameterrange:0<=pl<=5
tmAdvanceexecutiontime;thenextinstructionstartsexecutingtmsecondsbeforethecurrentinstructionfinishes
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateJobfile(std::stringjobname)orNRC_OpenJobfile(std::stringjobname)tocreateoropenajobfile.

NRC_JobfileInsertIMOV

Function PrototypeintNRC_JobfileInsertIMOV(intline,intvel,intacc,intdec,constNRC_Position&deviation,intpl=0,inttm=0);
DescriptionInsert Imov Instruction Into Job File.
ParametersInputParameters:
lineInsertinstructionatthespecifiedline.Valuerange:0<line<=(NRC_GetJobfileLineSum()+1)
velRobotrunningspeedasapercentageofmaximumspeed,parameterrange:0<vel<=100
accRobotrunningaccelerationasapercentageofeachjoint'smaximumacceleration,parameterrange:0<vel<=100
decRobotrunningdecelerationasapercentageofeachjoint'smaximumdeceleration,parameterrange:0<vel<=100
targetRobotmotiontargetposition
plSmoothness;willsmoothlytransitionwiththenextmotioninstruction.Thelargerthevalue,thesmoother,butthegreaterthetrajectorydeviation,parameterrange:0<=pl<=5
tmAdvanceexecutiontime;thenextinstructionstartsexecutingtmsecondsbeforethecurrentinstructionfinishes
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateJobfile(std::stringjobname)orNRC_OpenJobfile(std::stringjobname)tocreateoropenajobfile.
Whendeviation.coordisNRC_ACS,thisinstructionusesjointinterpolation;whendeviation.coordisothervalues,linearinterpolationisused

NRC_JobfileInsertDOUT

Function PrototypeintNRC_JobfileInsertDOUT(intline,intport,intvalue,doubletime_sec);
DescriptionInsert D Out Instruction Into Job File.
ParametersInputParameters:
lineInsertinstructionatthespecifiedline.Valuerange:0<line<=(NRC_GetJobfileLineSum()+1)
portdigitaloutputPortnumbertooutput,parameterrange:port>0
valuePortoutputstatus0-Lowlevel1-Highlevel
time_secDurationofportoutputstatus
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateJobfile(std::stringjobname)orNRC_OpenJobfile(std::stringjobname)tocreateoropenajobfile.

NRC_JobfileInsertTIMER

Function PrototypeintNRC_JobfileInsertTIMER(intline,doubletimeSec);
DescriptionInsert Timer Instruction Into Job File.
ParametersInputParameters:
lineInsertinstructionatthespecifiedline.Valuerange:0<line<=(NRC_GetJobfileLineSum()+1)
timeSecDelaytimeinseconds,parameterrange:timeSec>0
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateJobfile(std::stringjobname)orNRC_OpenJobfile(std::stringjobname)tocreateoropenajobfile.

NRC_JobfileInsertWAIT

Function PrototypeintNRC_JobfileInsertWAIT(intline,intport,intvalue,doubletimeoutSec,boolnow=false);
DescriptionInsert Wait Instruction Into Job File.
ParametersInputParameters:
lineInsertinstructionatthespecifiedline.Valuerange:0<line<=(NRC_GetJobfileLineSum()+1)
portdigitaloutputPortnumbertooutput,parameterrange:port>0
valuePortoutputstatus0-Lowlevel1-Highlevel
timeoutSecTimeoutinseconds,parameterrange:timeSec>=0
ifstillnotsatisfiedafterwaitingtimeoutSecseconds,willnotcontinuewaiting,thisinstructionexecutionends,Ifvalueis0,willwaitunlimitedsecondsuntiltheconditionismet
nowWhetherPLiscontinuous,true-continuous,false-non-continuous
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateJobfile(std::stringjobname)orNRC_OpenJobfile(std::stringjobname)tocreateoropenajobfile.

NRC_JobfileInsertUNTIL

Function PrototypeintNRC_JobfileInsertUNTIL(intline,intport,intvalue);
DescriptionInsert Until Instruction Into Job File.
ParametersInputParameters:
lineInsertinstructionatthespecifiedline.Valuerange:0<line<=(NRC_GetJobfileLineSum()+1)
portdigitaloutputPortnumbertooutput,parameterrange:port>0
valuePortoutputstatus0-Lowlevel1-Highlevel
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateJobfile(std::stringjobname)orNRC_OpenJobfile(std::stringjobname)tocreateoropenajobfile.
MustbeusedwithNRC_JobfileInsertENDUNTIL(intline)together

NRC_JobfileInsertENDUNTIL

Function PrototypeintNRC_JobfileInsertENDUNTIL(intline);
DescriptionInsert End Until Instruction Into Job File.
ParametersInputParameters:
lineInsertinstructionatthespecifiedline.Valuerange:0<line<=(NRC_GetJobfileLineSum()+1)
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateJobfile(std::stringjobname)orNRC_OpenJobfile(std::stringjobname)tocreateoropenajobfile.

NRC_JobfileInsertIF

Function PrototypeintNRC_JobfileInsertIF(intline,intport,intvalue);
DescriptionInsert If Instruction Into Job File.
ParametersInputParameters:
lineInsertinstructionatthespecifiedline.Valuerange:0<line<=(NRC_GetJobfileLineSum()+1)
portdigitaloutputPortnumbertooutput,parameterrange:port>0
valuePortoutputstatus0-Lowlevel1-Highlevel
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateJobfile(std::stringjobname)orNRC_OpenJobfile(std::stringjobname)tocreateoropenajobfile.

NRC_JobfileInsertVarIF

Function PrototypeintNRC_JobfileInsertVarIF(intline,conststd::string&varName,NRC_JUDGEtype,doublevalue);
DescriptionInsert Parameterized If Instruction Into Job File.
ParametersInputParameters:
lineInsertinstructionatthespecifiedline.Valuerange:0<line<=(NRC_GetJobfileLineSum()+1)
varNameParametertocompare,e.g.“GI001”
typeComparisonmethod
valueValuetocompare
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateJobfile(std::stringjobname)orNRC_OpenJobfile(std::stringjobname)tocreateoropenajobfile.

NRC_JobfileInsertWHILE

Function PrototypeintNRC_JobfileInsertWHILE(intline,intport,intvalue);
DescriptionInsert While Instruction Into Job File.
ParametersInputParameters:
lineInsertinstructionatthespecifiedline.Valuerange:0<line<=(NRC_GetJobfileLineSum()+1)
portdigitaloutputPortnumbertooutput,parameterrange:port>0
valuePortoutputstatus0-Lowlevel1-Highlevel
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateJobfile(std::stringjobname)orNRC_OpenJobfile(std::stringjobname)tocreateoropenajobfile.
MustbeusedwithNRC_JobfileInsertENDWHILE(intline)together!

NRC_JobfileInsertVarWHILE

Function PrototypeintNRC_JobfileInsertVarWHILE(intline,conststd::string&varName,NRC_JUDGEtype,doublevalue);
DescriptionInsert Parameterized While Instruction Into Job File.
ParametersInputParameters:
lineInsertinstructionatthespecifiedline.Valuerange:0<line<=(NRC_GetJobfileLineSum()+1)
varNameParametertocompare,e.g.“GI001”
typeComparisonmethod
valueValuetocompare
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateJobfile(std::stringjobname)orNRC_OpenJobfile(std::stringjobname)tocreateoropenajobfile.
MustbeusedwithNRC_JobfileInsertENDWHILE(intline)together!

NRC_JobfileInsertELSE

Function PrototypeintNRC_JobfileInsertELSE(intline);
DescriptionInsert Else Instruction Into Job File.
ParametersInputParameters:
lineInsertinstructionatthespecifiedline.Valuerange:0<line<=(NRC_GetJobfileLineSum()+1)
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateJobfile(std::stringjobname)orNRC_OpenJobfile(std::stringjobname)tocreateoropenajobfile.
MustbeusedwithNRC_JobfileInsertIF(intline,intport,intvalue),NRC_JobfileInsertENDIF(intline)together

NRC_JobfileInsertENDWHILE

Function PrototypeintNRC_JobfileInsertENDWHILE(intline);
DescriptionInsert End While Instruction Into Job File.
ParametersInputParameters:
lineInsertinstructionatthespecifiedline.Valuerange:0<line<=(NRC_GetJobfileLineSum()+1)
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateJobfile(std::stringjobname)orNRC_OpenJobfile(std::stringjobname)tocreateoropenajobfile.
MustbeusedwithNRC_JobfileInsertWHILE(intline,intport,intvalue)together!

NRC_JobfileInsertENDIF

Function PrototypeintNRC_JobfileInsertENDIF(intline);
DescriptionInsert End If Instruction Into Job File.
ParametersInputParameters:
lineInsertinstructionatthespecifiedline.Valuerange:0<line<=(NRC_GetJobfileLineSum()+1)
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateJobfile(std::stringjobname)orNRC_OpenJobfile(std::stringjobname)tocreateoropenajobfile.
MustbeusedwithNRC_JobfileInsertIF(intline,intport,intvalue)together

NRC_JobfileInsertPAUSERUN

Function PrototypeintNRC_JobfileInsertPAUSERUN(intline);
DescriptionInsert Pause Run Instruction Into Job File.
ParametersInputParameters:
lineInsertinstructionatthespecifiedline.Valuerange:0<line<=(NRC_GetJobfileLineSum()+1)
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateJobfile(std::stringjobname)orNRC_OpenJobfile(std::stringjobname)tocreateoropenajobfile.
MustbeusedwithNRC_JobfileInsertIF(intline,intport,intvalue)together

NRC_JobfileInsertCONTINUERUN

Function PrototypeintNRC_JobfileInsertCONTINUERUN(intline,intprogramtype,conststd::string&jobName);
DescriptionInsert Continue Run Instruction Into Job File.
ParametersInputParameters:
lineInsertinstructionatthespecifiedline.Valuerange:0<line<=(NRC_GetJobfileLineSum()+1)
programtypeProgramtype:1-Mainprogram2-Backgroundprogram
jobNameProgramname
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateJobfile(std::stringjobname)orNRC_OpenJobfile(std::stringjobname)tocreateoropenajobfile.

NRC_JobfileInsertSTOPRUN

Function PrototypeintNRC_JobfileInsertSTOPRUN(intline);
DescriptionInsert Stop Run Instruction Into Job File.
ParametersInputParameters:
lineInsertinstructionatthespecifiedline.Valuerange:0<line<=(NRC_GetJobfileLineSum()+1)
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateJobfile(std::stringjobname)orNRC_OpenJobfile(std::stringjobname)tocreateoropenajobfile.
MustbeusedwithNRC_JobfileInsertIF(intline,intport,intvalue)together

NRC_JobfileInsertRESTARTRUN

Function PrototypeintNRC_JobfileInsertRESTARTRUN(intline);
DescriptionInsert Restart Run Instruction Into Job File.
ParametersInputParameters:
lineInsertinstructionatthespecifiedline.Valuerange:0<line<=(NRC_GetJobfileLineSum()+1)
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateJobfile(std::stringjobname)orNRC_OpenJobfile(std::stringjobname)tocreateoropenajobfile.
MustbeusedwithNRC_JobfileInsertIF(intline,intport,intvalue)together

NRC_JobfileInsertCMDNOTE

Function PrototypeintNRC_JobfileInsertCMDNOTE(intline,conststd::stringnote);
DescriptionInsert Cm D Note Instruction Into Job File.
ParametersInputParameters:
lineInsertinstructionatthespecifiedline.Valuerange:0<line<=(NRC_GetJobfileLineSum()+1)
noteRemarkcontent
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateJobfile(std::stringjobname)orNRC_OpenJobfile(std::stringjobname)tocreateoropenajobfile.

NRC_JobfileInsertPthreadStart

Function PrototypeintNRC_JobfileInsertPthreadStart(intline,conststd::string&jobName);
DescriptionInsertPTHREAD_STARTinstructionintojobfile.
ParametersInputParameters:
lineInsertinstructionatthespecifiedline.Valuerange:0<line<=(NRC_GetJobfileLineSum()+1)
jobNameNameoflocalbackgroundprogramtostart
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateJobfile(std::stringjobname)orNRC_OpenJobfile(std::stringjobname)tocreateoropenajobfile.

NRC_JobfileInsertPthreadEnd

Function PrototypeintNRC_JobfileInsertPthreadEnd(intline,conststd::string&jobName);
DescriptionInsertPTHREAD_ENDinstructionintojobfile.
ParametersInputParameters:
lineInsertinstructionatthespecifiedline.Valuerange:0<line<=(NRC_GetJobfileLineSum()+1)
jobNameNameoflocalbackgroundprogramtostop
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateJobfile(std::stringjobname)orNRC_OpenJobfile(std::stringjobname)tocreateoropenajobfile.

NRC_JobfileInsertSETVAR

Function PrototypeintNRC_JobfileInsertSETVAR(intline,std::stringvarName,doublevarValue);
DescriptionInsert Set Var Instruction Into Job File.
ParametersInputParameters:
lineInsertinstructionatthespecifiedline.Valuerange:0<line<=(NRC_GetJobfileLineSum()+1)
varNamevariablenametowrite,e.g.“GI001”,“B099”
varValueValuetowrite
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateJobfile(std::stringjobname)orNRC_OpenJobfile(std::stringjobname)tocreateoropenajobfile.

NRC_JobfileInsertOPCmd

Function PrototypeintNRC_JobfileInsertOPCmd(intline,conststd::string&varName,NRC_OPREATIONtype,doublevalue);
DescriptionInsert Opc Md Instruction Into Job File.
ParametersInputParameters:
lineInsertinstructionatthespecifiedline.Valuerange:0<line<=(NRC_GetJobfileLineSum()+1)
varNameOperationparameter
typeOperationtype
valueOperationvalue
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateJobfile(std::stringjobname)orNRC_OpenJobfile(std::stringjobname)tocreateoropenajobfile.

NRC_JobfileInsertPALON

Function PrototypeintNRC_JobfileInsertPALON(intline,intid,inttype,intvar1=0,intvar2=0,intvar3=0);
DescriptionInsert Pal On Instruction Into Job File.
ParametersInputParameters:
lineInsertinstructionatthespecifiedline.Valuerange:0<line<=(NRC_GetJobfileLineSum()+1)
idRemarkcontent
typePalletizingtype:0-palletizing1-depalletizing
var1storecurrenttotalpalletizedworkpiececount,0meansdonotstore,1-100representsvariableGI001-GI100,parameterrange:0<=var1<=100
var2storescurrentpalletizedlayercount,0meansdonotstore,1-100representsvariableGI001-GI100,parameterrange:0<=var2<=100
var3storescurrentlayerworkpiececount,0meansdonotstore,1-100representsvariableGI001-GI100,parameterrange:0<=var3<=100
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateJobfile(std::stringjobname)orNRC_OpenJobfile(std::stringjobname)tocreateoropenajobfile.
MustbeusedwithNRC_JobfileInsertPALOFF(intline,intid,intvar)together

NRC_JobfileInsertPALOFF

Function PrototypeintNRC_JobfileInsertPALOFF(intline,intid,intvar=0);
DescriptionInsert Pal Off Instruction Into Job File.
ParametersInputParameters:
lineInsertinstructionatthespecifiedline.Valuerange:0<line<=(NRC_GetJobfileLineSum()+1)
idpalletizingprocessnumber,parameterrange:1<=id<=99
varVariabletostorewhetherpalletizingisfinished,0meansnotstored,1-100meansvariablesGB001-GB100,parameterrange:0<=var<=100
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateJobfile(std::stringjobname)orNRC_OpenJobfile(std::stringjobname)tocreateoropenajobfile.
MustbeusedwithNRC_JobfileInsertPALON(intline,intid,inttype,intvar1,intvar2,intvar3)together

NRC_JobfileInsertPALGRIPPER

Function PrototypeintNRC_JobfileInsertPALGRIPPER(intline,intid,inttool);
DescriptionInsert Pal Gripper Instruction Into Job File.
ParametersInputParameters:
lineInsertinstructionatthespecifiedline.Valuerange:0<line<=(NRC_GetJobfileLineSum()+1)
idpalletizingprocessnumber,parameterrange:1<=id<=99
toolGrippernumbertoswitchto,parameterrange:1<=id<=4
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateJobfile(std::stringjobname)orNRC_OpenJobfile(std::stringjobname)tocreateoropenajobfile.

NRC_JobfileInsertPALCLEAR

Function PrototypeintNRC_JobfileInsertPALCLEAR(intline,intid);
DescriptionInsert Pal Clear Instruction Into Job File.
ParametersInputParameters:
lineInsertinstructionatthespecifiedline.Valuerange:0<line<=(NRC_GetJobfileLineSum()+1)
idpalletizingprocessnumber,parameterrange:1<=id<=99
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateJobfile(std::stringjobname)orNRC_OpenJobfile(std::stringjobname)tocreateoropenajobfile.

NRC_JobfileInsertPALENTER

Function PrototypeintNRC_JobfileInsertPALENTER(intline,intid,intmoveType,intvel,intacc,intdec,intpl);
DescriptionInsert Pal Enter Instruction Into Job File.
ParametersInputParameters:
lineInsertinstructionatthespecifiedline.Valuerange:0<line<=(NRC_GetJobfileLineSum()+1)
idpalletizingprocessnumber,parameterrange:1<=id<=99
moveTypeInterpolationmethodforthisinstruction:1-jointinterpolation2-linearinterpolation3-arcinterpolation
velrobotrunningspeed:
forjointinterpolation,aspercentageofrobotmaximumspeed,parameterrange:0<vel<=100
forlinearorarcinterpolation,asabsoluterunningspeedatrobotend-effector,unit:mm/s,parameterrange:vel>1
accrobotrunacceleration,parameterrange:0<vel<=100
decrobotrundeceleration,parameterrange:0<vel<=100
plSmoothness;willsmoothlytransitionwiththenextmotioninstruction.Thelargerthevalue,thesmoother,butthegreaterthetrajectorydeviation,parameterrange:0<=pl<=5
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateJobfile(std::stringjobname)orNRC_OpenJobfile(std::stringjobname)tocreateoropenajobfile.

NRC_JobfileInsertPALSHIFT

Function PrototypeintNRC_JobfileInsertPALSHIFT(intline,intid,intmoveType,intvel,intacc,intdec,intpl);
DescriptionInsert Pal Shift Instruction Into Job File.
ParametersInputParameters:
lineInsertinstructionatthespecifiedline.Valuerange:0<line<=(NRC_GetJobfileLineSum()+1)
idpalletizingprocessnumber,parameterrange:1<=id<=99
moveTypeInterpolationmethodforthisinstruction:1-jointinterpolation2-linearinterpolation3-arcinterpolation
velrobotrunningspeed:
forjointinterpolation,aspercentageofrobotmaximumspeed,parameterrange:0<vel<=100
forlinearorarcinterpolation,asabsoluterunningspeedatrobotend-effector,unit:mm/s,parameterrange:vel>1
accrobotrunacceleration,parameterrange:0<vel<=100
decrobotrundeceleration,parameterrange:0<vel<=100
plSmoothness;willsmoothlytransitionwiththenextmotioninstruction.Thelargerthevalue,thesmoother,butthegreaterthetrajectorydeviation,parameterrange:0<=pl<=5
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateJobfile(std::stringjobname)orNRC_OpenJobfile(std::stringjobname)tocreateoropenajobfile.

NRC_JobfileInsertPALREAL

Function PrototypeintNRC_JobfileInsertPALREAL(intline,intid,intmoveType,intvel,intacc,intdec,intpl);
DescriptionInsert Pal Real Instruction Into Job File.
ParametersInputParameters:
lineInsertinstructionatthespecifiedline.Valuerange:0<line<=(NRC_GetJobfileLineSum()+1)
idpalletizingprocessnumber,parameterrange:1<=id<=99
moveTypeInterpolationmethodforthisinstruction:1-jointinterpolation2-linearinterpolation3-arcinterpolation
velrobotrunningspeed:
forjointinterpolation,aspercentageofrobotmaximumspeed,parameterrange:0<vel<=100
forlinearorarcinterpolation,asabsoluterunningspeedatrobotend-effector,unit:mm/s,parameterrange:vel>1
accrobotrunacceleration,parameterrange:0<vel<=100
decrobotrundeceleration,parameterrange:0<vel<=100
plSmoothness;willsmoothlytransitionwiththenextmotioninstruction.Thelargerthevalue,thesmoother,butthegreaterthetrajectorydeviation,parameterrange:0<=pl<=5
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateJobfile(std::stringjobname)orNRC_OpenJobfile(std::stringjobname)tocreateoropenajobfile.

NRC_JobfileInsertTOFFSETON

Function PrototypeintNRC_JobfileInsertTOFFSETON(intline,constNRC_Position&data);
DescriptionInsert T Offset On Instruction Into Job File.
ParametersInputParameters:
lineInsertinstructionatthespecifiedline.Valuerange:0<line<=(NRC_GetJobfileLineSum()+1)
dataOffsetvalue
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateJobfile(std::stringjobname)orNRC_OpenJobfile(std::stringjobname)tocreateoropenajobfile.
MustbeusedwithNRC_JobfileInsertTOFFSETOFF(intline)together

NRC_JobfileInsertTOFFSETOFF

Function PrototypeintNRC_JobfileInsertTOFFSETOFF(intline);
DescriptionInsert T Offset Off Instruction Into Job File.
ParametersInputParameters:
lineInsertinstructionatthespecifiedline.Valuerange:0<line<=(NRC_GetJobfileLineSum()+1)
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateJobfile(std::stringjobname)orNRC_OpenJobfile(std::stringjobname)tocreateoropenajobfile.
MustbeusedwithNRC_JobfileInsertTOFFSETON(intline,constNRC_Position&data)together

NRC_JobfileInsertARCON

Function PrototypeintNRC_JobfileInsertARCON(intline,intid);
DescriptionInsert Arc On Instruction Into Job File.
ParametersInputParameters:
lineInsertinstructionatthespecifiedline.Valuerange:0<line<=(NRC_GetJobfileLineSum()+1)
idpalletizingprocessnumber,parameterrange:1<=id<=99
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateJobfile(std::stringjobname)orNRC_OpenJobfile(std::stringjobname)tocreateoropenajobfile.
MustbeusedwithNRC_JobfileInsertARCOFF(intline,intid)together

NRC_JobfileInsertARCOFF

Function PrototypeintNRC_JobfileInsertARCOFF(intline,intid);
DescriptionInsert Arc Off Instruction Into Job File.
ParametersInputParameters:
lineInsertinstructionatthespecifiedline.Valuerange:0<line<=(NRC_GetJobfileLineSum()+1)
idpalletizingprocessnumber,parameterrange:1<=id<=99
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateJobfile(std::stringjobname)orNRC_OpenJobfile(std::stringjobname)tocreateoropenajobfile.
MustbeusedwithNRC_JobfileInsertARCON(intline,intid)together

NRC_JobfileInsertCustomInstruction

Function PrototypeintNRC_JobfileInsertCustomInstruction(intline,intid,conststd::string&cmdParam="");
DescriptionInsert Custom Instruction Into Job File.
ParametersInputParameters:
lineInsertinstructionatthespecifiedline.Valuerange:0<line<=(NRC_GetJobfileLineSum()+1)
idCustominstructionID
cmd_paramCustominstructionidentifier
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateJobfile(std::stringjobname)orNRC_OpenJobfile(std::stringjobname)tocreateoropenajobfile.

NRC_GetRunqueueCurrentRunLine

Function PrototypeintNRC_GetRunqueueCurrentRunLine();
DescriptionGet The Current Running Line Number Of The Run Queue.
ParametersNone
Return ValueReturn The Current Running Line Number Of The Run Queue
NotesNone

NRC_GetJobfileCurrentRunLine

Function PrototypeintNRC_GetJobfileCurrentRunLine();
DescriptionGet The Current Running Line Number Of The Job File.
ParametersNone
Return ValueReturn The Current Running Line Number Of The Job File
NotesNone

NRC_GetCycleIndex

Function PrototypeintNRC_GetCycleIndex();
DescriptionGet The Total Number Of Times The Current Job File Should Run.
ParametersNone
Return ValueReturn The Total Number Of Times The Current Job File Should Run
NotesNone

NRC_GetCycleCount

Function PrototypeintNRC_GetCycleCount();
DescriptionGet The Number Of Times The Current Job File Has Been Run.
ParametersNone
Return ValueReturn The Number Of Times The Current Job File Has Been Run
NotesNone

NRC_GetCycleTimeSec

Function PrototypeintNRC_GetCycleTimeSec();
DescriptionGet The Time The Current Job File Has Been Running.
ParametersNone
Return ValueReturn The Time The Current Job File Has Been Running
NotesNone

NRC_SetCycleIndex

Function PrototypeintNRC_SetCycleIndex(intindex);
DescriptionSet The Total Number Of Times The Current Job File Should Run.
ParametersOutputParameters:
indexTotalnumberoftimesthecurrentjobfileshouldrun, setto0forlooprunning, parameterrange:index>=0
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesNone

NRC_RunqueueInsertMOVJEXT

Function PrototypeintNRC_RunqueueInsertMOVJEXT(intvel,intacc,intdec,constNRC_Position&target,constNRC_SyncPosition&targetSync,intpl=0,inttm=0);
DescriptionInsert Mo Vj Ext Instruction Into Run Queue.
ParametersInputParameters:
velRobotrunningspeedasapercentageofmaximumspeed,parameterrange:0<vel<=100
accRobotrunningaccelerationasapercentageofeachjoint'smaximumacceleration,parameterrange:0<vel<=100
decRobotrunningdecelerationasapercentageofeachjoint'smaximumdeceleration,parameterrange:0<vel<=100
targetRobotmotiontargetposition,seeNRC_Position
targetSyncexternalaxismotion target position,seeNRC_SyncPosition
plSmoothness;willsmoothlytransitionwiththenextmotioninstruction.Thelargerthevalue,thesmoother,butthegreaterthetrajectorydeviation,parameterrange:0<=pl<=5
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateNoFlieRunqueue()tocreateafile-lessrunqueue

NRC_JobfileInsertMOVJEXT

Function PrototypeintNRC_JobfileInsertMOVJEXT(intline,intvel,intacc,intdec,constNRC_Position&target,constNRC_SyncPosition&targetSync,intpl=0,inttm=0);
DescriptionInsert Mo Vj Ext Instruction Into Job File.
ParametersInputParameters:
lineInsertinstructionatthespecifiedline.Valuerange:0<line<=(NRC_GetJobfileLineSum()+1)
velRobotrunningspeedasapercentageofmaximumspeed,parameterrange:0<vel<=100
accRobotrunningaccelerationasapercentageofeachjoint'smaximumacceleration,parameterrange:0<vel<=100
decRobotrunningdecelerationasapercentageofeachjoint'smaximumdeceleration,parameterrange:0<vel<=100
targetRobotmotiontargetposition,seeNRC_Position
targetSyncexternalaxismotion target position,seeNRC_SyncPosition
plSmoothness;willsmoothlytransitionwiththenextmotioninstruction.Thelargerthevalue,thesmoother,butthegreaterthetrajectorydeviation,parameterrange:0<=pl<=5
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateJobfile(std::stringjobname)orNRC_OpenJobfile(std::stringjobname)tocreateoropenajobfile.

NRC_RunqueueInsertMOVLEXT

Function PrototypeintNRC_RunqueueInsertMOVLEXT(intvel,intacc,intdec,constNRC_Position&target,constNRC_SyncPosition&targetSync,intpl=0,inttm=0);
DescriptionInsert Mo Vl Ext Instruction Into Run Queue.
ParametersInputParameters:
velRobotrunningspeedasapercentageofmaximumspeed,parameterrange:0<vel<=100
accRobotrunningaccelerationasapercentageofeachjoint'smaximumacceleration,parameterrange:0<vel<=100
decRobotrunningdecelerationasapercentageofeachjoint'smaximumdeceleration,parameterrange:0<vel<=100
targetRobotmotiontargetposition,seeNRC_Position
targetSyncexternalaxismotion target position,seeNRC_SyncPosition
plSmoothness;willsmoothlytransitionwiththenextmotioninstruction.Thelargerthevalue,thesmoother,butthegreaterthetrajectorydeviation,parameterrange:0<=pl<=5
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateNoFlieRunqueue()tocreateafile-lessrunqueue

NRC_JobfileInsertMOVLEXT

Function PrototypeintNRC_JobfileInsertMOVLEXT(intline,intvel,intacc,intdec,constNRC_Position&target,constNRC_SyncPosition&targetSync,intpl=0,inttm=0);
DescriptionInsert Mo Vl Ext Instruction Into Job File.
ParametersInputParameters:
lineInsertinstructionatthespecifiedline.Valuerange:0<line<=(NRC_GetJobfileLineSum()+1)
velRobotrunningspeedasapercentageofmaximumspeed,parameterrange:0<vel<=100
accRobotrunningaccelerationasapercentageofeachjoint'smaximumacceleration,parameterrange:0<vel<=100
decRobotrunningdecelerationasapercentageofeachjoint'smaximumdeceleration,parameterrange:0<vel<=100
targetRobotmotiontargetposition,seeNRC_Position
targetSyncexternalaxismotion target position,seeNRC_SyncPosition
plSmoothness;willsmoothlytransitionwiththenextmotioninstruction.Thelargerthevalue,thesmoother,butthegreaterthetrajectorydeviation,parameterrange:0<=pl<=5
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateJobfile(std::stringjobname)orNRC_OpenJobfile(std::stringjobname)tocreateoropenajobfile.

NRC_RunqueueInsertMOVCEXT

Function PrototypeintNRC_RunqueueInsertMOVCEXT(intvel,intacc,intdec,constNRC_Position&target,constNRC_SyncPosition&targetSync,intpl=0,inttm=0);
DescriptionInsert M Ovce Xt Instruction Into Run Queue.
ParametersInputParameters:
velRobotrunningspeedasapercentageofmaximumspeed,parameterrange:0<vel<=100
accRobotrunningaccelerationasapercentageofeachjoint'smaximumacceleration,parameterrange:0<vel<=100
decRobotrunningdecelerationasapercentageofeachjoint'smaximumdeceleration,parameterrange:0<vel<=100
targetRobotmotiontargetposition,seeNRC_Position
targetSyncexternalaxismotion target position,seeNRC_SyncPosition
plSmoothness;willsmoothlytransitionwiththenextmotioninstruction.Thelargerthevalue,thesmoother,butthegreaterthetrajectorydeviation,parameterrange:0<=pl<=5
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateNoFlieRunqueue()tocreateafile-lessrunqueue

NRC_JobfileInsertMOVCEXT

Function PrototypeintNRC_JobfileInsertMOVCEXT(intline,intvel,intacc,intdec,constNRC_Position&target,constNRC_SyncPosition&targetSync,intpl=0,inttm=0);
DescriptionInsert M Ovce Xt Instruction Into Job File.
ParametersInputParameters:
lineInsertinstructionatthespecifiedline.Valuerange:0<line<=(NRC_GetJobfileLineSum()+1)
velRobotrunningspeedasapercentageofmaximumspeed,parameterrange:0<vel<=100
accRobotrunningaccelerationasapercentageofeachjoint'smaximumacceleration,parameterrange:0<vel<=100
decRobotrunningdecelerationasapercentageofeachjoint'smaximumdeceleration,parameterrange:0<vel<=100
targetRobotmotiontargetposition,seeNRC_Position
targetSyncexternalaxismotion target position,seeNRC_SyncPosition
plSmoothness;willsmoothlytransitionwiththenextmotioninstruction.Thelargerthevalue,thesmoother,butthegreaterthetrajectorydeviation,parameterrange:0<=pl<=5
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesBeforecallingthisfunction,pleasefirstcallNRC_CreateJobfile(std::stringjobname)orNRC_OpenJobfile(std::stringjobname)tocreateoropenajobfile.

NRC_JobfileInsertPOSCALALL

Function PrototypeintNRC_JobfileInsertPOSCALALL(intline,std::stringpos_name,constNRC_Position&change,constNRC_SyncPosition&sync_change);
DescriptionInsert Position Bulk Modify Instruction Into Job File.
ParametersInputParameters:
lineInsertinstructionatthespecifiedline.Valuerange:0<line<=(NRC_GetJobfileLineSum()+1)
pos_nameGlobalpointnametomodify,range"GE0001"~"GE9999"
changeseeNRC_Position(NRC_COORDcoo,intusr,inttool,intcon,doubleaxis_pos1,doubleaxis_pos2,doubleaxis_pos3,doubleaxis_pos4,doubleaxis_pos5,doubleaxis_pos6,doubleaxis_pos7)
sync_changeseeNRC_SyncPosition
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesNote:Forbothchangeandsync_change,non-existentaxesmustbepassedas99999

NRC_RunqueueInsertPOSCALALL

Function PrototypeintNRC_RunqueueInsertPOSCALALL(std::stringpos_name,constNRC_Position&change,constNRC_SyncPosition&sync_change);
DescriptionInsert Position Bulk Modify Instruction Into Run Queue.
ParametersInputParameters:
pos_nameGlobalpointnametomodify,range"GE0001"~"GE9999"
changeseeNRC_Position(NRC_COORDcoo,intusr,inttool,intcon,doubleaxis_pos1,doubleaxis_pos2,doubleaxis_pos3,doubleaxis_pos4,doubleaxis_pos5,doubleaxis_pos6,doubleaxis_pos7)
sync_changeseeNRC_SyncPosition
Return Value0:Functioncallsucceeded
-101:Invalidinputparameter
-102:Targetobjectdoesnotexist, typicallyreturnedwhensysteminitializationisincomplete
-103:Targetobjectiscurrentlyinaninoperablestate
NotesNote:Forbothchangeandsync_change,non-existentaxesmustbepassedas99999