YASKAWA JOB file parser

[CagtayFabry]

YASKAWA JOB file parser

The goal is to create a Python utility that helps parsing YASKAWA JOB files written in the INFORM language.

structure of JOB file

A JOB file is a single text file made up of two parts:

1. the header section describing the job metadata, lokal variables, job arguments etc.
2. the program section containing the robot instructions

The first line of a JOB file (the header section) starts with

/JOB

The header section and the program section are separated by a single line containing the command:

NOP

basic syntax

header section

Different parts of the header section are indicated by / with various levels.
Example:

/JOB
//NAME SET_IDS_FULL
///FOLDERNAME TWINCAT_KOMMUNIKATION

program syntax

Commands in the program section are written in plain text.
In case of structures like for-loops, enclosed commands are indented by one tab \t

Example:

CALL JOB:SET_TCPON ARGF1
TCPON TL#(1)
IFTHENEXP CALLED_IN_MAIN=0
	 CALL JOB:TRIGGER ARGF"PROGRAMM_EIN"
ENDIF
TIMER T=0.50

Comments are indicated by starting the line with ' and have a maximum length of 33 characters.
The formatting does not allow umlaute like ö,ä,ü etc.

Python Tool

First, create a class JobFile that reads an existing job file from the file system.
The class should be called like this: job = JobFile(filename="examplefile.JBI")
The job file should be split into the header section and program section and the full code of each section should be stored (e.g. as individual lines).

After reading the file, the header section should be parsed and the different metadata should be stored as class properties.

For the program section, different rules should be discussed how the program structure should look like, what commands must be present or are not allowed, the order of specific commands etc. .

The individual rules will be listed and discussed in individual issues.
Example rules:

Every program should start with a comment line directly after the NOP statement

The program command SETREG MREG# should only be allowed when the job is listed unter FOLDERNAME TWINCAT_KOMMUNIKATION

learning goals

While developing the tool, the following Python skills should be practiced:

• reading and working with files (using the with statement)
• working with python classes (properties, methods etc.)
• string handling in python
• creating an executable python script
• writing output to the command line or a text file
• working with lists and dictionaries
• working with regex (advanced)

Example file

/JOB
//NAME SET_IDS_FULL
///FOLDERNAME TWINCAT_KOMMUNIKATION
//POS
///NPOS 0,0,0,0,0,0
//ALIAS
///LVARS 0,5,0,0,0,0,0,0
LI000 WID
LI001 NAHT
LI002 LAGE
LI003 RAUPE
LI004 SCHW
//ARGINFO
///ARGTYPE I,I,I,I,I,,,
///COMMENT
WID
NAHT
LAGE
RAUPE
SCHW



//INST
///DATE 2023/05/03 17:27
///COMM SET WID AND NUMBERS
///ATTR SC,RW
///LVARS 0,5,0,0,0,0,0,0
NOP
'--------------------------------
'Dieser Job setzt einen
'vollstndigen Satz an ID-Nummern
'mit WID
'--------------------------------
'Argumente lesen
GETARG WID IARG#(1)
GETARG NAHT IARG#(2)
GETARG LAGE IARG#(3)
GETARG RAUPE IARG#(4)
GETARG SCHW IARG#(5)
'--------------------------------
'ID Trigger festsetzen
SETREG MREG#(69) 1
'--------------------------------
'WID setzen
CALL JOB:SET_ID ARGFWID ARGF"WID"
'--------------------------------
'Nummern setzen
CALL JOB:SET_IDS ARGFNAHT ARGFLAGE ARGFRAUPE ARGFSCHW
'--------------------------------
'ID Trigger freigeben
SETREG MREG#(69) 0
END