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

    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

    21

For more information, see

    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

    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; version 2 of the License.

    81

    82

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

    83

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

    84

MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

    85

GNU General Public License for more details.

    86

    87

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

    88

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

    89

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

    90

    91

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