7. Command Line Interface

For helping users in some special situations and to do not confuse other users the EC-EngineerWeb 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-EngineerWeb

/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

/FORCECFG= config.ecc

Activates the “integration” mode, to be able create an ENI file automatically on closing EC-EngineerWeb

Some menu entires are also hidden, like

  • “New/Open/Save”

  • “Export Process Variables / Import ENI file / Export ENI file”

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

/CYCLETIME ="1000"

Sets the master cycle time and locks it for the user

Samples

Run “EC-EngineerWeb”, scan automatically the local system with IP address 127.0.0.1, export ENI file and export process variables (as CSV Format) on closing

EcEngineerWeb.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-EngineerWeb”, 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

EcEngineerWeb.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"
In case of an error, EC-EngineerWeb 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”