5.14. SOURce

The SOURce commands are used to set the output voltage and current values, remote voltage sensing, and implemented protection mechanisms on the specified channel. Although the APPLy command provides the most straightforward method to program the BB3 over the remote interfaces, the SOURce commands give you more flexibility to change individual parameters.

 

SCPI command

Description

[SOURce[<n>]]

 

:CURRent

 

[:LEVel]

 

[:IMMediate][:AMPLitude] {<current>}

Sets the output current

:STEP[:INCRement] {<step>}

Sets the step of the current change

:TRIGgered[:AMPLitude] {<current>}

Sets the triggered output current

:LIMit

 

[:POSitive][:IMMediate][:AMPLitude] {<current>}

Sets the output current limit

:MODE {<mode>}

Sets the current trigger mode

:PROTection

 

:DELay

 

[:TIME] {<time>}

Sets the over-current protection (OCP) programming delay

:STATe {<bool>}

Enables/disables over-current protection on the selected channel

:TRIPped?

Returns status of over-current protection activation

:RAMP:DURation {<duration>}

Sets output current ramp duration

:LIST

 

:COUNt

Sets the number of times that the list is executed

:CURRent[:LEVel]

Specifies the current setting for each list step

:DWELl

Specifies the dwell time for each list step

:VOLTage[:LEVel]

Specifies the voltage setting for each list step

:POWer

 

:LIMit {<power>}

Sets the output power limit

:PROTection[:LEVel]

Sets the over-power protection (OPP) level

:DELay

 

[:TIME] {<time>}

Sets the over-power protection programming delay

:STATe {<bool>}

Enables/disables over-power protection on the selected channel

:TRIPped?

Returns status of over-power protection activation

:VOLTage

 

[:LEVel]

 

[:IMMediate][:AMPLitude] {<voltage>}

Sets the output voltage

:STEP[:INCRement] {<step>}

Sets the step of the voltage change

:TRIGgered[:AMPLitude] {<voltage>}

Sets the triggered output voltage

:LIMit

 

[:POSitive][:IMMediate][:AMPLitude] {<voltage>}

Sets the output voltage limit

:MODE {<mode>}

Sets the voltage trigger mode

:PROGram[:SOURce] {<source>}

Sets voltage programming source

:PROTection[:LEVel]

Sets the over-voltage protection (OVP) level

:DELay

 

[:TIME] {<time>}

Sets the over-voltage protection (OVP) programming delay

:STATe {<bool>}

Enables/disables over-voltage protection on the selected channel

:TRIPped?

Returns status of over-voltage protection activation

:TYPE {<type>}

Selects the over-voltage protection (OVP) type

:RAMP:DURation {<duration>}

Sets output voultage ramp duration

:SENSe[:SOURce] {<source>}

Sets voltage sense inputs source

5.14.1. [SOURce[<n>]]:CURRent

Syntax

[SOURce[<n>]]:CURRent[:LEVel][:IMMediate][:AMPLitude] {<current>}

[SOURce[<n>]]:CURRent[:LEVel][:IMMediate][:AMPLitude]? [<query current>]

Description

This command sets the immediate current level of the channel. Units are in amperes. When [:SOURce[<n>]] or [<n>] is omitted, the currently selected channel will be affected by this command.

 

This command also increases or decreases the immediate current level using the ‘UP’ or DOWN parameter by a predetermined amount. The command CURRent:STEP sets the amount of increase or decrease. A new increment setting will not cause an execution error -222,"Data out of range" when the maximum or the minimum rated current is exceeded – the output value will be set to the maximum or the minimum value instead.

 

At *RST, the signal being sourced will be set to a "safe" condition. This is achieved by setting the amplitude to its MINimum value (see Section 8.1).

Parameters

Name

Type

Range

Default

<current>

NR2|Discrete

0 to MAXimum, MIN|DEF|MAX|UP|DOWN

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

 

<query current>

Discrete

MIN|DEF|MAX

Return

The query command returns the programmed current level. CURR? MIN, CURR? DEF and CURR? MAX can be used to obtain minimum, default and maximum current level on the currently selected channel. For actual output current value use MEASure:CURRent command.

Usage example

A 10 Ω load is connected and voltage is set to 20 V. With MAX current set measured current will be 2 A. When new current value is set to 1.2 A, voltage will drop to 12 V (the channel enters the CC mode of operation):

INST CH1

VOLT 20

CURR MAX

MEAS:VOLT?

20.00

CURR 1.2

MEAS:VOLT?

12.00

Query that returns maximum current of the currently selected channel:

CURR? MAX

5.00

Errors

150,"Power limit exceeded"

-222,"Data out of range"

Related Commands

*SAV

*RST

APPLy

MEASure[:SCALar]:CURRent[:DC]?

[SOURce[<n>]]:CURRent[:LEVel][:IMMediate]:STEP[:INCRement]

5.14.2. [SOURce[<n>]]:CURRent:STEP

Syntax

[SOURce[<n>]]:CURRent[:LEVel][:IMMediate]:STEP[:INCRement] {<step>}

[SOURce[<n>]]:CURRent[:LEVel][:IMMediate]:STEP[:INCRement]? [<query step>]

Description

Set the step of the current change of the channel. When [SOURce[<n>]] or [<n>] is omitted, the currently selected channel will be affected by this command. Step change is performed by using UP and DOWN as parameter for the [SOURce[<n>]]:CURRent command.

Parameters

Name

Type

Range

Default

<step>

NR2|Discrete

0.01 to 1|DEFault

0.05

 

<query step>

Discrete

DEFault

Return

The query returns the step of the current change of the specified channel.

Usage example

Return default step value:

CURR:STEP? DEF

0.05

When a 10 Ω load is connected with voltage set to 20 V and current to 1 A the first channel enters CC mode of operation. Current is then increased from 1 A in two steps to 1.2 A:

APPL CH1, 20,1

MEAS:VOLT?

10.00

CURR:STEP 0.1

CURR UP

MEAS:CURR?

1.10

CURR UP

MEAS:CURR?

1.20

MEAS:VOLT?

12.00

Related Commands

*SAV

[SOURce[<n>]]:CURRent

5.14.3. [SOURce[<n>]]:CURRent:TRIGgered

Syntax

[SOURce[<n>]]:CURRent[:LEVel]:TRIGgered[:AMPLitude] {<current>}

[SOURce[<n>]]:CURRent[:LEVel]:TRIGgered[:AMPLitude]? [<query current>]

Modules

 DCP405  

Description

This command programs the pending triggered current level. The pending triggered current level is a stored value that is transferred to the output terminals when a trigger occurs.

 

A pending triggered level is not affected by subsequent CURRent commands.

Parameters

Name

Type

Range

Default

<current>

NR2|Discrete

0 to maximum, MIN|DEF|MAX

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

0.00

 

<query current>

Discrete

MIN|DEF|MAX

Return

Query the triggered current level presently programmed. If no triggered level is programmed, the CURRent level is returned. CURR:TRIG? MIN and CURR:TRIG? MAX return the lowest and highest programmable triggered current levels.

Usage example

On the currently selected channel voltage will be set to 3.3 V and current to 1 A when INITiate command is executed:

VOLT:TRIG 3.3

CURR:TRIG 1

TRIG:SOUR IMM

INIT

Related Commands

ABORt

5.14.4. [SOURce[<n>]]:CURRent:LIMit[:POSitive][:IMMediate][:AMPLitude]

Syntax

[SOURce[<n>]]:CURRent:LIMit[:POSitive][:IMMediate][:AMPLitude] {<current>}

[SOURce[<n>]]:CURRent:LIMit[:POSitive][:IMMediate][:AMPLitude]? [<query current>]

Description

This command sets the channel’s output current limit. Units are in amperes.

When [:SOURce[<n>]] or [<n>] is omitted, the currently selected channel will be affected by this command.

This command could be used as mean of protection against incidental programming of too high output current that can be set for example with [SOURce[<n>]]:CURRent:STEP command.

 

Maximum limit value will be affected with detected failure of cooling fan or channel’s temperature sensor. Use CURR:LIM? MAX to query actual value.

Parameters

Name

Type

Range

Default

<current>

NR2|Discrete

0 to MAXimum, MIN|DEF|MAX

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

MAXimum

 

<query current>

Discrete

MIN|DEF|MAX

Return

The query returns the max. allowed output current of the specified channel. Querying MAX on an output channel returns the maximum current limit.

Usage example

Normal mode of operation for 5 A module:

CURR:LIM MAX?

5.00

Max. allowable current with faulty cooling fan or temperature sensor:

CURR:LIM MAX?

1.00

Related Commands

*SAV

[SOURce[<n>]]:CURRent:STEP

[SOURce[<n>]]:POWer:LIMit

[SOURce[<n>]]:VOLTage:LIMit[:POSitive][:IMMediate][:AMPLitude]

5.14.5. [SOURce[<n>]]:CURRent:MODE

Syntax

[SOURce[<n>]]:CURRent:MODE {<mode>}

[SOURce[<n>]]:CURRent:MODE?

Modules

 DCP405  

Description

This command determines what happens to the output current when the transient system is initiated and triggered:

  • FIXed – the output current remains at the immediate value
  • LIST – the output follows the list values when a trigger occurs.
  • STEP – the output goes to the triggered level when a trigger occurs.

Parameters

Name

Type

Range

Default

<mode>

Discrete

FIXed|LIST|STEP

FIXed

Return

The query command returns the current mode of the currently selected channel.

Usage example

CURR:MODE?

FIX

Related Commands

[SOURce[<n>]]:LIST:CURRent[:LEVel]

[SOURce[<n>]]:VOLTage:MODE

5.14.6. [SOURce[<n>]]:CURRent:PROTection:DELay[:TIME]

Syntax

[SOURce[<n>]]:CURRent:PROTection:DELay[:TIME] {<time>}

[SOURce[<n>]]:CURRent:PROTection:DELay[:TIME]? [<query time>]

Description

This command sets the over-current protection delay. The over-current protection function will not be triggered on the selected output channel during the delay time. After the delay time has expired, the over-current protection function will be active.

This prevents momentary changes in output status from triggering the over-current protection function. Programmed values can range from 0 to 10 seconds. See also Section 8.1

Parameters

Name

Type

Range

Default

<time>

NR2|Discrete

0 – 10|DEFault

20 ms

 

<query time>

Discrete

DEFault

Return

The query command returns the programmed delay time.

Usage example

Get default OCP delay of 20 milliseconds:

CURR:PROT:DEL? DEF

0.02

Related Commands

*SAV

OUTPut:PROTection:CLEar

5.14.7. [SOURce[<n>]]:CURRent:PROTection:STATe

Syntax

[SOURce[<n>]]:CURRent:PROTection:STATe {<bool>}

[SOURce[<n>]]:CURRent:PROTection:STATe?

Description

This command enables or disables the over-current protection (OCP) function. The enabled state is ON (1); the disabled state is OFF (0).

Since the power modules do not have a dedicated over-current protection circuit that can be programmed independently of output current level, entering the CC (constant current) mode of operation is used as a trigger to start OCP sequence. When delay time specified with the [SOURce[<n>]]:CURRent:PROTection:DELay[:TIME] command expired the output turns off and the Questionable Condition status register OCP bit 9 is set. An error tone will also follow if beeper is enabled (see SYSTem:BEEPer:STATe).

[SOURce[<n>]]:CURRent:PROTection:TRIPped? command can be used to query whether over-current protection occurred on the selected channel.

Parameters

Name

Type

Range

Default

<bool>

Boolean

ON|OFF|0|1

OFF

Return

The query command returns 0 if the current protection state is OFF, and 1 if the current protection state is ON.

Usage example

CURR:PROT:STAT?

0

Related Commands

*SAV

OUTPut:PROTection:CLEar

OUTPut:PROTection:COUPle

[SOURce[<n>]]:CURRent:PROTection:DELay[:TIME]

[SOURce[<n>]]:CURRent:PROTection:TRIPped

SYSTem:BEEPer:STATe

5.14.8. [SOURce[<n>]]:CURRent:PROTection:TRIPped?

Syntax

[SOURce[<n>]]:CURRent:PROTection:TRIPped?

Description

Query whether OCP occurred on the currently selected channel. When protection is tripped bit 9 (OCP) of the Questionable Instrument Isummary register will be set (see Section 3.4.2).

The OUTPut:PROTection:CLEar command can be send to clear OCP condition on the selected channel.

Return

This query returns a 1 if the protection circuit is tripped and a 0 if it is untripped.

Usage example

CURR:PROT:TRIP?

1

Related Commands

OUTPut:PROTection:CLEar

5.14.9. [SOURce[<n>]]:CURRent:RAMP:DURation

Syntax

[SOURce[<n>]]:CURRent:RAMP:DURation {<duration>}

[SOURce[<n>]]:CURRent:RAMP:DURation?

Description

Use this command to configures a constant rise of output current limit on the channel <n> within a set duration. The output current limit can be increased continuously within a 0 to 10 seconds with 1 ms step size.

Parameters

Name

Type

Range

Default

<duration>

NR2

0 – 10

Return

The query command returns set duration in seconds of the output current start ramp.

Usage example

CURR:RAMP:DUR 0.5

Related Commands

[SOURce[<n>]]:VOLTage:RAMP:DURation

5.14.10. [SOURce[<n>]]:LIST:COUNt

Syntax

[SOURce[<n>]]:LIST:COUNt {<count>}

[SOURce[<n>]]:LIST:COUNt?

Description

This command sets the number of times that the list is executed before it is completed. The list count range is 1 through 65535. Use the INFinity parameter or 0 to execute a list continuously.

 

Use ABORt to stop the list at any time. When the list is aborted, the output returns to the settings that were in effect before the list started.

Parameters

Name

Type

Range

Default

<count>

NR1|Discrete

0|1 – 65535|INFinity

1

Return

The query command returns the list count. Multiple responses are separated by commas. If a repeat count of 0 is returned, it means the list is set to repeat continuously.

Usage example

LIST:COUN?

10

Related Commands

ABORt

INITiate[:IMMediate]

MMEMory:LOAD:LIST[<n>]

MMEMory:STORe:LIST[<n>]

5.14.11. [SOURce[<n>]]:LIST:CURRent[:LEVel]

Syntax

[SOURce[<n>]]:LIST:CURRent[:LEVel] {<current>}[, ...]

[SOURce[<n>]]:LIST:CURRent[:LEVel]?

Description

This command specifies the current setting for each list step in amperes. A comma-delimited list of up to 256 steps may be programmed.

The order in which the current values are entered determines the sequence when the list executes.

To create a valid list, the VOLTage, CURRent and DWELl lists must either all be the same length, or have a length of 1, which is interpreted as having the same length as the list with the maximum length.

This command overwrites any previously programmed current list; it does not append to the previous list.

Parameters

Name

Type

Range

Default

<current>

NR2|Discrete

0 to maximum, MIN|DEF|MAX|UP|DOWN

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

Return

The query command returns the programmed current level. Multiple responses are separated by commas.

Usage example

LIST:CURR 0.25

Errors

306,"Too many list points"

Related Commands

MMEMory:LOAD:LIST[<n>]

MMEMory:STORe:LIST[<n>]

[SOURce[<n>]]:CURRent:MODE

[SOURce[<n>]]:LIST:COUNt

5.14.12. [SOURce[<n>]]:LIST:DWELl

Syntax

[SOURce[<n>]]:LIST:DWELl {<time>}[, ...]

[SOURce[<n>]]:LIST:DWELl?

Description

This command specifies the dwell time for each list step. A comma-delimited list of up to 256 steps may be programmed. Dwell time is the time that the output will remain at a specific step. Dwell times can be programmed from 0 through 65535 seconds.

 

Note that min. dwell time that can be achieved during the list execution depends of MCU activity and waveform shape. Therefore one have to find that out experimentally while list is executed on desired number of channels (one or two). Usage of oscilloscope is recommended for fast transitions since e.g. YT view resolution cannot be set to less then 20 ms. The expected usable min. dwell time goes well below 10 ms (down to 1 ms).

Parameters

Name

Type

Range

Default

<time>

NR2

0 – 65535

Return

The query command returns the programmed dwell times. Multiple responses are separated by commas.

Usage example

LIST:DWEL 20ms,10ms,10ms,50ms

Errors

306,"Too many list points"

Related Commands

MMEMory:LOAD:LIST[<n>]

MMEMory:STORe:LIST[<n>]

[SOURce[<n>]]:LIST:COUNt

5.14.13. [SOURce[<n>]]:LIST:VOLTage[:LEVel]

Syntax

[SOURce[<n>]]:LIST:VOLTage[:LEVel] {<voltage>}[, ...]

[SOURce[<n>]]:LIST:VOLTage[:LEVel]?

Description

This command specifies the voltage setting for each list step in volts. A comma-delimited list of up to 256 steps may be programmed.

The order in which the voltage values are entered determines the sequence when the list executes.

To create a valid list, the VOLTage, CURRent and DWELl lists must either all be the same length, or have a length of 1, which is interpreted as having the same length as the list with the maximum length.

This command overwrites any previously programmed voltage list; it does not append to the previous list.

Parameters

Name

Type

Range

Default

<voltage>

NR2|Discrete

0 to maximum, MIN|DEF|MAX|UP|DOWN

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

Return

The query command returns the programmed voltage level. Multiple responses are separated by commas.

Usage example

Programming the list that contain 4 steps and will be executed 20 times on the channel 2. Execution will start by receiving remote command (*TRG) since BUS is selected as a trigger source:

INST CH2

LIST:COUN 20

LIST:VOLT 0,1.5,3,4.5

LIST:CURR 0.25

LIST:DWEL 20ms,10ms,10ms,50ms

OUTP ON

*OPC?

0

TRIG:SOUR BUS

INIT

*TRG

Errors

306,"Too many list points"

Related Commands

MMEMory:LOAD:LIST[<n>]

MMEMory:STORe:LIST[<n>]

[SOURce[<n>]]:LIST:COUNt

[SOURce[<n>]]:VOLTage:MODE

5.14.14. [SOURce[<n>]]:POWer:LIMit

Syntax

[SOURce[<n>]]:POWer:LIMit {<power>}

[SOURce[<n>]]:POWer:LIMit? [<query power>]

Description

This command sets the channel’s output power limit. Units are in Watts. Such limitation is required if AC/DC power module cannot provides the same power as connected channel power module. For example, if power module can deliver 200 W but AC/DC power module offers only 155 W then MAXimum allowable continuous power is only 155 W.

Parameters

Name

Type

Range

Default

<power>

NR2|Discrete

0 to MAXimum, MIN|DEF|MAX

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

MAXimum

 

<query power>

Discrete

MIN|MAX

Return

The query returns the max. allowed output power of the specified channel. Querying MAX on an output channel returns the maximum rated power limit.

Usage example

POW:LIM DEF

POW:LIM?

150.00

Related Commands

*SAV

[SOURce[<n>]]:CURRent:LIMit[:POSitive][:IMMediate][:AMPLitude]

[SOURce[<n>]]:VOLTage:LIMit[:POSitive][:IMMediate][:AMPLitude]

5.14.15. [SOURce[<n>]]:POWer:PROTection[:LEVel]

Syntax

[SOURce[<n>]]:POWer:PROTection[:LEVel] {<power>}

[SOURce[<n>]]:POWer:PROTection[:LEVel]?

Description

Set the over-power protection (OPP) value of the channel. When [:SOURce[<n>]] or [<n>] is omitted, the currently selected channel will be affected by this command. When the over-power protection function of the specified channel is enabled ([SOURce[<n>]]:POWer:PROTection:STATe), the output turns off automatically when the output power exceeds the over-power protection value currently set.

[SOURce[<n>]]:POWer:PROTection:TRIPped? command can be used to query whether over-power protection occurred on the selected channel.

Parameters

Name

Type

Range

Default

<power>

NR2|Discrete

0 to MAXimum, MIN|DEF|MAX

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

DEFault

Return

Query the over-power protection (OPP) value of the selected channel.

Usage example

Set power protection to 50 W on the channel 2:

SOUR2:POW:PROT 50

Related Commands

*SAV

OUTPut:PROTection:COUPle

[SOURce[<n>]]:POWer:PROTection:TRIPped?

[SOURce[<n>]]:POWer:PROTection:STATe

5.14.16. [SOURce[<n>]]:POWer:PROTection:DELay[:TIME]

Syntax

[SOURce[<n>]]:POWer:PROTection:DELay[:TIME] {<time>}

[SOURce[<n>]]:POWer:PROTection:DELay[:TIME]? [<query time>]

Description

This command sets the over-power protection (OPP) delay. The over-power protection function will not be triggered on the selected output channel during the delay time. After the delay time has expired, the over-power protection function will be active.

This prevents momentary changes in output status from triggering the over-power protection function. Programmed values can range from 0 to 300 seconds. See also Section 8.1

Parameters

Name

Type

Range

Default

<time>

NR2|Discrete

0 – 300|DEFault

10

 

<query time>

Discrete

DEFault

Return

The query command returns the programmed delay time.

Usage example

Get default OPP delay of 10 seconds:

POW:PROT:DEL? DEF

10

Related Commands

*SAV

OUTPut:PROTection:CLEar

5.14.17. [SOURce[<n>]]:POWer:PROTection:STATe

Syntax

[SOURce[<n>]]:POWer:PROTection:STATe {<bool>}

[SOURce[<n>]]:POWer:PROTection:STATe?

Description

This command enables or disables the over-power protection (OPP) function. The enabled state is ON (1); the disabled state is OFF (0). If the over-power protection function is enabled and the measure output power reach value set by [SOURce[<n>]]:POWer:PROTection[:LEVel] the output is disabled and the Questionable Condition status register OPP bit 10 is set.

Parameters

Name

Type

Range

Default

<bool>

Boolean

ON|OFF|0|1

OFF

Return

The query command returns 0 if the current protection state is OFF, and 1 if the current protection state is ON.

Usage example

POW:PROT:STAT ON

POW:PROT:STAT?

1

Related Commands

*SAV

OUTPut:PROTection:CLEar

[SOURce[<n>]]:POWer:PROTection[:LEVel]

5.14.18. [SOURce[<n>]]:POWer:PROTection:TRIPped?

Syntax

[SOURce[<n>]]:POWer:PROTection:TRIPped?

Description

Query whether OPP occurred on the currently selected channel. When protection is tripped bit 10 (OPP) of the Questionable Instrument Isummary register will be set (see Section 3.4.2).

The OUTPut:PROTection:CLEar command can be send to clear OPP condition on the selected channel.

Return

This query returns a 1 if the protection circuit is tripped and a 0 if it is untripped.

Usage example

POW:PROT:TRIP?

0

Related Commands

OUTPut:PROTection:CLEar

5.14.19. [SOURce[<n>]]:VOLTage

Syntax

[SOURce[<n>]]:VOLTage[:LEVel][:IMMediate][:AMPLitude] {<voltage>}

[SOURce[<n>]]:VOLTage[:LEVel][:IMMediate][:AMPLitude]? [<query voltage>]

Description

This command sets the immediate voltage level of the output channel. Units are in volts. When [:SOURce[<n>]] or [<n>] is omitted, the currently selected channel will be affected by this command.

 

This command also increases or decreases the immediate voltage level using the ‘UP’ or DOWN parameter by a predetermined amount. The command VOLTage:STEP sets the amount of increase or decrease. A new increment setting will not cause an execution error -222,"Data out of range" when the maximum or the minimum rated current is exceeded – the output value will be set to the maximum or the minimum value instead.

 

At *RST, the signal being sourced will be set to a "safe" condition. This is achieved by setting the amplitude to its MINimum value (see Section 8.1).

Parameters

Name

Type

Range

Default

<voltage>

NR2|Discrete

0 to MAXimum, MIN|DEF|MAX|UP|DOWN

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

 

<query voltage>

Discrete

MIN|DEF|MAX

Return

The query command returns the programmed voltage level. VOLT? MIN, VOLT? DEF and VOLT? MAX can be used to obtain minimum, default and maximum voltage level on the currently selected channel. For actual output voltage value use MEASure:VOLTage? command.

Usage example

A 10 Ω load is connected and current is set to 1 A. With MAX voltage set measured voltage will be 10 V. When new voltage value is set to 5 V, current will drop to 0.5 A (the channel enters the CV mode of operation):

INST CH1

VOLT MAX

CURR 1

MEAS:CURR?

1.00

VOLT 5

MEAS:CURR?

0.50

Query that returns maximum current of the currently selected channel:

CURR? MAX

5.00

Errors

150,"Power limit exceeded"

-222,"Data out of range"

Related Commands

*SAV

*RST

APPLy

MEASure[:SCALar]:VOLTage[:DC]?

[SOURce[<n>]]:VOLTage[:LEVel][:IMMediate]:STEP[:INCRement]

5.14.20. [SOURce[<n>]]:VOLTage:LIMit[:POSitive][:IMMediate][:AMPLitude]

Syntax

[SOURce[<n>]]:VOLTage:LIMit[:POSitive][:IMMediate][:AMPLitude] {<voltage>}

[SOURce[<n>]]:VOLTage:LIMit[:POSitive][:IMMediate][:AMPLitude]? [<query voltage>]

Description

This command sets the channel’s output voltage limit. Units are in volts.

When [:SOURce[<n>]] or [<n>] is omitted, the currently selected channel will be affected by this command.

This command could be used as mean of protection against incidental programming of too high output voltage that can be set for example with [SOURce[<n>]]:VOLTage:STEP command.

Parameters

Name

Type

Range

Default

<voltage>

NR2|Discrete

0 to MAXimum, MIN|DEF|MAX

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

MAXimum

 

<query voltage>

Discrete

MIN|MAX

Return

The query returns the max. allowed output voltage of the specified channel. Querying MAX on an output channel returns the maximum voltage limit.

Usage example

VOLT:LIM 20

Related Commands

*SAV

[SOURce[<n>]]:CURRent:STEP

[SOURce[<n>]]:POWer:LIMit

[SOURce[<n>]]:VOLTage:LIMit[:POSitive][:IMMediate][:AMPLitude]

5.14.21. [SOURce[<n>]]:VOLTage:STEP

Syntax

[SOURce[<n>]]:VOLTage[:LEVel][:IMMediate]:STEP[:INCRement] {<step>}

[SOURce[<n>]]:VOLTage[:LEVel][:IMMediate]:STEP[:INCRement]? [<query step>]

Description

Set the step of the voltage change of the channel. When [SOURce[<n>]] or [<n>] is omitted, the currently selected channel will be affected by this command. Step change is performed by using UP and DOWN as parameter for the [SOURce[<n>]]:VOLTage command.

Parameters

Name

Type

Range

Default

<step>

NR2|Discrete

0.01 to 10|DEFault

0.1

 

<query step>

Discrete

DEFault

Return

The query returns the step of the voltage change of the specified channel.

Usage example

Return default step value:

VOLT:STEP? DEF

0.10

By connecting a 10 Ω load and current set to 2 A and voltage to 10 V the first channel enters the CV mode of operation. Voltage is then decreased from 10 V in two steps to 6 V:

APPL CH1, 10,2

MEAS:CURR?

1.0

VOLT:STEP 2

VOLT DOWN

VOLT DOWN

MEAS:VOLT?

6.0

MEAS:CURR?

0.60

Related Commands

*SAV

[SOURce[<n>]]:VOLTage

5.14.22. [SOURce[<n>]]:VOLTage:TRIGgered

Syntax

[SOURce[<n>]]:VOLTage[:LEVel]:TRIGgered[:AMPLitude] {<voltage>}

[SOURce[<n>]]:VOLTage[:LEVel]:TRIGgered[:AMPLitude]? [<query voltage>]

Description

This command programs the pending triggered voltage level. The pending triggered current level is a stored value that is transferred to the output terminals when a trigger occurs.

 

A pending triggered level is not affected by subsequent VOLTage commands.

 

 

Parameters

Name

Type

Range

Default

<voltage>

NR2|Discrete

0 to maximum, MIN|DEF|MAX

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

0.00

 

<query voltage>

Discrete

MIN|MAX

 

Return

Query the triggered voltage level presently programmed. If no triggered level is programmed, the VOLTage level is returned. VOLT:TRIG? MIN and VOLT:TRIG? MIN return the lowest and highest programmable triggered voltage levels.

Usage example

On the currently selected channel voltage will be set to 3.3V and current to 1A when INITiate command is executed:

VOLT:TRIG 3.3

CURR:TRIG 1

TRIG:SOUR IMM

INIT

Related Commands

ABORt

5.14.23. [SOURce[<n>]]:VOLTage:MODE

Syntax

[SOURce[<n>]]:VOLTage:MODE {<mode>}

[SOURce[<n>]]:VOLTage:MODE?

Description

This command determines what happens to the output voltage when the transient system is initiated and triggered:

  • FIXed – the output current remains at the immediate value
  • LIST – the output follows the list values when a trigger occurs.
  • STEP – the output goes to the triggered level when a trigger occurs.

Parameters

Name

Type

Range

Default

<mode>

Discrete

FIXed|LIST|STEP

FIXed

Return

The query command returns the voltage mode of the currently selected channel.

Usage example

VOLT:MODE?

LIST

Related Commands

[SOURce[<n>]]:LIST:VOLTage[:LEVel]

[SOURce[<n>]]:CURRent:MODE

5.14.24. [SOURce[<n>]]:VOLTage:PROGram[:SOURce]

Syntax

[SOURce[<n>]]:VOLTage:PROGram[:SOURce] {<source>}

[SOURce[<n>]]:VOLTage:PROGram[:SOURce]?

Modules

 DCP405  

Description

Use this command to define source for output voltage programming if channel support this option (use the SYSTem:CHANnel[:INFOrmation]:PROGram? to query channel programming capability).

A channel’s D/A converter controlled by CPU is used by default for voltage output programming. That source can be calibrated (see the CALibrate subsystem) and provide output within safe limits.

The external voltage programming could be used when fast interaction with an external process is required. For example, if tracking output of the connected D.U.T. (i.e. a power supply) is needed the BB3's power module like DCP405 effectively becomes a pre-regulator keeping its output voltage in relation with changes of the D.U.T. output keeping constant difference between connected D.U.T input and output and in that way its max. power dissipation.

 

Max. D/A converter programmed voltage of 2.5 V would results with MAXimal voltage output regardless of the channel’s voltage range (see Section 8.1). Therefore if EXTernal programming source is selected, any voltage value higher then 2.5 V could produce unexpected results and eventually damage the power module and/or connected load.

To limit possible damage when programming source is set to EXTernal, the over-voltage protection (OVP) will be activated and set to MAXimum ([SOURce[<n>]]:VOLTage:PROTection[:LEVel]) with protection delay time set to zero ([SOURce[<n>]]:VOLTage:PROTection:DELay[:TIME]). Further adjustment of OVP level and delay is also allowed (e.g. to decrease OVP level or increase delay time).

 

The enabled state is EXTernal (1); the disabled state is INTernal (0). Execution of this command also affects bit 13 (RPROG) of the Operation Instrument Isummary register (see Section 3.3.2) and activate dedicated LED indicatior (Rprog) on the module's front panel.

Self-test operation initiated by *TST? command will reset voltage programming on all channels to the internal/local source.

If external programming source is selected the DIAGnostic[:INFOrmation]:ADC? Query returns 0.00 value for U_SET.

Parameters

Name

Type

Range

Default

<source>

Discrete

INTernal|EXTernal

INTernal

Return

The query command returns 0 if the local (internal) voltage programming is selected, and 1 if the remote (external) sense is selected.

Usage example

VOLT:PROG EXT

VOLT:PROG?

1

Errors

-241,"Hardware missing"

312,"Cannot execute when the channels are coupled"

Related Commands

*TST

DIAGnostic[:INFOrmation]:ADC?

INSTrument:COUPle:TRACking

OUTPut:[:STATe]

[SOURce[<n>]]:VOLTage:PROTection[:LEVel]

[SOURce[<n>]]:VOLTage:PROTection:DELay[:TIME]

[SOURce[<n>]]:VOLTage:PROTection:TRIPped?

SYSTem:CHANnel[:INFOrmation:PROGram?

5.14.25. [SOURce[<n>]]:VOLTage:PROTection[:LEVel]

Syntax

[SOURce[<n>]]:VOLTage:PROTection[:LEVel] {<voltage>}

[SOURce[<n>]]:VOLTage:PROTection[:LEVel]?

Description

Set the over-voltage protection (OVP) value of the channel. When [:SOURce[<n>]] or [<n>] is omitted, the currently selected channel will be affected by this command. When the over-votlage protection function of the specified channel is enabled ([SOURce[<n>]]:VOLTage:PROTection:STATe), the output turns off automatically when the output voltage exceeds the over-voltage protection value currently set.

[SOURce[<n>]]:VOLTage:PROTection:TRIPped? command can be used to query whether over-voltage protection occurred on the selected channel.

 

An execution error -222,"Data out of range" will be generated when output voltage is controlled internally ([SOURce[<n>]]:VOLTage:PROGram[:SOURce]) and OVP value is set below programmed output voltage ([SOURce[<n>]]:VOLTage).

Parameters

Name

Type

Range

Default

<voltage>

NR2|Discrete

0 to maximum, MIN|DEF|MAX

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

Return

Query the over-voltage protection (OVP) value of the selected channel.

Usage example

Set voltage protection to 10.2 V on the channel 1:

SOUR1:VOLT:PROT 10.2

Errors

-222,"Data out of range"

Related Commands

*SAV

OUTPut:PROTection:COUPle

[SOURce[<n>]]:VOLTage

[SOURce[<n>]]:VOLTage:PROGram[:SOURce]

[SOURce[<n>]]:VOLTage:PROTection:TRIPped?

[SOURce[<n>]]:VOLTage:PROTection:STATe

5.14.26. [SOURce[<n>]]:VOLTage:PROTection:DELay[:TIME]

Syntax

[SOURce[<n>]]:VOLTage:PROTection:DELay[:TIME] {<time>}

[SOURce[<n>]]:VOLTage:PROTection:DELay[:TIME]? [<query time>]

Description

This command sets the over-voltage protection delay. The over-voltage protection function will not be triggered on the selected output channel during the delay time. After the delay time has expired, the over-voltage protection function will be active.

This prevents momentary changes in output status from triggering the over-voltage protection function. Programmed values can range from 0 to 10 seconds. See also Section 8.1

Parameters

Name

Type

Range

Default

<time>

NR2|Discrete

0 – 10|DEFault

5 ms

 

<query time>

Discrete

DEFault

Return

The query command returns the programmed delay time.

Usage example

Get default OVP delay of 50 milliseconds:

VOLT:PROT:DEL? DEF

0.050

Related Commands

*SAV

OUTPut:PROTection:CLEar

5.14.27. [SOURce[<n>]]:VOLTage:PROTection:STATe

Syntax

[SOURce[<n>]]:VOLTage:PROTection:STATe {<bool>}

[SOURce[<n>]]:VOLTage:PROTection:STATe?

Description

This command enables or disables the over-voltage protection (OVP) function. The enabled state is ON (1); the disabled state is OFF (0).

Power modules that do not have a dedicated over-voltage protection circuit can be programmed independently of output current level, entering the CV (constant voltage) mode of operation is used as a trigger to start OVP sequence. When delay time specified with the [SOURce[<n>]]:VOLTage:PROTection:DELay[:TIME] command expired the output turns off and the Questionable Condition status register OCP bit 8 is set. An error tone will also follow if beeper is enabled (see SYSTem:BEEPer:STATe).

[SOURce[<n>]]:VOLTage:PROTection:TRIPped? command can be used to query whether over-voltage protection occurred on the selected channel.

Parameters

Name

Type

Range

Default

<bool>

Boolean

ON|OFF|0|1

OFF

Return

The query command returns 0 if the voltage protection state is OFF, and 1 if the voltage protection state is ON.

Usage example

VOLT:PROT:STAT?

0

Related Commands

*SAV

OUTPut:PROTection:CLEar

[SOURce[<n>]]:VOLTage:PROTection:DELay[:TIME]

[SOURce[<n>]]:VOLTage:PROTection:TRIPped

SYSTem:BEEPer:STATe

5.14.28. [SOURce[<n>]]:VOLTage:PROTection:TRIPped?

Syntax

[SOURce[<n>]]:VOLTage:PROTection:TRIPped?

Description

Query whether OVP occurred on the currently selected channel. When protection is tripped bit 8 (OVP) of the Questionable Instrument Isummary register will be set (see Section 3.4.2).

When channel’s output voltage is controlled remotely ([SOURce[<n>]]:VOLTage:PROGram[:SOURce]) this protection will change voltage control back to INTernal source.

The OUTPut:PROTection:CLEar command can be send to clear OVP condition on the selected channel.

Return

This query returns a 1 if the protection circuit is tripped and a 0 if it is untripped.

Usage example

VOLT:PROT:TRIP?

0

VOLT:PROG?

0

Related Commands

OUTPut:PROTection:CLEar

[SOURce[<n>]]:VOLTage:PROGram[:SOURce]

5.14.29. [SOURce[<n>]]:VOLTage:PROTection:TYPE

Syntax

[SOURce[<n>]]:VOLTage:PROTection:TYPE {<type>}

[SOURce[<n>]]:VOLTage:PROTection:TYPE?

Modules

 DCP405  

Description

Use this command to select one of the following types of over-voltage protection mechanism:

  • HW – on-board OVP triac crow-bar circuit is active with trip level set to about 3 % over output voltage set using the [SOURce[<n>]]:VOLTage[:LEVel][:IMMediate][:AMPLitude] {<voltage>} command.
  • SW – MCU is monitoring output voltage and compare it with trip level set using the [SOURce[<n>]]:POWer:PROTection[:LEVel] command. If trip level is reached OVP will disable output when time set by [SOURce[<n>]]:POWer:PROTection:DELay[:TIME] command passed.

The HW OVP circuit will cause that output terminals be shorted, and that could damage one or both of the on-board fuses. If that happened be sure to use new fuse with the same current rating.

Parameters

Name

Type

Range

Default

<type>

Discrete

HW|SW

SW

Return

The query command returns type of currenlty active OVP mechanism.

Usage example

VOLT:PROT:TYPE HW

Errors

-241,"Hardware missing"

Related Commands

*RST

[SOURce[<n>]]:VOLTage[:LEVel][:IMMediate][:AMPLitude] {<voltage>}

[SOURce[<n>]]:POWer:PROTection[:LEVel]

[SOURce[<n>]]:VOLTage:PROTection:STATe

5.14.30. [SOURce[<n>]]:VOLTage:RAMP:DURation

Syntax

[SOURce[<n>]]:VOLTage:RAMP:DURation {<duration>}

[SOURce[<n>]]:VOLTage:RAMP:DURation?

Description

Use this command to configures a constant rise of output voltage on the channel <n> within a set duration. The output voltage can be increased continuously within a 0 to 10 seconds with 1 ms step size.

Parameters

Name

Type

Range

Default

<duration>

NR2

0 – 10

Return

The query command returns set duration in seconds of the output voltage start ramp.

Usage example

CURR:RAMP:DUR 0.5

Related Commands

[SOURce[<n>]]:CURRent:RAMP:DURation

5.14.31. [SOURce[<n>]]:VOLTage:SENSe[:SOURce]

Syntax

[SOURce[<n>]]:VOLTage:SENSe[:SOURce] {<source>}

[SOURce[<n>]]:VOLTage:SENSe[:SOURce]?

Modules

 DCP405  

Description

This command enables or disables remote sensing. The enabled state is EXTernal (1); the disabled state is INTernal (0). Execution of this command also affects bit 12 (RSENSE) of the Operation Instrument Isummary register (see Section 3.3.2).

Self-test operation initiated by *TST? command will put remote sense on all channels into disable state.

When channels are not coupled together (INSTrument:COUPle:TRACking) this command turn on a dedicated LED indicator (Rsense) mounted on the power module's front panel.

 

Remote sensing has no effect during CC (Constant Current) operation. Rsense indicator will not be affected if output state is off (OUTPut OFF command).

Parameters

Name

Type

Range

Default

<source>

Discrete

INTernal|EXTernal

INTernal

Return

The query command returns 0 if the internal sense is selected, and 1 if the remote (external) sense is selected.

Usage example

VOLT:SENS EXT

VOLT:SENS?

1

Errors

-241,"Hardware missing"

312,"Cannot execute when the channels are coupled"

Related Commands

*SAV

*TST

INSTrument:COUPle:TRACking

OUTPut:[:STATe]

SYSTem:CHANnel[:INFOrmation]:PROGram?

5.14.32. [SOURce[<n>]]:VOLTage:SLEW:FALLing

Not implemented yet

5.14.33. [SOURce[<n>]]:VOLTage:SLEW:RISing

Not implemented yet