Generic driver device activation in documentation. stable-1.5
authorFlorian Pose <fp@igh-essen.com>
Tue, 10 Dec 2013 10:38:03 +0100
branchstable-1.5
changeset 2535 72b61b089625
parent 2534 a0e787e196cd
child 2536 15f122b0f3d2
Generic driver device activation in documentation.
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}