Download CX-Supervisor Reference Manual

PLC Commands
SECTION 6 Functions and Methods
The PLC called controlPLC is closed. No further communications with the
PLC will take place until it is reopened.
6-6-2
DownloadPLCProgram
Syntax
returnstate
processed)
=
DownloadPLCProgram(plcname,
filename,
Remarks
Argument
Type
Description
returnstate
bool
Returnstate is '1' if the function is successful, or
'0' otherwise.
plcname
string
Name of PLC to download the program to.
filename
string
Name of the file on disk to download to the
PLC. If a drive and path are not specified, the
current directory is assumed, which may not be
the same as the application directory. If a
filename is specified as "" the user is prompted
at runtime for a filename.
processed
bool
processed is set to 'TRUE' when the operation
is actually completed.
Typical Example
DownloadPLCProgram("controlPLC", "Prog01.bin", done)
The program stored in the file 'Prog01.bin' in the current directory is
downloaded to the PLC 'controlPLC'. Before continuing, the script waits up to
five seconds for the action to succeed.
6-6-3
Note:
The operation may not be complete immediately after the statement has been
executed. The processed flag 'done' is set at a later time when the operation
has been completed. Therefore, if using statements that require the upload to
be completed create an On Condition script containing the code to be
executed after the upload, with the processed flag as the expression (e.g.
'done').
Note:
This command can only be used when the PLC is in 'STOP' mode. Refer to
chapter 6, GetPLCMode or chapter 6, SetPLCMode for further information.
GetPLCMode
Syntax
mode = GetPLCMode("plcname")
Remarks
Argument
Type
Description
mode
string
A Text point containing the current PLC mode.
Possible modes are 'STOP', 'DEBUG', 'RUN',
'MONITOR' and 'UNKNOWN'.
plcname
string
Name of PLC
Typical Example
currentmode = GetPLCMode("controlPLC")
In this example, the current mode of the PLC 'controlPLC' is stored in the point
'currentmode'.
68