HV System Linux Control Software Instructions

Victor Barashko <barvic@ufl.edu>

(Draft 04/19/2005)

Initial HV System startup sequence

• Turn on Primary Power Supply, Master Crate and Distribution Crate.
• Turn on Control PC
• Wait until computer boots and shows graphical login screen
• Log in using “hvuser” account.

Restart driver for HV Interface cards.

• Open X-terminal or console application
• Log in as “root” using ‘su’ command
• Run command ‘/etc/init.d/hvcard stop’ to stop driver
• Run command ‘/etc/init.d/hvcard start’ to start driver
• Exit from “root” account using ‘exit’ command

Start DIM services for HV System

• In terminal window run command ‘~hvuser/dim/linux/dns’
• Open new terminal window
• Start HV DIM server application using command ‘hvServerNew –p –m –a –l’

HV System control client application

Usage: hvClientNew -[options]

Options:

-h(-?) show this usage info

-nN set hostcard address (default 0)

-aN set module address N (0..15)

-bN set module type to (0-NONE, 1-MASTER, 2-RDB30, 3-RDB36, 4-MON30, 5-MON36)

-cN set module channel (N > 36 set ALL channels mode)

-oN set module state (0-OFF, 1-ON)

-sN set module state or channel state (with -c) (0-OFF, 1-ON)

-r reset trip state condition

-vN set voltage in Volts (0..4000)

-tN set maximum trip current level mkA (1..1500)

-jN set trip delay in msec

-kN set linked master trip delay in msec

-uN set ramp up speed in Volts (1..4000)

-dN set ramp down speed in Volts (1..4000)

-fN set relay state for master board (0-OFF, >0-ON

-z disable calibration data, raw DAC-ADC mode

-wN saving of data from module in file mode (0-OFF, >0-ON

-p display monitored values from modules

-g set Primary Supply Control mode

Addressing

To access HV System boards 2 adressing modes could be used

1. Low Level Addressing mode – Primary Power Supply, Master Board and Distribution Board can be accessed independently using following addressing scheme

For Master and Distribution Boards:

-nN ,where N is HostCard address (logical number of PCI Interface HostCard inserted into Control PC and to which control cable for appropriate board is attached)

-aN , where N is module address on control bus (number in range 0-15, which corresponds to assigned rotary switch position on front panel of Master and Distribution Boards)

For Primary Power Supply (when using option –g):

-nN , where N is serial port (logical number which represent COM (serial) port number, starting from 0, to which Primary Power Supply RS232-Fiber adapter is attached

-aN , where N is GPIB address (GPIB address which is assigned to Primary Power Supply and which is defined by switches on GPIB interface adapter box)

Examples of addressing:

‘hvClientNew –n0 –a5’ - access Master or Distribution module controlled by HostCard with logical number 0 with assigned module address 5

‘hvClientNew –n1 –a15’ – access Master or Distribution module controlled by HostCard with logical number 1 with assigned module address 15

‘hvClientNew –n0 –a2 –g’ - access Primary Power Supply controlled by GPIB interface which is connected to serial port COM1 and with assigned GPIB address 2

2. High Level Addressing mode – Related Primary Power Supply, Master Board and Distribution Board are controlled as one board (CMS EMU Muon chamber) using predefined mapping between chamber name and Distribution Board ID

Example of addressing:

‘hvClientNew ME+2/2/15’ – access chamber ME+2/2/15 (control Distribution Board, Master Board channel to which Distribution Board is connected via SHV cable and control Primary Power Supply to which Master Board is connected)

Set and Display operation Modes

There are 2 modes of setting and displaying of voltage and current values for Master and Distribution HV System boards (Primary Power Supply use only volts and mkA)

• “Standard” mode (by default) – values of currents and voltages are set and displayed as mkA and Volts correspondently (conversion with calibration coefficients is used)

• “Raw” mode (with option –z) – values of currents and voltages are set and displayed as actual values of onboard DACs and ADCs.

NOTE: Use “Raw” mode only when using Low Level Addressing mode

Examples:

‘hvClientNew –n0 –a0 –v1000’ or

‘hvClient ME+2/2/15 –v1000’ // set output voltage to 1000V

‘hvClientNew –n0 –a0 –t10’ or

‘hvClient ME+2/2/15 –t10’ // set maximum current trip level to 10mkA

‘hvClientNew –n0 –a0 –u100 –z’ // set voltage ramp-up speed to 100 DAC counts

‘hvClientNew –n0 –a0 –p –z’ // display monitored voltages and currents as ADC values

‘hvClientNew –n0 –a0 –p’ // display monitored voltages and currents as volts and mkA

Voltage control options

• To set output voltage use option -vN, where N should be in range (0-4000)
• To set ramp-up speed use option –uN, where N should be in range (1-4000)
• To set ramp-down speed use option –dN, where N should be in range (1-4000)

NOTE: When using “Standard” mode, the displayed set values for output voltage, ramp-up, ramp-down speed could differ +/-2V from values which are set via mentioned above command options, because of round-up after conversion from DAC-ADC values to voltage values using calibration coefficients.

Example:

‘hvClientNew –n0 –a0 –v2600 –u15 –d100’ // set output voltage to 2600V, ramp-up speed to 15V, ramp-down speed to 100V

Trip current control options

· To set maximum current trip level use option –tN, where N

o in “Standard” mode:

- for Distribution Boards should be in range 1-100mkA (1mkA step)

- for Master Boards should be in range 1-1500mkA

o in “Raw” mode

- for Master and Distribution Boards should be in range 1-4000 ADC counts.

NOTE: Current measurement scheme use the reverse scale, it means that a ADC value of 1 corresponds to the maximum current

· To set trip delay use option –jN, where N should be in range 20-20000msec (20msec step)

Example:

‘hvClientNew –n0 –a0 –t10 –j100’ // set trip level to 10mkA and trip delay to 100msec

Channel control option

To manipulate individual channels use option -cN ,where N is channel number 1..36  (you could use multiple -c parameters in command line)

Module and Channel state control options

-sN (N=0-1) - set channel state or set all channels state, if -c option is omitted  (0-OFF, 1-ON)
-oN (N=0-1) - set module state (0-OFF, 1-ON)

Examples:
’hvClientNew -n0 -a1 -s1’ // turn on all channels on module and set module state to on
’hvClientNew -n0 -a1 -s0‘ // turn off all channels on module and set module state to off
’hvClientNew -n0 -a1 -c10 -s1 -o1’ // turn on channel 10 and set module state to on
’hvClientNew -n0 -a1 -c10 -s0’ // turn off channel 10
’hvClientNew -n0 -a1 -c2 -c5 -c10 -s1 -o1’ // turn on channels 2,5,10
’hvClientNew -n0 -a1 -c2 -c5 -c10 -s0’ // turn off channels 2,5,10

Other options

To display periodically updated data from module use –p option (use Ctrl-C to exit).

To disable/enable write to files with ~20Hz rate, ADC values of monitored voltages and currents from module use option –wN (where N=0 – enable writing, 1 – disable)

To reset last trip current and voltage values use –r option

Example of typical work session with one module using High Level addressing mode

‘hvClientNew ME+2/2/15 –v2000 –u10 –d100 –t10 –j100’ // set initial voltage, ramp-up, ramp-down, trip level and trip delay for all channels on module

‘hvClientNew ME+2/2/15 –s1’ // change module state to ON (module start to do voltage ramp-up)

‘hvClientNew ME+2/2/15 –c10 –c20 –v2800’ // set voltage on channel ##10,20 to 2800V

‘hvClientNew ME+2/2/15 –t1’ // change trip level to 1mkA

‘hvClientNew ME+2/2/15 –p –w1’ // display monitored data from module and enable writing to file voltages and currents data

‘hvClientNew ME+2/2/15 –w0’ // disable writing to file voltages and currents data

‘hvClientNew ME+2/2/15 –s0’ // change module state to OFF (output voltage on module will be set to 0V)

Screenshot of typical module data display when using option –p in Low Level Addressing mode

(in this case command line was ‘hvClientNew –n1 –a3 –p’)