org.lsst.ccs.subsystem.rafts

Class BiasControl

java.lang.Object

org.lsst.ccs.monitor.Control

org.lsst.ccs.subsystem.rafts.BiasControl

All Implemented Interfaces:

org.lsst.ccs.config.ConfigurationBulkChangeHandler, org.lsst.ccs.framework.HasLifecycle

public class BiasControl
extends org.lsst.ccs.monitor.Control
implements org.lsst.ccs.config.ConfigurationBulkChangeHandler

Implements control of CCD biases and CS gate.

Author:

Owen Saxton

Field Summary

Fields

Modifier and Type	Field and Description
static String	CS_GATE Constants.
static String	CS_GATE_P Constants.
static String	GD Constants.
static String	GD_P Constants.
static String	OD Constants.
static String	OD_P Constants.
static String	OG Constants.
static String	OG_P Constants.
static String	OG_SH Constants.
static String	RD Constants.
static String	RD_P Constants.

Fields inherited from class org.lsst.ccs.monitor.Control

description, devc, hwChan, log, mon

Constructor Summary

Constructors

Constructor and Description
BiasControl() Constructor.

Method Summary

Modifier and Type	Method and Description
int	checkBiasStepLimits(double[] slowAdcs, List<String> tmsgList) Measure BiasDac offsets to prepare for a jump
boolean	checkConfig() Checks configuration.
protected void	configure(org.lsst.ccs.monitor.Monitor mon, org.lsst.ccs.monitor.Device devc) Configures channel description.
int	getBiasDacsPowerState(double[] slowAdcs, List<String> tmsgList) Checks whether Bias voltage values are ON, OFF, DELTA
String	getChanged() Gets the changed variable value
int	getCsGate() Gets the Current Source gate DAC value.
double	getCsGateP() Gets the Current Source gate current.
int	getGd() Gets the Guard Diode DAC value.
double	getGdP() Gets the Guard Diode voltage.
int	getHwVersion() Deprecated.
static int	getHwVersion(org.lsst.ccs.drivers.reb.BoardDacs dac) Gets the hardware version.
int	getOd() Gets the Output Drain DAC value.
double	getOdP() Gets the Output Drain voltage.
int	getOg() Gets the Output Gate DAC value.
double	getOgP() Gets the Output Gate voltage.
int	getOgSh() Gets the Output Gate shift DAC value.
int	getRd() Gets the Reset Drain DAC value.
double	getRdP() Gets the Reset Drain voltage.
boolean	isRaw() Gets the raw state.
int	setBiasDacsCalibration(double[] slowAdcs, List<String> tmsgList, boolean action) Measure and Set BiasDac Calibration to converge measured and configured voltages
void	setCsGate(int value) Sets the Current Source gate DAC value.
void	setCsGateP(double value) Sets the Current Source gate current.
void	setGd(int value) Sets the Guard Diode DAC value.
void	setGdMax(double value) Sets the Guard Diode voltage maximum.
void	setGdMin(double value) Sets the Guard Diode voltage minimum.
void	setGdP(double value) Sets the Guard Diode voltage.
void	setOd(int value) Sets the Output Drain DAC value.
void	setOdMax(double value) Sets the Output Drain voltage maximum.
void	setOdMin(double value) Sets the Output Drain voltage minimum.
void	setOdP(double value) Sets the Output Drain voltage.
void	setOg(int value) Sets the Output Gate DAC value.
void	setOgMax(double value) Sets the Output Gate voltage maximum.
void	setOgMin(double value) Sets the Output Gate voltage minimum.
void	setOgP(double value) Sets the Output Gate voltage.
void	setOgSh(int value) Sets the Output Gate shift DAC value.
void	setParameterBulk(Map<String,Object> params) Augments setting of parameters to trigger CCDsPowerState update Parameters are set by ConfigurationChanger methods If parameters match the pattern the rebDevice updateCCDsPowerState flag is set If parameters match the pattern the matching bits in this.changed are set
void	setRd(int value) Sets the Reset Drain DAC value.
void	setRdMax(double value) Sets the Reset Drain voltage maximum.
void	setRdMin(double value) Sets the Reset Drain voltage minimum.
void	setRdP(double value) Sets the Reset Drain voltage.
boolean	testShorts(List<REBDevice.AdcData> dataList, List<String> tmsgList) Tests for biases shorts.
void	validateBulkChange(Map<String,Object> params) Validates configuration parameter change.

Methods inherited from class org.lsst.ccs.monitor.Control

checkOnline, checkTimeout, getDescription, getHwChan, getName, getSubsystem, init, testOnline

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.lsst.ccs.framework.HasLifecycle

build, postBuild, postInit, postShutdown, postStart, shutdown, start

Field Detail

GD_P

public static final String GD_P

Constants.

See Also:

Constant Field Values

OD_P

public static final String OD_P

Constants.

See Also:

Constant Field Values

OG_P

public static final String OG_P

Constants.

See Also:

Constant Field Values

RD_P

public static final String RD_P

Constants.

See Also:

Constant Field Values

CS_GATE_P

public static final String CS_GATE_P

Constants.

See Also:

Constant Field Values

GD

public static final String GD

Constants.

See Also:

Constant Field Values

OD

public static final String OD

Constants.

See Also:

Constant Field Values

OG

public static final String OG

Constants.

See Also:

Constant Field Values

OG_SH

public static final String OG_SH

Constants.

See Also:

Constant Field Values

RD

public static final String RD

Constants.

See Also:

Constant Field Values

CS_GATE

public static final String CS_GATE

Constants.

See Also:

Constant Field Values

Constructor Detail

BiasControl

public BiasControl()

Constructor.

Method Detail

configure

protected void configure(org.lsst.ccs.monitor.Monitor mon,
                         org.lsst.ccs.monitor.Device devc)

Configures channel description.

Overrides:

configure in class org.lsst.ccs.monitor.Control

Parameters:

mon - The associated monitor object

devc - The associated device object

checkConfig

public boolean checkConfig()

Checks configuration.

Returns:

Whether configuration is okay

isRaw

public boolean isRaw()

Gets the raw state.

Returns:

Whether configuration data are raw ADC values

getHwVersion

public static int getHwVersion(org.lsst.ccs.drivers.reb.BoardDacs dac)

Gets the hardware version.

Parameters:

dac - The board DAC object

Returns:

The hardware version

getHwVersion

@Deprecated
public int getHwVersion()

Deprecated.

Gets the hardware version.

Returns:

The hardware version

validateBulkChange

public void validateBulkChange(Map<String,Object> params)
                        throws IllegalArgumentException

Validates configuration parameter change.

Specified by:

validateBulkChange in interface org.lsst.ccs.config.ConfigurationBulkChangeHandler

Parameters:

params - The map of configuration parameter values

Throws:

IllegalArgumentException

setParameterBulk

public void setParameterBulk(Map<String,Object> params)
                      throws IllegalArgumentException

Augments setting of parameters to trigger CCDsPowerState update Parameters are set by ConfigurationChanger methods If parameters match the pattern the rebDevice updateCCDsPowerState flag is set If parameters match the pattern the matching bits in this.changed are set

Specified by:

setParameterBulk in interface org.lsst.ccs.config.ConfigurationBulkChangeHandler

Parameters:

params - The map of configuration parameter values

Throws:

IllegalArgumentException

getChanged

@Command(type=QUERY,
         description="Get the changed variable value")
public String getChanged()

Gets the changed variable value

Returns:

The value

setGdP

@ConfigurationParameterChanger
public void setGdP(double value)

Sets the Guard Diode voltage.

Parameters:

value -

getGdP

@Command(type=QUERY,
         description="Get the Guard Diode voltage")
public double getGdP()

Gets the Guard Diode voltage.

Returns:

The value

setGdMax

@ConfigurationParameterChanger
public void setGdMax(double value)

Sets the Guard Diode voltage maximum.

Parameters:

value -

setGdMin

@ConfigurationParameterChanger
public void setGdMin(double value)

Sets the Guard Diode voltage minimum.

Parameters:

value -

setGd

@ConfigurationParameterChanger
public void setGd(int value)

Sets the Guard Diode DAC value.

Parameters:

value -

getGd

@Command(type=QUERY,
         description="Get the Guard Diode DAC value")
public int getGd()

Gets the Guard Diode DAC value.

Returns:

value

setOdP

@ConfigurationParameterChanger
public void setOdP(double value)

Sets the Output Drain voltage.

Parameters:

value -

getOdP

@Command(type=QUERY,
         description="Get the readout mode Output Drain voltage")
public double getOdP()

Gets the Output Drain voltage.

Returns:

The value

setOdMax

@ConfigurationParameterChanger
public void setOdMax(double value)

Sets the Output Drain voltage maximum.

Parameters:

value -

setOdMin

@ConfigurationParameterChanger
public void setOdMin(double value)

Sets the Output Drain voltage minimum.

Parameters:

value -

setOd

@ConfigurationParameterChanger
public void setOd(int value)

Sets the Output Drain DAC value.

Parameters:

value -

getOd

@Command(type=QUERY,
         description="Get the readout mode Output Drain DAC value")
public int getOd()

Gets the Output Drain DAC value.

Returns:

value

setOgP

@ConfigurationParameterChanger
public void setOgP(double value)

Sets the Output Gate voltage.

Parameters:

value -

getOgP

@Command(type=QUERY,
         description="Get the Output Gate voltage")
public double getOgP()

Gets the Output Gate voltage.

Returns:

The value

setOgMax

@ConfigurationParameterChanger
public void setOgMax(double value)

Sets the Output Gate voltage maximum.

Parameters:

value -

setOgMin

@ConfigurationParameterChanger
public void setOgMin(double value)

Sets the Output Gate voltage minimum.

Parameters:

value -

setOg

@ConfigurationParameterChanger
public void setOg(int value)

Sets the Output Gate DAC value.

Parameters:

value -

getOg

@Command(type=QUERY,
         description="Get the Output Gate DAC value")
public int getOg()

Gets the Output Gate DAC value.

Returns:

value

setOgSh

@ConfigurationParameterChanger
public void setOgSh(int value)

Sets the Output Gate shift DAC value.

Parameters:

value -

getOgSh

@Command(type=QUERY,
         description="Get the Output Gate shift DAC value")
public int getOgSh()

Gets the Output Gate shift DAC value.

Returns:

value

setRdP

@ConfigurationParameterChanger
public void setRdP(double value)

Sets the Reset Drain voltage.

Parameters:

value -

getRdP

@Command(type=QUERY,
         description="Get the Reset Drain voltage")
public double getRdP()

Gets the Reset Drain voltage.

Returns:

The value

setRdMax

@ConfigurationParameterChanger
public void setRdMax(double value)

Sets the Reset Drain voltage maximum.

Parameters:

value -

setRdMin

@ConfigurationParameterChanger
public void setRdMin(double value)

Sets the Reset Drain voltage minimum.

Parameters:

value -

setRd

@ConfigurationParameterChanger
public void setRd(int value)

Sets the Reset Drain DAC value.

Parameters:

value -

getRd

@Command(type=QUERY,
         description="Get the Reset Drain DAC value")
public int getRd()

Gets the Reset Drain DAC value.

Returns:

value

setCsGateP

@ConfigurationParameterChanger
public void setCsGateP(double value)

Sets the Current Source gate current.

Parameters:

value -

getCsGateP

@Command(type=QUERY,
         description="Get the Current Source gate")
public double getCsGateP()

Gets the Current Source gate current.

Returns:

The value

setCsGate

@ConfigurationParameterChanger
public void setCsGate(int value)

Sets the Current Source gate DAC value.

Parameters:

value -

getCsGate

@Command(type=QUERY,
         description="Get the Current Source gate")
public int getCsGate()

Gets the Current Source gate DAC value.

Returns:

value

testShorts

public boolean testShorts(List<REBDevice.AdcData> dataList,
                          List<String> tmsgList)
                   throws RaftException

Tests for biases shorts.

Parameters:

dataList - A list to receive read ADC values

tmsgList - A list of strings to contain messages

Returns:

Whether the test failed

Throws:

RaftException - Note OD not in test: driver doesn't turn on below ~15V

getBiasDacsPowerState

public int getBiasDacsPowerState(double[] slowAdcs,
                                 List<String> tmsgList)

Checks whether Bias voltage values are ON, OFF, DELTA

Parameters:

slowAdcs[] - array of values measued in REBDevice

tmsgList - List to contain test messages

Returns:

powerState On=1; Off=0; ;DELTA>1, error=-1

Throws:

RaftException

setBiasDacsCalibration

public int setBiasDacsCalibration(double[] slowAdcs,
                                  List<String> tmsgList,
                                  boolean action)

Measure and Set BiasDac Calibration to converge measured and configured voltages

Parameters:

slowAdcs - array of measured voltages for CCD biases

tmsgList - List to contain results returned to caller

action - true|false to actually submit config changes returns 0 on success or a count of errors (voltages with out of range offsets)

checkBiasStepLimits

public int checkBiasStepLimits(double[] slowAdcs,
                               List<String> tmsgList)

Measure BiasDac offsets to prepare for a jump

Parameters:

slowAdcs - array of measured voltages for CCD biases

tmsgList - List to contain results returned to caller

Returns:

true|false on okay to jump (step is less than maxStep)