Regatron.Source

Code author: Kevin Kennedy <protonyx@users.noreply.github.com>

Connecting to the Instrument

The Regatron sources can be outfitted with Ethernet-to-USB adapters for use with the TopCon software. In order to connect to the source with an adapter installed, you must install the drivers so that the device appears as a local COM port to the operating system.

class labtronyx.drivers.Regatron.Source.d_TopCon(resource, **kwargs)[source]

Driver for Regatron TopCon compatible Power Supplies

clearErrors()[source]

Clear all errors and warnings. In a multi-unit system the errors and warnings of all slave units will be cleared as well.

getFirmwareVersion()[source]

Get the firmware version

Returns:str
getMode()[source]

Returns the mode of the selected unit. Select a unit using selectUnit.

Possible values:

  • ‘cv’: Constant Voltage
  • ‘cc’: Constant Current
  • ‘cp’: Constant Power
  • ‘ulim’: Usense limit active
  • ‘plim’: Psense limit active
  • ‘cder’: Current derating active
Returns:str
getModuleCurrentRange()[source]

Get the minimum and maximum current levels for the currently selected module.

Units: A

Returns:tuple (minimum, maximum)
getModulePowerRange()[source]

Get the minimum and maximum power levels for the currently selected module.

Units: kW

Returns:tuple (minimum, maximum)
getModuleVoltageRange()[source]

Get the minimum and maximum voltage levels for the currently selected module.

Units: V

Returns:tuple (minimum, maximum)
getSerialNumber()[source]

Get the firmware serial number.

Returns:str
getState()[source]

Returns the state of the selected unit. Select a unit using selectUnit.

Possible values with Voltage OFF:

  • ‘POWERUP’
  • ‘READY’
  • ‘ERROR’
  • ‘STOP’

Possible values with Voltage ON:

  • ‘RUN’
  • ‘WARN’
Returns:str
getSystemCurrentRange()[source]

Get the minimum and maximum system current levels

Units: A

Returns:tuple (minimum, maximum)
getSystemPowerRange()[source]

Get the minimum and maximum system power levels

Units: kW

Returns:tuple (minimum, maximum)
getSystemVoltageRange()[source]

Get the minimum and maximum system voltage levels

Units: V

Returns:tuple (minimum, maximum)
getTerminalCurrent()[source]

Get the actual system output current

Note:

The module select should be set to system using:  `selectUnit(64)`
Returns:float
getTerminalPower()[source]

Get the actual system output power

Note:

The module select should be set to system using:  `selectUnit(64)`
Returns:float
getTerminalVoltage()[source]

Get the actual system output voltage

Note:

The module select should be set to system using:  `selectUnit(64)`
Returns:float
powerOff()[source]

Switch off the power supply unit

powerOn()[source]

Switch on the power supply unit

selectUnit(index)[source]

Select a unit within the system for queries that require a unit to be selected.

Possible values: * 0: Master * 1-63: Slave * 64: System

The slave number (1 ... 63) required for the ModuleSelectIndex depends on the multi-unit operating mode and can be calculated with the values of the multi-unit ID selectors on the front panel according to the following formula:

+==============================+===================+ | Multi-unit operating mode | ModuleSelectIndex | +==============================+===================+ | Parallel or series operation | (8 * AH) + AL | +——————————+——————-+ | Multi-load operation | (16 * AH) + AL | +——————————+——————-+

Parameters:index (int) – ModuleSelectIndex
setCurrent(neg, pos)[source]

Set the forward and reverse current flow limits.

Note:

The master unit must be selected using `selectUnit(0)`
Parameters:
  • neg (float) – Reverse Current setpoint
  • pos (float) – Forward Current setpoint
setPower(neg, pos)[source]

Set the forward and reverse power flow limits.

Note:

The master unit must be selected using `selectUnit(0)`
Parameters:
  • neg (float) – Reverse Power setpoint
  • pos (float) – Forward Power setpoint
setVoltage(voltage)[source]

Set the voltage limit.

Note:

The master unit must be selected using `selectUnit(0)`
Parameters:voltage (float) – Voltage setpoint