IgH EtherCAT Master for Linux
Go to file
Florian Pose 8d0c28bae8 README: Requirements and realtime. 2006-04-18 13:41:17 +00:00
devices Fixed devices Makefile. 2006-04-12 12:04:27 +00:00
include Fixed syntax error in EC_READ_BIT macro. 2006-04-06 09:16:25 +00:00
master Prepared Free-Run mode 2006-04-12 10:40:32 +00:00
mini Plugfest: rt und mini angepasst. 2006-04-05 09:04:29 +00:00
rt Prepared Free-Run mode 2006-04-12 10:40:32 +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 Advanced build system 2006-04-11 08:26:18 +00:00
README README: Requirements and realtime. 2006-04-18 13:41:17 +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
fragen.txt Fragen aktualisiert. 2006-04-05 13:38:41 +00:00
install.sh ec_list tool for listing the bus in user space 2006-04-11 12:54:01 +00:00
todo.txt Updated todo.txt 2006-04-11 14:38:34 +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>).

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