doc: Finished (this time for good) the setup guide

eded9783 · Theodor-Adrian Stana · bf352df8 · eded9783 · eded9783 · eded9783
Commit eded9783 authored Jan 13, 2015 by Theodor-Adrian Stana
Hide whitespace changes
Inline Side-by-side

Showing with 47 additions and 14 deletions

cern-title.tex doc/setup/cern-title.tex +2 -2

icons.png doc/setup/fig/icons.png +0 -0

setup.tex doc/setup/setup.tex +45 -12

No files found.
--- a/doc/setup/cern-title.tex
+++ b/doc/setup/cern-title.tex
@@ -5,11 +5,11 @@
 %---------------------------------------------------------------
 % name
 %---------------------------------------------------------------
-\noindent{\LARGE \textbf{Setting up the PTS system}}
+\noindent{\LARGE \textbf{Setting up the CONV-TTL-RS485 PTS system}}
 \noindent \rule{\textwidth}{.1cm}
-\hfill January 12, 2015
+\hfill January 13, 2015
 \vspace*{3cm}

--- a/doc/setup/fig/icons.png
+++ b/doc/setup/fig/icons.png
--- a/doc/setup/setup.tex
+++ b/doc/setup/setup.tex
@@ -77,7 +77,7 @@ work, see \\
  \hline
  \multicolumn{1}{c}{\textbf{Date}} & \multicolumn{1}{c}{\textbf{Version}} & \multicolumn{1}{c}{\textbf{Change}} \\
  \hline
-  12-01-2015 & 0.1 & First draft \\
+  13-01-2015 & 0.1 & First draft \\
  \hline
  \end{tabular}
 }
@@ -216,10 +216,20 @@ the details in the next section to test our system and network was properly inst
  password: ADMIN
  %>
  \end{verbatim}
-  \item If the prompt appears as above, the setup is fine. Now we need to disable the telnet ping
+  \vspace{11pt}
-  that the SysMon does, so it doesn't get in the way of our Python scripts, which use Telnet
+  \item Make sure the ELMA crate has gateware version 2.31 or higher on it. In the SysMon Telnet prompt:
-  to talk to the CONV-TTL-RS485 FPGA. Run the following commands in the Telnet prompt of the ELMA
+  \begin{verbatim}
-  crate:
+  %>version
+   Sysmon3Gen  041-452 Ind.A
+   Software version 2.31 CERN
+   Settings Saved in Internal FLASH
+   MAC Address: FF:FF:FF:FF:FF:FF
+   SN: 12345678
+   Assembly ID: 0
+  \end{verbatim}
+  \item Now we need to disable the telnet ping that the SysMon does, so it doesn't get in the way of
+  our Python scripts, which use Telnet to talk to the CONV-TTL-RS485 FPGA. Run the following commands
+  in the Telnet prompt of the ELMA crate:
  \begin{verbatim}
  telnetping 0
  saveenv
@@ -258,9 +268,10 @@ See Appendix~\ref{app:build} for details on the second.
  to the home folder of the \verb=pts= user and extract the archive:
  \begin{verbatim}
  cd ~
-  wget http://www.ohwr.org/attachments/download/3745/ubuntu.tar.gz
+  wget http://www.ohwr.org/attachments/download/3771/ubuntu.tar.gz
  tar xzvf ubuntu.tar.gz
  \end{verbatim}
+  Note that you can also copy the archive from a USB stick instead of downloading it from OHWR.
  \item Check that all extracted files and folders have write permissions:
  \begin{small}
  \begin{verbatim}
@@ -293,8 +304,8 @@ See Appendix~\ref{app:build} for details on the second.
  \end{verbatim}
  \item Now we that have the test scripts on the system we can create a dedicated
  user that will be used to run the PTS for the CONV-TTL-RS485. Open up Ubuntu's
-  \textbf{User Accounts} window (click the \verb=pts= user account name at the top
+  \textbf{User Accounts} window (click the \verb=pts= user account name at the top-right
-  left of the screen), unlock this window by providing the \verb=pts= user account's
+  side of the screen), unlock this window by providing the \verb=pts= user account's
  password (\verb=pts-user=) and create a new user with the following settings:
  \begin{itemize}
    \item \textbf{Account Type:} Standard
@@ -310,20 +321,42 @@ See Appendix~\ref{app:build} for details on the second.
    \item \textbf{Action: } Set a password now
    \item \textbf{New password: } pts-user
  \end{itemize}
-  \item Log in to the new \verb=conv-ttl-rs485= user account
+  \item Close the \textbf{User accounts} window
-  \item Unlock all items except Nautilus from the launcher bar on the left side of the screen
+  \item Log in to the new \verb=conv-ttl-rs485= user account by clicking on the \verb=pts= user
-  \item Open up a terminal window, and copy the desktop shortcuts from the extracted PTS tarball
+  on the top-right side of the screen and selecting the \verb=conv-ttl-rs485= user
-  to this user's desktop:
+  \item Open a terminal and run the following commands to set up the PTS test system terminal
+  windows and to copy the desktop shortcuts users will use to run the PTS:
  \begin{verbatim}
+  cd ~
+  cp .bashrc .bashrc.old
+  cp /home/pts/ubuntu/t485/config/bashrc.pts .bashrc
  cd ~/Desktop/
  cp /home/pts/ubuntu/t485/config/*.desktop .
  \end{verbatim}
+  \item Right-click on the terminal window and click \textbf{Lock to Launcher}
+  \item Close the terminal window
+  \item Unlock all items except the folder navigator and the terminal from the launcher bar on the
+  left side of the screen (right click the item and select \textbf{Unlock from Launcher})
+  \item Set the CONV-TTL-RS485 desktop background for the user:
+  \begin{itemize}
+    \item on the Desktop, right-click and select \textbf{Change Desktop Background}
+    \item hit the \textbf{+} under Wallpapers
+    \item navigate to \verb=/home/pts/ubuntu/t485/config/=
+    \item select \verb=t485-background.png= as the background image
+    \item make sure the scaling of the image is set to \textbf{Zoom}
+  \end{itemize}
+  \item Finally, order the desktop launcher icons as shown in Figure~\ref{fig:icons}
  \item You should now have a working PTS test system. Navigate to the desktop and
  try to run the new \textbf{Run CONV-TTL-RS485 PTS} executable here. Plug in a card
  to see if the PTS system communicates to it (no need to set up daisy-chains or anything
  for this test, you can do that later).
 \end{enumerate}
+\begin{figure}[h]
+  \centerline{\includegraphics[scale=.45]{fig/icons.png}}
+  \caption{\label{fig:icons} Order of PTS icons on the desktop}
+\end{figure}
 %==============================================================================
 \pagebreak
 \begin{appendices}