Yaskawa Basics
Basics | Viewer | Point editor | Robot 3D View | Settings | Plugins

▲ Overview

DReS opens Yaskawa Motoman jobs (*.JBI, INFORM language of the NX100 / DX100 / DX200 / YRC1000 controllers) directly from a controller backup. Besides a syntax-aware text editor it reads the configuration of the controller from the backup and uses it everywhere a job needs it: control groups, tools, user frames, soft limits, interference areas, variable names, macros and I/O names. With the geometry of the robot (YaskawaGenericKinematics.xml) and the gear data of the controller the points can be edited in degrees and in Cartesian coordinates, with a 3D preview of the robot.
Job F7R2.JBI with the CTB data of the controller (left) and the point table (bottom).
Everything works offline, on a copy of the backup - the editor never connects to the robot.

▲ What is read from the controller backup

A project is a directory with the backup of one controller (the files as saved by the controller, e.g. CMOS / ALL backup). A job opened from such a directory automatically uses the configuration of its controller, even if another project is active.

FileContentWhere it is used
*.JBIjobs: header (//POS), instructionsviewer, point table, point editor
SYSTEM.SYSsystem and parameter version, application, language, control groups (//ROBOT NAME: R1..R8, B1..B8, S1..S24 with model and axis mask), version information, time counters (control power, servo power, playback, moving, operating, energy time) Robot info, model of the robot for the kinematics, control group of every point
TOOL.CNDtool data: TCP X, Y, Z, Rx, Ry, Rz, centre of gravity, weight, moment of inertia CTB data, TCP in the point editor and in 3D
UFRAME.CNDuser frames: name, tool and taught points ORG / XX / XY (pulses), resulting frame (BUSER) CTB data, frame of the Cartesian tab, user frames in 3D
SC.PRMpulse soft limits of every axis of every control group (S1CxG400..415) CTB data, marking of points outside the limits (point table, motion editor, point editor)
CUBEINTF.CNDinterference areas: cubes (X, Y, Z in µm) and axis interference (pulses), control group, name CTB data
RC.PRM, SV.PRMgear ratio (RC<g>G) and encoder resolution (SV<g>G) of every axis pulses per degree of every axis - axis values in degrees
VARNAME.DATnames (comments) of the global variables B, I, D, R, S, P, BP, EX tooltips, the long-text column of the viewer, long text window (editable)
VAR.DATvalues of the global variables at the time of the backup, global position variables P / BP / EX tooltips ([backup: value]), global positions in the point table (read only)
MACRO.DATmacro definitions: macro number, MJ number, macro job and names of its arguments tooltip of MACROn MJ#(m), Go to the macro job
IONAME.DATnames of the inputs and outputs tooltips, the long-text column, long text window (editable; setting IO names file)
The files of the backup are only read. The jobs (*.JBI) you save and, on request, the I/O and variable names saved from the long text window (IONAME.DAT, VARNAME.DAT) are the only files the editor writes.

▲ Project tree

A Yaskawa project is shown in the tree of the Files tab with the name of the robot (model of R1 from SYSTEM.SYS) and the files sorted into folders.
The job of a line is opened by a double-click in the tree, the jobs already open are listed under Open documents with their comment (///COMM).

▲ Robot info

The Robot info tab shows the data of SYSTEM.SYS of the active project:

▲ CTB data: tools, frames, soft limits, interference areas

The CTB data tab shows the configuration data of the controller as a tree:
NodeContent
Tool dataevery defined tool (TOOL 0..63) with its name; expanded: X, Y, Z [mm], Rx, Ry, Rz [°]
Base datauser frames grouped by robot (R1, R2 ...): name, tool used for teaching, taught points ORG / XX / XY, resulting frame
Load datatools with a load: weight [kg], centre of gravity [mm], moment of inertia [kg·m²]
Soft limits [pulse]negative and positive pulse limit of every axis of every control group (SC.PRM)
Interference areascubes (method, control group, X / Y / Z min–max in mm) and axis interference areas (pulse range of the axes) with their names from CUBEINTF.CND
The CTB data of a Yaskawa controller are read only - see Editing CTB data.

▲ Long texts: I/O and variable names (IONAME.DAT, VARNAME.DAT)

When a Yaskawa project becomes the active controller, the long text window (the same window as for VKRC, KRC and Fanuc signal lists) is filled with the names of the controller:
Long text window of a Yaskawa controller: variable names with the backup values, I/O names.
The descriptions can be edited in the table (double-click); the tooltips of the viewer show the changed text immediately. The filter under the table finds signals and variables by name or text.

Saving the names

The export button of the long text window writes:
FormatContent
Yaskawa IONAME.DATthe I/O names in the format of the controller - the layout of the IONAME.DAT of the backup (/IONAME, //IN, //OUT ..., four names per line) is kept, only the changed names are replaced; an empty description keeps the default name or leaves the name empty
Yaskawa VARNAME.DATthe variable names in the format of the controller - changed names are replaced in place, removed names leave an empty line, new names are added at the end of their section (0500 1,0,NAME); the header and the number of lines of every section (///SHARE) stay as they were
Text file (*.txt), Text CSV (*.csv)VARIABLE text / VARIABLE;text - for translation or documentation
The [backup: value] part is never written. Commas are replaced with spaces (they separate the names in the controller files). When the IONAME.DAT or VARNAME.DAT of the backup itself is overwritten, a copy IONAME.DAT.bak / VARNAME.DAT.bak is made the first time. Saving the names (IONAME.DAT, VARNAME.DAT, TXT, CSV) requires the Yaskawa licence.

Loading names

Load file of the long text window accepts:
Typical use: export the names to CSV, translate them (e.g. German to English), load the CSV back, check the jobs with the new names in the tooltips and save IONAME.DAT and VARNAME.DAT for the controller.

▲ Parameter files (*.PRM)

The parameter files of the backup (ALL.PRM, SC.PRM, RC.PRM, SV.PRM ...) open in the text editor with their own highlighting (yaskawa_prm.xml, chosen automatically for *.PRM): the file header (//SC DX), the sections (///S1C1G) and the values - zeros are grey, so that the values that are set stand out.

A sticky header above the text always shows where the first visible line belongs: the file header (//SC DX - in ALL.PRM the file the section comes from), the section with its line number and the address of the first value of the first visible line (e.g. S1C1G400). A click on the section goes to its line.
ALL.PRM: the sticky header shows file RC, section RC1G (line 14); line 113 starts with RC1G980, the gear ratio numerators.
A value is identified by its address: the section and the position of the value in the section, counted from 0 over all lines of the section (ten values per line). The tooltip of a value shows the address, the value and, for the parameters DReS reads itself, the meaning:
AddressMeaning
S1CgG400 .. 407positive soft limit of axis 1..8 of control group g [pulse] (SC.PRM)
S1CgG408 .. 415negative soft limit of axis 1..8 [pulse] (SC.PRM)
RCgG972 .. 979gear ratio denominator of axis 1..8 (RC.PRM)
RCgG980 .. 987gear ratio numerator of axis 1..8, the sign gives the motor direction (RC.PRM)
SVgG24 .. 31encoder pulses per motor revolution of axis 1..8 (SV.PRM)
SC.PRM: zeros in grey, tooltip of the negative soft limit of axis 1 (S1C1G408).
Besides these, about 110 parameters of SC.PRM have a short meaning after the parameter chapter of the Yaskawa DX200 manual: speeds and positioning zones (S1CgG000 ..), operation and mode settings (S2C195 ..), cube and interference areas (S2C001 .., S3C000 ..), relays (S4C327 ..). Most numbers are the same on DX100 and YRC1000, but this is not guaranteed - check the manual of the controller before changing a parameter.

The application parameters of AP.PRM (A1P .. A8P, one section per application) mean different things depending on the application set in AxP000 (0 = arc welding); the tooltip lists the variants of the manual, e.g. A1P003: arc welding - first start condition file of power source 2, handling - output of the F2 key, spot welding - maximum number of power sources.

Without the Yaskawa licence the address and meaning (tooltip, sticky header) are shown for the first 100 lines of a parameter file. The whole file stays readable and highlighted; further on the sticky header shows the file header and the section as usual, and in place of the address a warning icon with the information that the address and meaning of the parameters require the Yaskawa licence. The comparison of parameter files value by value (Archive Diff) always requires the licence.

The addresses are the ones used in the Yaskawa manuals and on the teach pendant (e.g. S1C1G400); other parameters show the address and the value only.

Basics | Viewer | Point editor | Robot 3D View | Settings | Plugins