5.2. CALibration

This subsystem provides commands for the module output calibration. Only one channel can be calibrated at a time. If calibration mode has not been enabled with CALibration:STATe, the calibration commands will generate an error. Use CALibration:SAVE to save any changes, otherwise all changes will be lost on exit from calibration mode. Within the same calibration session both output voltage and current can be calibrated for the currently selected channel.

Calibration cannot start if channel output is not enabled (OUTPut[:STATe] ON).

During calibration process up to 20 measurement points can be entered within range for selected module and value (e.g. 0 to 40 V for DCP405 power module). The minimum recommended number of measurement points is two to compensate slope and offset errors.

 

SCPI Command

Description

CALibration[:MODE] {<bool>}, {<password>}

Enables/disables calibration mode

:CLEar {<password>}

Clears all calibration parameters

:CURRent

 

[:DATA] {<value>}

Enters the calibration value for set point

:LEVel {<point>}, {<level>}

Calibrates the output current programming

:RANGe {range}

Sets current range for multiple current range module

:PASSword

 

:NEW {<old>}, {<new>}

Changes calibration password

:REMark {<string>}

Saves calibration information

:SAVE

Saves the new cal constants in non-volatile memory

:SCReen:INIT

Initiates touchscreen calibration procedure

:STATe {<bool>}, {<password>}

Enables calibration parameters

:VOLTage

 

[:DATA] {<value>}

Enters the calibration value for set point

:LEVel {<point>}, {<level>}

Calibrates the output voltage programming

5.2.1. CALibration[:MODE]

Syntax

CALibration[:MODE] {<bool>}, {<password>}

CALibration[:MODE]?

Description

This command enables or disables calibration mode. Calibration mode must be enabled for the channel to accept any calibration commands. The first parameter specifies the ON (1) or OFF (0) state. The second parameter is the password. Successful execution of this command set both output VOLTage and CURRent of the selected channel to the MINimum value (see Section 8.1).

Execution of this command also affects bit 0 (CALibrating) of the Operation Instrument Isummary register (see Section 3.3.2).

 

If both voltage and current calibration parameters exists on calibration mode exit (CALibration[:MODE] OFF) the CALibration:STATe ON command will automatically follows.

Parameters

Name

Type

Range

Default

<bool>

Boolean

ON|OFF|0|1

OFF

 

<password>

Quoted string

4 to 16 characters

"eezbb3"

Return

The returned parameter is 0 (OFF) or 1 (ON).

Usage example

See Section 10.2

Errors

102,"Invalid cal password"

104,"Bad sequence of calibration commands"

312,"Cannot execute when the channels are coupled"

Related Commands

CALibration:STATe

DIAGnostic[:INFOrmation]:OTIMe?

INSTrument:COUPle:TRACking

5.2.2. CALibration:CLEar

Syntax

CALibration:CLEar {<password>}

Description

Clear all calibration parameters stored in the module non-volatile memory for the currently selected channel. After successful execution of this command CALibration:STATe will be set to OFF (0) and further usage of the calibration data will be disabled. This command will be also filled calibration remark with the date and note that calibration data has been cleared.

Parameters

Name

Type

Range

Default

<password>

Quoted string

4 to 16 characters

"eezbb3"

Return

None

Usage example

DIAG:CAL?

"remark=2020-04-28 new cal",

"u_cal_params_exists=1",

"u_point1_dac=0.150000",

"u_point1_data=0.145000",

"u_point1_adc=0.178900",

"u_point2_dac=38.000000",

"u_point2_data=39.292000",

"u_point2_adc=38.032799",

"i_5A_cal_params_exists=1",

"i_5A_point1_dac=0.050000",

"i_5A_point1_data=0.060100",

"i_5A_point1_adc=0.059840",

"i_5A_point2_dac=4.800000",

"i_5A_point2_data=5.072900",

"i_5A_point2_adc=4.810040",

"i_50mA_cal_params_exists=1",

"i_50mA_point1_dac=0.000500",

"i_50mA_point1_data=0.000591",

"i_50mA_point1_adc=0.000600",

"i_50mA_point2_dac=0.048000",

"i_50mA_point2_data=0.049897",

"i_50mA_point2_adc=0.048100"

CAL:STAT?

1

CAL:CLE "eezbb3"

CAL:STAT?

0

DIAG:CAL?

"remark= Not calibrated",

"u_cal_params_exists=0",

"i_cal_params_exists=0"

Errors

102,"Invalid cal password"

Related Commands

CALibration:STATe

DIAGnostic[:INFOrmation]:CALibration?

5.2.3. CALibration:CURRent[:DATA]

Syntax

CALibration:CURRent[:DATA] {<value>}

Description

This command can only be used when calibration is enabled and the output state of the currently selected channel is ON. It enters a current value that is obtained by reading an external meter. The calibration level (CALibration:CURRent:LEVel {<point>, <level>}) has to be selected first for the value being entered. The BB3 then computes new current calibration constants. These constants has to be stored in non-volatile memory with CALibration:SAVE command.

Parameters

Name

Type

Range

Default

<value>

NR2

-0.5 A to MAX +0.5 A

The maximum value is dependent on the power module current rating. See Section 8.1

Return

None

Usage example

See Section 10.2

Errors

104,"Bad sequence of calibration commands"

107,"Cal value out of range"

Related Commands

CALibration:CURRent:LEVel

5.2.4. CALibration:CURRent:LEVel {<point>}, {<level>}

Syntax

CALibration:CURRent:LEVel {<point>}, {<level>}

Description

This command can only be used when calibration is enabled and the output state of the currently selected channel is ON. It sets the power module to a calibration point that is entered with the CAL:CURR[:DATA] command.

Parameters

Name

Type

Range

Default

<point>

NR1

1 – 20

<level>

NR2

0 to MAX (see also Section 8.1)

Return

None

Usage example

See Section 10.2

Errors

101,"Calibration state is off"

104,"Bad sequence of calibration commands"

Related Commands

CALibration:CURRent[:DATA]

CALibration:STATe

INSTrument:NSELect

INSTrument[:SELect]

[SOURce[<n>]]:CURRent

5.2.5. CALibration:CURRent:RANGe

Syntax

CALibration:CURRent:RANGe {<range>}

Modules

 DCP405 

Description

When BB3 is equipped with power modules that has multiple current range (e.g. DCP405 that can be find out with the SYSTem:CHANnel:MODel? command) it’s recommended to perform calibration of all ranges. Use this command to select current range on which calibration will be accomplished.

Parameters

Name

Type

Range

Default

<range>

Discrete|NR2

LOW|HIGH|0.05|5

HIGH|5

Return

None

Usage example

See Section 10.2

Errors

101,"Calibration state is off"

-241,"Hardware missing"

Related Commands

CALibration:CURRent:LEVel

CALibration:STATe

SYSTem:CHANnel:MODel?

5.2.6. CALibration:PASSword:NEW

Syntax

CALibration:PASSword:NEW {<old>}, {<new>}

Description

Enter a new calibration password. To change the password, first unsecure the BB3 using the old password. Then, the new code has to be entered. The calibration code may contain up to 16 characters over the remote interface. Minimum length is 4 characters.

The new password is automatically stored in non-volatile memory and does not have to be stored with CALibration:SAVE.

Parameters

Name

Type

Range

Default

<old>

Quoted string

4 to 16 characters

eezbb3

 

<new>

Quoted string

4 to 16 characters

Return

None

Usage example

CAL:PASS:NEW "eezbb3", "mycal1234"

Errors

102,"Invalid cal password"

105,"Cal password too long"

106,"Cal password too short"

5.2.7. CALibration:REMark

Syntax

CALibration:REMark {<user remark>}

CALibration:REMark?

Description

Record calibration information about the power module. The BB3 should be in calibration mode before sending a calibration message.

Parameters

Name

Type

Range

Default

<user remark>

Quoted string

0 to 32 characters

"Calibration passed"

Return

Query the calibration message.

Usage example

CAL:REM "Calibrated by EEZ"

CAL:REM?

"Calibrated by EEZ"

See also Section 10.2

Errors

The following errors could be generated by command but not query:

101,"Calibration state is off"

104,"Bad sequence of calibration commands"

Related Commands

CALibration:STATe

5.2.8. CALibration:SAVE

Syntax

CALibration:SAVE

Description

This command saves calibration constants in non-volatile memory after the calibration procedure has been completed. If calibration mode is exited by programming CALibration:STATe OFF without first saving the new constants, the previous constants are restored. Execution of this command also affects bit 0 (CALibrating) of the Operation Instrument Isummary register (see Section 3.3.2).

Return

None

Usage example

See Section 10.2

Errors

-340,"Calibration failed"

101,"Calibration state is off"

104,"Bad sequence of calibration commands"

111,"No new cal data exists"

5.2.9. CALibration:SCReen:INIT

Syntax

CALibration:SCReen:INIT

Description

Use this command to initiate calibration procedure when touchscreen calibration data are lost or corrupted. Calibration has to be performed locally on the BB3.

 

New calibration procedure can be initiated also by touching the screen and hold for more then 15 seconds.

Return

None

Usage example

CAL:SCR:INIT

5.2.10. CALibration:STATe

Syntax

CALibration:STATe {<bool>}

CALibration:STATe?

Description

This command enables or disables usage of calibration parameters if they exists.

Parameters

Name

Type

Range

Default

<bool>

Boolean

OFF|ON|0|1

ON

Return

The returned parameter is 0 (OFF) or 1 (ON).

Usage example

CAL:STAT OFF

Errors

110,"Cal params missing or corrupted"

Related Commands

DIAGnostic[:INFOrmation]:OTIMe?

5.2.11. CALibration:VOLTage[:DATA]

Syntax

CALibration:VOLTage[:DATA] {<value>}

Description

This command can only be used when calibration is enabled and the output state of the currently selected channel is ON. It enters a voltage value that you obtained by reading an external meter. The calibration level (see CALibration:VOLTage:LEVel {<point>, <level>}) for the value being entered. The BB3 then computes new voltage calibration constants. These constants has to be stored in non-volatile memory with CALibration:SAVE command.

Parameters

Name

Type

Range

Default

<value>

NR2

-1 V to MAX +1 V

The maximum value is dependent on the power module voltage rating. See Section 8.1

Return

None

Usage example

See Section 10.2

Errors

104,"Bad sequence of calibration commands"

107,"Cal value out of range"

Related Commands

CALibration:SAVE

CALibration:STATe

CALibration:VOLTage:LEVel

INSTrument:NSELect

INSTrument[:SELect]

5.2.12. CALibration:VOLTage:LEVel {<point>}, {<level>}

Syntax

CALibration:VOLTage:LEVel {<point>}, {<level>}

Description

This command can only be used when calibration is enabled and the output state of the currently selected channel is ON. It sets the power module to a calibration point that is entered with the CAL:VOLT[:DATA] command.

Parameters

Name

Type

Range

Default

<point>

NR1

1 – 20

<level>

NR2

0 to MAX (see also Section 8.1)

Return

None

Usage example

See Section Section 10.2

Errors

101,"Calibration state is off"

104,"Bad sequence of calibration commands"

Related Commands

CALibration:STATe

CALibration:VOLTage[:DATA]

INSTrument:NSELect

INSTrument[:SELect]

[SOURce[<n>]]:VOLTage