9. Command Line Interface
For helping users in some special situations and to do not confuse other users the EC-Engineer supports a small command line interface:
- /CFG = config.ecc
Open a specific configuration file
config.ecc
directly after starting EC-Engineer- /EMI = emi.xml
Sets the path to the
EMI
file which should be used (Mandatory if ecc does not already exist)
- /CAPTURE= capture.ecd
Open a specific capture file
capture.ecd
directly after starting EC-Engineer and activates the diagnosis mode
- /ENIBUILDER
Activates the EniBuilder support, means two additional context menu entries of the device will be available to export and import the configuration file for the EniBuilder
- /FORCECFG= config.ecc
Activates the “integration” mode, to be able create an
ENI
file automatically on closing EC-Engineer- Some menu entires are also hidden, like
“New/Open/Save”
“EMI Manager”
“Export Process Variables / Import
ENI
file / ExportENI
file”Toolbar
Further supported parameters:
- /LOCAL = "127.0.0.1"
Activates the local system and the network adapter with IP address “127.0.01” will be chosen. If you use the optimized LinkLayer you can write
/LOCAL
=”I8254x” or/LOCAL
=”RTL8169” (/LOCAL
or/REMOTE
or/CAPTURE
is mandatory).
- /REMOTE = "127.0.0.1:6000:0:0"
Activates the remote system, where IP address is “127.0.0.1”, port is 6000, master instance is set to 0 and protocol is 0 (RAS). It is also supported to use the DNS name instead of the IP address (
/LOCAL
or/REMOTE
or/CAPTURE
is mandatory). It is also possible to set the parameter for more master instances (only if ecc exists with more master units). Therefore just add the additional parameter with a ‘;’. E.g.:/REMOTE
=”127.0.0.1:6000:1;127.0.0.2:6001:2” or/REMOTE
=”127.0.0.1:6000:1:0;127.0.0.2:6001:2:0”
- /CAPTURE = C:/myfile.ccd:0
Activates the offline diagnosis system, where the path to the capture file is
c:/myfile.ccd
and the selected snapshot is “0” (/LOCAL
or/REMOTE
or/CAPTURE
is mandatory)
- /VARTYPE = "csv|plc|pd|xml" (default=csv)
Sets the format of the process variables export slave (for more information about the supported formats
- /FORCEDIAG
Activates the diagnosis mode after startup. If diagnosis mode can not be activated the application will be closed.
- /AUTOSAVE
Current configuration will be saved automatically on exit (without asking the user if he want to discard all changes)
- /ALLMASTERUNITS
If there is more than one master unit in the ecc, you can create an
ENI
file and variable export for all with this paramter
- Samples
Run “EC-Engineer”, scan automatically the local system with IP address 127.0.0.1, export
ENI
file and export process variables (as CSV Format) on closingEcEngineer.exe /FORCECFG="cfg_local.ecc" /EMI="emi.xml" /LOCAL=127.0.0.1 /SCAN /ENIEXPORT="cfg_local.eni" /VAREXPORT="cfg_local.var" /VARTYPE="csv"
Run “EC-Engineer”, scan automatically the remote system with IP address 127.0.0.1, Port 6000, MasterInstance 0, export
ENI
file and export process variables (as PLC Format) on closingEcEngineer.exe /FORCECFG="cfg_remote.ecc" /EMI="emi.xml" /REMOTE=127.0.0.1:6000:0:0 /SCAN /ENIEXPORT="cfg_remote.eni" /VAREXPORT="cfg_remote.var" /VARTYPE="plc"
Run EC-Engineer and switch to diagnosis mode
EcEngineer.exe /FORCECFG="cfg_remote.ecc" /EMI="emi.xml" /REMOTE=127.0.0.1:6000:0:0 /FORCEDIAG
Run EC-Engineer and switch to offline diagnosis mode
EcEngineer.exe /FORCECFG="cfg_capture.ecc" /EMI="emi.xml" /CAPTURE=C:/myfile.ccd:0 /FORCEDIAG
- In case of an error, EC-Engineer will do the following
Add error message to the log file (message level must be set to “All Messages”)
If the GUI is already visible, he will show a message box
Set exit code to “-1”