FANUC Open CNC

FROM / SRAM Management Utility for Command Line

Specification

Edition 1.0
12-August-2004

Software Development Center

FANUC LTD.

The contents of this document are subject to change without

notice according to the progress of development.

TITLE
FANUC Open CNC
FROM/SRAM Management Utility for Command
Line Specification

01 04.08.12 New DRAW.NO. A-79714E

Ed. Date Design Description FANUC LTD. Sheet 1/9

1. Overview
On the control boards of CNC, Flash ROM modules (hereafter, “FROM”) and Static RAM
modules (hereafter, “SRAM”) are mounted. In these FROM/SRAM modules, the important
data that decides the CNC/PMC characteristic is stored. Typical data that stored in each
module is as follows.

A. FROM included files

<System files>
CNC control software
PMC management software
Servo management software
Ethernet management firmware

<User files>
Ladder program
C-language executor
Macro executor
Order made macro
PMC C-language program

B. SRAM included data

NC programs
CNC/PMC parameters
Tool offset
Custom macro variables

Up to now, these data are managed at CNC BOOT function with using memory cards at every
CNC control unit.
When Open CNC is introduced, the PC function is connected to CNC control unit through High
Speed Serial Bus (HSSB) or Ethernet. Then the input/output of these FROM/SRAM data can
be done at the remote place apart from the shop floor of CNC control units. And using PC
function, the centralized management of FROM/SRAM data of multiple CNC control units can
be achieved.

In this document, we would like to explain the specification of “FROM/SRAM Management

Utility” that runs on the PC function.

TITLE
FANUC Open CNC
FROM/SRAM Management Utility for Command
Line Specification

01 04.08.12 New DRAW.NO. A-79714E

Ed. Date Design Description FANUC LTD. Sheet 2/9

2. Supported functions
This utility can do the following operations to FROM/SRAM data of CNC control unit from Open
CNC PC side.

Operation on FROM
SAVE function : backs up the files stored in the FROM to any folder of PC.
DELETE function : deletes the files stored in the FROM.
LOAD function : restores the saved FROM files under any folder of PC into the
FROM of CNC.
Restored FROM file becomes effective after next power on cycle
of CNC.

Operation on SRAM
BACKUP function : backs up whole contents of SRAM data to any folder of PC.
RESTORE function : restores the saved SRAM data to CNC.

3. Caution
A. CNC ID information is included in the FROM/SRAM data that is backed up by this utility.
So, the backed-up data cannot be restored to CNC other than the original CNC from which
the data is backed up as a general rule.

B. When SRAM data is backed up and SRAM data is restored using this utility, CNC must be
in the emergency stop state.

C. Please do the backup and the restore operation of SRAM data immediately after the power
supply is turned on.

TITLE
FANUC Open CNC
FROM/SRAM Management Utility for Command
Line Specification

01 04.08.12 New DRAW.NO. A-79714E

Ed. Date Design Description FANUC LTD. Sheet 3/9

4. Naming convention of stored files
When FROM/SRAM data is backed up using this utility, the stored files in the PC is named as
follows.

For FROM files when backed up to PC

When FROM files are backed up to PC side, the following file names will attached to the
file automatically.

FROM file name (name on the display list) . xxx (xxx = 000, 001, 002,...)

The extension(xxx) will be added to the file name so that duplicated files do not exist under
the specified folder.
Space “ “, period “.” are replaced with underscore “_” at the FROM file name.

Example) when “NC BASIC” is backed up :

NC_BASIC.000

(File size is original file size + 16 bytes)

For SRAM data when backed up to PC

The name for the SRAM data file is assigned to fixed name according to the original SRAM
size, plus extension at PC.
If the file name is changed, that file cannot be restored to SRAM.

Example) in case of SRAM (1MByte) from “MAIN” of 16i :

The SRAM data is divided into the following 2 files.
SRAM1_0A.FDB (size: 512 KBytes + 16 bytes)
SRAM1_0B.FDB (size: 512 KBytes)

5. Supported CNCs
This utility is available to the following CNCs

FS16i MODEL A/B

FS18i MODEL A/B
FS21i MODEL A/B
FS16i-W MODEL B

TITLE
FANUC Open CNC
FROM/SRAM Management Utility for Command
Line Specification

01 04.08.12 New DRAW.NO. A-79714E

Ed. Date Design Description FANUC LTD. Sheet 4/9

6. Preparation to start
In order to execute this utility application, HSSB driver and FOCAS2 libraries (FWLIB32.DLL,
FWLIB160.DLL, FWLIB16W.DLL, FWLIBE1.DLL) have to be installed to the PC beforehand.

Note)
In case that HSSB connection is not used, HSSB driver and FWLIB160.DLL, FWLIB16W.DLL
are not required.
In case that Ethernet connection is not used, FWLIBE1.DLL is not required.

This utility"FromUtil2.EXE" starts from the command line.

The FOCAS2 libraries and Ethernet management firmware that enable this function is as
follows.

< FOCAS2 libraries >

FWLIB32.DLL Edition 04.1.0.1 or later
FWLIB160.DLL Edition 02.1.0.1 or later
FWLIB16W.DLL Edition 02.1.0.1 or later
FWLIBE1.DLL Edition 02.1.0.14 or later

< Ethernet management firmware >

656A/10 or later
656B/03 or later
6567/12 or later

TITLE
FANUC Open CNC
FROM/SRAM Management Utility for Command
Line Specification

01 04.08.12 New DRAW.NO. A-79714E

Ed. Date Design Description FANUC LTD. Sheet 5/9

7. Operation
This utility"FromUtil2.EXE" starts from the command line.
The progress situation and the processing result are output to the command line screen and
the specified log file.

The command line syntax for FromUtil2.EXE is as follows:

FromUtil2 [-nNode|-hHost:Port [-tTime]] [-lst|-sav|-del|-lod] [-r“path¥list_file”]

[-service] [“Target_path¥”] [-bkup|-rstr]
[-pw1=MTBpassword] [-pw2=USERpassword] [-f”path¥log_file”]

Option Function
-nNode Specify the Node number at HSSB connection (0..7)
-hHost:Port [-tTime] Specify the Host name/IP address and Port number. When the Timeout
value is not specified, it is assumed as 30 second by default.
-lst If specified, this utility writes the name of System files and User files
contained in the CNC’s FROM into the file specified by “path¥list_file”.
When the file name is written, space” ”, period”.” located on the FROM
program name is changed to underscore”_”.
-sav If specified, this utility reads the System files and User files contained in
the CNC’s FROM, and then places them under “Target_path¥”
according to the file name described in the file, “path¥list_file”.
If –service switch is not specified, the System files will not be read out.
-del If specified, this utility deletes the System files and User files contained
in the CNC’s FROM according to the file name described in the file,
“path¥list_file”.
If –service switch is not specified, the System files will not be deleted.
-lod If specified, this utility writes the System files and User files located
under “Target_path¥” into the CNC’s FROM according to the file name
described in the file, “path¥list_file”.
-r“path¥list_file” Specify the PC side file that is referred when the System files and User
files contained in CNC’s FROM are handled by any of the above
(Note 1) switches [-lst|-sav|-del|-lod].
-service Specify this switch in case that the System files contained in the CNC’s
FROM are handled by any of the above switches [-sav|-del].
“Target_path¥” Specify the PC side file location in case that the CNC’s FROM is
handled by any of the above switches [-sav|-lod], or in case that the
CNC’s SRAM is handled by any of the below switches [-bkup|-rstr].
-bkup If specified, this utility reads the CNC’s SRAM data and then saves it
under “Target_path¥”.
When the same name file has been located, the file is overwritten.
-rstr If specified, this utility restores the SRAM data file from “Target_path¥”
into the CNC’s SRAM area.

TITLE
FANUC Open CNC
FROM/SRAM Management Utility for Command
Line Specification

01 04.08.12 New DRAW.NO. A-79714E

Ed. Date Design Description FANUC LTD. Sheet 6/9

 Option Function
-pw1=MTBpassword When the User files contained in the CNC’s FROM or SRAM data is
protected by the CNC parameter setting, specify the corresponding
value for the MTB’s password.
-pw2=USERpassword When the User files contained in the CNC’s FROM or SRAM data is
protected by the CNC parameter setting, specify the corresponding
value for the End user’s password.
-f”path¥log_file” If specified, this utility saves the progress messages displayed on the
command line into the file specified by this option.

(*)The folder name and the file name can be specified by enclosing by a double quotation
marks.
ex.) -fC:¥Temp¥target” “d¥result.log”

(Note 1) Examples of “path¥list_file”

a) In case that [-lst] switch is used:

The name of files contained in the CNC’s FROM are written one by one line.
Space” ”, period”.” located on the FROM program name is changed to underscore”_”.
The extension as the PC file will not added because these file names are the
information read out from CNC.

NC_BASIC
DG_SERVO
PMC-RB
ETHE

b) In case that [-sav|-del] switch is used:

Specify the file name that is to be read out from CNC’s FROM or to be deleted from
CNC’s FROM by one at each line. If semi-colon”;” is placed at the top of the line, the
information of whole line is ignored. The extension as the PC file will not specified
because these file names are the information for CNC’s FROM

NC_BASIC
. DG_SERVO
PMC-RB
; comment example
;ETHE

TITLE
FANUC Open CNC
FROM/SRAM Management Utility for Command
Line Specification

01 04.08.12 New DRAW.NO. A-79714E

Ed. Date Design Description FANUC LTD. Sheet 7/9

 c) In case that [-lod] switch is used:
Specify the PC file name that will be written into the CNC’s FROM by one at each line.
The file names must be matched with the files located under “Target_path¥”. If
semi-colon”;” is placed at the top of the line, the information of whole line is ignored.

NC_BASIC.001
DG_SERVO.001
PMC-RB.001
; comment example
;ETHE.001

Example)

1. "-lst" switch ( for FROM file )

[HSSB connection]
fromutil2 -n0 -lst -r"C:¥fromsram¥list.txt" -f"C:¥fromsram¥log¥List.log"

[Ethernet connection]
fromutil2 -h"192.168.0.1:8193" -t10 -lst -r"C:¥fromsram¥¥list.txt"
-f"C:¥fromsram¥log¥List.log"

2. "-sav" switch ( for FROM file )

[HSSB connection]
fromutil2 -n0 -sav -r"C:¥fromsram¥list.txt" -service -f"C:¥fromsram¥log¥Save.log"
"C:¥fromsram¥target"

[Ethernet connection]
fromutil2 -h"192.168.0.1:8193" -t10 -sav -r"C:¥fromsram¥list.txt"
-service -f"C:¥fromsram¥log¥Save.log" "C:¥fromsram¥target"

3. "-lod" switch ( for FROM file )

[HSSB connection]
fromutil2 -n0 -lod -r"C:¥fromsram¥¥LoadList.txt" –service
-f"C:¥fromsram¥log¥Load.log" "C:¥fromsram¥target"

[Ethernet connection]
fromutil2 -h"192.168.0.1:8193" -t10 -lod -r"C:¥fromsram¥¥LoadList.txt"
-service -f"C:¥fromsram¥log¥Load.log" "C:¥fromsram¥target"

TITLE
FANUC Open CNC
FROM/SRAM Management Utility for Command
Line Specification

01 04.08.12 New DRAW.NO. A-79714E

Ed. Date Design Description FANUC LTD. Sheet 8/9

 4. "-del" switch ( for FROM file )

[HSSB connection]
fromutil2 -n0 -del -r"C:¥fromsram¥list.txt" -service -f"C:¥fromsram¥log¥Delete.log"

[Ethernet connection]
fromutil2 -h"192.168.0.1:8193" -t10 -del -r"C:¥fromsram¥list.txt"
-service -f"C:¥fromsram¥log¥Delete.log"

5. "-bkup" switch ( for SRAM file )

[HSSB connection]
fromutil2 -n0 -bkup -f"C:¥fromsram¥log¥Bkup.log" "C:¥fromsram¥target"

[Ethernet connection]
fromutil2 -h"192.168.0.1:8193" -t10 –bkup
-f"C:¥fromsram¥log¥Bkup.log" "C:¥fromsram¥target"

6. "-rstr" switch ( for SRAM file )

[HSSB connection]
fromutil2 -n0 -rstr -f"C:¥fromsram¥log¥Rstr.log" "C:¥fromsram¥target"

[Ethernet connection]
fromutil2 -h"192.168.0.1:8193" -t10 –rstr
-f"C:¥fromsram¥log¥Rstr.log" "C:¥fromsram¥target"

TITLE
FANUC Open CNC
FROM/SRAM Management Utility for Command
Line Specification

01 04.08.12 New DRAW.NO. A-79714E

Ed. Date Design Description FANUC LTD. Sheet 9/9