\documentstyle[11pt,a4,psfig]{article}
\title{DEveloppement soft}
\author{G.ZEHNACKER}
\date{Edition june 1991}
\begin{document}

\hsize=16cm
\vsize=25cm
\oddsidemargin 0 in
\evensidemargin 0 in
\pagestyle{plain}

\begin{titlepage}
{

\font\small=cmssbx10 at 14.4truept
\font\medium=cmssbx10 at 17.28truept
\font\large=cmssbx10 at 20.74truept
\hrule height 0pt
\parindent=0pt
%\parskip=0pt
\hskip 3.9truein
\large
\par
\vskip .5truein
\large
Eurogam project
\hskip 5cm
EDOC124\par
\vskip 1.5truein
\hrule height 2pt
\vskip 20pt
\large
Electronics test card software\par
\small

\vskip .5truein
\vskip 20pt
\hrule height 2pt
\vskip 1truein
\small
\begin{tabbing}
Edition \=: 1.0 10 june 1991 (draft)\\
	\>: 1.1 05 Sept 1991\\
	\> \\
Authors \>: B.HUMBERT, Ch.RING \& G.ZEHNACKER \\
\end{tabbing}


\vskip 7cm
\small
SATD

Centre de Recherches Nucl\'{e}aires de Strasbourg \par

CNRS-IN2P3 France\par

}
\end{titlepage}

\tableofcontents

\newpage

\section{Introduction}
\subsection{Abstract}
	The aim is to give the same software to test electronics cards in the
	preliminary phase test and during the experiment with different
	multidetectors which are build with VXI cards.
	Differents functions allows :
	\begin{itemize}
	\item to display a synoptic
	\item to select special points to connect the "resource manager"  at a
	scope
	\item to read hardware register on the VXI card and adjust his value
	\item to save the new value
	\item to compare the data base value and the actualy value in the card
	\item to make a zoom on a part of card
	\item to display spectra which are build from the detectors card ( in
	the "resource manager" and/or in the histogrammer)
	\end{itemize}

\subsection{Contents}
\begin{enumerate}
\item introduction
\item aim of the software
\item general concepts
\item software environment
\item description of the interface user
\item the menus
\item every objects description
\item meaning of the graphic symboles
\item test point dialog box
\item register dialog box
\item procedure to build spectrum in the "resource manager"
\item conclusion
\end{enumerate}

\newpage

\section{But du logiciel}

	Les nouveaux multid\'{e}tecteurs font appel \`{a} une electronique
	fortement int\'{e}gr\'{e}e qui ne poss\`{e}de plus de moyen de
	r\'{e}glage manuel avec bouton et tournevis. Cette \'{e}lectronique
	form\'{e}e de diff\'{e}rentes cartes suit au mieux la norme VXI. Ces
	cartes sont ins\'{e}r\'{e}es dans un chassis \`{a} norme VXI sous le
	contr\^{o}le d'une carte appel\'{e}e "Resource Manager" et pilot\'{e}es
	\`{a} partir d'une station de travail par l'utilisateur avec le
	logiciel "tcard" ( test carte ).


	Ce logiciel est utilisable pour diverses cartes ( carte trigger,
 carte GE et BGO dans un premier temps, puis  carte Demon et carte Icare dans
 un deuxi\`{e}me temps). Il pourra servir aussi pour d'autres types de cartes
 que celles pr\'{e}vues actuellement. Il donne tous les moyens de r\'{e}glage
 de l'electronique en offrant la possibilit\'{e} d'agir sur des boutons ou
 switchs,  de lire ou \'{e}crire dans des registres, de s\'{e}lectionner des
 signaux \`{a} afficher sur un oscilloscope et de visualiser les spectres
 obtenus \`{a} la suite de ces r\`{e}glages.

	Les diff\'{e}rents protocoles entre "tcard" et le VXI sont d\'{e}crits
	dans le EDOC126.

\vskip 1cm

\begin{figure}[h]
\psfig{figure=fig1.ps,width=16cm,height=14cm}
\end{figure}

\section{G\'{e}n\'{e}ralit\'{e}s sur l'utilisation de "tcard"}

\subsection{Appel de "OPEN WINDOWS"}

	Sur les stations SPARCS IPC (coquelicot et capucine) apr\'{e}s
	l'entr\'{e}e en session r\'{e}pondre yes \`{a} la question
	demand\'{e}e.
	Sur la station couleur SUN 3/50 (lupin) les membres du groupe "eurogam"
	seront directement sous "OPEN WINDOWS". Faire  rlogin coquelicot dans
	une fen\^{e}tre "cmdtool", puis setenv "DISPLAY lupin:0.0" . L'appel de
	tcard se fera en rajoutant ce param\`{e}tre. Dans l'avenir cette
	procedure sera encore simplifi\`{e}e.

\subsection{L'appel du logiciel}
	Il peut \^{e}tre appel\'{e} de deux fa\c{c}ons : par commande ou icone
	( repr\'{e}sentation symbolique de "tcard" ).

  Le nom du logiciel est "tcard". Pour des raisons de commodit\'{e} et de
  s\'{e}curit\'{e}, il est pr\'{e}vu d'\^{e}tre lan\c{c}\'{e} \`{a} partir des
  stations situ\'{e}es pr\`{e}s des chassis VXI

  Apr\'{e}s une entr\'{e}e en session, au bout de quelques secondes de patience
  , le syst\`{e}me ouvrira une fen\^{e}tre appel\'{e}e "OPEN WINDOW2 ", puis
  des fen\^{e}tres "terminal" .

 \subsubsection{par icone}
  Normalement une icone "tcard" apparaitra \`{a} l'\'{e}cran parmi d'autres
  icones (par ex l'horloge et textedit). Pour ouvrir la fen\^{e}tre tcard deux
  solutions:
  \begin{itemize}
  \item en d\'{e}pla\c{c}ant le curseur sur l'icone et en faisant un double
  clic (deux clics successifs ) sur la touche gauche de la souris
  \item ou faites glisser le curseur sur l'icone, puis appuyer sur la touche de
  droite de la souris. Un petit menu apparait. Tout en appuyant sur la touche
  droite de la souris, d\'{e}placer le curseur sur l'option "open" qui se met
  en inverse video ; alors en relachant le bouton de la souris la fen\^{e}tre
  "tcard" s'ouvrira .
  \end{itemize}

 \subsubsection{Par commande}
  Si l'icone "tcard" n'est pas \`{a} l'\'{e}cran sur une SPARC avec \'{e}cran
  couleur(apr\`{e}s un quit sur la fen\^{e}tre et non un close) alors taper : "
  tcard \& " dans la fenetre console.
  L'appel de tcard sur lupin se fera en rajoutant le param\`{e}tre  DISPLAY
  sous la formae tcard \$DISPLAY.

 \subsection{L'\'{e}cran de la station}
	Il est constitu\'{e} de la fen\^{e}tre "tcard", de la fen\^{e}tre
	console o\`{u} s'afficheront des renseignements de contr\^{o}le ( par
	ex les caract\'{e}ristiques de l'op\'{e}ration dans le chassis VXI, ou
	quelques messages de "tcard" ) et d'une fenetre "shell command ". On
	pourra si on le souhaite faire un rlogin sur le noyau VXworks ( par
	rlogin peony ). Les commandes \'{e}lementaires d'acc\'{e}s au create
	VXI (lecture ou \'{e}criture dans un registre) sont alors directement
	accessibles de la station.
	L'on aura ainsi centralis\'{e} tous les outils "software" de
	surveillance et de test de l'electronique.

 \subsection{les aides}
	Deux types d'aides sont disponibles en ligne. La notice accessible page
	apr\`{e}s page en cliquant sur le bouton help ( pour l'instant en
	fran\c{c}ais) au bas de l'\'{e}cran \`{a} gauche. Des aides plus
	cibl\'{e}es seront accesibles sur des objets de la fen\^{e}tre
	principale et des bo\^{i}tes de dialogue(en anglais). Pour cela
	positionner le curseur sur l'objet choisi et taper sur la touche Help(
	sur les stations SUN IPC). Une boite d'aide s'ouvrira. On la refermera
	en cliquant sur la punaise ( en haut \`{a} gauche) de la boite.

\subsection{Appel des fonctions du logiciel}

  Ces diff\'{e}rentes fonctions  seront appel\'{e}es soit  par menu , soit par
  clic sur le synoptique , soit encore par l'interm\'{e}diaire de boites de
  dialogue dans lesquelles sont d\'{e}finies des donn\'{e}es ou lanc\'{e}es des
  actions. Les menus sont appelables en cliquant sur le bouton droit de la
  souris , les choix sur le synoptique sur le bouton gauche. Pendant le
  trac\'{e} du synoptique, son menu reste gris\'{e}. Aucune autre action ne
  sera prise en compte sur un menu; mais \'{e}ventuellement sur une autre
  fen\^{e}tre.

\subsection{Les boites de dialogue}
	Elles aparaitront pour saisir des informations. Chaque bo\^{i}te peut
	\^{e}tre fix\'{e}e en permanence \`{a} l'\'{e}cran en "punaisant"
	celle-\c{c}i. (cliquer sur le symbole en haut \`{a} gauche avec la
	touche gauche de la souris). En recliquant \`{a} nouveau sur la punaise
	la boite s'en va et reapparaitra \`{a} la prochaine s\'{e}lection d'un
	point test.
	 Il est possible de placer la boite de dialogue n'importe o\`{u} sur
	 l'\'{e}cran. Pour cela cliquer sur le nom de la boite (touche gauche
	 de la souris) et repositioner l\`{a} \`{a} l'endroit souhait\'{e} en
	 d\'{e}pla\c{c}ant la souris tout en maintenant enfonc\'{ }le bouton.


\subsection{V\'{e}rification des valeurs saisies}

  "tcard" v\'{e}rifie la validit\'{e} des donn\'{e}s fournies : les num\'{e}ros
  de d\'{e}tecteur, les num\'{e}ros des registres ou les num\'{e}ros de points
  de test scope. Les nombres d'objets sont obtenus \`{a} partir de la base de
  donn\'{e}es. Si une erreur est d\'{e}tect\'{e}e alors "tcard" ouvre une boite
  d'alerte dans laquelle il faudra cliquer (bouton gauche) sur le bouton ok.

\subsection{Fin d'utilisation de "tcard"}

	Deux moyens s'offrent \`{a} l'utilisateur. \\
	En  se positionnant dans le bouton quit et en cliquant la touche gauche
	de la souris, on ouvre une boite d'alerte, une r\'{e}ponse est
	necessaire : un clic gauche sur yes ou no . \\
	En se positionnant dans le rep\`{e}re en  haut \`{a} gauche de la
	fenetre et en cliquant avec la touche  droite de la souris sur celui
	\c{c}i alors  un petit menu apparait ; en choississant quit on sort de
	"tcard" sans faire apparaitre l'icone, en choissisant close on ferme la
	fen\^{e}tre et on voit apparaitre l'icone de "tcard"

\section{L'environnement du logiciel}


\subsection{Contraintes syst\`{e}me et biblioth\`{e}ques}

	Le logiciel tourne sur une machine SPARC sous SUN OS 4.1 . Il est
	d\'{e}velopp\'{e} en C en utilisant les outils graphiques fournis sous
	"OPEN WINDOWS2" c'est \'{a} dire la biblioth\'{e}que Xviews de SUN et
	Xwindows version 11.4 du MIT .


\subsection{Les  moyens mat\`{e}riel}

	Le sch\'{e}ma plus haut montre les moyens mat\'{e}riels n\'{e}cessaires
	pour mettre en oeuvre ce logiciel. Une station de travail SUN ipc ,
	couleur, s\'{e}lectionne les actions qui sont traduites en ordre \`{a}
	\'{e}xecuter par le "Resource Manager". La station et le "Resource
	Manager" sont connect\'{e}s sur Ethernet.

\subsection{Base de donn\'{e}es}

	Une base de donn\'{e}es est \`{a}  constituer. Elle contient toutes les
	informations n\'{e}cessaires au fonctionnement des cartes VXI. Ces
	informations sont extraites et mises \`{a} jour par des t\^{a}ches
	"read et write database" appel\'{e}s par "tcard".

\subsection{Protocole entre le synoptique et le "Resource Manager"}

	Toute action \`{a} l'\'{e}cran se traduit par l'envoi d'une commande
	\`{a} un logiciel de communication qui l'envoie par des "remote
	procedure call" (RPC) \`{a} une t\^{a}che Vxworks dans le "Resource
	Manager" du VXI. Ces logiciels seront d\'{e}crits dans des edocs. Une
	r\'{e}ponse est renvoy\'{e}e dans tous les cas. ( sinon un time out est
	d\'{e}clench\'{e}). Un controle est affich\'{e} sur la console du
	Vxworks et rappel\'{e} dans la fen\^{e}tre "console" de la station

\subsection{Les fichiers des synoptiques}

	Un fichier sp\'{e}cifique en ASCII contient tous les renseignements
	pour tracer un synoptique d'une carte. Il sera lu par "tcard",
	interpret\'{e},  traduit en ordre Xwindows, puis affich\'{e} sur
	l'\'{e}cran de la station
	 Un prochain edoc d\'{e}crira les r\`{e}gles \`{a} suivre pour le
	 former. Une aide \`{a} la cr\`{e}ation de ce fichier est envisageable
	 mais n'a pas \'{e}t\'{e} jug\'{e}e prioritaire.
	 Il existe actuellement les fichiers germanium.syn, bgo.syn, roci*.syn.
	 Le fichier trigger.syn reste \`{a} cr\'{e}\'{e}r.

\subsection{Les autres fichiers}
	Sous un r\'{e}pertoire "SYNOPTIQUE" se trouveront tous les fichiers
	necessaires \`{a} "tcard":
	\begin{itemize}
	\item l'executable "tcard"
	\item le fichier d'aide tcard.info
	\item le fichier notice edoc124.dvi ( edoc124.latex est sous edoc)
	\item le synoptique sous forme postscript *.ps
	\item le digest du setup dous la forme ASCII *.data
	\item les synoptiques sous la forme *.syn
	\end{itemize}
\subsection{Les variables d'environnement}
	\subsubsection{PATH}
	La variable \$PATH a \'{e}t\'{e} compl\'{e}t\'{e}e dans .ucshrc par le
	PATH sur \$HOME/SYNOPTiQUE.
	\subsubsection{SYNOPTIQUE}
	Cette variable est d\'{e}finie dans .ucshrc par \$HOME/SYNOPTIQUE
	\subsubsection{DISPLAY}
	En principe sur la station "coquelicot" cette variable est d\'{e}finie
	par d\'{e}faut. L'utilisateur n'a donc pas \'{a} s'en pr\'{e}occuper.
	Mais sur les autres stations ( non SPARC ) on conseillera
de la cr\'{e}\'{e}r ainsi:  setenv DISPLAY host:0.0  . En \'{e}tant "logg\'{e}
" sur par ex  coquelicot "tcard" sera appel\'{e} par :  tcard -display
\$DISPLAY
	\subsubsection{HELPPATH}
	Cette variable est \'{a} cr\'{e}er pour atteindre le fichier d'aide
	tcard.info dans le fichier .ucshrc. Sa d\'{e}finition sera:
	setenv HELPPATH \$HOME/SYNOPTIQUE

\section{L'interface graphique de "tcard"}

	Ce logiciel  permet de v\'{e}rifier le bon fonctionnement des  cartes
	"trigger" et "multid\'{e}tecteurs". Il est con\c{c}u \`{a} la fois pour
	la phase de test et en utilisation r\'{e}elle  en exp\'{e}rience.
L'\'{e}cran a \'{e}t\'{e} divis\'{e} en zones pour r\'{e}pondre \`{a} cet
objectif. \\

L'\'{e}cran se compose de plusieurs zones :

\subsection{Identification}
	On donne le nom du logiciel "tcard " .

\subsection{Zone d'informations}
	La date est mise \`{a} jour apr\`{e}s chaque clic de la souris sur le
	synoptique. Le message "choice" donne le type b (bouton ou switch) , r
	(registre) , v (visu ou scope) ) et le num\'{e}ro de l'objet cliqu\'{e}
	; on peut ainsi rapidement trouver des anomalies \'{e}ventuelles en
	consultant le fichier *.data avec le menu data base.

\subsection{Sortie du logiciel}
	Le bouton "quit" permet de sortir du logiciel apr\'{e}s confirmation
\subsection{Les menus}
	Ils sont au nombre de trois : "database" , "synoptique" et "display"
Plus de d\'{e}tails sont donn\'{e} plus loin.

\subsection{Affichage du synoptique}
	Celui ci est appel\'{e} ap\`{e}s s\'{e}lection d'une option du menu
	synoptique. Il est n\'{e}cessaire de fournir le num\'{e}ro du
	d\'{e}tecteur \`{a} acc\'{e}der apr\`{e}s affichage complet du
	sch\`{e}ma (en dessous \`{a} gauche du synoptique).

\newpage

\begin{figure}[h]
\psfig{figure=fig2.ps,width=16cm,height=16cm}
\end{figure}

\begin{center}
figure 2 L'interface graphique de tcard
\end{center}

\subsection{Choix du num\'{e}ro du d\'{e}tecteur}
	Par d\'{e}faut on s\'{e}lectionne le d\'{e}tecteur 1; mais
	naturellement on souhaitera visualiser les informations concernant un
	des d\'{e}tecteurs pr\'{e}sent dans le ou les chassis VXI. On entrera
	la valeur qui sera v\'{e}rifi\'{e}e dans le champs pr\'{e}vus \`{a}
	cot\'{e} du nom du d\'{e}tecteur. Entre parenth\`{e}ses le nombre total
	de d\'{e}tecteurs pr\'{e}sents actuellement dans le ou les chassis
	VXI.

\subsection{Affichage des commandes vers le Vxi ou la "Data base"}
	En affichant les commandes transmises au VXI ou \`{a} la "data base",
	on v\'{e}rifiera ainsi en permanence le bon s\'{e}quencement des
	op\'{e}rations.


\subsection{Zone d'affichage d'un spectre}
	Un ou des spectres (max 4) pourront \^{e}tre visualis\'{e}s pour un
	contr\^{o}le rapide. Une vue plus fine imposera d'utiliser le logiciel
	d'analyse appelable par le bouton "analyse" au bas de la fenetre
	"tcard". L'appel des spectres se fera par l'interm\'{e}diaire du
	"Spectrun Server"

\subsection{Entr\'{e}e de commandes Unix}
	Dans cet \'{e}mulateur de terminal pourront \^{e}tre entr\'{e}s des
	commandes UNIX ou du protocole entre "tcard" et le VXI ou la "data
	base".

\subsection{Appel de diff\`{e}rents logiciels}
	Ces boutons : help ( affichage de edoc124.dvi), setup(action sur la
	data base), control, acquisition, analyse (v\'{e}rifiaction plus
	pr\'{e}cise des spectres) font appel aux logiciels d\'{e}crits dans
	d'autres EDOC.

\section{Les menus}

\subsection{Menu data base }
	En choississant une des options, on affichera dans la zone "affichage
	de commandes", toutes les caract\'{e}ristiques du dernier objet
	selectionn\'{e} et rappel\'{e} dans le message "choice"; on affichera
	dans une f\^{e}netre textedit le contenu du fichier *.data (c'est un
	digest du setup avec nom des objets, leurs caract\'{e}ristiques). Ce
	fichier ne peut \^{e}tre que consult\'{e}. En cliquant sur le symbole
	en haut \`{a} gauche de ce textedit , puis en glissant  sur close du
	petit nenu (bouton droit de la souris) , cette fenetre se transformera
	en icone r\'{e}appelable par un double clic.

	\subsection{Menu synoptique}
	Ce menu comporte une option permettant de choisir le nom de la carte
	VXI \`{a} tester. Ce sont les cartes trigger, germanium,
 BGO, demon et icare .

\subsection{Menu display}
	Le menu display fournit les options pour la mise en oeuvre de la
	formation de spectres dans le "Resource Manager" ( en phase de test de
	carte). Ce sont:
	\begin{itemize}
	\item choix des param\`{e}tres des diverses voies ( 6 maximum pour GE)
	\item d\'{e}marrage de la formation de spectres
	\item arr\^{e}t de la formation de spectres
	\item effacement d'un spectre dans le "Resource Manager"
	\item rafra\^{i}chissement de l'image
	\end{itemize}

\subsection{Mode d'appel des menus}

	D\'{e}placer le curseur (la fl\`{e}che) sur l'un des trois menus. Puis
	enfoncer la touche de droite; un menu d\'{e}roulant s'ouvre alors; tout
	en laissant enfon\c{c}\'{e} la touche droite d\'{e}placer la souris
	vers le bas; chaque option est mise successivement en gris\'{e}e;  vous
	relacherez la touche de la souris en \'{e}tant positionn\'{e} sur
	l'option voulue.



\section{Description de diff\'{e}rents objets}

\subsection{Database}
	La "data base" contiendra toutes les informations n\'{e}cessaires pour
	l'initialisation et la mise \`{a} jour des donn\'{e}es pour les cartes
	( trigger et multid\'{e}tecteur). Des fichiers "setup" (non modifiables
	durant le test) fourniront les valeurs qui seront charg\'{e}es dans des
	fichiers courants modifiables par l'utilisateur. Tous ces fichiers sont
	cr\'{e}\'{e}s par un \'{e}diteur de texte, donc en ASCII et imprimables
	\`{a} tout moment.

La "data base" se compose d'un ensemble  de fichiers d\'{e}crivant les
caract\'{e}ristiques  :
	\begin{itemize}
	\item des points scope
	\item des registres
	\item des boutons
	\end{itemize}
	Un EDOC d\'{e}crit en d\'{e}tail ces fichiers.
	En s\'{e}lectionnnant tout d'abord un des trois objets sur le
	synoptique , puis en choississant ce menu, on verra les
	caract\'{e}ristiques de l'objet ( notamment son nom, sa valeur
	actuelle, les bornes de variation pour les registres etc).


\subsection{Synoptique}
	Le synoptique a \'{e}t\'{e} \'{e}labor\'{e} \`{a} partir du sh\'{e}ma
	\'{e}lectronique.
	On choisira les objets actifs \`{a} v\'{e}rifier en cliquant sur les
	zones color\'{e}es \`{a} l'\`{e}cran (num\'{e}rot\'{e}es et carr\'{e}es
	ou circulaires)

	 Ce synoptique comprend diff\'{e}rents types d'objets :

	\begin{itemize}
	\item des objets statiques (composants, lignes de liaison, texte)
	\item des lignes en pointill\'{e} pr\'{e}cisant les composants communs
	\`{a} plusieurs cartes
	\item des objets dynamiques
		\begin{description}
		\item [a) ]points de s\'{e}lection pour affichage de signaux,(
		dit test point)
		\item [b) ]points de s\'{e}lection d'ajustement de valeurs de
		registre ,
		\item [c) ]composant pouvant \^{e}tre zoomm\'{e}
		\item [d) ]bouton on/off ou \`{a} deux  etats (low/high ...)
		\end{description}
	\end{itemize}

 Les objets dynamiques pourront \^{e}tre choisis en positionnant la fl\`{e}che
 sur l'objet et en cliquant sur la touche de gauche de la souris. Suivant
 l'objet selectionn\'{e} le logiciel ouvrira des boites de dialogue
 diff\'{e}rentes d\'{e}crites plus loin et en fonction des choix faits  enverra
 une commande au "Resource Manager' qui la r\'{e}percutera sur la carte choisie
 (trigger, BGO, GE, Demon ou Icare).\\
Les zones \`{a} l'int\'{e}rieur des lignes en pointill\'{e} indique que les
objets qui s'y trouvent sont communs \`{a} toute la carte.

	\subsection{Spectre}
	Pour voir l'influence des modifications d'une valeur d'un composant
	imm\'{e}diatement, il sera possible de constituer un spectre dans le
	"Resource Manager" \`{a} partir de donn\'{e}es provenant de la carte et
	la voie s\'{e}lectionn\'{e}e. Ce spectre sera visualisable dans la zone
	du bas \`{a} droite de l'\'{e}cran. Nous d\'{e}crivons plus loin la
	proc\'{e}dure \`{a} suivre pour obtenir ces spectres.

	 Pour approfondir l'analyse du spectre, il sera possible d'appeler le
	 logiciel "analyse".


\section{Signification des symboles du synoptique}

	Les points selectionnables sur le synoptique sont dessin\'{e}s en
	couleur et auront des formes diverses suivant le cas.

\subsection{Objets statiques}
	\subsubsection{Composants}
	Des composants plus ou moins complexes ( rectangle de couleur "yellow")
	suivant les cartes sont consid\'{e}r\'{e}s comme statiques pour le
	synoptique. Ils sont l\`{a} pour la compr\'{e}hension du sch\'{e}ma.
	\subsubsection{Liaisons}
	De couleur "brown", elles interconnectent les composants et les objets
	dynamiques.
	\subsubsection{Texte}
	De couleur "brown", certaines inscriptions apportent une meilleure
	compr\'{e}hension au synoptique.

\subsection{Objets dynamiques}
	Si le curseur est positionn\'{e} sur ces objets, ils sont sensibles au
	clic de la souris et provoque une action d\'{e}crit plus loin.

	\subsubsection{Affichage sur oscilloscope}

	Les points de s\'{e}lection pour affichage sur scope seront rouges
	corail de forme ovale. Ils contiennent un chiffre et une lettre
	symbolique du type de connecteur visu autoris\'{e}. Le clic sur ces
	points ouvre une boite de dialogue appel\'{e}e "scope"

	Comme il n'est plus possible de brancher directement des sondes
	d'oscilloscope sur les cartes, il est donc devenu n\'{e}cessaire de
	faire afficher des signaux logiques ou analogiques dont les points de
	connexion sont s\'{e}lectionn\'{e}s par logiciel. Le "Resource
	Manager"  reli\'{e} \`{a} un oscilloscope recevra les signaux provenant
	de points d'une carte multid\'{e}tecteur et les visualisera via le
	panneau VXI et des sorties lemo frontales sont envoy\'{
}ees \`{a} un scope.

	\subsubsection{Ajustement des valeurs}

	Les points d'ajustement et de mesure seront num\'{e}rot\'{e}s,  de
	forme carr\'{e}e et de couleur "aquamarine". Il ouvre une boite de
	dialogue de r\'{e}glage.

	Chaque carte comporte des registres dont les valeurs sont accessibles
	en lecture et \'{e}criture \`{a} partir par exemple d'une station de
	travail par l'interm\'{e}diaire d'un tube ethernet et d'un "Resource
	Manager" en relation avec ce tube et la carte \`{a} tester. Il existe
	deux types de valeurs: celles agissant sur la voie \`{a} l'\'{e}cran,
	et celles agissant sur toutes les voies.

	\subsubsection{Bouton un ou deux \'{e}tats}
	En cliquant sur ces boutons, on les fait passer dans un autre
	\'{e}tat.

	Certains boutons pourront \^{e}tre positionn\'{e}s ON ou OFF. Suivant
	le cas ces boutons seront verts ou rouges.
	D'autres types de boutons \`{a} deux positions (deux inscriptions)
	auront un \'{e}tat actif de couleur "medium spring green" et inactif de
	couleur "yellow (par ex high , low).

	Un troisi\`{e}me type de bouton \`{a} une inscription sera soit actif
	de couleur "medium spring green" et inactif de couleur "yellow".
(par exemple Atten )

\subsubsection{Zoom}
	Certains composants (notamment ROCI) comporteront suffisament de points
	de connexion vers un scope ou de points de mesure pour justifier un
	synoptique diff\'{e}rents de la carte m\`{e}re.
	Le zoom est appelable en cliquant sur les composants de couleur"dark
	turquoise". Le zoom sera surtout utile aux ing\'{e}nieurs.


\section{Boite de dialogue point de test scope}

\begin{figure}[h]
\psfig{figure=fig3.ps,width=10cm,height=10cm}
\end{figure}

\begin{center}
figure 3 boite de dialogue scope
\end{center}

	Cette boite de dialogue est ouverte lorsqu'on clique sur les points de
	connexion scope rouge (ovale). Une ligne de bouton est dessin\'{e}e au
	haut de la boite de dialogue. Ne seront autoris\'{e}s que les boutons
	portant une indication, les autres seront interdits comme l'indiquera
	une boite d'alerte si on essaye de cliquer sur ces boutons vides
	d'inscription.
	 On voit aussi apparaitre le nom et le num\'{e}ro du d\'{e}tecteur
	 choisi (zone de dialogue en bas \`{a} gauche).

\subsection{Choix des valeurs (detecteur, point test)}
	Il est aussi possible de choisir un autre d\'{e}tecteur que celui sur
	lequel on est positionn\'{e}. Dans ce cas, on active le champ
	"detector\#" en positionnant la souris dessus et en cliquant sur le
	bouton gauche; puis on entrera au clavier la nouvelle valeur suivie de
	la touche return.
	 De la m\^{e}me fa\c{c}on on peut aussi modifier le num\'{e}ro du point
	 de test. Dans ce cas on sp\'{e}cifiera le nouveau type de fonctions
	 autoris\'{e}es dans les boutons \`{a} choix multiples .

\subsection{Fonctions scope choisie A ou L}
	Dans un deuxi\`{e}me temps on choisira les types de sortie
	autoris\'{e}s vers le scope en cliquant sur les choix suivants.
	\begin{itemize}
	\item soit 2 voies analogiques (A1 et A2)
	\item soit 2 voies logiques (L1 et L2)
	\end{itemize}
	Cette s\'{e}lection provoquera l'envoi de la demande d'affichage sur le
	scope connect\'{e} au chassis VXI.

\subsection{Fonction Mesure de Tension}
	La s\'{e}lection des points registres permet aussi la lecture et
	l'affichage du signal analogique, g\'{e}n\'{e}r\'{e} par le DAC, sur la
	sortie  MT du VXI. La mise \`{a} jour correspondante se fera
	automatiquement dans cette boite de dialogue. En outre l'objet
	graphique "test alimentation" du ROCI  permet une mesure et un
	affichage de toutes les tensions d'alimentation de la carte GE (par ex)

\section{Boite de dialogue registre}


	Le nom du registre apparaitra comme ent\^{e}te de la boite
	Cette boite servira \`{a} la fois pour extraire les valeurs des points
	de mesure des diff\'{e}rents d\'{e}tecteurs et de les modifier
	\'{e}ventuellement. En cliquant sur un  carr\'{e} bleu num\'{e}rot\`{e}
	cette boite apparaitra avec le num\'{e}ro actuel du d\'{e}tecteur et du
	registre choisi ainsi que les bornes ("offset" et "gamme") et  la
	r\'{e}solution (par d\'{e}faut = 1) obtenus \`{a} partir de la data
	base.

\subsection{Modification pour un seul detecteur}
	Pour modifier la valeur trois possibilit\'{e}s s'offrent \`{a} nous:
	\begin{itemize}
	\item cliquer sur la touche gauche de la souris tout en
	d\'{e}pla\c{c}ant le curseur du potentiom\`{e}tre; le relachement
	valide la position du potentiom\`{e}tre
	\item entrer une valeur au clavier sur le champ \`{a} cot\'{e} du
	potentiom\`{e}tre en terminant par return
	\item cliquer sur le bouton + ou - de fa\c{c}on \`{a} augmenter ou
	diminuer la valeur actuelle du param\`{e}tre
	\end{itemize}

	La valeur ainsi modifi\'{e}e est renvoy\'{e}e syst\'{e}matiquement sur
	le registre du d\'{e}tecteur  choisi.

\subsection{Modification pour plusieurs d\'{e}tecteurs}
	 Nous prevoyons de pouvoir \'{e}galement modifier le m\^{e}me
	 param\`{e}tre sur plusieus d\'{e}tecteurs en pr\'{e}cisant le
	 num\'{e}ro de d\`{e}but et de fin s\'{e}par\'{e} par un tiret (par
	 exemple 1-10 cad du premier au dixi\`{e}me).

	 Une autre possibilit\'{e} ets de fournir une liste de num\'{e}ro
	 s\'{e}par\'{e}e par une virgule ( par exemple 1,5,8,10).

\begin{figure}[h]
\psfig{figure=fig4.ps,width=16cm,height=10cm}
\end{figure}
\begin{center}
figure 4 boite de dialogue mesure
\end{center}

\subsection{Lecture}
	Apres une modification du num\'{e}ro du d\'{e}tecteur ou du registre,
	on lira la valeur actuelle dans le registre. Celle \c{c}i sera
	affich\'{e}e dans cette boite de dialogue. Il sera alors possible de la
	modifier si c'est souhaitable. Le nombre maximun de registre ne peut
	naturellement pas \^{e}tre d\'{e}pass\'{e}; si c'est le cas une boite
	d'alerte le rappelera et demandera de clique sur ok.

\subsection{Restauration}
	Le bouton "restore" recup\`{e}rera la valeur actuelle de la "data base"
	notamment apr\`{e}s des essais de changement d'une valeur;

\subsection{Sauvegarde}
	Si l'on estime que la valeur actuelle du param\`{e}tre est bonne, on
	pourra la sauvegarder dans la "data base courante" en cliquant sur le
	bouton "save".

\section{Procedure de formation de spectres}
	Les spectres seront form\'{e}s dans le "Resource Manager" \`{a} partir
	des ADC d'une voie et d'un param\`{e}tre de cette voie. La puissance de
	traitement du "Resource Manager" permet de former 6 spectres de 16k (
	ce qui correspondant aux nombres de voies Germanium par carte VXI).
	Le menu Display fournit tous les outils pour r\'{e}aliser cette
	fonction.

	 En premier, on choissira l'option "adc" c'est \`{a} dire le type de
	 carte(BGO ,GE, Demon ou Icare), puis le num\'{e}ro de la voie et enfin
	 le param\`{e}tre ( par ex pour GE : Energie 4Mev ou 20Mev, ou le
	 Crossover ou le tac).
	 Puis on effacera  la m\'{e}moire du "Resource Manager" par "erase".
	 Une option "start" lancera effectivement la formation du spectre , une
	 option "stop" l'arr\^{e}tera
	 Une derni\`{e}re option permet de recup\'{e}rer \`{a} tout moment les
	 spectres du "Resource Manager" par l'option "refresh".

\section{Conclusion}
	L'utilisation des diff\'{e}rents outils disponibles sous "tcard"
	devrait permettre un bon test des cartes par les ing\'{e}nieurs
	electroniciens en phase de mise au point, mais aussi d'apporter une
	bonne aide pour le physicien en pr\'{e}paration et en cours
	d'exp\'{e}rience.

\end{document}
