Section: USER COMMANDS (1)
Updated: January 2, 2014
Index Return to Main Contents


trloctrl - Setup and control the TRLO II of a VULOM/TRIDI.  


trloctrl [OPTION]... [COMMAND|EXPR]...  


The flexible FPGA trigger control TRLO II running on a VULOM/TRIDI can operate the full trigger logics of a nuclear physics experiment. The system includes the functionality of most logic NIM modules. It also has features for advanced monitoring, e.g. trigger-alignment recording as well as plenty of scalers and timer latches.

With around 500 setup register of 60 kinds and 200 signals of almost as many variations, efficient handling can be a daunting task. The trloctrllib and trloctrl companion library and command-line interface program for control, monitoring and read-out help with this. Complex configurations can be loaded from setup files, while one-off commands for testing can be quickly issued from a shell.



Select the VME address A of the module to handle. The address is given in hexadecimal. With A given as 'dummy', a plain memory space in RAM is used instead, for dry-running.

Display a short help text and exit.

Set all setup registers to 0 (WIRED_ZERO for multiplexer destinations).

Print the configuration, i.e. all setup registers. Registers with default value (0, or WIRED_ZERO for multiplexer destinations) are not shown.

Print the status of the trigger system: scalers of the fast_path coincidence builder and deadtime veto, and the trigger state machine. Print once, or every INTERVAL seconds.

Dump/reset all MUX source scalers, or per requested NAMEs. Show currently active pattern         Every n s (default 1). Or reset.

Load command file (to memory only, i.e. nothing is executed yet and affecting the module).

Execute COMMAND from loaded configuration.

Execute EXPR as an command.

[=setup,dest,src] List all available setup registers, multiplexer destinations and sources. The list can be limited by TYPE as 'setup', 'dest' and 'src'.

Soft-scope for TRIG LMU inputs.

Multi-hit timer-latch (stop with Ctrl+C).

Multi-hit timer-latch #A,#B,... record to stdout.

Debugging of tracer and sampler.

Run VME test to special segment in TRLO II; address readback.

Run VME test to special segment in TRLO II; RAM block write/read.

Read from VULOM at given VME offset. HEXadecimal address given with prefix 0x.

Write to VULOM at given VME offset. HEXadecimal address and value given with prefix 0x.



0 after successfully operation, 1 on failure.



Note the necessity to enclose arguments with parentheses in quotation marks, to prevent the shell from doing Bad Things (TM).

Set the TRLO II to generate triggers and respect the TRIMI deadtime:
trloctrl --addr=2 --clear-setup \

  "period(1)=10us" "TRIG_PENDING[1]=PULSER(1)" \


To monitor the counts of all multiplexer sources once per second:
trloctrl --mux-src-scalers



Håkan T. Johansson <>



trimictrl(1), trloconf(5), vulomflash(1)




This document was created by man2html, using the manual pages.
Time: 04:29:24 GMT, July 10, 2017