# HG changeset patch
# User Florian Pose <fp@igh-essen.com>
# Date 1386668283 -3600
# Node ID 72b61b089625cbd04e1753d2d65cf9b5abf35d7a
# Parent  a0e787e196cdd5addc1536da1aa89267c7ab228b
Generic driver device activation in documentation.

diff -r a0e787e196cd -r 72b61b089625 documentation/ethercat_doc.tex
--- a/documentation/ethercat_doc.tex	Fri Nov 29 16:42:20 2013 +0100
+++ b/documentation/ethercat_doc.tex	Tue Dec 10 10:38:03 2013 +0100
@@ -1239,6 +1239,25 @@
 realtime context.
 \end{itemize}
 
+\paragraph{Device Activation} In order to send and receive frames through a
+socket, the Ethernet device linked to that socket has to be activated,
+otherwise all frames will be rejected. Activation has to take place before the
+master module is loaded and can happen in several ways:
+
+\begin{itemize}
+
+\item Ad-hoc, using the command \lstinline+ip link set dev ethX up+ (or the
+older \lstinline+ifconfig ethX up+),
+
+\item Configured, depending on the distribution, for example using
+\lstinline+ifcfg+ files (\lstinline+/etc/sysconfig/network/ifcfg-ethX+) in
+openSUSE and others. This is the better choice, if the EtherCAT master shall
+start at system boot time. Since the Ethernet device shall only be activated,
+but no IP address etc.\ shall be assigned, it is enough to use
+\lstinline+STARTMODE=auto+ as configuration.
+
+\end{itemize}
+
 %------------------------------------------------------------------------------
 
 \section{Providing Ethernet Devices}