1

-------------------------------------------------------------------------------

     2

     3

This is the README file of the IgH EtherCAT Master.

     4

     5

$Id$

     6

     7

Contents:

     8

1) General Information

     9

2) Requirements

    10

3) Building and installing

    11

4) Realtime & Tuning

    12

5) License

    13

    14

-------------------------------------------------------------------------------

    15

    16

1) General Information

    17

======================

    18

    19

This is an Open-Source EtherCAT master implementation for Linux 2.6.

    20

    22

    23

http://etherlab.org

    24

    25

or contact

    26

    27

Florian Pose <fp@igh-essen.com>

    28

Ingenieurgemeinschaft IgH

    29

Heinz-Baecker-Str. 34

    30

D-45356 Essen

    31

http://igh-essen.com

    32

    33

-------------------------------------------------------------------------------

    34

    35

2) Requirements

    36

===============

    37

    38

1) Software requirements

    39

    40

Configured sources for the Linux 2.6 kernel are required to build the EtherCAT

    41

master.

    42

    43

2) Hardware requirements

    44

    45

The EtherCAT master needs a RTL8139 (or compatible) network interface card to

    46

run. Drivers for other widespread devices (i. e. Intel PRO/100) will be

    47

implemented soon.

    48

    49

-------------------------------------------------------------------------------

    50

    51

3) Building and installing

    52

==========================

    53

    54

See the INSTALL file.

    55

    56

-------------------------------------------------------------------------------

    57

    58

4) Realtime & Tuning

    59

====================

    60

    61

Realtime patches for the Linux kernel are supported, but not required. The

    62

realtime processing has to be done by the calling module (see API

    63

documentation). The EtherCAT master code itself is (except for the free-run

    64

mode) completely passive.

    65

    66

To avoid frame timeouts, deactivating DMA access for hard drives is

    67

recommented (hdparm -d0 <DEV>).

    68

    69

-------------------------------------------------------------------------------

    70

    71

5) License

    72

==========

    73

    74

Copyright (C) 2006  Florian Pose, Ingenieurgemeinschaft IgH

    75

    76

This file is part of the IgH EtherCAT Master.

    77

    78

The IgH EtherCAT Master is free software; you can redistribute it

    79

and/or modify it under the terms of the GNU General Public License

    80

as published by the Free Software Foundation; either version 2 of the

    81

License, or (at your option) any later version.

    82

    83

The IgH EtherCAT Master is distributed in the hope that it will be

    84

useful, but WITHOUT ANY WARRANTY; without even the implied warranty of

    85

MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

    86

GNU General Public License for more details.

    87

    88

You should have received a copy of the GNU General Public License

    89

along with the IgH EtherCAT Master; if not, write to the Free Software

    90

Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA

    91

    92

The right to use EtherCAT Technology is granted and comes free of

    93

charge under condition of compatibility of product made by

    94

Licensee. People intending to distribute/sell products based on the

    95

code, have to sign an agreement to guarantee that products using

    96

software based on IgH EtherCAT master stay compatible with the actual

    97

EtherCAT specification (which are released themselves as an open

    98

standard) as the (only) precondition to have the right to use EtherCAT

    99

Technology, IP and trade marks.

   100

   101

-------------------------------------------------------------------------------