IgH EtherCAT Master for Linux
Go to file
Florian Pose 2e17997172 Introduced version number define. 2006-04-20 14:34:58 +00:00
devices Introduced version number define. 2006-04-20 14:34:58 +00:00
include Translated all comments and documentation to english language. 2006-04-20 13:31:31 +00:00
master Introduced version number define. 2006-04-20 14:34:58 +00:00
mini Translated all comments and documentation to english language. 2006-04-20 13:31:31 +00:00
rt Translated all comments and documentation to english language. 2006-04-20 13:31:31 +00:00
tools Better calc. of coupler address; coupler address in SysFS; better output of ec_list 2006-04-11 14:12:01 +00:00
Doxyfile Advanced build system 2006-04-11 08:26:18 +00:00
Makefile Translated all comments and documentation to english language. 2006-04-20 13:31:31 +00:00
README README: Requirements and realtime. 2006-04-18 13:41:17 +00:00
TODO Moved fragen.txt outside the source tree, renamed todo.txt to TODO 2006-04-20 13:19:36 +00:00
ethercat.conf.tmpl Better installer and startup scripts. 2006-04-07 10:38:47 +00:00
ethercat.sh Restart action in RC script 2006-04-10 07:29:53 +00:00
install.sh ec_list tool for listing the bus in user space 2006-04-11 12:54:01 +00:00

README

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

$Id$

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

General Information
===================

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

For more information, see

http://etherlab.org

or contact

Florian Pose <fp@igh-essen.com>
Ingenieurgemeinschaft IgH
Heinz-Baecker-Str. 34
D-45356 Essen
http://igh-essen.com

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

Requirements
============

1) Software requirements

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

2) Hardware requirements

The EtherCAT master needs a RTL8139 (or compatible) network interface card to
run. Drivers for other widespread devices (i. e. Intel PRO/100) will be
implemented soon.

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

Building and installing
=======================

1) Create a copy of the configuration template:

  $ cp ethercat.conf.tmpl ethercat.conf

2) Adjust the Variables in the configuration file to your needs.

3) Build the EtherCAT master and network device driver modules:

  $ make

4) Install the the EtherCAT master (as root):

  # make install

  This will create the following files and directories:
    - /etc/sysconfig/ethercat (configuration file)
    - /etc/init.d/ethercat    (startup script)
    - /usr/sbin/rcethercat    (link to startup script)

  The modules will be placed in /lib/modules/<KERNEL>/kernel/drivers/net
  (where <KERNEL> is the Linux kernel version configured in ethercat.conf).

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

Realtime & Tuning
=================

Realtime patches for the Linux kernel are supported, but not required. The
realtime processing has to be done by the calling module (see API
documentation). The EtherCAT master code itself is (except for the free-run
mode) completely passive.

To avoid frame timeouts, deactivating DMA access for hard drives is
recommented (hdparm -d0 <DEV>).

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