\documentstyle[11pt,a4,psfig]{article} \title{Developpement soft} \author{G.ZEHNACKER} \date{Edition march 1992} \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 EDOC135\par \vskip 1.5truein \hrule height 2pt \vskip 2cm \large Installation procedures for \\ \vskip .5cm electronic card test\ \ \vskip .25cm \rm (tcard, database access, VXI configuration)\\ \vskip .5truein \small \vskip .5truein \vskip 20pt \hrule height 2pt \vskip 1truein \small \begin{tabbing} Edition \=: 1.2 \\ Date \>: march 1992\\ Authors \>: C.DIARRA,B.HUMBERT,G.ZEHNACKER \\ \end{tabbing} \vskip 4cm \small Centre de Recherches Nucl\'{e}aires de Strasbourg \par CENG Bordeaux \par CNRS-IN2P3 France\par } \end{titlepage} \newpage \tableofcontents \newpage \section{Introduction} You have two possibilitys to extract the Eurogam tcard software :\\ - with ftp : account anonymous , under directory ./eurogam \\ - with a tar\_file : see create\_tarfile \& extract\_file \section{Edoc references} The edoc124.latex describes the aim and the use of tcard. This document is specificality related to the implementation of all this software. The edoc126.latex describes the various protocols \\ The edoc128.latex contains GE, BGO and trigger synoptiques\\ The edoc131.latex describes the "tcard" VXI Register Server\\ The edoc133.latex describes the database for the VXI cards testing\\ Under directory $\$$HOME/EDOC you find this edoc135.latex \section{Tcard software} Under directory $\$$HOME/SYNOPTIQUE you find :\\ \subsection{Executables files} tcard\\ set\_vxi\_config\\ power\_supply\\ \subsection{Tcard datas} \subsubsection{icon file} tcard.icon\\ \subsubsection{help\_file} tcard.info\\ \subsubsection{synoptique description files} ge.syn\\ ge\_roci.syn\\ bgo.syn\\ bgo\_roci.syn\\ trigger.syn\\ legende.syn \subsubsection{digest data base} ge.data\\ ge\_roci.data\\ bgo.data\\ bgo\_roci.data\\ \section{Software to access to VXI, data\_base \& spectrum} Under directory $\$$HOME/bin you find several tasks to manage exchanges with VXI crate, the database and spectra built by the resource manager\\ \subsection{access on VXI} load\_vxi\\ read\_vxi\\ write\_vxi\\ button\_vxi\\ scope\_vxi\\ scope\_reset\_vxi\\ mt\_vxi\\ echgl\\ \subsection{access on data base} init\_database\\ read\_database\\ write\_database\\ save\_current\_database\\ load\_bgo\\ load\_ge\\ \subsection{access on spectrum} auto\_erase\_spectrum\\ erase\_spectrum\\ start\_plus1\\ stop\_plus1\\ refresh\_spectrum\\ \subsection{data base reformating and configuration} dbformat is used to reformat or check the data base files after their edition or modification) \section{list\_of\_database files} \begin{verbatim} Data base files under directory = $DATABASE/current Array_Setup.G Array_Setup.S Array_Setup.T Button_Setup.G Button_Setup.S Button_Setup.T Button_Setup_0000.G G is for GE, S for Shield and T for Trigger. Button_Setup_0000.S One file is now needed for each serial number of VXI card Button_Setup_0000.T (ex:0001 ) Button_Setup_default_config.G standard file to be used before checking each Button_Setup_default_config.S new VXI card ( new serial number) Button_Setup_default_config.T Reg_Setup.G Reg_Setup.S Reg_Setup.T Reg_Setup_0000.G Reg_Setup_0000.S Reg_Setup_0000.T Reg_Setup_default_config.G Reg_Setup_default_config.S Reg_Setup_default_config.T VXIConfig.G VXIConfig.S VXIConfig.T VXIConfig.target power_supply.ge power_supply.bgo \end{verbatim} \section{VXI processes} \begin{verbatim} All files needed by the Resource Manager to run "tcard" are in the directory ./VXI. The directory ./VXI is divided in 5 subdirectories: ./VXI/vw/ ./VXI/TEST/ ./VXI/AutoConf/ ./VXI/PLUS\_UN/ ./VXI/Server/ \end{verbatim} \subsection{ ./VXI/vw/} \begin{verbatim} In the directory ./VXI/vw/ there are 5 files : - vxWorks - vxWorks.sym the vxWorks kernel and symbols table used by the Resource Manager. - startup.cmd the vxWorks startup file used by the Resource Mnanger. It's important to modify this file to take care of some particularities : - for console : tyBackspaceSet - for nfs file system : - nfsMount - nfsAuthUnixSet - cd - prompt.o a very small program to have a nice prompt - vxRshd.o a Wind River program to have remote command facility used by "tcard" in the plus un ADC. \end{verbatim} \subsection{ ./VXI/TEST/} \begin{verbatim} In the directory ./VXI/TEST/ there are the library test_lib.o (used by hardware experts) and 2 test programs executed at startup time (fifo_test.o & roci_test.o). \end{verbatim} \subsection{ ./VXI/AutoConf/} \begin{verbatim} In the directory ./VXI/AutoConf/ there is the VXI routines used to autoconfigure and 2 small programs : - one (vxiShow) to know the contents of the device registers of a particular device (vxiShow device_number). - the other (vxitblShow) to know the contents of the device registers maintained in the VXI table of a particular device (vxitblShow device_number). \end{verbatim} \subsection{ ./VXI/PLUS\_UN/} \begin{verbatim} In the directory ./VXI/PLUS\_UN there is the plus un library used by "tcard" to build the spectrum required by a clic on an ADC. \end{verbatim} \subsection{ ./VXI/Server/} \begin{verbatim} In the directory ./VXI/Server there is the Server library cardlib and 5 servers : - mt_server - read_server - scope_server - switch_server - write_server \end{verbatim} \subsection{ Entering Boot Parameters} \begin{verbatim} boot device : ln processor number : 0 host name : lys file name : /home/lys/gc/g3400/eurogam/VXI/vw/vxWorks inet on ethernet (e) : 134.158.84.5 inet on backplane (b): host inet (h) : 134.158.83.1 gateway inet (g) : user (u) : bh ftp password (pw) (blank = use rsh): flags (f) : 0x28 target name (tn) : holly startup script (s) : lys:/home/lys/gc/g3400/eurogam/VXI/vw/startup.cmd other (o) : \end{verbatim} \section{tar\_script} \subsection{tar tcard.script} tar -cvf tcard.tar tcard\\ set\_vxi\_config\\ power\_supply\\ tcard.icon\\ tcard.info\\ ge.syn\\ ge\_roci.syn\\ bgo.syn\\ bgo\_roci.syn\\ trigger.syn\\ ge.data\\ ge\_roci.data\\ bgo.data\\ bgo\_roci.data\\ legende.syn\\ edoc124.dvi\\ \subsection{database\_bin.script} \begin{verbatim} tar -cvf database_bin.tar autoerase_spectrum button_vxi dbformat erase_spectrum init_database load_bgo load_ge load_vxi mt_vxi popen_vxRsh read_database read_vxi refresh_spectrum save_current_database scope_reset_vxi scope_vxi start_plus1 stop_plus1 vxRsh write_database write_vxi update_vxi_database echgl \end{verbatim} \subsection{tardatabase.script} \begin{verbatim} tar -cvf database.tar Array_Setup.G Array_Setup.S Array_Setup.T Button_Setup.G Button_Setup.S Button_Setup.T Button_Setup_0000.G Button_Setup_0000.S Button_Setup_0000.T Button_Setup_default_config.G Button_Setup_default_config.S Button_Setup_default_config.T Reg_Setup_0000.G Reg_Setup.S Reg_Setup.T Reg_Setup_default_config.G Reg_Setup_default_config.S Reg_Setup_default_config.T VXIConfig.G VXIConfig.S VXIConfig.T VXIConfig.target power_supply.ge power_supply.bgo \end{verbatim} \section{Create\_tarfile} Under $\$$HOME you find the "create\_tarfile" which save \\ README\_install\\ create\_tarfile \\ extract\_tarfile \\ .ucshrc\_tcard \\ edoc135.latex \\ tcard.tar.Z \\ database\_bin.tar.Z \\ database.tar.Z \\ some processes for VXI\\ \subsection{Tarfiles,.ucshrc,edoc} \begin{verbatim} tar -cvf /dev/nrst0 README_install tar -cvf /dev/nrst0 create_tarfile tar -cvf /dev/nrst0 extract_tarfile tar -cvf /dev/nrst0 .ucshrc_tcard cd EDOC tar -cvf /dev/nrst0 edoc135.latex \end{verbatim} \subsection{tcard.tar.Z} \begin{verbatim} cd ../SYNOPTIQUE sh tar_tcard.script compress -v tcard.tar tar -cvf /dev/nrst0 tcard.tar.Z \end{verbatim} \subsection{database\_bin.tar.Z} \begin{verbatim} cd ../bin sh tar_database_bin.script compress -v database_bin.tar tar -cvf /dev/nrst0 database_bin.tar.Z \end{verbatim} \subsection{database.tar.Z} \begin{verbatim} cd ../DATABASE/current sh tar_database.script compress -v database.tar tar -cvf /dev/nrst0 database.tar.Z \end{verbatim} \subsection{vxi.tar.Z} \begin{verbatim} cd ../../ tar -cvf vxi.tar ./VXI compress -v vxi.tar tar -cvf /dev/nrst0 vxi.tar.Z mt -f /dev/rst0 rewind \end{verbatim} \section{Installation} \subsection{README\_install file} \begin{verbatim} 1. please read first README_install tar -xvf /dev/rst0 README_install 2. please do: mt -f /dev/nrst0 fsf 3. please read extract_tarfile with: tar -xvf /dev/rst0 extract_tarfile 4. please execute: sh extract_tarfile 5. please define environment variables ( see .ucshrc_tcard ) for example setenv HOME $PWD 6. your installation is now finish \end{verbatim} \subsection{Environment variables} You find the environment variables in the file ".ucshrc\_tcard" \subsubsection{Tcard and database variables} \begin{verbatim} setenv SYNOPTIQUE $HOME/SYNOPTIQUE setenv SPECTRE $HOME/SPECTRA setenv EDOC $HOME/EDOC setenv VISU $HOME/VISU setenv ACQUISITION $HOME/ACQUISITION setenv DATABASE $HOME/DATABASE setenv DATABASE_VXI $HOME/DATABASE_VXI setenv COMMON $HOME/DATABASE/SOURCE_C/common setenv DBMS $HOME/DATABASE/SOURCE/dbms \end{verbatim} \subsubsection{Open look} \begin{verbatim} setenv HELPPATH $HOME/HELP:$HOME/SYNOPTIQUE setenv OLWMMENU $HOME/.olwmrc setenv OPENWINHOME /usr/openwin setenv GUIDEHOME /home/openwin4/GUIDE setenv LD_LIBRARY_PATH /usr/lib:$OPENWINHOME/lib: /home/openwin4/lib: $GUIDEHOME/lib:/usr/lib/X11:/HOME/lang/CC/lib/sun4 \end{verbatim} \subsubsection{Bin path} \begin{verbatim} modify of course the PATH setenv PATH /home/etc: /HOME/lang/CC/sun4c: /usr/ucb: /usr/bin: /bin:/etc: /usr/etc: /home/tran/$cpu/lib: /usr/sunlink/dni: /usr/bin/X11: /usr/5bin: /home/bin: /home/bin4: /HOME/binx: /HOME/lang: /usr/local/bin:/usr/CC/sun4: $OPENWINHOME/bin: $GUIDEHOME/bin: $HOME/SYNOPTIQUE: $HOME/VISU: $HOME/ACQUISITION. \end{verbatim} \subsection{Extract\_tarfile} The tar\_file contains: \\ README\_install \\ create\_tarfile \\ extract\_tarfile .ucshrc\_tcard \\ edoc135.latex \\ tcard.tar.Z \\ database\_bin.tar.Z \\ database.tar.Z \\ \subsection{Tarfiles,.ucshrc,edoc} \begin{verbatim} tar -xvf /dev/nrst0 README_install mt -f /dev/nrst0 fsf tar -xvf /dev/nrst0 create_tarfile mt -f /dev/nrst0 fsf tar -xvf /dev/nrst0 extract_tarfile mt -f /dev/nrst0 fsf tar -xvf /dev/nrst0 .ucshrc_tcard mt -f /dev/nrst0 fsf mkdir EDOC cd EDOC tar -xvf /dev/nrst0 edoc135.latex mt -f /dev/nrst0 fsf \end{verbatim} \subsection{tcard.tar.Z} \begin{verbatim} cd .. mkdir SYNOPTIQUE cd SYNOPTIQUE tar -xvf /dev/nrst0 tcard.tar.Z uncompress tcard.tar.Z tar -xvf tcard.tar mt -f /dev/nrst0 fsf \end{verbatim} \subsection{database\_bin.tar.Z} \begin{verbatim} cd .. mkdir bin cd bin tar -xvf /dev/nrst0 database_bin.tar.Z uncompress database_bin.tar.Z tar -xvf database_bin.tar mt -f /dev/nrst0 fsf \end{verbatim} \subsection{database.tar.Z} \begin{verbatim} cd .. mkdir DATABASE/current cd DATABASE/current tar -xvf /dev/nrst0 database.tar.Z uncompress database.tar.Z tar -xvf database.tar mt -f /dev/nrst0 fsf \end{verbatim} \subsection{vxi.tar.Z} \begin{verbatim} tar -xvf /dev/nrst0 vxi.tar.Z uncompress vxi.tar.Z tar -xvf vxi.tar mt -f /dev/rst0 rewind \end{verbatim} \end{document}