Starting and using TDUControl » History » Version 6

Version 5 (Thomas Dealtry, 08/08/2014 04:09 PM) → Version 6/21 (Thomas Dealtry, 01/30/2015 04:18 AM)


h1. Getting help

Email Tom Dealtry -

h1. Overview

The following are instructions on how to communicate with the NOvA timing distrubution unit (TDU). The TDU distributes timing information throughout the system, handles synchronisation between boards,
Starting and includes automatic propagation delay calculation & compensation. using TDUControl

There are various ways to communicate:

* Through lbnerc & daqinterface (coming soon)
* Booting up an xmlrpc server & commuicating through this
* Communicating with the TDU directly

h1. List of commands (to be expanded)

All 'get', 'do', and 'read' commands return an error code with a common numbering scheme.

h2. 'get' commands

* <code>get_status()</code>
Returns [error_code, ready_to_do]. When ready_to_do is True, the control register can be modified (i.e. a 'do' command can be performed)

h2. 'do' commands

* <code>do_ping()</code>
ping the TDU

* <code>do_time_sync()</code>
Perform a time synchronisation (this calls <code>get_status()</code> internally)

* <code>do_delay_calc()</code>
Perform a propagation delay calculation (this calls <code>get_status()</code> internally)

* <code>do_send_sync_pulse()</code>
Send a sync pulse (this calls <code>get_status()</code> internally)

* <code>debug_do_write_control_reg(data_to_or)</code>
Write the control register to perform a none standard operation (this calls <code>get_status()</code> internally)

h2. 'read' commands

* <code>read_tdu_id()</code>
Read out the TDU version & ID numbers

* <code>read_tdu_status()</code>
Read out the TDU's current operating conditions (current, voltage, temperature, fan status, FPGA status)

* <code>read_gps_status()</code>
Read out the GPS status (faults, timeouts, sat count, etc. + current UTC time)

* <code>read_error_registers()</code>
Read out the error registers

* <code>read_control_reg()</code>
Read out the control register

* <code>debug_read_all_registers()</code>
Read out all the registers. Also comes with some hints on what the 'default' for normal operating conditions is.

h2. Other commands

* <code>close_socket()</code>

* print_log
Will be made private

h2. Error codes


h1. List of TDU IP addresses (to be expanded)

* Master:
* Slave:

h1. Using the NOvA GUI (TDUControl) - OLD & BROKEN

To start TDUControl, use the following steps:

# log into the <code>lbnedaq</code> account on <code>lbne35t-gateway01</code>
# <code>source /data/lbnedaq/novadaq/setup/</code> <code>'source /data/lbnedaq/novadaq/setup/'</code>
# <code>TDUControl -m</code> <code>'TDUControl -m'</code>
# enter the IP address of the Master TDU into the GUI (

Alternatively for steps 3 & 4, you can run <code>TDUControl <code>'TDUControl -m -t</code>'</code>

The IP addresses of the TDU's are:
* Master:
* Slave: