Control Handler Commands

Specifies the settings to remotely control the Material Handler IO connector.

Click on a blue keyword to view the command details.

CONTrol:HANDler:C:MODE <char>

Applicable Models: E505xA (Read-Write) Sets and reads the direction of data flow for Port C.
Parameters
<char>	Direction of flow. Choose from: INPut - Port C is used to input data OUTPut - Port C is used to output data
Examples	CONT:HAND:C:MODE INP control:handler:c:mode output
Query Syntax	CONTrol:HANDler:C:MODE?
Return Type	Character
Default	INPut

CONTrol:HANDler:D:MODE <char>

Applicable Models: E505xA (Read-Write) Sets and reads the direction of data flow for Port D.
Parameters
<char>	Direction of flow. Choose from: INPut - Port D is used to input data OUTPut - Port D is used to output data
Examples	CONT:HAND:D:MODE INP control:handler:d:mode output
Query Syntax	CONTrol:HANDler:D:MODE?
Return Type	Character
Default	Input

CONTrol:HANDler:<port>[:DATa] <num>

Applicable Models: E505xA (Read-Write) Writes and reads data on the specified port.
Parameters
<port>	Port identifier to set bits for. Choose from: A,B,C,D,E,F,G,H
<num>	The number of the data bits to set. Refer to the following table for the maximum number for each port. The minimum number for each port is 0.

Port	Max allowable <num>	MSB...........................................LSB 23...................................................0
A	255	A7...A0	Write-only
B	255	B7...B0	Write-only
C	15	C3...C0	Read-Write
D	15	D3...D0	Read-Write
E	255	D3...D0 + C3...C0	Read-Write
F	65535	B7...B0 + A7...A0	Write-only
G	1048575	C3...C0 + B7...B0 + A7...A0	Write-only
H	16777215	D3...D0 + C3...C0 + B7...B0 + A7...A0	Write-only

	Note: When writing to port G, port C must be set to output mode When writing to port H, both port C and port D must be set to output mode. Use CONT:HAND:C:MODE OUTP and CONT:HAND:D:MODE OUTP
Examples	CONT:HAND:A 254 control:handler:c:data 12
Query Syntax	CONTrol:HANDler:<port>:DATA?
Return Type	Numeric
Default	Not Applicable

CONTrol:HANDler[:EXTension]:INDex:LOGic <char>

Applicable Models: E505xA (Read-Write) Sets the logic of the index line. There is no soft front-panel element for this feature. (M937xA) Index is on "Trig Out" port on the last PXIe module
Parameters
<charl>	Choose from: POSitive - Causes the Index line to have positive logic (Low signal indicates that the measurement is complete) NEGative - Causes the Index lines to have negative logic (High signal indicates that the measurement is complete).
Examples	CONT:HAND:IND:LOG NEG control:handler:extension:index:logic negaive
Query Syntax	CONTrol:HANDler[:EXTension]:INDex:LOGIC?
Return Type	Character
Default	POSitive

CONTrol:HANDler[:EXTension]:INDex[:STATe] <bool>

Applicable Models: E505xA (Read-Write) Determines the control of Material Handler connector Pin 20. A "Mnemonic not implemented" error is returned if the VNA does NOT have this capability.
Parameters
<bool>	Choose from: ON (1) - Pin 20 is controlled by the Index signal OFF (0) - Pin 20 is controlled by Output Port B6
Examples	CONT:HAND:IND 1 control:handler:extension:index:state off
Query Syntax	CONTrol:HANDler[:EXTension]:INDex[:STATe]?
Return Type	Boolean
Default	OFF

CONTrol:HANDler[:EXTension]:RTRigger[:STATe] <bool>

Applicable Models: E505xA (Read-Write) Determines the control of Material Handler connector Pin 21. A "Mnemonic not implemented" error is returned if the VNA does NOT have this capability.
Parameters
<bool>	Choose from: ON (1) - Pin 21 is controlled by the Ready for Trigger signal OFF (0) - Pin 21 is controlled by Output Port B7
Examples	CONT:HAND:RTR 1 control:handler:extension:rtrigger:state off
Query Syntax	CONTrol:HANDler[:EXTension]:RTRigger[:STATe]?
Return Type	Boolean
Default	OFF

CONTrol:HANDler:INPut?

Applicable Models: E505xA (Read-Only) Reads a hardware latch that captures high to low transitions on Input1 of the Material Handler IO. Reading the latch causes it to reset and is ready for the next transition. The hardware latch is only capable of capturing one transition per query. Additional transitions are ignored until after the next query. Momentarily driving Input1 high, then low, will cause a transition to be detected and latched.
Examples	CONT:HAND:INP? control:handler:input?
Return Type	Integer - Returns a value of zero or one. 0 - No transition detected since last query. 1 - Transition detected.
Default	Not Applicable

CONTrol:HANDler:LOGic <char>

Applicable Models: E505xA (Read-Write) Sets the logic of the Data ports A-H on the Handler connector. Some of these lines are connected internally to the AuxIO.
Parameters
<char>	Choose from: POSitive- Causes the Port lines to have positive logic (high = 1, low = 0). NEGative- Causes the Port lines to have negative logic (high = 0, low = 1). For ports that are in output (write) mode, a change in logic causes the output lines to change state immediately. For example, Low levels change immediately to High levels. For ports that are in input (read) mode (C,D,E only), a change in logic will be reflected when data is read from that port. For example, if a line read 0, the next read after a logic change will read 1.
Examples	CONT:HAND:LOG POS control:handler:logic negative
Query Syntax	CONTrol:HANDler:LOGic?
Return Type	Character
Default	NEGative

CONTrol:HANDler:OUTPut<port>[:DATa] <num>

Applicable Models: E505xA (Read-Write) Sets or reads the specified output line. Type 1 and Type 2 configurations: Returns the last value written to the selected output pin. Type 3 configuration: Returns the current state of the selected output pin. If an Input1 trigger occurs, the state may not be the same value as was written.
Parameters
<port>	Output port. Choose from: 1 - output 1(default) 2 - output 2 (M9341 does not support this)
<num>	0 - Low 1 - High
Examples	CONT:HAND:OUTPut1 1 control:handler:output2:data 0
Query Syntax	CONTrol:HANDler:OUTPut<num>:DATA?
Return Type	Boolean
Default	0 - Low

CONTrol:HANDler:OUTPut<port>:USER[:DATa] <num>

Applicable Models: E505xA (Read-Write) Sets or reads the specified USER output line. Type 1 and Type2 configurations: Returns the last value written to the selected output pin. Type3 configuration: Returns the current state of the selected output pin. If an Input1 trigger occurs, the state may not be the same value as was written. Learn about User Output.
Parameters
<port>	USER Output port. Choose from: 1 - User output 1(default) 2 - User output port. (M9341 does not support this)
<num>	0 - Low 1 - High
Examples	CONT:HAND:OUTPut1:USER 1 control:handler:output2:user:data 0
Query Syntax	CONTrol:HANDler:OUTPut<num>:USER:DATA?
Return Type	Boolean
Default	0 - Low

CONTrol:HANDler:PASSfail:LATCh <bool>

Applicable Models: E505xA (Read-Write) Enable the compatible mode with the E5071C for pass/fail status. If this is enabled, the pass/fail result of the Material Handler IO (pin33) is kept until next measurement . The default pass/fail state set is defined by CONTrol:HANDler:PASSfail:MODe <char>, and this function woks independently from the command “CONTrol:HANDler:PASSfail:MODe <char>”. This mode does not provide full compatibility with the E5071C in the timing chart perspective.
Parameters
<char>	Choose from: OFF (0)- Off. ON (1)- Enable Pass/Fail line latch mode. E5071C compatible.
Examples	CONT:HAND:PASS:LATC 1 control:handler:passfail:latch on
Query Syntax	CONTrol:HANDler:PASSfail:LATCh?
Return Type	Boolean
Default	OFF (0)

CONTrol:HANDler:PASSfail:LOGic <char>

Applicable Models: E505xA (Read-Write) Sets the logic of the PassFail line of the Material Handler IO (pin 33).
Parameters
<char>	Choose from: POSitive- Causes the PassFail line to have positive logic (high = pass, low = fail). NEGative- Causes the PassFail line to have negative logic (high = fail, low = pass).
Examples	CONT:HAND:PASS:LOG POS control:handler:passfail:logic negative
Query Syntax	CONTrol:HANDler:PASSfail:LOGic?
Return Type	Character
Default	POSitive

CONTrol:HANDler:PASSfail:MODe <char>

Applicable Models: E505xA (Read-Write) Sets and reads the default logical pass/fail state. This is the state the pass/fail line stays in until a failure occurs (if the mode is NOWait), or until an end-of-sweep condition occurs (if the mode is PASS or FAIL). The end-of-sweep condition is determined by the CONTrol:HANDler:PASSfail:SCOPe command.
Parameters
<char>	Choose from: PASS- the line stays in PASS state until the end-of-sweep condition occurs, at which time the pass/fail line is set, and the pass/fail strobe (line 36) is activated. FAIL- the line stays in FAIL state until the end-of-sweep condition occurs, at which time the pass/fail line is set, and the pass/fail strobe (line 36) is activated. NOWait- the pass/fail line is set, and the pass/fail strobe (line 36) is activated as soon as a failure condition occurs.
Examples	CONT:HAND:PASS:MODE NOW control:handler:passfail:mode fail
Query Syntax	CONTrol:HANDler:PASSfail:MODE?
Return Type	Character
Default	NOWait

CONTrol:HANDler:PASSfail:SCOPe <char>

Applicable Models: E505xA (Read-Write) Sets and reads the scope of pass/fail testing. The pass/fail line on the material handler port can report the status of all measurements on each channel, or all measurements on all channels. This command selects which option to use.
Parameters
<char>	Choose from: CHANnel - A pass/fail result is computed and written to the output pins at the end of all sweeps on a channel. GLOBal - A pass/fail result is computed and written to the output pins at the end of all sweeps on a channel. If the pass/fail mode is NOWait (as set by CONTrol:HANDler:PASSfail:MODe), the status and strobe pins are written immediately. Otherwise the pins are written as indicated above. Regardless of the mode value, the pass/fail line is returned to its default state (as set by the MODE command) at the end of channel or group of channels.
Examples	CONT:HAND:PASS:SCOP CHAN control:handler:passfail:scope sweep
Query Syntax	CONTrol:HANDler:PASSfail:SCOPe?
Return Type	Character
Default	GLOBal

CONTrol:HANDler:PASSfail:POLicy <char>

Applicable Models: E505xA (Read-Write) Sets the policy used to determine how global pass/fail is computed.
Parameters
<char>	Name of the policy to use. Choose from: ALLTests - Pass/Fail Status returns PASS if all tests on all measurements pass. ALLMeas - Pass/Fail Status returns PASS if all measurements have associated tests, and all tests pass. FAIL is returned if even one measurement has no associated limit test. Only those measurements which are not in HOLD mode contribute to the pass/fail result.
Examples	CONT:HAND:PASS:POL control:handler:passfail:policy
Query Syntax	CONTrol:HANDler:PASSfail:POLicy?
Return Type	Character
Default	ALLTests

CONTrol:HANDler:PASSfail:STATus?

Applicable Models: E505xA

(Read-Only) Returns the most recent pass/fail status value. Use this command as follows:

Set the VNA trigger scope to GLOBAL
Set the VNA trigger source to MANUAL or EXTERNAL.
Configure and enable Limit Testing.
Trigger the VNA.
Use the *OPC? command to determine when the sweep is complete.
Use the CONT:HAND:PASS:STAT? query to obtain the global pass/fail result.

Return Type

Character - One of the following is returned:

PASS - all measurements not in HOLD mode have been swept, and all associated limit tests have passed.

FAIL - all measurements not in HOLD mode have been swept, and one or more limit tests failed according to the specified Pass/Fail policy.

NONE - status cannot be determined because measurements are in progress.

Default

Not Applicable

CONTrol:HANDler:SWEepend <char>

Applicable Models: E505xA (Read-Write) Specifies the event that will cause the Handler Sweep End line to strobe. The strobe is at least 10ms in duration, and is activated when all calculations for the associated measurement are complete. This line is connected internally to the Sweep End line of the AUX IO connector.
Parameters
<char>	Choose from: SWEep - the line goes low when each sweep is complete CHANnel - the line goes low when all the sweeps for each channel is complete. GLOBal - the line goes low when all sweeps for all channels are complete. The default state of the passFail line (before a measurement occurs) and after a failure occurs is set by CONTrol:HANDler:PASSfail:MODe
Examples	CONT:HAND:SWE SWE control:handler:sweepend channel
Query Syntax	CONTrol:HANDler:SWEepend?
Return Type	Character
Default	GLOBal