5.15. SENSe

SCPI command

Description

SENSe

:APERture {<period>}

Sets the integration time

:CURRent

[:DC]

RANGe {<range>} [, <channel>]

Selects a DC current measurement range

:DIGital

:RANGe {<pin>}, {<range>}

Set the range of the digital input

:SPEed {<pin>}, {<speed>}

Set the speed of the digital input

:DLOG

:CLEar

Resets DLOG settings

:FUNCtion

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

Enables/disables output current internal data logging

:DIGital

[:INPut] {<pin>}, {<enable>}, {<channel>}

Enables/disables digital input 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

:TRACe

[:DATA] {<value>}[, …]

Adds new data into log file

:BOOKmark {<bookmark>}

Adds a bookmark into the active DLOG

:REMark {<user remark>}

Adds user description to the log file

:X

:LABel {<label>}

Sets X-axis label

[:RANGe]:MIN {<min>}

Sets X-axis min. value

[:RANGe]:MAX {<max>}

Sets X-axis max. value

SCALe

:STEP {<step>}

Sets X-axis step value

:UNIT {<unit>}

Sets X-axis units

:Y<n>

:LABel {<label>}

Sets Y-axis<n> label

[:RANGe]:MIN {<min>}

Sets Y-axis<n> min. value

[:RANGe]:MAX {<max>}

Sets Y-axis<n> max. value

:SCALe

:UNIT {<unit>}

Sets Y-axis<n> units

:FUNCtion

[:ON] {<function>}[, <channel>]

Sets the MIO160 module analog outputs mode

:NPLCycles {<cycles>}

Sets the number of power line cycles (NPLC)

:VOLTage

[:DC]

:RANGe {<range>} [, <channel>]

Selects a DC voltage measurement range

Syntax

SENSe:APERture {<period>}

SENSe:APERture?

Modules

 MIO 

Description

This command sets the integration time for one point measurement.

The APERture value is coupled to NPLCycles by the equation: APERture = NPLCycles / selected AC line frequency. For example, for NPLC of 5 and 50 Hz the integration time is 100 ms.

The AC line frequency is not detected automatically, therefore it has to be set with the SYSTem:LFRequency command.

Using an integer number of power line cycles can reduce measurement noise from line frequency sources.

Parameters

Name

Type

Range

Default

<period>

NR2

0 – 0.5

–

Return

The query command returns the present setting of the integration time.

Usage example

SENS:NPLC 5

SENS:APER?

0.1

Errors

-241,"Hardware missing"

Related Commands

SENSe:NPLCycles

SYSTem:LFRequency

Syntax

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

SENSe:CURRent[:DC]:RANGe? [<channel>]

Modules

 DCP  MIO 

Description

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

When used on the MIO168 (i.e. its AFE) use range 0 for auto-ranging function.

Parameters

Name

Type

Range

Default

<range>

NR2|Discrete

DCP: 0.5, 5, LOW|HIGH|BEST,
MIO+AFE3: 0 – 3

BEST

<channel>

Channel

DCP: CH1|CH2|CH3|CH4|CH5|CH6,
MIO+AFE3: (@n04), (@n06)

–

Return

The query returns the presently selected current range.

Usage example

SENS:CURR:RANG?

0.05

Errors

-241,"Hardware missing"

Related Commands

SENSe:VOLTage[:DC]:RANGe

SYSTem:CHANnel:MODel?

Syntax

SENSe:DIGital:RANGe {<pin>}, {<range>}

SENSe:DIGital:RANGe?

Modules

 MIO 

Description

Use this command to set the voltage range of the input specified by <pin> on the 8-bit digital port (@n01) where n is the MIO168 module slot number:

• Low – 0 to 3.3 / 5 V
• High – 0 to 12 V (resilient to 24 V)

Parameters

Name

Type

Range

Default

<pin>

NR1

1 – 8

–

<range>

Discrete

LOW|HIGH

–

Return

The query command returns the voltage range of the selected digital input.

Usage example

INST (@301)

SENS:DIG:RANG 1,HIGH

SENS:DIG:RANG? 1

"HIGH"

Related Commands

MEASure:DIGital[:BYTE]

SENSe:DIGital:SPEed

Syntax

SENSe:DIGital:SPEed {<pin>}, {<speed>}

SENSe:DIGital:SPEed?

Modules

 MIO 

Description

Use this command to set the speed of the input specified by <pin> on the digital port (@n01) where n is the MIO168 module slot number. This command is applicable only to pin 1 and 2.

Parameters

Name

Type

Range

Default

<pin>

NR1

1 – 2

–

<speed>

Discrete

FAST|SLOW

–

Return

The query command returns the speed of the selected digital input.

Usage example

INST (@301)

SENS:DIG:SPE 1,FAST

Related Commands

MEASure:DIGital[:BYTE]

SENSe:DIGital:RANGe

Syntax

SENSe:DLOG:CLEar

Description

This command resets all DLOG parameters.

Usage example

SENS:DLOG:CLE

Errors

-241,"Hardware missing"

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>

Boolean

ON|OFF|0|1

OFF

<channel>

Channel

CH1|CH2|CH3|CH4|CH5|CH6

–

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

Syntax

SENSe:DLOG:FUNCtion:DIGital[:INPut] {<pin>}, {<enable>}, {<channel>}

SENSe:DLOG:FUNCtion:DIGital[:INPut]? {<pin>}, {<channel>}

Modules

 MIO 

Description

Use this command to enable or disable digital input internal data logging on the specified channel.

Parameters

Name

Type

Range

Default

<pin>

NR1

1 – 8

–

<enable>

Boolean

ON|OFF|0|1

OFF

<channel>

Channel

(@n02) where n is the slot number

–

Return

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

Usage example

SENS:DLOG:FUNC:DIG 1, ON, (@302)

Related Commands

INIT:DLOG

SENSe:DLOG:CURRent

SENSe:DLOG:FUNCtion:POWer

SENSe:DLOG:FUNCtion:VOLTage

SENSe:DLOG:PERiod

SENSe:DLOG:TIME

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>

Boolean

ON|OFF|0|1

OFF

<channel>

Channel

CH1|CH2|CH3|CH4|CH5|CH6

–

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

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>

Boolean

ON|OFF|0|1

OFF

<channel>

Channel

CH1|CH2|CH3|CH4|CH5|CH6

–

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

Syntax

SENSe:DLOG:PERiod {<time>}

SENSe:DLOG:PERiod?

Description

Use this command to set the data logging sample period in seconds.

Parameters

Name

Type

Range

Default

<time>

NR2

0.005 – 120

0.02

Return

The query command returns the sample period in seconds.

Usage example

SENS:DLOG:PER 1

Related Commands

INITiate:DLOG

SENSe:DLOG:TIME

Syntax

SENSe:DLOG:TIME {<time>}

SENSe:DLOG:TIME?

Description

This command sets the data logging 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>

NR1

1 – 86400000

60

Return

The query command returns the sample duration in seconds.

Usage example

SENS:DLOG:TIME 3600

Related Commands

INITiate:DLOG

MMEMory:INFOrmation?

SENSe:DLOG:PERiod

Syntax

SENSe:DLOG:TRACe:BOOKmark {<bookmark>}

Description

Use this command to add a bookmark into the active DLOG.

Parameters

Name

Type

Range

Default

<bookmark>

Quoted string

1 to 25 characters

–

Usage example

SENS:DLOG:BOOK "start fan"

Related Commands

ABORt:DLOG

INITiate:DLOG {<filename>}

Syntax

SENSe:DLOG:TRACe[:DATA] {<value>}[, …]

Description

When the X-axis and all Y-axes is defined, and when the DLOG file name is specified, it remains to add points (data) into DLOG. Use this command to do this as many times as needed. The first time this command is called, the Y-axis values are set for the first point (as many <value> parameters as the Y-axis should be set), the second time for the second point, etc.

When the values of all points are defined, execute the ABORt:DLOG command and the creation of the DLOG file is complete.

Parameters

Name

Type

Range

Default

<value>

NR2

Y:RANGe:MINimum to Y:RANGe:MAXimum

–

Usage example

SENS:DLOG:TRAC 10.2, 33.34, 0.022

Related Commands

ABORt:DLOG

Syntax

SENSe:DLOG:TRACe:REMark {<user remark>}

SENSe:DLOG:TRACe:REMark?

Description

Use this command to add description to the log file.

Parameters

Name

Type

Range

Default

<user remark>

Quoted string

0 to 128 characters

–

Return

The query command returns log file description as a quoted string.

Usage example

SENS:DLOG:TRAC:REM "Test data log"

Related Commands

INITiate:DLOG

INITiate:DLOG:TRACe

SENSe:DLOG:TRACe[:DATA]

Syntax

SENSe:DLOG:TRACe:X:LABel {<label>}

SENSe:DLOG:TRACe:X:LABel?

Description

Use this command to set DLOG X-axis label name.

Parameters

Name

Type

Range

Default

<label>

Quoted string

0 to 32 characters

–

Return

The query returns X-axis label name as quoted string.

Usage example

SENS:DLOG:TRAC:X:LAB "Imon"

Related Commands

SENSe:DLOG:TRACe:X:STEP

SENSe:DLOG:TRACe:X:UNIT

Syntax

SENSe:DLOG:TRACe:X:UNIT {<unit>}

SENSe:DLOG:TRACe:X:UNIT?

Description

This command specifies DLOG X-axis unit, typically this is the time, or SECond.

Parameters

Name

Type

Range

Default

<unit>

Discrete

VOLT|AMPEr|WATT|JOULe|SECOnd|OHM|FARAd|HERTz

–

Return

The query command returns log file X-axis units name as quoted string.

Usage example

SENS:DLOG:TRAC:X:UNIT VOLT

Related Commands

SENSe:DLOG:TRACe:X:STEP

SENSe:DLOG:TRACe:X:LABel

Syntax

SENSe:DLOG:TRACe:X:STEP {<step>}

SENSe:DLOG:TRACe:X:STEP?

Description

Use this command to set step or ∆x, i.e. the distance between two points on the X-axis of the DLOG.

Parameters

Name

Type

Range

Default

<step>

NR2

Greater then zero

–

Return

The query command returns X-axis step value.

Usage example

SENS:DLOG:TRAC:X:STEP 0.1

Related Commands

SENSe:DLOG:TRACe:X:LABel

SENSe:DLOG:TRACe:X:UNIT

Syntax

SENSe:DLOG:TRACe:X[:RANGe]:MIN {<min>}

SENSe:DLOG:TRACe:X[:RANGe]:MIN?

Description

Use this command to set the first point of the DLOG X-axis. The next point has the value MIN + STEP, then MIN + 2 * STEP, etc.

Parameters

Name

Type

Range

Default

<min>

NR2

–

–

Return

The query command returns set X-axis minimal value.

Usage example

SENS:DLOG:TRAC:X:MIN 0

Related Commands

SENSe:DLOG:TRACe:X:UNIT

Syntax

SENSe:DLOG:TRACe:X[:RANGe]:MAX {<max>}

SENSe:DLOG:TRACe:X[:RANGe]:MAX?

Description

Optional command to set the value of the last point on the DLOG X-axis.

Parameters

Name

Type

Range

Default

<max>

NR2

–

–

Return

The query command returns set X-axis maximum value.

Usage example

SENS:DLOG:TRAC:X:MAX 20

Related Commands

SENSe:DLOG:TRACe:X:UNIT

Syntax

SENSe:DLOG:TRACe:X:SCALe {<scale>}

SENSe:DLOG:TRACe:X:SCALe?

Description

Use this command to set the X-axis scale.

Currently, only linear (LINear) scale is supported.

Parameters

Name

Type

Range

Default

<scale>

Discrete

LINear|LOGarithmic

–

Return

The query command returns X-axis scale type.

Usage example

SENS:DLOG:TRAC:X:SCAL LIN

Related Commands

SENSe:DLOG:TRACe:Y:SCALe

Syntax

SENSe:DLOG:TRACe:Y<n>:LABel {<label>}

SENSe:DLOG:TRACe:Y<n>:LABel?

Description

Use this command to set DLOG Y-axis label name. DLOG file could contains up to 18 Y-axis defined by <n>.

Parameters

Name

Type

Range

Default

<label>

Quoted string

0 to 32 characters

–

Return

The query returns label name as quoted string of the selected Y-axis.

Usage example

SENS:DLOG:TRAC:Y1:LAB "Umon"

Related Commands

SENSe:DLOG:TRACe:Y<n>:UNIT

Syntax

SENSe:DLOG:TRACe:Y<n>[:RANGe]:MIN {<min>}

SENSe:DLOG:TRACe:Y<n>[:RANGe]:MIN?

Description

Use this command to set the first point of the <n> Y-axis. The next point has the value MIN + STEP, then MIN + 2 * STEP, etc.

Parameters

Name

Type

Range

Default

<min>

NR2

–

–

Return

The query command returns set <n> Y-axis minimal value.

Usage example

SENS:DLOG:TRAC:Y1:MIN 1

Related Commands

SENSe:DLOG:TRACe:Y<n>[:RANGe]:MAX

SENSe:DLOG:TRACe:Y<n>:UNIT

Syntax

SENSe:DLOG:TRACe:Y<n>[:RANGe]:MAX {<max>}

SENSe:DLOG:TRACe:Y<n>[:RANGe]:MAX?

Description

Optional command to set the value of the last point on the <n> Y-axis.

Parameters

Name

Type

Range

Default

<max>

NR2

–

–

Return

The query command returns set <n> Y-axis maximum value.

Usage example

SENS:DLOG:TRAC:Y1:MAX 50

Related Commands

SENSe:DLOG:TRACe:Y<n>[:RANGe]:MIN

SENSe:DLOG:TRACe:Y<n>:UNIT

Syntax

SENSe:DLOG:TRACe:Y:SCALe {<scale>}

SENSe:DLOG:TRACe:Y:SCALe?

Description

Use this command to set the Y-axis scale.

Parameters

Name

Type

Range

Default

<scale>

Discrete

LINear|LOGarithmic

–

Return

The query command returns Y-axis scale type.

Usage example

SENS:DLOG:TRAC:Y:SCAL LIN

Related Commands

SENSe:DLOG:TRACe:X:SCALe

Syntax

SENSe:DLOG:TRACe:Y<n>:UNIT {<unit>}

SENSe:DLOG:TRACe:Y<n>:UNIT?

Description

This command specifies DLOG <n> Y-axis unit.

Parameters

Name

Type

Range

Default

<unit>

Discrete

VOLT|AMPEr|WATT|JOULe|SECOnd|OHM|FARAd|HERTz

–

Return

The query command returns <n> Y-axis units name as quoted string.

Usage example

SENS:DLOG:TRAC:Y1:UNIT "AMPE"

Related Commands

SENSe:DLOG:TRACe:Y<n>:LABel

SENSe:DLOG:TRACe:Y<n>:UNIT

Syntax

SENSe:FUNCtion[:ON] {<function>}[, <channel>]

SENSe:FUNCtion[:ON]? [<channel>]

Modules

 MIO 

Description

This command defines AIN1 to AIN4 input mode of the MIO168 module with AFE1 that could be current or voltage.

Parameters

Name

Type

Range

Default

<function>

Discrete

CURRent|VOLTage

–

<channel>

channel

(@n03) to (@n06) where n is the slot number

Return

The query command returns set analog input mode.

Usage example

SENS:FUNC CURR,(@304)

Related Commands

SENSe:CURRent[:DC]:RANGe

SENSe:VOLTage[:DC]:RANGe

SOURce:FUNCtion[:ON]

Syntax

SENSe:NPLCycles {<cycles>}

SENSe:NPLCycles?

Modules

 MIO 

Description

Use this command to specify the number of AC power line cycles (NPLC) that the measurement will span (i.e. integration time where 1 NPLC=20 ms for 50 Hz, or 16.67 ms for 60 Hz AC power line). It insures better measurement accuracy and reduces measurement noise on low current and voltage measurements.

The AC line frequency is not detected automatically, therefore it has to be set with the SYSTem:LFRequency command.

The NPLC value is coupled to APERture by the equation: NPLCycles = APERture x selected AC line frequency. For example, for APERture of 0.1 and 50 Hz the NPLC is 5.

Using an integer number of power line cycles can reduce measurement noise from line frequency sources.

Parameters

Name

Type

Range

Default

<cycles>

NR2

0 – 25

–

Return

Returns the present setting of the number of power line cycles.

Usage example

SENS:NPLC

5

Errors

-241,"Hardware missing"

Related Commands

SENSe:APERture

SYSTem:LFRequency

Syntax

SENSe:VOLTage[:DC]:RANGe {<range>} [, <channel>]

SENSe:VOLTage[:DC]:RANGe? [<channel>]

Modules

 MIO 

Description

This command selects a DC voltage measurement range. The entered range must be higher than the maximum voltage that you expect to measure. Units are in volts.

Use range 0 for auto-ranging function.

Parameters

Name

Type

Range

Default

<range>

NR1

MIO+AFE3: 0 – 3

–

<channel>

Channel

MIO+AFE3: (@n03), (@n05)

–

Return

The query returns the presently selected voltage range.

Usage example

SENS:VOLT:RANG?

0

Errors

-241,"Hardware missing"

Related Commands

SENSe:CURRent[:DC]:RANGe