<a id="compile-ecdemo"></a>

# Compiling the EcMonitorDemo

The following main rules can be used to generate the example applications for all operating systems.

- `<OS>` is a placeholder for the operating system used.
- `<ARCH>` for the architecture. If different architectures are supported.

## Software Development Kit (SDK)

The EC-Monitor development kit is needed to write applications based on the EC-Monitor core.
The EC-Monitor core is shipped as a library which is linked together with the application.

The following components are supplied together with an SDK:

- `/Bin`:       Executables containing the EC-Monitor core
- `/Doc`:       Documentation
- `/Examples`:  Example applications as source code
- `/SDK`:       EtherCAT® Software Development Kit containing libraries and header files to build C/C++-applications
- `/SDK/INC`:   Header files to be included with the application
- `/SDK/LIB`:   Libraries to be linked with the application
- `/SDK/FILES`: Additional files for platform integration
- `/Sources/Common`: Shared source code

## Include search path

The header files are located in the following directories:

```default
<InstallPath>/SDK/INC/<OS>/<ARCH>
<InstallPath>/SDK/INC
<InstallPath>/Sources/Common
```

## Libraries

The libraries are delivered as static, dynamic or both. This is depending on the operating system. They are located in the following directories:

Static libraries
: ```default
  <InstallPath>/SDK/LIB/<OS>/<ARCH>
  ```
  <br/>
  EC-Monitor core
  : ```default
    libEcMonitor.a
    ```
  <br/>
  EC-Monitor RAS server (optional)
  : ```default
    libEcMonitorRasServer.a
    ```

Dynamic libraries
: ```default
  <InstallPath>/Bin/<OS>/<ARCH>
  ```
  <br/>
  EC-Monitor core
  : ```default
    libEcMonitor.so
    ```
  <br/>
  EC-Monitor RAS server (optional)
  : ```default
    libEcMonitorRasServer.so
    ```

Whether it is a Shared Object `*.so` or a Dynamic Link Library `*.dll` depends on the operating system.

## Preprocessor definitions

The following preprocessor directives must be set in the build environment or project:

```default
EC_MONITOR
```

Exclude the EC-Daq support in the demo:

```default
EXCLUDE_DAQ_SUPPORT
```