Release Notes for R04-10-00 (last updated 08/08/2005, ST):
The latest revision of this document is located here. The notes for the previous release are located here.
These procedures cover a Windows installation. If you wish to install LATTE under Unix/Linux, refer to the separate procedure.
Please refer to the instructions here to install the NFS server.
Setting up the cfg files:
Verifying LATTE installation:
Displaying software and hardware versions:
In order to run the "versions" utility, at the command prompt change the directory to "%ONLINE_ROOT%\LATTE" and type "versions.bat --server servername --schema schemaName". This should output version info for all modules (VxWorks and python) loaded, and all hardware defined in the given schema that is connected.To begin writing LATTE scripts, refer to the test scripts in the %ONLINE_ROOT%\tests\apps directory for orientation.
Running Run Control:
Run Control needs to be started from the LATTE\start directory as follows:
runcontrolmain --server servername --config configFilename --schema schemaFileName
Example:
runcontrolmain --server gitot --config runControl.cfg --schema %ONLINE_ROOT%\repos\simpleTemSchema.xml
If you need to change the schema without exiting Run Control you can use the “Select Schema” File menu option.
Flight Software Release:
Qt and PyQt Related:
LDF:
Hippodraw:
Run Control:
Client & Servers:
GOSED:
Schema/Configuration:
Housekeeping:
Plumbing Flags:
The following flags can be used in a
schema file under the <flags> tag to configure the FSW drivers and the LCB. The
flag name follows its default value along with a description of what the flag
does.
The following table shows the flags that each functional block supports:
GAEM 'CmdrspFabric', 'EventFabric', 'UsePdu1' GCRU 'EnableInternal1PPS' GEBM 'CmdrspFabric' GEPU 'CmdrspFabric', 'EventFabric', 'UsePdu1' GGEM 'CmdrspFabric', 'EventFabric' GLCB 'BoardId', 'UseRedundant', 'UseBitWide', 'UseTrailingIClock', 'UseTrailingOClock', 'IgnoreMissingNodes' GPDU 'CmdrspFabric' GSIU 'CmdrspFabric', 'EventFabric', 'UseSecMainFeed', 'PowerPdu0', 'PowerPdu1', 'PowerPrimDab', 'PowerSecDab' GTEM: 'CmdrspFabric', 'EventFabric', 'UsePdu1'
In the case of GSIU definition, the following convention should be used:
ID=0 corresponds to SIU_ext
ID=1 corresponds to SIU_0
ID=2 corresponds to SIU_1
usage: startupMainGUI.py --config <configname> --server <servername> [--appdir <appdirname>]
[--cmddebug <cmddebugname>] [--evtdebug <evtdebugname>] [--fswmsglevel <fswmsglevelname>]
[--noreload <noreloadname>] [--schema <schemaname>] [--securedir <securedirname>]
[--app <appname>] [--ocsport <ocsportname>] [--initforce] [--noerrfile] [--norcoverride] [--ocsverbose]
[--oesforce] [--playback] [--paramverify]
Detailed explanation:
Mandatory options:
--server to specify the hostname or the IP address of the teststand crate to connect to.
--config to specify the run control configuration file to use.
Optional options:
--app Specify the standalone application or suite to run.
Typically used by test or suite runners.
--appdir Specify the application directory
--cmddebug Specify command client debug mode (defaults to 0).
If this option is specified then all register accesses from the command client is logged to the logger.
--evtdebug Specify event client debug mode (defaults to 0)
The following debug modes are available and can be added together for combinations:
0: No Debug
1: Debug All
2: Event Dump
4: Warnings
8: Parser Output
16: Error Output
--fswmsglevel Specify the FSW message level for the OCS manager task.
--initforce Force command-response and event fabrics initialization on the SBC.
--noerrfile Disable error archive file output.
--noplumbing Do not automatically plumb the LAT upon connection.
--norcoverride Prevents the run conditions to be overridden with NOT-DEFINED.
--noreload Specify a file that contains prefixes of modules which should not be reloaded when a user script is selected.
This list gets appended to the default list which currently contains the following prefixes 'scipy', 'weave', 'qwt', 'xml', 'pyexpat', 'win32'.
The file should contain one prefix per line.
--ocsverbose Enable fabrics initialization messages on the SBC.
--ocsport Define the port used to connect to OCS
--oesforce Force our OES socket to be the default event server for the SBC.
--paramverify Force the parameter verifier to come up even if running in non-secure mode
--playback Indicate that Run Control should command the event server to play back the next event from its file. Since this is done using the GLT's self trigger command, the state of the internal trigger enable bit deterimines whether the application or Run Control will issue the self trigger command.No events will be delivered if the application has the internal trigger enabled, but doesn't issue CMD_SELF_TRIGGERs.
--schema Specify the schema file to load.
--securedir The full path to the secure directory where the password file ("passwords") and the user permissions file ("security.cfg") is stored. If this switch is specified then RunControl is started in secure mode.
The following table contains a list of all LATTE supported tags which may appear in a run report (rcReport.out):
TestName | Name of the script run |
SuiteName | Name of the suite run |
RunId | Unique 9 digit identifier for the run. The run's most significant three digits corresponds to a machine id, the other 6 digits forn a sequence number that gets incremented with every run |
Operator | Name of the operator running the test |
OperatorId | Three digit id of the operator as specified in runcontrol.cfg |
EventCount | Number of events taken if any during the execution of the test. |
BadEventCount | Number of events that are marked as bad before being transmitted from the SBC to the client PC. |
ErrorEventCount | Number of events where at least one of the contributions of the event has the error bit set in its summary. |
TriggerParityErrorEventCount | Number of events whichthe trigger parity error is set. |
PacketErrorEventCount | Number of events which have a packet error. |
PauseCount | Number of times the test was paused. |
PausedTime | Total number of seconds spent in paused state. |
StartTime | The timestamp for the start of the test in the form of a tuple. |
ElapsedTime | Total number of seconds spent during the execution of the test. |
EndTime | The timestamp for the end of the test in the form of a tuple. |
SBCHandledEvents | Total number of events received by the event handler running on the SBC regardless of whether it got transferred over to the client over the TCP socket during a siingle run. |
ValidEvents | Total number of events selected to be transferred over to the client over the TCP socket during a single run. |
FailedEventTCPSends | Total number of events which had a TCP socket send failure during a single run. |
FailedEventHWXmits | Total number of events which had the event descriptor bit xstatus set after it's been received by the SBC event handler during a single run. |
DiscardedEvents | Total number of events which would cause an EWOULDBLOCK error during send for a single run. Currently always zero since non-blocking sockets are being used. |
LengthMismatchedEvents | Total number of events where the event size doesn't match the size specified in the event header during a single run. |
UnsentEvents | Total number of events that are not send over the socket due to a filter or a prescaler during a single run. |
FreeDiskSpace | Free disk space for the C: drive on Windows and current working directory for Unix. |
SchemaConfigFile | The main schema file loaded when Run Control is launched. |
AdditionalInputFiles | Any include files used in the schema. |
AssociatedFiles | Any files exported by the user script by calling the addExportedFile method. |
CallbackParameters | Event filter settings |
VersionData | A dictionary of key, value pairs containing software and hardware identifiers and their versions. |
Release | A dictionary of key, value pairs containing LATTE and subsystem identifiers and their release tags. |
ModulesFailedVerification | A list of modules and schema files which failed the checksum verification. |
FITSfile | Name of the FITS file generated. |
ArchiveFile | Name of the event archive file (*.ldf) generated. |
ErrorArchive | Name of the error event archive file (err*.ldf) generated. |
BadEventArchive | Name of the bad event archive file (bad*.ldf) generated. |
HSKArchive | Name of the housekeeping FITS file generated. |
LogFile | Name of the session level log file generated. |
RunLogFile | Name of the run level log file generated. |
Comments | List of comment strings inputted by the operator and the system. |
Site | Test site |
ParticleType | Particle Type |
InstrumentType | Instrument Type |
Orientation | Orientation |
Phase | Phase |
AverageDeadTime | Percentage of the average TEM dead time during a single run. |
GEMDeadTime | Percentage of the average GEM dead time. |
ParamVerify | Indicates that the parameter verifier was activated during the run. |
SerialNos | Serial numbers of hardware as specified in the schema. |
ScriptReport | Name of the test report produced at the end of the run. |
TriggerMask | Trigger bits enabled during the run. These bits are roi, calLow, calHigh, tkr, periodic, solicited, cno and external. |
ErrorLogCount | Number of error log messages that were output since the run started. |
CompletionStatus | Integer value indicating the completion status for that run. |
CompletionStatusStr | String value indicating the completion status for that run. |
(Retrieved by running versions.bat --server servername --schema schemaName while in %ONLINE_ROOT%\LATTE directory)
Module
Version
CMX[cmx_asBuiltSpy] V2-4-2 CMX[cmx_asBuilt] V2-2-2 EMP[asc] V0-0-5 FILE[file_hdr_rtos] V2-3-0 GNAT[gnat_vme] V2-0-1 GNAT[gnat_xbrd] V2-0-1 LATC[lat_init] V6-2-0 LATTE 2.3 LATTE.browser 2.5 LATTE.browser.Browser 2.5 LATTE.browser.BrowserImpl 2.15 LATTE.browser.BrowserPreferences 2.2 LATTE.browser.BrowserReadme 2.1 LATTE.browser.bar 2.1 LATTE.browser.barw 2.3 LATTE.browser.browserPreferencesImpl 2.2 LATTE.browser.doublehisto 2.3 LATTE.browser.imagedata 2.1 LATTE.browser.listmean 2.1 LATTE.browser.mask 2.1 LATTE.browser.multibar 2.5 LATTE.browser.radiomask 2.1 LATTE.browser.towerwidget 2.1 LATTE.browser.towerwidgetImpl 2.2 LATTE.browser.trgConsumer 2.7 LATTE.browser.trgDisplay 2.9 LATTE.browser.trgDisplayImpl 2.17 LATTE.browser.userAppBrowser 2.9 LATTE.browser.userAppBrowserGui 1.2 LATTE.browser.userAppLeaf 2.4 LATTE.browser.userAppLoader 2.6 LATTE.browser.userAppTree 2.4 LATTE.client 2.5 LATTE.client.gBits 2.5 LATTE.client.gCmdCli 2.7 LATTE.client.gCommand 2.3 LATTE.client.gEvtCli 2.36 LATTE.client.gException 2.13 LATTE.client.gFswMessages 2.4 LATTE.client.gLog 2.8 LATTE.client.gLoopback 2.2 LATTE.client.gNode 2.2 LATTE.client.gOcsMessages 2.4 LATTE.client.gOpcode 2.1 LATTE.client.gOptions 2.5 LATTE.client.gRegister 2.3 LATTE.client.gResponse 2.6 LATTE.client.gSocket 2.11 LATTE.consumer 1.2 LATTE.consumer.consumer 1.5 LATTE.consumer.consumerPlotter 1.10 LATTE.consumer.standardLDF 1.7 LATTE.consumer.standardPlotter 1.10 LATTE.consumer.standardPlotterGui 1.4 LATTE.consumer.standardPlotterGuiImpl 1.2 LATTE.copyright_SLAC 1.2 LATTE.database 2.5 LATTE.database.gAEM 2.16 LATTE.database.gAttr 2.17 LATTE.database.gCRU 2.8 LATTE.database.gConstraint 2.3 LATTE.database.gDb 2.22 LATTE.database.gEBM 2.10 LATTE.database.gEGU 2.4 LATTE.database.gEPU 2.1 LATTE.database.gFabrics 2.5 LATTE.database.gGEM 2.19 LATTE.database.gGLT 2.7 LATTE.database.gGroup 2.1 LATTE.database.gHSK 1.13 LATTE.database.gHdb 1.8 LATTE.database.gLAT 2.17 LATTE.database.gLCB 2.12 LATTE.database.gMem 1.5 LATTE.database.gNAT 2.4 LATTE.database.gOCS 2.29 LATTE.database.gPDU 2.12 LATTE.database.gPlumber 2.12 LATTE.database.gRule 2.4 LATTE.database.gSIU 2.1 LATTE.database.gSchemaConfig 2.75 LATTE.database.gTEM 2.25 LATTE.database.gTPG 2.4 LATTE.database.gVersions 2.32 LATTE.database.gXBR 2.17 LATTE.dispatch 2.2 LATTE.dispatch.dispatcher 2.1 LATTE.dispatch.errors 2.1 LATTE.dispatch.robustapply 2.1 LATTE.dispatch.saferef 2.1 LATTE.gosed 1.2 LATTE.gosed.GOSEDACD 1.7 LATTE.gosed.GOSEDACDImpl 1.8 LATTE.gosed.GOSEDCAL 1.8 LATTE.gosed.GOSEDCALImpl 1.8 LATTE.gosed.GOSEDCALTKR 1.8 LATTE.gosed.GOSEDCALTKRImpl 1.9 LATTE.gosed.GOSEDData 1.11 LATTE.gosed.GOSEDDataImpl 1.10 LATTE.gosed.GOSEDPainter 1.15 LATTE.gosed.GOSEDPreferences 1.5 LATTE.gosed.GOSEDPreferencesImpl 1.14 LATTE.gosed.GOSEDReadme 1.2 LATTE.gosed.GOSEDTKR 1.4 LATTE.gosed.GOSEDTKRImpl 1.2 LATTE.gosed.GOSEDTWR 1.4 LATTE.gosed.GOSEDTWRImpl 1.2 LATTE.gosed.GOSED_LDF 1.37 LATTE.gosed.GOTED 1.2 LATTE.gosed.GOTEDImpl 1.6 LATTE.gosed.ServerPreferences 1.2 LATTE.gosed.ServerPreferencesImpl 1.9 LATTE.gosed.colorScale 1.3 LATTE.gosed.gosed 1.10 LATTE.gosed.gosedImpl 1.24 LATTE.logger 2.2 LATTE.logger.AlertGuiImpl 1.5 LATTE.logger.MSGLogGUI 2.2 LATTE.logger.MSGLogGUIImpl 2.11 LATTE.logger.socketLogging 1.2 LATTE.monitoring 1.4 LATTE.monitoring.Collector 1.6 LATTE.monitoring.HskAlarms 1.9 LATTE.monitoring.HskCli 1.3 LATTE.monitoring.HskCollector 1.8 LATTE.monitoring.HskGuiReceiver 1.9 LATTE.monitoring.HskPacketDecoder 1.3 LATTE.monitoring.HskPacketRetriever 1.2 LATTE.monitoring.HskReceiver 1.9 LATTE.monitoring.HskRecorder 1.7 LATTE.monitoring.HskRegisters 1.2 LATTE.monitoring.HskRetriever 1.9 LATTE.monitoring.HskSqlGuiReceiver 1.7 LATTE.monitoring.HskSqlInterface 1.7 LATTE.monitoring.HskSqlSvr 1.4 LATTE.monitoring.HskSvr 1.13 LATTE.monitoring.Receiver 1.2 LATTE.monitoring.Recorder 1.3 LATTE.monitoring.Retriever 1.3 LATTE.monitoring.TrendMaps 1.9 LATTE.monitoring.Trendable 1.2 LATTE.monitoring.testTrending 1.3 LATTE.monitoring.tools 1.3 LATTE.monitoring.tools.monitoringDbSyncIn 1.1 LATTE.monitoring.tools.monitoringDbSyncOut 1.5 LATTE.monitoring.tools.parseFswHsk 1.1 LATTE.power 1.3 LATTE.power.GpibPwrCtrl 1.2 LATTE.power.GpibPwrCtrlImpl 1.2 LATTE.power.PorcinePanel 1.7 LATTE.runcontrol 2.2 LATTE.runcontrol.Argument 2.1 LATTE.runcontrol.ArgumentImpl 2.2 LATTE.runcontrol.EnvMon 2.3 LATTE.runcontrol.EnvMonImpl 2.19 LATTE.runcontrol.EnvMonSetRange 2.1 LATTE.runcontrol.FEpowerUp 2.16 LATTE.runcontrol.FSM 2.0 LATTE.runcontrol.GlobalPanel 2.4 LATTE.runcontrol.GlobalPanelImpl 2.19 LATTE.runcontrol.LATsweep 2.13 LATTE.runcontrol.PowerPanel 2.1 LATTE.runcontrol.PowerPanelImpl 2.10 LATTE.runcontrol.RunControl 2.5 LATTE.runcontrol.RunControlCommon 2.41 LATTE.runcontrol.RunControlFSM 2.2 LATTE.runcontrol.RunControlGUI 2.3 LATTE.runcontrol.RunControlGUIImpl 2.2 LATTE.runcontrol.RunControlMain 2.55 LATTE.runcontrol.RunControlMainGUI 2.3 LATTE.runcontrol.RunControlMainGUIImpl 2.19 LATTE.runcontrol.fits2ldf 2.1 LATTE.runcontrol.ldf2fits 2.2 LATTE.runcontrol.rcArchiver 2.2 LATTE.runcontrol.rcCommentPanel 2.4 LATTE.runcontrol.rcComplStatus 2.5 LATTE.runcontrol.rcEndRunDlg 2.3 LATTE.runcontrol.rcEndRunDlgImpl 2.4 LATTE.runcontrol.rcFitsWriter 2.5 LATTE.runcontrol.rcHouseKeeping 2.4 LATTE.runcontrol.rcLogin 2.2 LATTE.runcontrol.rcLoginImpl 2.1 LATTE.runcontrol.rcParamVerifier 2.3 LATTE.runcontrol.rcParamVerifyGUI 2.3 LATTE.runcontrol.rcParamVerifyGUIImpl 2.5 LATTE.runcontrol.rcPreferencesGUI 2.5 LATTE.runcontrol.rcPreferencesGUIImpl 2.14 LATTE.runcontrol.rcPreferencesManager 2.17 LATTE.runcontrol.rcPythonShell 2.1 LATTE.runcontrol.rcReportGen 2.12 LATTE.runcontrol.rcRunIdHelper 2.2 LATTE.runcontrol.rcScmCfgSelector 2.1 LATTE.runcontrol.rcSecurityMan 2.5 LATTE.runcontrol.rcStatusMonitor 2.10 LATTE.runcontrol.rcSuite 2.21 LATTE.runcontrol.rcTestReport 2.4 LATTE.runcontrol.rcTransitions 2.128 LATTE.runcontrol.rcUsers 2.2 LATTE.runcontrol.rcUtil 2.12 LATTE.start 1.2 LATTE.start.startupGUI 1.1 LATTE.start.startupMainGUI 2.14 LATTE.tests 1.2 LATTE.tools 2.2 LATTE.tools.AcdHWMultiplexer 2.2 LATTE.tools.DataDistributor 2.7 LATTE.tools.DataDistributorPoll 2.3 LATTE.tools.DataExport 2.6 LATTE.tools.FreeSpace 2.1 LATTE.tools.MailAlert 1.2 LATTE.tools.gAlert 1.5 LATTE.tools.guiBridges 2.8 LATTE.tools.taskEngine 2.2 LATTE.trigger 2.3 LATTE.trigger.NullObjects 2.3 LATTE.trigger.TrgAbstract 2.1 LATTE.trigger.TrgCmdCounters 2.1 LATTE.trigger.TrgCnoCounters 1.1 LATTE.trigger.TrgCoincidences 2.1 LATTE.trigger.TrgConditions 2.2 LATTE.trigger.TrgConditionsValue 2.2 LATTE.trigger.TrgEngines 2.1 LATTE.trigger.TrgEventCounter 2.1 LATTE.trigger.TrgGem 2.8 LATTE.trigger.TrgGemAbstract 2.3 LATTE.trigger.TrgGemCounters 2.2 LATTE.trigger.TrgGemPeriodicCondition 2.1 LATTE.trigger.TrgGemRegisterGeometry 2.2 LATTE.trigger.TrgGemRegisters 2.9 LATTE.trigger.TrgGemSequence 2.1 LATTE.trigger.TrgInputEnables 2.2 LATTE.trigger.TrgMiniGLT 2.4 LATTE.trigger.TrgMiniGLTAbstract 2.1 LATTE.trigger.TrgMiniGLTRegisters 2.1 LATTE.trigger.TrgObject 2.3 LATTE.trigger.TrgPPSTimer 1.1 LATTE.trigger.TrgPeriodic 2.1 LATTE.trigger.TrgRoiAsTiles 2.1 LATTE.trigger.TrgRoiAsVeto 2.1 LATTE.trigger.TrgSequence 2.1 LATTE.trigger.TrgTileCounters 2.1 LATTE.trigger.TrgTower 2.1 LATTE.trigger.TrgTriggerCounters 2.1 LATTE.trigger.TrgUsingTiles 2.1 LATTE.trigger.rcDefaultTrigger 2.2 LATTE.trigger.rcTrgFunctions 2.3 LATTE.trigger.rcTrgGem 2.10 LATTE.trigger.rcTrgMiniGLT 2.8 LCBD[lcbd] V1-2-10 LDF.LDF 5.6.2 LEM[lem] V4-2-1 LEM[lem_cli] V4-2-1 LEM[lem_lists] V4-2-1 MSG[msg_mt] V2-0-3 MSG[msg_print] V2-0-3 MySQLdb 1.1.8 Numeric 23.6 OCS(server) 2.1 OCS[ocs] V7-8-1 OES[oes] V6-4-1 PBS[pbs] V2-9-0 PIG[pig_flying] V8-0-0 PIG[pig_power] V8-0-0 PyQt 3.14.1 Python 0x20305f0 Qt 3.3.3 SIP 0x40201 VXW[vxw_eeprom] V6-1-4 ZLIB[zlib_inflate] V2-1-0 cfitsio 2.510 logging 0.4.9.5 sihippo 1.14.8 startup-mv2304.vx 1.4 xml 0.8.3
Please contact Selim Tuvi, Ric Claus, Lester Miller or Jim
Panetta if you have problems or any questions (Contacts
Page)