INSTALL
author Dominik Staubli <ch1010252@ch10pc423>
Thu, 21 Jan 2010 11:09:31 +0100
changeset 1798 e7733f825982
parent 1331 7cd33a77f926
child 1883 57b500c062fe
permissions -rw-r--r--
Domain datagram working counter calculation bugfix: increment expected wc for a given slave & direction just once for each datagram
This bug occurs if you configure more than one SM in the same direction on the same slave
198
f7dff1ed01ba Separate INSTALL file.
Florian Pose <fp@igh-essen.com>
parents:
diff changeset
     1
-------------------------------------------------------------------------------
f7dff1ed01ba Separate INSTALL file.
Florian Pose <fp@igh-essen.com>
parents:
diff changeset
     2
f7dff1ed01ba Separate INSTALL file.
Florian Pose <fp@igh-essen.com>
parents:
diff changeset
     3
This is the INSTALL file of the IgH EtherCAT Master.
f7dff1ed01ba Separate INSTALL file.
Florian Pose <fp@igh-essen.com>
parents:
diff changeset
     4
f7dff1ed01ba Separate INSTALL file.
Florian Pose <fp@igh-essen.com>
parents:
diff changeset
     5
$Id$
f7dff1ed01ba Separate INSTALL file.
Florian Pose <fp@igh-essen.com>
parents:
diff changeset
     6
1331
7cd33a77f926 merge -c1609 branches/stable-1.4: INSTALL, README.
Florian Pose <fp@igh-essen.com>
parents: 1214
diff changeset
     7
vim: set spelllang=en spell tw=78
7cd33a77f926 merge -c1609 branches/stable-1.4: INSTALL, README.
Florian Pose <fp@igh-essen.com>
parents: 1214
diff changeset
     8
198
f7dff1ed01ba Separate INSTALL file.
Florian Pose <fp@igh-essen.com>
parents:
diff changeset
     9
-------------------------------------------------------------------------------
f7dff1ed01ba Separate INSTALL file.
Florian Pose <fp@igh-essen.com>
parents:
diff changeset
    10
f7dff1ed01ba Separate INSTALL file.
Florian Pose <fp@igh-essen.com>
parents:
diff changeset
    11
Building and installing
355
3a652b240c48 Improved INSTALL file.
Florian Pose <fp@igh-essen.com>
parents: 198
diff changeset
    12
=======================
3a652b240c48 Improved INSTALL file.
Florian Pose <fp@igh-essen.com>
parents: 198
diff changeset
    13
1331
7cd33a77f926 merge -c1609 branches/stable-1.4: INSTALL, README.
Florian Pose <fp@igh-essen.com>
parents: 1214
diff changeset
    14
The complete build and installation procedure is described in the respective
7cd33a77f926 merge -c1609 branches/stable-1.4: INSTALL, README.
Florian Pose <fp@igh-essen.com>
parents: 1214
diff changeset
    15
section of the documentation available from http://etherlab.org/en/ethercat.
355
3a652b240c48 Improved INSTALL file.
Florian Pose <fp@igh-essen.com>
parents: 198
diff changeset
    16
198
f7dff1ed01ba Separate INSTALL file.
Florian Pose <fp@igh-essen.com>
parents:
diff changeset
    17
-------------------------------------------------------------------------------
380
971d079ff771 Updated INSTALL file.
Florian Pose <fp@igh-essen.com>
parents: 355
diff changeset
    18
785
c7e600cd2812 Updated README etc.
Florian Pose <fp@igh-essen.com>
parents: 560
diff changeset
    19
For the impatient: The procedure mainly consists of calling
380
971d079ff771 Updated INSTALL file.
Florian Pose <fp@igh-essen.com>
parents: 355
diff changeset
    20
487
448b0b23b905 Updated documentation.
Florian Pose <fp@igh-essen.com>
parents: 380
diff changeset
    21
$ ./configure
1331
7cd33a77f926 merge -c1609 branches/stable-1.4: INSTALL, README.
Florian Pose <fp@igh-essen.com>
parents: 1214
diff changeset
    22
$ make all modules
380
971d079ff771 Updated INSTALL file.
Florian Pose <fp@igh-essen.com>
parents: 355
diff changeset
    23
1331
7cd33a77f926 merge -c1609 branches/stable-1.4: INSTALL, README.
Florian Pose <fp@igh-essen.com>
parents: 1214
diff changeset
    24
... and as root:
487
448b0b23b905 Updated documentation.
Florian Pose <fp@igh-essen.com>
parents: 380
diff changeset
    25
1331
7cd33a77f926 merge -c1609 branches/stable-1.4: INSTALL, README.
Florian Pose <fp@igh-essen.com>
parents: 1214
diff changeset
    26
# make modules_install install
1106
745a0cc03143 Added depmod call to docs.
Florian Pose <fp@igh-essen.com>
parents: 1081
diff changeset
    27
# depmod
487
448b0b23b905 Updated documentation.
Florian Pose <fp@igh-essen.com>
parents: 380
diff changeset
    28
1331
7cd33a77f926 merge -c1609 branches/stable-1.4: INSTALL, README.
Florian Pose <fp@igh-essen.com>
parents: 1214
diff changeset
    29
... and linking the init script and copying the sysconfig file from $PREFIX/etc
1017
b9224ef0546c Updated install script; udev rule.
Florian Pose <fp@igh-essen.com>
parents: 785
diff changeset
    30
to the appropriate locations and customizing the sysconfig file.
b9224ef0546c Updated install script; udev rule.
Florian Pose <fp@igh-essen.com>
parents: 785
diff changeset
    31
b9224ef0546c Updated install script; udev rule.
Florian Pose <fp@igh-essen.com>
parents: 785
diff changeset
    32
# ln -s ${PREFIX}/etc/init.d/ethercat /etc/init.d/ethercat
b9224ef0546c Updated install script; udev rule.
Florian Pose <fp@igh-essen.com>
parents: 785
diff changeset
    33
# cp ${PREFIX}/etc/sysconfig/ethercat /etc/sysconfig/ethercat
b9224ef0546c Updated install script; udev rule.
Florian Pose <fp@igh-essen.com>
parents: 785
diff changeset
    34
# vi /etc/sysconfig/ethercat
b9224ef0546c Updated install script; udev rule.
Florian Pose <fp@igh-essen.com>
parents: 785
diff changeset
    35
1214
63802a52dd69 udev docs.
Florian Pose <fp@igh-essen.com>
parents: 1106
diff changeset
    36
Make sure, that the 'udev' package is installed, to automatically create the
63802a52dd69 udev docs.
Florian Pose <fp@igh-essen.com>
parents: 1106
diff changeset
    37
EtherCAT character devices. The character devices will be created with mode
63802a52dd69 udev docs.
Florian Pose <fp@igh-essen.com>
parents: 1106
diff changeset
    38
0660 and group root by default. If you want to give normal users reading
63802a52dd69 udev docs.
Florian Pose <fp@igh-essen.com>
parents: 1106
diff changeset
    39
access, create a udev rule like this:
1017
b9224ef0546c Updated install script; udev rule.
Florian Pose <fp@igh-essen.com>
parents: 785
diff changeset
    40
b9224ef0546c Updated install script; udev rule.
Florian Pose <fp@igh-essen.com>
parents: 785
diff changeset
    41
# echo KERNEL==\"EtherCAT[0-9]*\", MODE=\"0664\" > /etc/udev/rules.d/99-EtherCAT.rules
b9224ef0546c Updated install script; udev rule.
Florian Pose <fp@igh-essen.com>
parents: 785
diff changeset
    42
b9224ef0546c Updated install script; udev rule.
Florian Pose <fp@igh-essen.com>
parents: 785
diff changeset
    43
Now you can start the EtherCAT master:
b9224ef0546c Updated install script; udev rule.
Florian Pose <fp@igh-essen.com>
parents: 785
diff changeset
    44
b9224ef0546c Updated install script; udev rule.
Florian Pose <fp@igh-essen.com>
parents: 785
diff changeset
    45
# /etc/init.d/ethercat start
b9224ef0546c Updated install script; udev rule.
Florian Pose <fp@igh-essen.com>
parents: 785
diff changeset
    46
1081
66c60b99c2e8 Minor change.
Florian Pose <fp@igh-essen.com>
parents: 1017
diff changeset
    47
Have a look at the examples/ subdirectory for some application examples.
66c60b99c2e8 Minor change.
Florian Pose <fp@igh-essen.com>
parents: 1017
diff changeset
    48
1017
b9224ef0546c Updated install script; udev rule.
Florian Pose <fp@igh-essen.com>
parents: 785
diff changeset
    49
Have fun!
380
971d079ff771 Updated INSTALL file.
Florian Pose <fp@igh-essen.com>
parents: 355
diff changeset
    50
971d079ff771 Updated INSTALL file.
Florian Pose <fp@igh-essen.com>
parents: 355
diff changeset
    51
-------------------------------------------------------------------------------