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:

/HELP, /?

Shows the help dialog

/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)

/REMOTE = "127.0.0.1:6000:0"

Activates the remote system, where IP address is “127.0.0.1”, port is 6000, master instance is set to 0

/ENIEXPORT = config.eni

Activates an automatic ENI export on close

/CYCLETIME = "2000"

Changes the cycle time from ecc or EMI in config

/DIAG

Activates diagnosis mode

/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

/PROJECTTEMPLATEPATH

Opens a specific configuration file as project template

/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 / Export ENI file”

  • Toolbar

Further supported parameters:

/EMI = emi.xml

Sets the path to the EMI file which should be used (Mandatory)

/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)

/ENIEXPORT = config.eni

Activates the ENI export (Mandatory)

/VAREXPORT = config.var

Activates the process variables export (Optional)

/VARTYPE = "csv|plc|pd|xml" (default=csv)

Sets the format of the process variables export slave (for more information about the supported formats

/EBIEXPORT = config.ebi

Activates the EBI (EniBuilder input file) export

/SCAN

Scans the bus after startup

/FORCEDIAG

Activates the diagnosis mode after startup. If diagnosis mode can not be activated the application will be closed.

/CYCLETIME ="1000"

Sets the master cycle time and locks it for the user

/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 closing

EcEngineer.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 closing

EcEngineer.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”