5.12. SENSe

The SENSe control the current measurement range, energy counting/window, and the data acquisition sequence.

 

SCPI command

Description

SENSe

 

:AHOur

 

:RESet {<channel>}

Resets the amp-hour (Ah) measurement to zero

:CURRent

 

[:DC]

 

RANGe[:UPPer] {<range>}

Selects a DC current measurement range

AUTO {<bool>}

Enables/disables seamless measurement auto ranging

:DLOG

 

:FUNCtion

 

:CURRent {<bool>}, {<channel>}

Enables/disables output current internal data logging

:POWer {<bool>}, {<channel>}

Enables/disables output power internal data logging

:VOLTage {<bool>}, {<channel>}

Enables/disables output voltage internal data logging

:PERiod {<time>}

Sets the sample period for internal data logging

:TIME {<time>}

Sets the sample duration for internal data logging

:WHOur

 

:RESet {<channel>}

Resets the watt-hour (Wh) measurement to zero

5.12.1. SENSe:AHOur:RESet

Syntax

SENSe:AHOur:RESet {<channel>}

Description

Not implemented yet

 

Use this command to reset the amp-hour counter to zero of the specified channel. If channels are coupled (in series or parallel) or in tracking mode, both channel’s counters will be reset to zero.

Parameters

Name

Type

Range

Default

<channel>

Discrete

CH1|CH2

Usage example

SENSE:AHO:RES

Related Commands

FETCh:WHOur?

INSTrument:COUPle:TRACking

OUTPut:TRACk[:STATe]

SENSe:AHOur:RESet

SYSTem:CHANnel:INFOrmation:AHOur:TOTal?

5.12.2. SENSe:CURRent[:DC]:RANGe[:UPPer]

Syntax

SENSe:CURRent[:DC]:RANGe[:UPPer] {<range>}

SENSe:CURRent[:DC]:RANGe[:UPPer]?

Description

This command selects a DC current measurement range when Power board with multiple current ranges is installed (e.g. r5B12 that can be find out with the SYSTem:CHANnel:MODel? command). The entered value must be higher than the maximum current that you expect to measure. Units are in amperes.

 

If selected range is lower then measured current, when load is connected, an error -220 will be generated.

Parameters

Name

Type

Range

Default

<range>

Numeric (NR2), discrete

0.5, 5, MIN|MAX, DEFault

DEF

Return

The query command returns the maximum DC current that can be measured on the range that is presently set.

Usage example

SENS:CURR:RANG?

0.5

Errors

-220,"Cannot set range"

Related Commands

SENSe:CURRent[:DC]:RANGe:AUTO

SYSTem:CHANnel:MODel?

5.12.3. SENSe:CURRent[:DC]:RANGe:AUTO

Syntax

SENSe:CURRent[:DC]:RANGe:AUTO {<bool>}

SENSe:CURRent[:DC]:RANGe:AUTO?

Description

This command enables/disables current measurement autoranging. Autoranging provides seamless measurement ranging, which results in a wide dynamic range with no data being lost across ranges.

 

When enabled, this command overrides the SENSe:CURRent[:DC]:RANGe setting.

Parameters

Name

Type

Range

Default

<bool>

Discrete

ON|OFF|0|1

OFF

Return

The query command returns 0 if current measurement autoranging is OFF, and 1 if current measurement autoranging is ON.

Usage example

SENS:CURR:RANG:AUTO?

0

Related Commands

SENSe:CURRent[:DC]:RANGe

SYSTem:CHANnel:MODel?

5.12.4. SENSe:DLOG:FUNCtion:CURRent

Syntax

SENSe:DLOG:FUNCtion:CURRent {<bool>}, {<channel>}

SENSe:DLOG:FUNCtion:CURRent? {<channel>}

Description

Use this command to enable or disable output current internal data logging on the specified channel.

Parameters

Name

Type

Range

Default

<bool>

Discrete

ON|OFF|0|1

OFF

<channel>

Discrete

CH1|CH2

Return

The query command returns the status (0 or 1) of the output current internal data logging enabled on the specified channel

Usage example

SENS:DLOG:FUNC:CURR ON, CH1

Related Commands

INIT:DLOG

SENSe:DLOG:FUNCtion:POWer

SENSe:DLOG:FUNCtion:VOLTage

SENSe:DLOG:PERiod

SENSe:DLOG:TIME

5.12.5. SENSe:DLOG:FUNCtion:POWer

Syntax

SENSe:DLOG:FUNCtion:POWer {<bool>}, {<channel>}

SENSe:DLOG:FUNCtion:POWer? {<channel>}

Description

Use this command to enable or disable output power internal data logging on the specified channel.

Parameters

Name

Type

Range

Default

<bool>

Discrete

ON|OFF|0|1

OFF

<channel>

Discrete

CH1|CH2

Return

The query command returns the status (0 or 1) of the output power internal data logging enabled on the specified channel

Usage example

SENS:DLOG:FUNC:VOLT OFF, CH2

Related Commands

INIT:DLOG

SENSe:DLOG:FUNCtion:CURRent

SENSe:DLOG:FUNCtion:VOLTage

SENSe:DLOG:PERiod

SENSe:DLOG:TIME

5.12.6. SENSe:DLOG:FUNCtion:VOLTage

Syntax

SENSe:DLOG:FUNCtion:VOLTage {<bool>}, {<channel>}

SENSe:DLOG:FUNCtion:VOLTage? {<channel>}

Description

Use this command to enable or disable output voltage internal data logging on the specified channel.

Parameters

Name

Type

Range

Default

<bool>

Discrete

ON|OFF|0|1

OFF

<channel>

Discrete

CH1|CH2

Return

The query command returns the status (0 or 1) of the output voltage internal data logging enabled on the specified channel

Usage example

SENS:DLOG:FUNC:VOLT OFF, CH2

Related Commands

INIT:DLOG

SENSe:DLOG:FUNCtion:CURRent

SENSe:DLOG:FUNCtion:POWer

SENSe:DLOG:PERiod

SENSe:DLOG:TIME

5.12.7. SENSe:DLOG:PERiod

Syntax

SENSe:DLOG:PERiod {<time>}

SENSe:DLOG:PERiod?

Description

Use this command to set the sample period in seconds. For the sample period, the

minimum is 20 ms, and it has to be in integral of 20 ms, while the maximum is 120 s. The entered value will be rounded to the nearest 20 ms integral.

Parameters

Name

Type

Range

Default

<time>

Discrete

0.02 – 120

0.02

Return

The query command returns the sample period in seconds.

Usage example

SENS:DLOG:PER 1

Related Commands

SENSe:DLOG:TIME

5.12.8. SENSe:DLOG:TIME

Syntax

SENSe:DLOG:TIME {<time>}

SENSe:DLOG:TIME?

Description

This command sets the sample duration, the entered value is in seconds. For sample duration, the maximum is 86 400 000 seconds or 24 000 hours or 1000 days (depending of the available space on the installed SD Card, see the MMEMory:INFOrmation? command).

Parameters

Name

Type

Range

Default

<time>

Discrete

1 – 86400000

60

Return

The query command returns the sample duration in seconds.

Usage example

SENS:DLOG:TIME 3600

Related Commands

MMEMory:INFOrmation?

SENSe:DLOG:PERiod

5.12.9. SENSe:WHOur:RESet

Syntax

SENSe:WHOur:RESet {<channel>}

Description

Not implemented yet

 

Use this command to reset the watt-hour counter to zero of the specified channel. If channels are coupled (in series or parallel) or in tracking mode, both channel’s counters will be reset to zero.

Parameters

Name

Type

Range

Default

<channel>

Discrete

CH1|CH2

Usage example

SENS:WHO:RES

Related Commands

FETCh:AHOur?

INSTrument:COUPle:TRACking

OUTPut:TRACk[:STATe]

SENSe:WHOur:RESet

SYSTem:CHANnel:INFOrmation:WHOur:TOTal