5.15. SENSe – EEZ – Envox Experimental Zone

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
: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

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
Parameters	<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?

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: Low – 0 to 3.3 / 5 V High – 0 to 12 V (resilient to 24 V)
Parameters	Name	Type	Range	Default
Parameters	<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
Parameters	<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
Parameters	<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
Parameters	<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
Parameters	<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
Parameters	<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

Cookie	Duration	Description
__cfduid	1 month	The cookie is used by cdn services like CloudFare to identify individual clients behind a shared IP address and apply security settings on a per-client basis. It does not correspond to any user ID in the web application and does not store any personally identifiable information.
cookielawinfo-checkbox-advertisement	1 year	The cookie is set by GDPR cookie consent to record the user consent for the cookies in the category "Advertisement".
cookielawinfo-checkbox-analytics	1 year	This cookies is set by GDPR Cookie Consent WordPress Plugin. The cookie is used to remember the user consent for the cookies under the category "Analytics".
cookielawinfo-checkbox-necessary	1 year	This cookie is set by GDPR Cookie Consent plugin. The cookies is used to store the user consent for the cookies in the category "Necessary".
cookielawinfo-checkbox-performance	1 year	This cookie is set by GDPR Cookie Consent plugin. The cookie is used to store the user consent for the cookies in the category "Performance".
PHPSESSID	session	This cookie is native to PHP applications. The cookie is used to store and identify a users' unique session ID for the purpose of managing user session on the website. The cookie is a session cookies and is deleted when all the browser windows are closed.

Cookie	Duration	Description
IDE	1 year 24 days	Used by Google DoubleClick and stores information about how the user uses the website and any other advertisement before visiting the website. This is used to present users with ads that are relevant to them according to the user profile.
test_cookie	15 minutes	This cookie is set by doubleclick.net. The purpose of the cookie is to determine if the user's browser supports cookies.
VISITOR_INFO1_LIVE	5 months 27 days	This cookie is set by Youtube. Used to track the information of the embedded YouTube videos on a website.
yt-remote-connected-devices	never	These cookies are set via embedded youtube-videos.
yt-remote-device-id	never	These cookies are set via embedded youtube-videos.
yt.innertube::nextId	never	These cookies are set via embedded youtube-videos.
yt.innertube::requests	never	These cookies are set via embedded youtube-videos.

Cookie	Duration	Description
aelia_cs_selected_currency	1 day	No description
CONSENT	16 years 9 months 21 days 7 hours 19 minutes	No description
cookielawinfo-checkbox-functional	1 year	The cookie is set by GDPR cookie consent to record the user consent for the cookies in the category "Functional".
cookielawinfo-checkbox-others	1 year	No description

Table of content