INSTALL
author Florian Pose <fp@igh-essen.com>
Mon, 29 Dec 2008 15:22:00 +0000
branchstable-1.4
changeset 1687 5c40af734120
parent 1654 6b835fae2cab
child 1331 7cd33a77f926
permissions -rw-r--r--
Output ioctl() debugging in hex.
-------------------------------------------------------------------------------

This is the INSTALL file of the IgH EtherCAT Master.

$Id$

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

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

The build and installation procedure is described in section 2.1 in the
documentation available from http://etherlab.org/en/ethercat.

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

For the impatient: The procedure mainly consists of calling

$ ./configure
$ make
$ make modules

(and as root)

# make install
# make modules_install
# depmod

...and linking the init script and copying the sysconfig file from $PREFIX/etc
to the appropriate locations and customizing the sysconfig file.

# ln -s ${PREFIX}/etc/init.d/ethercat /etc/init.d/ethercat
# cp ${PREFIX}/etc/sysconfig/ethercat /etc/sysconfig/ethercat
# vi /etc/sysconfig/ethercat

Make sure, that the 'udev' package is installed, to automatically create the
EtherCAT character devices. The character devices will be created with mode
0660 and group root by default. If you want to give normal users reading
access, create a udev rule like this:

# echo KERNEL==\"EtherCAT[0-9]*\", MODE=\"0664\" > /etc/udev/rules.d/99-EtherCAT.rules

Now you can start the EtherCAT master:

# /etc/init.d/ethercat start

Have a look at the examples/ subdirectory for some application examples.

Have fun!

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