Zeus CTD Z System Test Suite
Full Technical Information Current list of spares
To use:
- Depending on where you are, choose a computer.
- Find out where the software is stored.
- Set up your link to your favourite transputer.
- Choose required software package from below.
Note: the software will only work at DESY if the KERNEL running on ZUKVS3 is first disabled. This must not be done during running and can only be done by someone with sufficient system priviledges.
Available test software: (click on the appropriate one to run)
- TCT : allows single LTC boards to be tested.[Tech]
- ROCTEST : General test package.
- SST : obsolete.
- The JBL group: [Tech]
- PIGLET : Gives LTCs a very hard time.
- POOH : Test the system stand-alone.
- POOHBEAR : Test the system with the GFLT.
- TIGGER : Test the pipeline synchronisation.
The JBL group can also be used on the FADC's as well.
- MULTI-Z : test data transfers to/from all Z-cards in all (16 & 2) Z-by-T crates. It test the functionality of both the Z-LTCC's and Z cards.
Click on the package to find out how to run it. Click on the associated [Tech] link for more technical information about it.
Underlying code:
- HARNESS - transputer communications
Ref. (ZEUS Note 91-123 ZEUS C.T.D. Occam Harness, Phillip Hallam-Baker)
- GODEL - multi crate communications
- ZTCLIB - general test functions
Technical Information:
Diagrams:
- Overview of the system: .eps
.gif
- CTD schematic readout: .eps no .gif
- The local z data acquisition system demonstrating the the fuctionality of the timing controllers: .eps .gif
- A functional diagram of the MTC. The test functionality, not operational during normal data taking, is representedby dotted lines: .eps .gif
- A state transistion diagram of the LTC demonstrating its basic operation during a run: .eps no .gif
- A functional diagram of the LTC. The test functionality, not operational during normal data taking, is represented by dotted lines: .eps .gif
- An example of a timing diagram also showing LTC address transistions: .eps .gif
Texts:
Which computer to use?
- At UCL: UCLVE (decnet) or vx5 (IP)
- At DESY: ZUKVS3
- At OXFORD: ZUKVS1
Where is the stuff?
The layout of the software is essentially the same at UCL, DESY and Oxford, with only the base directory being different.
- At UCL: DISK$Z1:[ZEUS_ONLINE.CTD_ONLINE3]
- At DESY/Oxford: SYS$SYSDEVICE:[CTD_ONLINE]
Each package has its own directory, and each version has a directory within each package directory. Each version has four directories; source, config, work and target. So for version v5_0 of TCT you would have the following directories:
[.TCT]
[.TCT.V5_0]
[.TCT.V5_0.SOURCE]
[.TCT.V5_0.TARGET]
[.TCT.V5_0.CONFIG]
[.TCT.V5_0.WORK]
Which Link to use?
Before starting the software the link to the root transputer of the network must be defined (link 0 is the default).
At DESY:
- LINK0 - Z system DAQ
- LINK1 - rucksack flying link
- LINK2 - FADC system DAQ
- LINK3 - Level 6 electronics
At UCL
TCT
How to run:
- If you haven't done it yet:
- at UCL: @DISK$Z1:[ZEUS_ONLINE.CTD_ONLINE3]SETUP.COM
- at DESY/OXFORD: @SYS$SYSDEVICE:[CTD_ONLINE]SETUP.COM
- Type: TCTSET
- If this doesn't work try explicitly: @TCT_BASE_DIR:TCTSET
- If you wish to run an older version see CTD_SET.
- Setup up your LINK
N.B. At the moment TCT can only run on a ROC connected to the VAX link, not across a transputer network.
- Type: TCT
Or TCTF for the flying link version.
What are the loop tests?
What do the errors mean?
How do I rebuild the software?
ROCTEST
How to run:
- If you haven't done it yet:
- at UCL: @DISK$Z1:[ZEUS_ONLINE.CTD_ONLINE3]SETUP.COM
- at DESY/OXFORD: @SYS$SYSDEVICE:[CTD_ONLINE]SETUP.COM
- Type: ROCSET
- If this doesn't work try explicitly: @ROCTEST_BASE_DIR:ROCSET
- If you wish to run an older version see CTD_SET.
- At UCL: setup up your LINK
- Type:
- at DESY: ROCTEST linknumber bootable
e.g.
ROCTEST 0 16CRATE - will use link 0 and run on all 16 crates.
ROCTEST 3 Z0 - will use link 3 and run a single crate version (e.g. level 6 in DESY).
- at UCL: ROC bootable
e.g.
ROC Z0 - will run the single crate bootable.
ROC - will also run the single crate bootable.
How do I rebuild the software?
SST
- OBSOLETE.
How to run:
- If you haven't done it yet:
- at UCL: @DISK$Z1:[ZEUS_ONLINE.CTD_ONLINE3]SETUP.COM
- at DESY/OXFORD: @SYS$SYSDEVICE:[CTD_ONLINE]SETUP.COM
- Type: CTD_SET SST V5_0
- Setup up your LINK
- Type: SST
For more info see the TCT page.
How do I rebuild the software?
CTD_SET
Older versions of TCT and ROCTEST are available. These are listed in the following table: (columns HARNESS and GODEL refer to which version of these the program uses)
Program | Version | HARNESS | GODEL | Comment |
TCT | v4_2 | v5_2 | v1_9 | |
| v5_0 | v6_0 | v1_11 | |
| v5_1 | v7_2 | v1_11 | |
| v5_2 | v7_2 | v1_11 | normal and flying links |
ROCTEST | v4_1 | v5_2 | v1_9 | |
| v4_2 | v5_2 | v1_9 | not available at DESY |
| v5_0 | v7_4 | v1_11 | new zcard test |
SST | v5_0 | v6_0 | v1_11 | |
To select a particular old version type: CTD_SET progname version
e.g. for v5_0 of TCT type: CTD_SET TCT V5_0
PIGLET, POOH, POOHBEAR and TIGGER
How to run:
- Log in to ZUKVS3.
- Type: @userdisk:[UCL.Pooh]setup
- Type in the name of the program: e.g. PIGLET
For example, to check the cabling is OK so that the system runs, you could
first try Pooh stand-alone and then PoohBear with the GFLT (or Test Box).
The first event causes a Count message from each LTC handler.
Pressing the space bar generates an error summary and the program continues.
Any other key causes the message handler to exit after giving the summary.
N.B. The programs are run from ZUKVS3 using the ISERVER from the occam Toolset.
They are independent of both the main DAQ software and the test software
for a single LTC (TCT, SST and ROCTEST), which all use the HARNESS.
N.N.B. Piglet doesn't test the LTC in crate 17 (RBOX1) by design.
Pooh tests all the LTCs together.
Having problems with POOH et al.?
What does the output mean?
MULTI-Z
How to run:
- Go to the correct directory: SET DEFAULT USERDISK:[UCL.ZTEST]
- Run: @userdisk:[UCL.ZTEST]setup.com
- Specify which link you wish to use:
GETLINK QTA0 will set up link 0,
GETLINK QTA1 will set up link 1.
N.B. This is for the single crate test only. The multicrate test uses link 0 by default, if you wish to change this edit the file ZTEST.COM.
- For the single crate version type: ZTEST1
or for the multicrate version type: ZTEST
Note: The LTCs in the RBOXs will fail these tests because the RBOX timing is set up for the FLT cards and not z-cards.
If the cards are alright the output should look like this.
Original emails:
Who you're gonna call?
- WWW pages problems: meh@hep.ucl.ac.uk
- Problems with an LTC/MTC: mp@hep.ucl.ac.uk
- Problems with JBL software: jbl@hep.ucl.ac.uk