INSTALL
author Florian Pose <fp@igh-essen.com>
Wed, 24 Sep 2008 08:48:23 +0000
branchstable-1.4
changeset 1634 ae4c73f4c56d
parent 1106 745a0cc03143
child 1214 63802a52dd69
permissions -rw-r--r--
merge -r1446:1448 trunk: Plugfest6 fixes.
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
f7dff1ed01ba Separate INSTALL file.
Florian Pose <fp@igh-essen.com>
parents:
diff changeset
     7
-------------------------------------------------------------------------------
f7dff1ed01ba Separate INSTALL file.
Florian Pose <fp@igh-essen.com>
parents:
diff changeset
     8
f7dff1ed01ba Separate INSTALL file.
Florian Pose <fp@igh-essen.com>
parents:
diff changeset
     9
Building and installing
355
3a652b240c48 Improved INSTALL file.
Florian Pose <fp@igh-essen.com>
parents: 198
diff changeset
    10
=======================
3a652b240c48 Improved INSTALL file.
Florian Pose <fp@igh-essen.com>
parents: 198
diff changeset
    11
785
c7e600cd2812 Updated README etc.
Florian Pose <fp@igh-essen.com>
parents: 560
diff changeset
    12
The build and installation procedure is described in section 2.1 in the
c7e600cd2812 Updated README etc.
Florian Pose <fp@igh-essen.com>
parents: 560
diff changeset
    13
documentation available from http://etherlab.org/en/ethercat.
355
3a652b240c48 Improved INSTALL file.
Florian Pose <fp@igh-essen.com>
parents: 198
diff changeset
    14
198
f7dff1ed01ba Separate INSTALL file.
Florian Pose <fp@igh-essen.com>
parents:
diff changeset
    15
-------------------------------------------------------------------------------
380
971d079ff771 Updated INSTALL file.
Florian Pose <fp@igh-essen.com>
parents: 355
diff changeset
    16
785
c7e600cd2812 Updated README etc.
Florian Pose <fp@igh-essen.com>
parents: 560
diff changeset
    17
For the impatient: The procedure mainly consists of calling
380
971d079ff771 Updated INSTALL file.
Florian Pose <fp@igh-essen.com>
parents: 355
diff changeset
    18
487
448b0b23b905 Updated documentation.
Florian Pose <fp@igh-essen.com>
parents: 380
diff changeset
    19
$ ./configure
1017
b9224ef0546c Updated install script; udev rule.
Florian Pose <fp@igh-essen.com>
parents: 785
diff changeset
    20
$ make
487
448b0b23b905 Updated documentation.
Florian Pose <fp@igh-essen.com>
parents: 380
diff changeset
    21
$ make modules
380
971d079ff771 Updated INSTALL file.
Florian Pose <fp@igh-essen.com>
parents: 355
diff changeset
    22
487
448b0b23b905 Updated documentation.
Florian Pose <fp@igh-essen.com>
parents: 380
diff changeset
    23
(and as root)
448b0b23b905 Updated documentation.
Florian Pose <fp@igh-essen.com>
parents: 380
diff changeset
    24
560
9bb7bf607d82 Updated INSTALL file.
Florian Pose <fp@igh-essen.com>
parents: 487
diff changeset
    25
# make install
487
448b0b23b905 Updated documentation.
Florian Pose <fp@igh-essen.com>
parents: 380
diff changeset
    26
# make modules_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
1017
b9224ef0546c Updated install script; udev rule.
Florian Pose <fp@igh-essen.com>
parents: 785
diff changeset
    29
...and linking the init script and copying the sysconfig file from $PREFIX/etc
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
b9224ef0546c Updated install script; udev rule.
Florian Pose <fp@igh-essen.com>
parents: 785
diff changeset
    36
The EtherCAT character device will be created with mode 0660 and group root by
b9224ef0546c Updated install script; udev rule.
Florian Pose <fp@igh-essen.com>
parents: 785
diff changeset
    37
default. If you want to give normal users reading access, create a udev rule
b9224ef0546c Updated install script; udev rule.
Florian Pose <fp@igh-essen.com>
parents: 785
diff changeset
    38
like this:
b9224ef0546c Updated install script; udev rule.
Florian Pose <fp@igh-essen.com>
parents: 785
diff changeset
    39
b9224ef0546c Updated install script; udev rule.
Florian Pose <fp@igh-essen.com>
parents: 785
diff changeset
    40
# 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
    41
b9224ef0546c Updated install script; udev rule.
Florian Pose <fp@igh-essen.com>
parents: 785
diff changeset
    42
Now you can start the EtherCAT master:
b9224ef0546c Updated install script; udev rule.
Florian Pose <fp@igh-essen.com>
parents: 785
diff changeset
    43
b9224ef0546c Updated install script; udev rule.
Florian Pose <fp@igh-essen.com>
parents: 785
diff changeset
    44
# /etc/init.d/ethercat start
b9224ef0546c Updated install script; udev rule.
Florian Pose <fp@igh-essen.com>
parents: 785
diff changeset
    45
1081
66c60b99c2e8 Minor change.
Florian Pose <fp@igh-essen.com>
parents: 1017
diff changeset
    46
Have a look at the examples/ subdirectory for some application examples.
66c60b99c2e8 Minor change.
Florian Pose <fp@igh-essen.com>
parents: 1017
diff changeset
    47
1017
b9224ef0546c Updated install script; udev rule.
Florian Pose <fp@igh-essen.com>
parents: 785
diff changeset
    48
Have fun!
380
971d079ff771 Updated INSTALL file.
Florian Pose <fp@igh-essen.com>
parents: 355
diff changeset
    49
971d079ff771 Updated INSTALL file.
Florian Pose <fp@igh-essen.com>
parents: 355
diff changeset
    50
-------------------------------------------------------------------------------