# Running EcMasterDemoDc

The EcMasterDemoDc is available “out of the box” for different operating systems. It is an EC-Master example application that handles the following tasks:

- Showing basic EtherCAT® communication
- MainDevice stack initialization into OPERATIONAL state
- DC and DCM configuration
- Process Data operations for e.g. Beckhoff EL2004, EL1004 and EL4132
- Periodic diagnosis task
- Periodic Job Task in polling mode
- Logging

Start the EcMasterDemoDc from the command line to put the EtherCAT® network into operation. At least a Real-time Ethernet Driver must be specified.

```doscon
> EcMasterDemoDc -ndis 192.168.157.2 1 -f eni.xml -t 0 -v 3 -dcmmode busshift
```

## Command line parameters

### EcMasterDemoDc             <LinkLayer> [-f ENI-FileName] [-t time] [-b cycle time] [-a affinity] [-v level] [-perf [level]] [-log prefix [msg cnt]] [-lic key] [-oem key] [-fingerprint method] [-maxbusslaves cnt] [-flash address] [-printvars] [-sp [port]] [-ctloff] [-rec [prefix [frame cnt]]] [-junctionred] [-dcmmode <mode> [<synctocyclestart>]] [-dcmlog]

The parameters are as follows:

### -f <ENI-FileName>

Path to ENI file

### -t <time>

Running duration [ms]. When the time expires the demo application exits completely.

* **<time>:**
  Time [ms], 0 = forever (default = 120000)

### -b <cycle time>

Specifies the bus cycle time. Defaults to 1000 µs (1 ms).

* **<cycle time>:**
  Bus cycle time in µsec

### -a <affinity>

The CPU affinity specifies which CPU the demo application ought to use.

* **<affinity>:**
  0 = first CPU, 1 = second, …

### -v <level>

The verbosity level specifies how much console output messages will be generated by the demo application. A high verbosity level leads to more messages.

* **<level>:**
  Verbosity level: 0=off (default), 1..n=more messages

### -perf [<level>]

Enable max. and average time measurement in µs for all EtherCAT® jobs (e.g. ProcessAllRxFrames).

* **<level>:**
  Depending on level the performance histogram can be activated as well.

### -log <prefix> [<msg cnt>]

Use given file name prefix for log files.

* **<prefix>:**
* **<msg cnt>:**
  Messages count for log buffer allocation

### -lic <key>

Set License key.

* **<key>:**
  License key string

### -oem <key>

Use OEM key

* **<key>:**
  64 bit OEM key.

### -fingerprint <method>

Read license fingerprint

* **<method>:**
  Fingerprint method

### -junctionred

Enable junction redundancy (automatic mode)

### -flash <address>

Flash outputs

* **<address>:**
  0=all, >0 = SubDevice station address

### -sp [<port>]

If platform has support for IP Sockets, this command-line option enables the Remote API Server to be started. The Remote API Server is going to listen on TCP Port 6000 (or port parameter if given) and is available for connecting Remote API Clients.

* **<port>:**
  RAS server port

### -rec [<prefix> [<frame cnt>]]

Packet capture file recording

* **<prefix>:**
  File name prefix
* **<frame cnt>:**
  Frame count for log buffer allocation

### -dcmmode <mode> [<synctocyclestart>]

Set DCM mode

* **<mode>:**
  off | busshift | mastershift | masterrefclock | linklayerrefclock
* **<synctocyclestart>:**
  Sync to cycle start: 0 = disabled (default), 1 = enabled

### -dcmlog

Enable DCM logging (default: disabled)

### -ctloff

Disable DCM control loop for diagnosis