org.lsst.ccs.subsystem.rafts

Class DacControl

java.lang.Object

org.lsst.ccs.monitor.Control

org.lsst.ccs.subsystem.rafts.DacControl

All Implemented Interfaces:

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

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

Implements control of the DACs on a REB.

Author:

Owen Saxton

Field Summary

Fields

Modifier and Type	Field and Description
static String	CS_GATE
static String	PCLK_HIGH
static String	PCLK_HIGH_P
static String	PCLK_HIGH_SH
static String	PCLK_LOW
static String	PCLK_LOW_P
static String	PCLK_LOW_SH
static String	RG_HIGH
static String	RG_HIGH_P
static String	RG_HIGH_SH
static String	RG_LOW
static String	RG_LOW_P
static String	RG_LOW_SH
static String	SCLK_HIGH
static String	SCLK_HIGH_P
static String	SCLK_HIGH_SH
static String	SCLK_LOW
static String	SCLK_LOW_P
static String	SCLK_LOW_SH

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

description, devc, hwChan, log, mon

Constructor Summary

Constructors

Constructor and Description
DacControl() Constructor

Method Summary

Modifier and Type	Method and Description
boolean	checkConfig() Checks configuration.
void	clear(int wait, List<REBDevice.AdcData> dataList) Clears (zeroes) all DAC values on the REB.
void	clear(List<REBDevice.AdcData> dataList) Clears (zeroes) all DAC values on the REB.
protected void	configure(org.lsst.ccs.monitor.Monitor mon, org.lsst.ccs.monitor.Device devc) Configures DAC description.
int[]	getCsGate()
int	getHwVersion() Deprecated.
static int	getHwVersion(org.lsst.ccs.drivers.reb.BoardDacs dac) Gets the hardware version.
int	getPclkHigh() Gets the high parallel clock rail DAC value.
double	getPclkHighP() Gets the high parallel clock rail voltage.
int	getPclkHighSh() Gets the high parallel clock rail shift DAC value.
int	getPclkLow() Gets the low parallel clock rail DAC value.
double	getPclkLowP() Gets the low parallel clock rail voltage.
int	getPclkLowSh() Gets the low parallel clock rail shift DAC value.
int	getRgHigh() Gets the high reset gate rail DAC value.
double	getRgHighP() Gets the high reset gate rail voltage.
int	getRgHighSh() Gets the high reset gate rail shift DAC value.
int	getRgLow() Gets the low reset gate rail DAC value.
double	getRgLowP() Gets the low reset gate rail voltage.
int	getRgLowSh() Gets the low reset gate rail shift DAC value.
int	getSclkHigh() Gets the high serial clock rail DAC value.
double	getSclkHighP() Gets the high serial clock rail voltage.
int	getSclkHighSh() Gets the high serial clock rail shift DAC value.
int	getSclkLow() Gets the low serial clock rail DAC value.
double	getSclkLowP() Gets the low serial clock rail voltage.
int	getSclkLowSh() Gets the low serial clock rail shift DAC value.
boolean	isRaw() Gets the raw state.
int	loadChanged(boolean check, List<REBDevice.AdcData> dataList) Loads changed configured DAC values onto the REB.
int	loadChanged(int wait, boolean check, List<REBDevice.AdcData> dataList) Loads changed configured DAC values onto the REB.
int	loadConfig(boolean check, List<REBDevice.AdcData> dataList) Loads configured DAC values onto the REB.
int	loadConfig(int wait, boolean check, List<REBDevice.AdcData> dataList) Loads configured DAC values onto the REB.
void	setCsGate(int[] value) Sets/Gets the current source gates.
void	setPclkHigh(int value) Sets the high parallel clock rail DAC value.
void	setPclkHighMax(double value) Sets the high parallel clock rail voltage maximum.
void	setPclkHighMin(double value) Sets the high parallel clock rail voltage minimum.
void	setPclkHighP(double value) Sets the high parallel clock rail voltage.
void	setPclkHighSh(int value) Sets the high parallel clock rail shift DAC value.
void	setPclkLow(int value) Sets the low parallel clock rail DAC value.
void	setPclkLowMax(double value) Sets the low parallel clock rail voltage maximum.
void	setPclkLowMin(double value) Sets the low parallel clock rail voltage minimum.
void	setPclkLowP(double value) Sets the low parallel clock rail voltage.
void	setPclkLowSh(int value) Sets the low parallel clock rail shift DAC value.
void	setRgHigh(int value) Sets the high reset gate rail DAC value.
void	setRgHighMax(double value) Sets the high reset gate rail voltage maximum.
void	setRgHighMin(double value) Sets the high reset gate rail voltage minimum.
void	setRgHighP(double value) Sets the high reset gate rail voltage.
void	setRgHighSh(int value) Sets the high reset gate rail shift DAC value.
void	setRgLow(int value) Sets the low reset gate rail DAC value.
void	setRgLowMax(double value) Sets the low reset gate rail voltage maximum.
void	setRgLowMin(double value) Sets the low reset gate rail voltage minimum.
void	setRgLowP(double value) Sets the low reset gate rail voltage.
void	setRgLowSh(int value) Sets the low reset gate rail shift DAC value.
void	setSclkHigh(int value) Sets the high serial clock rail DAC value.
void	setSclkHighMax(double value) Sets the high serial clock rail voltage maximum.
void	setSclkHighMin(double value) Sets the high serial clock rail voltage minimum.
void	setSclkHighP(double value) Sets the high serial clock rail voltage.
void	setSclkHighSh(int value) Sets the high serial clock rail shift DAC value.
void	setSclkLow(int value) Sets the low serial clock rail DAC value.
void	setSclkLowMax(double value) Sets the low serial clock rail voltage maximum.
void	setSclkLowMin(double value) Sets the low serial clock rail voltage minimum.
void	setSclkLowP(double value) Sets the low serial clock rail voltage.
void	setSclkLowSh(int value) Sets the low serial clock rail shift DAC value.
boolean	testShorts(List<REBDevice.AdcData> dataList, StringBuilder fcause) Tests for clock lines shorts.
void	validateBulkChange(Map<String,Object> params) Validates configuration changes

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.config.ConfigurationBulkChangeHandler

setParameterBulk

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

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

Field Detail

SCLK_LOW_P

public static final String SCLK_LOW_P

See Also:

Constant Field Values

SCLK_HIGH_P

public static final String SCLK_HIGH_P

See Also:

Constant Field Values

PCLK_LOW_P

public static final String PCLK_LOW_P

See Also:

Constant Field Values

PCLK_HIGH_P

public static final String PCLK_HIGH_P

See Also:

Constant Field Values

RG_LOW_P

public static final String RG_LOW_P

See Also:

Constant Field Values

RG_HIGH_P

public static final String RG_HIGH_P

See Also:

Constant Field Values

SCLK_LOW

public static final String SCLK_LOW

See Also:

Constant Field Values

SCLK_LOW_SH

public static final String SCLK_LOW_SH

See Also:

Constant Field Values

SCLK_HIGH

public static final String SCLK_HIGH

See Also:

Constant Field Values

SCLK_HIGH_SH

public static final String SCLK_HIGH_SH

See Also:

Constant Field Values

PCLK_LOW

public static final String PCLK_LOW

See Also:

Constant Field Values

PCLK_LOW_SH

public static final String PCLK_LOW_SH

See Also:

Constant Field Values

PCLK_HIGH

public static final String PCLK_HIGH

See Also:

Constant Field Values

PCLK_HIGH_SH

public static final String PCLK_HIGH_SH

See Also:

Constant Field Values

RG_LOW

public static final String RG_LOW

See Also:

Constant Field Values

RG_LOW_SH

public static final String RG_LOW_SH

See Also:

Constant Field Values

RG_HIGH

public static final String RG_HIGH

See Also:

Constant Field Values

RG_HIGH_SH

public static final String RG_HIGH_SH

See Also:

Constant Field Values

CS_GATE

public static final String CS_GATE

See Also:

Constant Field Values

Constructor Detail

DacControl

public DacControl()

Constructor

Method Detail

configure

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

Configures DAC 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 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 DACs 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 changes

Specified by:

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

Parameters:

params - Map of parameter values

Throws:

IllegalArgumentException

setPclkLowP

@ConfigurationParameterChanger
public void setPclkLowP(double value)

Sets the low parallel clock rail voltage.

Parameters:

value -

getPclkLowP

public double getPclkLowP()

Gets the low parallel clock rail voltage.

Returns:

The value

setPclkLowMax

@ConfigurationParameterChanger
public void setPclkLowMax(double value)

Sets the low parallel clock rail voltage maximum.

Parameters:

value -

setPclkLowMin

@ConfigurationParameterChanger
public void setPclkLowMin(double value)

Sets the low parallel clock rail voltage minimum.

Parameters:

value -

setPclkLow

@ConfigurationParameterChanger
public void setPclkLow(int value)

Sets the low parallel clock rail DAC value.

Parameters:

value -

getPclkLow

public int getPclkLow()

Gets the low parallel clock rail DAC value.

Returns:

value

setPclkLowSh

@ConfigurationParameterChanger
public void setPclkLowSh(int value)

Sets the low parallel clock rail shift DAC value.

Parameters:

value -

getPclkLowSh

public int getPclkLowSh()

Gets the low parallel clock rail shift DAC value.

Returns:

value

setPclkHighP

@ConfigurationParameterChanger
public void setPclkHighP(double value)

Sets the high parallel clock rail voltage.

Parameters:

value -

getPclkHighP

public double getPclkHighP()

Gets the high parallel clock rail voltage.

Returns:

The value

setPclkHighMax

@ConfigurationParameterChanger
public void setPclkHighMax(double value)

Sets the high parallel clock rail voltage maximum.

Parameters:

value -

setPclkHighMin

@ConfigurationParameterChanger
public void setPclkHighMin(double value)

Sets the high parallel clock rail voltage minimum.

Parameters:

value -

setPclkHigh

@ConfigurationParameterChanger
public void setPclkHigh(int value)

Sets the high parallel clock rail DAC value.

Parameters:

value -

getPclkHigh

public int getPclkHigh()

Gets the high parallel clock rail DAC value.

Returns:

value

setPclkHighSh

@ConfigurationParameterChanger
public void setPclkHighSh(int value)

Sets the high parallel clock rail shift DAC value.

Parameters:

value -

getPclkHighSh

public int getPclkHighSh()

Gets the high parallel clock rail shift DAC value.

Returns:

value

setSclkLowP

@ConfigurationParameterChanger
public void setSclkLowP(double value)

Sets the low serial clock rail voltage.

Parameters:

value -

getSclkLowP

public double getSclkLowP()

Gets the low serial clock rail voltage.

Returns:

The value

setSclkLowMax

@ConfigurationParameterChanger
public void setSclkLowMax(double value)

Sets the low serial clock rail voltage maximum.

Parameters:

value -

setSclkLowMin

@ConfigurationParameterChanger
public void setSclkLowMin(double value)

Sets the low serial clock rail voltage minimum.

Parameters:

value -

setSclkLow

@ConfigurationParameterChanger
public void setSclkLow(int value)

Sets the low serial clock rail DAC value.

Parameters:

value -

getSclkLow

public int getSclkLow()

Gets the low serial clock rail DAC value.

Returns:

value

setSclkLowSh

@ConfigurationParameterChanger
public void setSclkLowSh(int value)

Sets the low serial clock rail shift DAC value.

Parameters:

value -

getSclkLowSh

public int getSclkLowSh()

Gets the low serial clock rail shift DAC value.

Returns:

value

setSclkHighP

@ConfigurationParameterChanger
public void setSclkHighP(double value)

Sets the high serial clock rail voltage.

Parameters:

value -

getSclkHighP

public double getSclkHighP()

Gets the high serial clock rail voltage.

Returns:

value

setSclkHighMax

@ConfigurationParameterChanger
public void setSclkHighMax(double value)

Sets the high serial clock rail voltage maximum.

Parameters:

value -

setSclkHighMin

@ConfigurationParameterChanger
public void setSclkHighMin(double value)

Sets the high serial clock rail voltage minimum.

Parameters:

value -

setSclkHigh

@ConfigurationParameterChanger
public void setSclkHigh(int value)

Sets the high serial clock rail DAC value.

Parameters:

value -

getSclkHigh

public int getSclkHigh()

Gets the high serial clock rail DAC value.

Returns:

value

setSclkHighSh

@ConfigurationParameterChanger
public void setSclkHighSh(int value)

Sets the high serial clock rail shift DAC value.

Parameters:

value -

getSclkHighSh

public int getSclkHighSh()

Gets the high serial clock rail shift DAC value.

Returns:

value

setRgLowP

@ConfigurationParameterChanger
public void setRgLowP(double value)

Sets the low reset gate rail voltage.

Parameters:

value -

getRgLowP

public double getRgLowP()

Gets the low reset gate rail voltage.

Returns:

The value

setRgLowMax

@ConfigurationParameterChanger
public void setRgLowMax(double value)

Sets the low reset gate rail voltage maximum.

Parameters:

value -

setRgLowMin

@ConfigurationParameterChanger
public void setRgLowMin(double value)

Sets the low reset gate rail voltage minimum.

Parameters:

value -

setRgLow

@ConfigurationParameterChanger
public void setRgLow(int value)

Sets the low reset gate rail DAC value.

Parameters:

value -

getRgLow

public int getRgLow()

Gets the low reset gate rail DAC value.

Returns:

value

setRgLowSh

@ConfigurationParameterChanger
public void setRgLowSh(int value)

Sets the low reset gate rail shift DAC value.

Parameters:

value -

getRgLowSh

public int getRgLowSh()

Gets the low reset gate rail shift DAC value.

Returns:

value

setRgHighP

@ConfigurationParameterChanger
public void setRgHighP(double value)

Sets the high reset gate rail voltage.

Parameters:

value -

getRgHighP

public double getRgHighP()

Gets the high reset gate rail voltage.

Returns:

The value

setRgHighMax

@ConfigurationParameterChanger
public void setRgHighMax(double value)

Sets the high reset gate rail voltage maximum.

Parameters:

value -

setRgHighMin

@ConfigurationParameterChanger
public void setRgHighMin(double value)

Sets the high reset gate rail voltage minimum.

Parameters:

value -

setRgHigh

@ConfigurationParameterChanger
public void setRgHigh(int value)

Sets the high reset gate rail DAC value.

Parameters:

value -

getRgHigh

public int getRgHigh()

Gets the high reset gate rail DAC value.

Returns:

value

setRgHighSh

@ConfigurationParameterChanger
public void setRgHighSh(int value)

Sets the high reset gate rail shift DAC value.

Parameters:

value -

getRgHighSh

public int getRgHighSh()

Gets the high reset gate rail shift DAC value.

Returns:

value

setCsGate

@ConfigurationParameterChanger
public void setCsGate(int[] value)

Sets/Gets the current source gates.

Parameters:

value -

getCsGate

public int[] getCsGate()

loadConfig

public int loadConfig(boolean check,
                      List<REBDevice.AdcData> dataList)
               throws RaftException

Loads configured DAC values onto the REB.

Parameters:

check - Whether to check the read-back value

dataList - List to receive values from power & slow ADCs

Returns:

The number of DACs loaded

Throws:

RaftException

loadConfig

public int loadConfig(int wait,
                      boolean check,
                      List<REBDevice.AdcData> dataList)
               throws RaftException

Loads configured DAC values onto the REB.

Parameters:

wait - The time to wait after loading a DAC (ms)

check - Whether to check the read-back value

dataList - List to receive read-back values

Returns:

The number of DACs loaded

Throws:

RaftException - Note: LCA-10064 order is SclkLow, SclkHigh, PclkLow, PclkHigh, RgLow, RgHigh

loadChanged

public int loadChanged(boolean check,
                       List<REBDevice.AdcData> dataList)
                throws RaftException

Loads changed configured DAC values onto the REB.

Parameters:

check - Whether to check the read-back value

dataList - List to receive read-back values

Returns:

The number of DACs loaded

Throws:

RaftException

loadChanged

public int loadChanged(int wait,
                       boolean check,
                       List<REBDevice.AdcData> dataList)
                throws RaftException

Loads changed configured DAC values onto the REB.

Parameters:

wait - The time to wait after loading a DAC (ms)

check - Whether to check the read-back value

dataList - List to receive read-back values

Returns:

The number of DACs loaded

Throws:

RaftException - Note: LCA-10064 order is SclkLow, SclkHigh, PclkLow, PclkHigh, RgLow, RgHigh

clear

public void clear(List<REBDevice.AdcData> dataList)
           throws RaftException

Clears (zeroes) all DAC values on the REB.

Parameters:

dataList - A list to receive read ADC values

Throws:

RaftException

clear

public void clear(int wait,
                  List<REBDevice.AdcData> dataList)
           throws RaftException

Clears (zeroes) all DAC values on the REB.

Parameters:

wait - The time to wait after loading a DAC (ms)

dataList - A list to receive read ADC values

Throws:

RaftException

testShorts

public boolean testShorts(List<REBDevice.AdcData> dataList,
                          StringBuilder fcause)
                   throws RaftException

Tests for clock lines shorts.

Parameters:

dataList - A list to receive read ADC values

fcause - A StringBuilder to append any failure cause to

Returns:

Whether the test failed

Throws:

RaftException