photons.equipment.arroyo_6305 module

ComboSource 6305 laser-diode controller from Arroyo Instruments.

class photons.equipment.arroyo_6305.ComboSource(record, **kwargs)

Bases: BaseEquipment

ComboSource 6305 laser-diode controller from Arroyo Instruments.

Parameters:

• record (EquipmentRecord) – The equipment record.

• **kwargs – Keyword arguments. Can be specified as attributes of an XML element in a configuration file (with the tag of the element equal to the alias of record).

connection: ConnectionMessageBased

CURRENT_LIMIT = 1

VOLTAGE_LIMIT = 2

SENSOR_LIMIT = 4

PHOTODIODE_CURRENT_LIMIT = 4

PHOTODIODE_POWER_LIMIT = 8

TEMPERATURE_HIGH_LIMIT = 8

TEMPERATURE_LOW_LIMIT = 16

INTERLOCK_DISABLED = 16

SENSOR_SHORTED = 32

SENSOR_OPEN = 64

OPEN_CIRCUIT = 128

LASER_SHORT_CIRCUIT = 256

OUT_OF_TOLERANCE = 512

OUTPUT_ON = 1024

THERMAL_RUN_AWAY = 4096

R_LIMIT = 8192

T_LIMIT = 16384

clear()

Clears the standard event status register, all event registers, and the error queue.

Return type:

None

condition_register_laser()

Returns the condition-register value of the laser.

Bit	Value	Description
0	1	Current limit
1	2	Voltage limit
2	4	Photodiode current limit
3	8	Photodiode power limit
4	16	Interlock disabled
5	32	Unused
6	64	Unused
7	128	Laser open circuit
8	256	Laser short circuit
9	512	Out of tolerance
10	1024	Output on
11	2048	Unused
12	4096	Unused
13	8192	R limit
14	16384	T limit
15	32768	Unused

Return type:

int

condition_register_tec()

Returns the condition-register value of the TEC.

Bit	Value	Description
0	1	Current limit
1	2	Voltage limit
2	4	Sensor limit
3	8	Temperature high limit
4	16	Temperature low limit
5	32	Sensor shorted
6	64	Sensor open
7	128	TEC open circuit
8	256	Unused
9	512	Out of tolerance
10	1024	Output on
11	2048	Unused
12	4096	Thermal run-away
13	8192	Unused
14	16384	Unused
15	32768	Unused

Return type:

int

disable_error_checking()

Disable error checking.

Return type:

None

enable_error_checking()

Enable error checking.

Return type:

None

get_laser_current()

Returns the applied current (in milliamps) to the laser diode.

Return type:

float

get_laser_current_setpoint()

Returns the setpoint current (in milliamps) of the laser diode.

Return type:

float

get_laser_temperature()

Returns the temperature (in Celsius) of the laser diode.

Return type:

float

get_laser_tolerance()

Returns the tolerance (in milliamps) and the time window (in seconds) that is required to achieve tolerance.

Return type:

tuple[float, float]

get_tec_temperature_setpoint()

Returns the setpoint temperature of the TEC.

Return type:

float

get_tec_tolerance()

Returns the tolerance value (in Celsius) and the time window (in seconds) that is required to achieve tolerance.

Return type:

tuple[float, float]

is_laser_enabled()

Checks if the laser is lasing.

Return type:

bool

is_tec_enabled()

Checks if the TEC is enabled or disabled.

Return type:

bool

laser_off()

Turn the laser output off.

Return type:

None

laser_on(*, wait=True, timeout=120)

Turn the laser output on.

Parameters:

• wait (bool) – Whether to wait for the laser diode current and temperature to stabilize before returning to the calling program.

• timeout (float) – The maximum number of seconds to wait before raising an exception.

Return type:

None

photodiode_current()

Returns the current (in uA) of the monitoring photodiode.

Return type:

float

set_laser_current(milliamps, *, wait=True, timeout=120)

Set the laser diode current.

Parameters:

• milliamps (float) – The laser diode setpoint current, in mA.

• wait (bool) – Whether to wait for the laser diode current and temperature to stabilize before returning to the calling program.

• timeout (float) – The maximum number of seconds to wait before raising an exception.

Return type:

None

set_laser_tolerance(tolerance, duration)

Set the laser tolerance criteria.

Allows control over when the output of the laser driver is considered in tolerance (or stable), in order to satisfy the tolerance condition of the operation complete definition.

Parameters:

• tolerance (float) – Tolerance value (in milliamps) for the measured laser diode current to be within the setpoint. Must be between 0 and 100.

• duration (float) – The measured current must be within the setpoint value plus or minus the tolerance value for duration seconds. Must be between 0.1 and 50 seconds.

Return type:

None

set_tec_temperature(celsius, *, wait=True, timeout=120)

Set the laser diode current.

Parameters:

• celsius (float) – The TEC temperature, in Celsius.

• wait (bool) – Whether to wait for the laser diode current and temperature to stabilize before returning to the calling program.

• timeout (float) – The maximum number of seconds to wait before raising an exception.

Return type:

None

set_tec_tolerance(tolerance, duration)

Set the TEC tolerance criteria.

Allows control over when the output of the temperature controller is considered in tolerance (or stable), in order to satisfy the tolerance condition of the operation complete definition.

Parameters:

• tolerance (float) – Tolerance value, in Celsius, for the measured laser temperature to be within the setpoint. Must be between 0.01 and 10.

• duration (float) – The measured temperature must be within the setpoint value plus or minus the tolerance value for duration seconds. Must be between 0.1 and 50 seconds.

Return type:

None

tec_off()

Disable TEC control.

Return type:

None

tec_on(*, wait=True, timeout=120)

Enable TEC control.

Parameters:

• wait (bool) – Whether to wait for the laser diode current and temperature to stabilize before returning to the calling program.

• timeout (float) – The maximum number of seconds to wait before raising an exception.

Return type:

None

wait(timeout=120)

Wait for the laser diode current and temperature to be stable.

The condition-register value must be okay and the laser diode current and temperature values must be within tolerance of the setpoint value.

Parameters:

timeout (float) – The maximum number of seconds to wait before raising an exception.

Return type:

None