2985 $ `\textbf{make modules}` |
2986 $ `\textbf{make modules}` |
2986 \end{lstlisting} |
2987 \end{lstlisting} |
2987 |
2988 |
2988 Table~\ref{tab:config} lists important configuration switches and options. |
2989 Table~\ref{tab:config} lists important configuration switches and options. |
2989 |
2990 |
2990 \begin{table} |
2991 \begin{longtable}{l|p{.4\textwidth}|l} |
2991 \caption{Configuration options} |
2992 \caption{Configuration options}\rule[-5ex]{0mm}{0mm} |
2992 \label{tab:config} |
2993 \label{tab:config}\\ |
2993 \vspace{2mm} |
2994 |
2994 \begin{tabular}{l|p{.3\textwidth}|l} |
2995 \textbf{Option/Switch} & \textbf{Description} & \textbf{Default}\\\hline |
|
2996 \endfirsthead |
|
2997 |
|
2998 \textbf{Option/Switch} & \textbf{Description} & \textbf{Default}\\\hline |
|
2999 \endhead |
2995 |
3000 |
2996 \bf Option/Switch & \bf Description & \bf Default\\\hline |
3001 \bf Option/Switch & \bf Description & \bf Default\\\hline |
2997 |
3002 |
2998 \lstinline+--prefix+ & Installation prefix & \textit{/opt/etherlab}\\ |
3003 \lstinline+--prefix+ & Installation prefix & \textit{/opt/etherlab}\\ |
2999 |
3004 |
3000 \lstinline+--with-linux-dir+ & Linux kernel sources & Use running kernel\\ |
3005 \lstinline+--with-linux-dir+ & Linux kernel sources & Use running kernel\\ |
3001 |
3006 |
|
3007 \lstinline+--with-module-dir+ & Subdirectory in the kernel module tree, where |
|
3008 the EtherCAT kernel modules shall be installed. & \textit{ethercat}\\ |
|
3009 |
|
3010 \hline |
|
3011 |
|
3012 \lstinline+--enable-generic+ & Build the generic Ethernet driver (see |
|
3013 sec.~\ref{sec:generic-driver}). & no\\ |
|
3014 |
|
3015 \lstinline+--enable-8139too+ & Build the 8139too driver & yes\\ |
|
3016 |
|
3017 \lstinline+--with-8139too-kernel+ & 8139too kernel & $\dagger$\\ |
|
3018 |
|
3019 \lstinline+--enable-e100+ & Build the e100 driver & no\\ |
|
3020 |
|
3021 \lstinline+--with-e100-kernel+ & e100 kernel & $\dagger$\\ |
|
3022 |
|
3023 \lstinline+--enable-e1000+ & Enable e1000 driver & no\\ |
|
3024 |
|
3025 \lstinline+--with-e1000-kernel+ & e1000 kernel & $\dagger$\\ |
|
3026 |
|
3027 \lstinline+--enable-r8169+ & Enable r8169 driver & no\\ |
|
3028 |
|
3029 \lstinline+--with-r8169-kernel+ & r8169 kernel & $\dagger$\\ |
|
3030 |
|
3031 \hline |
|
3032 |
3002 \lstinline+--with-rtai-dir+ & RTAI path (only for RTAI example) & \\ |
3033 \lstinline+--with-rtai-dir+ & RTAI path (only for RTAI example) & \\ |
3003 |
3034 |
3004 \hline |
3035 \lstinline+--enable-debug-if+ & Create a debug interface for each master & no\\ |
|
3036 |
|
3037 \lstinline+--enable-debug-ring+ & Create a debug ring to record frames & no\\ |
|
3038 |
|
3039 \lstinline+--enable-eoe+ & Enable EoE support & yes\\ |
|
3040 |
|
3041 \lstinline+--enable-cycles+ & Use CPU timestamp counter. Enable this on Intel |
|
3042 architecture to get finer timing calculation. & no\\ |
|
3043 |
|
3044 \lstinline+--enable-hrtimer+ & Use high-resolution timer to let the master |
|
3045 state machine sleep between sending frames. & no\\ |
|
3046 |
|
3047 \lstinline+--enable-regalias+ & Read alias address from register. & no\\ |
3005 |
3048 |
3006 \lstinline+--enable-tool+ & Build the command-line tool ``ethercat'' (see |
3049 \lstinline+--enable-tool+ & Build the command-line tool ``ethercat'' (see |
3007 sec.~\ref{sec:tool}). & yes\\ |
3050 sec.~\ref{sec:tool}). & yes\\ |
3008 |
3051 |
3009 \lstinline+--enable-userlib+ & Build the userspace library. & yes\\ |
3052 \lstinline+--enable-userlib+ & Build the userspace library. & yes\\ |
3010 |
3053 |
3011 \lstinline+--enable-eoe+ & Enable EoE support & yes\\ |
3054 \lstinline+--enable-tty+ & Build the TTY driver. & no\\ |
3012 |
3055 |
3013 \lstinline+--enable-cycles+ & Use CPU timestamp counter. Enable this on Intel |
3056 \lstinline+--enable-wildcards+ & Enable \textit{0xffffffff} to be wildcards |
3014 architecture to get finer timing calculation. & no\\ |
3057 for vendor ID and product code. & no\\ |
3015 |
|
3016 \lstinline+--enable-debug-if+ & Create a debug interface for each master & no\\ |
|
3017 |
|
3018 \lstinline+--enable-debug-ring+ & Create a debug ring to record frames & no\\ |
|
3019 |
3058 |
3020 \hline |
3059 \hline |
3021 |
3060 |
3022 \lstinline+--enable-8139too+ & Build the 8139too driver & yes\\ |
3061 \end{longtable} |
3023 |
|
3024 \lstinline+--with-8139too-kernel+ & 8139too kernel & $\dagger$\\ |
|
3025 |
|
3026 \lstinline+--enable-e100+ & Build the e100 driver & no\\ |
|
3027 |
|
3028 \lstinline+--with-e100-kernel+ & e100 kernel & $\dagger$\\ |
|
3029 |
|
3030 \lstinline+--enable-e1000+ & Enable e1000 driver & no\\ |
|
3031 |
|
3032 \lstinline+--with-e1000-kernel+ & e1000 kernel & $\dagger$\\ |
|
3033 |
|
3034 \lstinline+--enable-e1000e+ & Enable e1000e driver & no\\ |
|
3035 |
|
3036 \lstinline+--with-e1000e-kernel+ & e1000e kernel & $\dagger$\\ |
|
3037 |
|
3038 \lstinline+--enable-r8169+ & Enable r8169 driver & no\\ |
|
3039 |
|
3040 \lstinline+--with-r8169-kernel+ & r8169 kernel & $\dagger$\\ |
|
3041 |
|
3042 \lstinline+--enable-generic+ & Build the generic Ethernet driver (see |
|
3043 sec.~\ref{sec:generic-driver}). & no\\ |
|
3044 |
|
3045 \end{tabular} |
|
3046 \vspace{2mm} |
|
3047 |
3062 |
3048 \begin{description} |
3063 \begin{description} |
3049 |
3064 |
3050 \item[$\dagger$] If this option is not specified, the kernel version to use is |
3065 \item[$\dagger$] If this option is not specified, the kernel version to use is |
3051 extracted from the Linux kernel sources. |
3066 extracted from the Linux kernel sources. |
3052 |
3067 |
3053 \end{description} |
3068 \end{description} |
3054 |
|
3055 \end{table} |
|
3056 |
3069 |
3057 \section{Building the Interface Documentation} |
3070 \section{Building the Interface Documentation} |
3058 \label{sec:gendoc} |
3071 \label{sec:gendoc} |
3059 |
3072 |
3060 The source code is documented using Doxygen~\cite{doxygen}. To build the HTML |
3073 The source code is documented using Doxygen~\cite{doxygen}. To build the HTML |