BK_Precision.Multimeter

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

Driver

The BK Precision Multimeters use a Silicon Labs CP210x USB to UART Bridge. This requires a third party driver that must be downloaded from the BK Precision website before connecting the device.

That driver can be downloaded from here

The driver officially supports Windows XP, Vista, 7

Configuration

In order to be recognized by the VISA driver, the instrument must be configured with a baudrate of 9600. This must be done on the instrument following the directions given in the user’s guide

class labtronyx.drivers.BK_Precision.Multimeter.d_2831(resource, **kwargs)

Driver for BK Precision 2831E and 5491B Digital Multimeters

disableFrontPanel()

Disables the front panel display. Display can be re-enabled by calling enableFrontPanel or pressing the LOCAL button on the instrument.

enableFrontPanel()

Enables the front panel display if it was previously disabled.

getError()

Gets the last error message from the device.

Returns:str

getFunction()

Alias for getMode

getIntegrationRate()

Get the integration period (measurement speed). Expressed as a factor of the power line frequency.

Returns:float

getMeasurement()

Get the last available reading from the instrument. This command does not trigger a measurement if trigger source is not set to IMMEDIATE.

Returns:float

getMeasurementOffset()

Get the current measurement offset value.

Returns:float

getMode()

Get the current operating mode

Returns:str

getRange()

Get the range for the measurement.

Returns:float

getTriggerSource()

Get the trigger source for a measurement.

Returns:str

reset()

Reset the instrument

setFunction(value)

Alias for setMode

setIntegrationRate(value)

Set the integration period (measurement speed) for the basic measurement functions (except frequency and period). Expressed as a factor of the power line frequency.

Parameters:value – Integration rate

setMeasurementOffset(value=None)

Establish a reference value for the measurement. When the offset is set, the result of a measurement will be the algebraic difference between the reference value and the current reading.

Expected value ranges:

• DC Voltage: 0 to 1000 Volts
• AC Voltage: 0 to 750 Volts
• Current: 0 to 20 Amps
• Resistance: 0 to 20e6 ohms

Parameters:value (float) – Reference value

setMode(func)

Set the configuration mode

Valid modes:

• ‘AC Voltage’
• ‘DC Voltage’
• ‘Resistance’
• ‘AC Current’
• ‘DC Current’
• ‘Frequency’
• ‘Period’
• ‘Diode’
• ‘Continuity’

Parameters:func (str) – Configuration mode

setRange(value)

Set the range for the measurement. The range is selected by specifying the expected reading as an absolute value. The instrument will then go to the most ideal range that will accomodate the expected reading

Possible values for value:

• ‘MIN’ or ‘0’
• Number (see ranges below)
• ‘DEFAULT’
• ‘MAX’
• ‘AUTO’

Expected value ranges:

• DC Voltage: 0 to 1000 Volts
• AC Voltage: 0 to 750 Volts
• Current: 0 to 20 Amps
• Resistance: 0 to 20e6 ohms
• Frequency or Period: 0 to 1010 Volts

Parameters:value (str) – Measurement Range

setTriggerSource(value)

Set the trigger source for a measurement.

Valid values:

• Continual: Internal continuous trigger
• Bus: Triggered via USB/RS-232 Interface
• External: Triggered via the Trig button on the front panel

Parameters:value (str) – Trigger source

trigger()

Triggers the measurement if trigger source is set to Bus

zeroMeasurement()

Reads the current measurement and set it as the offset.