5.15. SENSe
5.15. SENSe
The SENSe control the current measurement range, energy counting/window, the data acquisition sequence and DLOG viewer parameters.
SCPI command |
Description |
SENSe |
|
Sets the integration time |
|
:CURRent |
|
[:DC] |
|
Selects a DC current measurement range |
|
:DIGital |
|
Set the range of the digital input |
|
Set the speed of the digital input |
|
:DLOG |
|
Resets DLOG settings |
|
:FUNCtion |
|
Enables/disables output current internal data logging |
|
:DIGital |
|
Enables/disables digital input internal data logging |
|
Enables/disables output power internal data logging |
|
Enables/disables output voltage internal data logging |
|
Sets the sample period for internal data logging |
|
Sets the sample duration for internal data logging |
|
:TRACe |
|
Adds new data into log file |
|
Adds a bookmark into the active DLOG |
|
Adds user description to the log file |
|
:X |
|
Sets X-axis label |
|
Sets X-axis min. value |
|
Sets X-axis max. value |
|
|
|
Sets X-axis step value |
|
Sets X-axis units |
|
:Y<n> |
|
Sets Y-axis<n> label |
|
Sets Y-axis<n> min. value |
|
Sets Y-axis<n> max. value |
|
|
|
Sets Y-axis<n> units |
|
:FUNCtion |
|
Sets the MIO160 module analog outputs mode |
|
Sets the number of power line cycles (NPLC) |
|
:VOLTage |
|
[:DC] |
|
Selects a DC voltage measurement range |
5.15.1. SENSe:APERture
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 |
5.15.2. SENSe:CURRent[:DC]:RANGe
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, |
BEST |
|
|
<channel> |
Channel |
DCP: CH1|CH2|CH3|CH4|CH5|CH6, |
– |
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? |
5.15.3. SENSe:DIGital:RANGe
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:
|
|||
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 |
5.15.4. 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 |
5.15.5. SENSe:DLOG:CLEar
Syntax |
SENSe:DLOG:CLEar |
Description |
This command resets all DLOG parameters. |
Usage example |
SENS:DLOG:CLE |
Errors |
-241,"Hardware missing" |
5.15.6. 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> |
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 |
5.15.7. SENSe:DLOG:FUNCtion:DIGital[:INPut]
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 |
5.15.8. 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> |
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 |
5.15.9. 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> |
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 |
5.15.10. SENSe:DLOG:PERiod
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 |
5.15.11. 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 |
5.15.12. SENSe:DLOG:TRACe:BOOKmark
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>} |
5.15.13. SENSe:DLOG:TRACe[:DATA]
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 |
5.15.14. SENSe:DLOG:TRACe:REMark
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] |
5.15.15. SENSe:DLOG:TRACe:X:LABel
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 |
5.15.16. 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 |
5.15.17. SENSe:DLOG:TRACe:X:STEP
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 |
5.15.18. SENSe:DLOG:TRACe:X[:RANGe]:MIN
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 |
5.15.19. SENSe:DLOG:TRACe:X[:RANGe]:MAX
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 |
5.15.20. SENSe:DLOG:TRACe:X:SCALe
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 |
5.15.21. SENSe:DLOG:TRACe:Y<n>:LABel
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 |
5.15.22. SENSe:DLOG:TRACe:Y<n>[:RANGe]:MIN
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 |
5.15.23. SENSe:DLOG:TRACe:Y<n>[:RANGe]:MAX
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 |
5.15.24. SENSe:DLOG:TRACe:Y:SCALe
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 |
5.15.25. SENSe:DLOG:TRACe:Y<n>:UNIT
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 |
5.15.26. SENSe:FUNCtion[:ON]
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] |
5.15.27. SENSe:NPLCycles
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 |
5.15.28. SENSe:VOLTage[:DC]:RANGe
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 |