dls-tutorial/testmanager.tex at main · sblanchet/dls-tutorial · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
\chapter{TestManager}

TestManager is a graphical application for visualizing channels exported
by PdServer. The official documentation is available in
\cite{testmanager_user_manual}.


\section{Install prerequisites}

\subsubsection{Run a Windows application on Linux}
TestManager is a Windows application that needs \texttt{wine} to run
on Linux.  Wine exists in two flavors: \texttt{wine32} for 32-bit
applications and \texttt{wine64} for 64-bit ones.  As a 32-bit
application, TestManager requires \textbf{wine32} to run on Linux; it
does not work with wine64.


\subsubsection{Install wine32}
\texttt{wine32} is available only for the \texttt{i386} architecture
which is disabled by default on Ubuntu 64-bit.
Therefore the \texttt{i386} architecture must be enabled to install
\texttt{wine32}.

\begin{shellcmd}
sudo -i
dpkg --add-architecture i386
apt update
apt install wine32
\end{shellcmd}


\section{Install TestManager}

TestManager is a single-executable application that is very easy to set up.

\noindent Download the file from https://etherlab.org/
\begin{shellcmd}
wget http://etherlab.org/download/testmanager/msr_test_manager_3_6_4.exe
\end{shellcmd}

The first start may be very long because \texttt{wine} is
initializing a full Windows environment. Fortunately, subsequent
starts are faster.


\section{Configure TestManager}
\begin{itemize}

\item Run TestManager with \texttt{wine}

\begin{shellcmd}
wine msr_test_manager_3_6_4.exe
\end{shellcmd}


\item The splash screen appears

\begin{center}
\includegraphics[width=0.5\textwidth]{genpicts/testmanager-00.eps}
\end{center}

It can be closed by clicking the \textit{Start Now} button,
or by waiting a few seconds until the red progress bar reaches
the IgH logo on the right.


\item The main window appears. Fill in the host (127.0.0.1) and port
  (2345) input boxes, then click \textit{Connect}.

\begin{center}
\includegraphics[width=\textwidth]{genpicts/testmanager-01.eps}
\end{center}


\item If the connection is successful, a tree item appears on the left
  side, and the link quality bar turns green

\begin{center}
\includegraphics[width=\textwidth]{genpicts/testmanager-02.eps}
\end{center}

If nothing appears, check that the test server\footnote{see
section \ref{test-server-for-testmanager}}
is still running and that the host and port are correctly
entered in the input boxes.


\item Create a widget to display the signal.
  Right-click on the right panel and select \textit{New Page}.

\begin{center}
\includegraphics[width=\textwidth]{genpicts/testmanager-03.eps}
\end{center}

\item Enter a page name, for example \textit{Page1}.

\begin{center}
\includegraphics[width=\textwidth]{genpicts/testmanager-04.eps}
\end{center}


\item Right-click on \textit{Page1} and select \textit{New Component | Channel (Graph) | Single Channel Scrolling Graph}

\begin{center}
\includegraphics[width=\textwidth]{genpicts/testmanager-05.eps}
\end{center}

\item Expand the tree in the left panel to find the
  \textit{RT-Variable/s1/c} channel. Drag and drop it to the orange area at
  the bottom of the channel widget.

\begin{center}
\includegraphics[width=\textwidth]{genpicts/testmanager-06.eps}
\end{center}


\item The channel is plotted in real time. Drag the corner of the widget to
  increase the size to see the channel more clearly.

\begin{center}
\includegraphics[width=\textwidth]{genpicts/testmanager-07.eps}
\end{center}


\item To edit the widget properties, right-click on it and select \textit{Configure}.

\begin{center}
\includegraphics[width=\textwidth]{genpicts/testmanager-08.eps}
\end{center}

The property window appears. Change the following values:
\begin{itemize}
\item Maximal Value = 20
\item Minimum Value = 0
\end{itemize}

\begin{center}
\includegraphics[width=0.7\textwidth]{genpicts/testmanager-09.eps}
\end{center}

\item The default sample rate is low (2~Hz). To increase it,
  right-click on the widget and select \textit{Data Transfer}

\begin{center}
\includegraphics[width=\textwidth]{genpicts/testmanager-10.eps}
\end{center}

The Data Transfer window appears.  To have a smoother
curve, increase both \textit{Sample Rate} and \textit{Buffer Size/s}.
\begin{itemize}
\item Sample Rate = 10
\item Buffer Size /s = 600
\end{itemize}

\begin{center}
\includegraphics[width=\textwidth]{genpicts/testmanager-11.eps}
\end{center}


\begin{center}
\includegraphics[width=\textwidth]{genpicts/testmanager-12.eps}
\end{center}

\section{Go further}
To go further with TestManager, read the official
documentation, which is available in \cite{testmanager_user_manual}.

\end{itemize}