Sense:Multiplexer Commands


Controls External Test Sets (N44xx, E5091A, "Z", and "H" series).

Click on a keyword to view the command details.

Red commands are superseded.

See Also


SENSe:MULTiplexer<id>:ADDRess <address>

(Read-Write) Sets and returns the address for the external test set at the specified ID. This command should be immediately preceded by the SENSe:MULT:TYPE command.

Parameters

 

<id>

Id of the external test set. If unspecified, Id is assumed to be 1. Must be previously set by the SENSe:MULT:TYPE command.

<address>

Integer  The test set address.

  • For a GPIB test set (N44xx and some specials), this is the GPIB address.

  • For a test set I/O test set (some specials), it is the position of the test set in the chain (starting at 0).

  • For USB test sets (E5091A), the address is set by DIP switches on the rear panel.

Examples

SENS:MULT1:TYPE "Z5623A_K66" ' use K66 test set, and reference it through ID 1

SENS:MULT1:ADDR 0 ' first test set in sequence

' All subsequent commands using SENS:MULT1 will refer to this test set

Query Syntax

SENSe:MULTiplexer<id>:ADDRess?

Return Type

Numeric

Default

Not Applicable


SENSe<cnum>:MULTiplexer<id>:ALLPorts <string>

(Read-Write)  Sets or gets the port selections for all available ports on the specified channel.

Parameters

 

<cnum>

Any existing channel number. If unspecified, value is set to 1.

<id>

Id of the external test set. If unspecified, Id is assumed to be 1. Must be previously set by the SENSe:MULT:TYPE command.

<string>

Comma-separated list of port selections, one for each port. Each port selection must correspond to one of the values returned by SENS:MULT:PORT:CAT?.

Do NOT include + and - .

Examples

' for channel 5 and test set 1, set port 1 to T1,

' port 2 to A, port 3 to R2+, port 4 to R3-.

SENS5:MULT1:ALLP "T1,A,R2,R3 "

Query Syntax

SENSe<cnum>:MULTiplexer<id>:ALLPorts?

Return Type

STRING

Default

Not Applicable


SENSe:MULTiplexer:CATalog?

(Read-Only) Returns a comma-separated list of the external test sets models that are currently supported. Choose one of these items to send SENS:MULT1:TYPE.

Examples

SENS:MULT:CAT?

Return Type

String

Default

Not Applicable


SENSe:MULTiplexer<id>:COUNt?

(Read-Only) Returns the total number of ports of the specified test set.

Returns 0 if no test set is connected (GPIB test sets only).

Parameters

 

<id>

Id of the external test set. If unspecified, Id is assumed to be 1. Must be previously set by the SENSe:MULT:TYPE command.

Examples

SENS:MULT1:COUN?
sense:multiplexer2:count?

Return Type

Numeric

Default

Not Applicable


SENSe:MULTiplexer<id>:DISPlay[:STATe] <bool>

(Read-Write) Turns ON and OFF the display of the test set control status bar. This status bar indicates the test set that is being controlled and the current port mappings. This setting is turned ON automatically when the test set is enabled.

Parameters

 

<id>

Id of the external test set. If unspecified, Id is assumed to be 1. Must be previously set by the SENSe:MULT:TYPE command.

<bool>

ON(1)  Turns ON the display.

OFF (0)  Turns OFF the display.

Examples

SENS:MULT1:DISP 1
sense:multiplexer2:display:state on

Query Syntax

SENSe:MULTiplexer<id>:DISPlay[:STATe]?

Return Type

Boolean

Default

OFF (0)


SENSe:MULTiplexer<id>:INCount?

(Read-Only) Returns the number of input ports for the specified test set.

  • For test sets such as the E5091A that do NOT use jumper cables to route the stimulus and response signals, this command returns the number of test set ports that can be connected to the PNA.

  • For test sets that DO use jumper cables to route the stimulus and response signals, such as the N44xx, the return value is not valid.

Parameters

 

<id>

Id of the external test set. If unspecified, Id is assumed to be 1. Must be previously set by the SENSe:MULT:TYPE command.

Examples

SENS3:MULT1:INC?  ' returns the number of input ports for test set 1 on channel 3

Return Type

Numeric

Default

Not Applicable


SENSe<cnum>:MULTiplexer:LABel <string>

(Read-Write) Sets and returns the display label for the testset on the specified channel. The label appears in a status bar at the bottom of the PNA display when SENS:MULT:DISP is set to ON.

Parameters

 

<cnum>

Any existing channel number. If unspecified, value is set to 1.

<string>

Display label text.

Examples

SENS3:MULT:LAB 'High-power output'

Query Syntax

SENSe<cnum>:MULTiplexer:LABel?

Return Type

String

Default

Not Applicable


SENSe<cnum>:MULTiplexer<id>:OUTPut[:DATa] <num>

(Read-Write) Sets or returns the control line value for the specified channel.

Parameters

 

<cnum>

Any existing channel number. If unspecified, value is set to 1.

<id>

Id of the external test set. If unspecified, Id is assumed to be 1. Must be previously set by the SENSe:MULT:TYPE command.

<numr>

An integer specifying the decimal value of the control line. Values are obtained by adding weights from the following table that correspond to individual lines.

Line

Weight

1

1

2

2

3

4

4

8

5

16

6

32

7

64

8

128

 

Note:

  • The E5091A interprets SENS:MULT1:OUTP 0 as all lines OFF.

  • All "Z"and "H" series test sets interpret SENS:MULT1:OUTP 0 as all lines ON.

Refer to your test set documentation for setting control line values.

 

Examples

SENS3:MULT1:OUTP 48  'For Z5623A K64, lines 5 and 6 are OFF; all other lines are set to ON state.

Query Syntax

SENSe<cnum>:MULTiplexer<id>:OUTPut[:DATa]?

Return Type

Numeric

Default

Not Applicable


SENSe:MULTiplexer<id>:PORT<pnum>:CATalog?

(Read-Only) Returns a comma-separated list of valid port selections for the specified port.

Parameters

 

<id>

Id of the external test set. If unspecified, Id is assumed to be 1. Must be previously set by the SENSe:MULT:TYPE command.

<pnum>

Integer - Input port number for which to return valid Output port selections. Read the number of input ports for the test set using SENS:MULT:INCount?

Examples

SENS:MULT1:PORT3:CAT?  ' returns the valid port selections for port 3

Return Type

String

Default

Not Applicable


SENSe<cnum>:MULTiplexer<id>:PORT<pnum>:SELect <string>

(Write-Only) Sets and returns a port mapping for a single port. If this command creates a conflict with an existing port, the PNA will resolve the conflict.

Note: This command is not supported for the Z5623AK44.

Parameters

 

<cnum>

Channel number of the measurement. If unspecified, value is set to 1.

<id>

Id of the external test set. If unspecified, Id is assumed to be 1. Must be previously set by the SENSe:MULT:TYPE command.

<pnum>

Integer - Logical port number.

<string>

Physical port number.

Examples

SENS:MULT1:PORT3:SEL "4" 'sets logical port 3 to physical port 4.

Return Type

String

Default

Not Applicable


SENSe:MULTiplexer<id>:STATe <bool>

(Read-Write) Enables and disables (ON/OFF) the port mapping and control line output of the specified test set.

If the specified test set is not connected or not ON, then setting State ON will report an error. All other properties can be set when the test set is not connected.

When this command is set to ON, then the display of the test set status bar (SENS:MULT:DISP) is also set to ON.

Parameters

 

<id>

Id of the external test set. If unspecified, Id is assumed to be 1. Must be previously set by the SENSe:MULT:TYPE command.

<bool>

ON(1)  Enables test set control.

OFF (0)  Disables test set control.

Examples

SENS:MULT1:STAT 1
sense2:multiplexer2:state on

Query Syntax

SENSe<cnum>:MULTiplexer<id>:STATe?

Return Type

Boolean

Default

OFF (0)


SENSe<cnum>:MULTiplexer<id>:TSET9:OUTPut[:DATA] <data> Superseded

Note: This command is replaced with SENS:MULT:OUTP

(Read-Write) Sets the control lines of the specified E5091A. Control lines, provided through a E5091A front panel connector, are used to control external equipment such as a part handler. See your E5091A documentation to learn more about control lines.

Parameters

 

<cnum>

Channel number of the measurement. If unspecified, value is set to 1.

<id>

Id of the E5091A test set. Choose from 1 or 2. Learn how to set ID value.

<data>

Data value used to set control lines. Values are obtained by adding weights from the following table that correspond to individual lines. HIGH =1; LOW=0.

Line

Weight

1

1

2

2

3

4

4

8

5

16

6

32

7

64

8

128

0 - Sets all lines low

255 - Sets all lines high

Examples

'The following sets line 3 and 4 high. All other lines low.

SENS:MULT1:TSET9:OUTP 12

Query Syntax

SENSe<cnum>:MULTiplexer<id>:TSET9:OUTPut[:DATA]?

Return Type

Numeric

Default

0


SENSe<cnum>:MULTiplexer<id>:TSET9:PORT1 <char> Superseded

Note: This command is replaced with SENS:MULT:ALLPorts which sets ALL ports to the specified outputs.

(Read-Write)  Switches Port 1 of the specified E5091A to one of the available outputs.

Parameters

 

<cnum>

Any existing channel number; if unspecified, value is set to 1.

<id>

Id of the E5091A test set. Choose from 1 or 2. Learn how to set ID value.

<char>

Output port to be switched to. Choose from:

A

T1 - (If Port 2 already is connected to T1, then Port 2 will be switched to T2.)

Examples

SENS:MULT1:TSET9:PORT1 A

Query Syntax

SENSe<cnum>:MULTiplexer<id>:TSET9:PORT1?

Return Type

Character

Default

A


SENSe<cnum>:MULTiplexer<id>:TSET9:PORT2 <char> Superseded

Note: This command is replaced with SENS:MULT:ALLPorts which sets ALL ports to the specified outputs.

(Read-Write)  Switches Port 2 of the specified E5091A to one of the available outputs.

Parameters

 

<cnum>

Any existing channel number; if unspecified, value is set to 1.

<id>

Id of the E5091A test set. Choose from 1 or 2. Learn how to set ID value.

<char>

Output port to be switched to. Choose from:

T1 - If Port 1 already is connected to T1, then Port 1 will be switched to A.

T2

Examples

SENS:MULT1:TSET9:PORT2 T2

Query Syntax

SENSe<cnum>:MULTiplexer<id>:TSET9:PORT2?

Return Type

Character

Default

T1


SENSe<cnum>:MULTiplexer<id>:TSET9:PORT3 <char> Superseded

Note: This command is replaced with SENS:MULT:ALLPorts which sets ALL ports to the specified outputs.

(Read-Write)  Switches Port 3 of the specified E5091A to one of the available outputs.

Parameters

 

<cnum>

Any existing channel number; if unspecified, value is set to 1.

<id>

Id of the E5091A test set. Choose from 1 or 2. Learn how to set ID value.

<char>

Output port to be switched to. Choose from:

R1 (R1+)

R2 (R2+)

R3  (R3+) If option 007 (7port), R2 is selected.

Examples

SENS:MULT1:TSET9:PORT3 R2

Query Syntax

SENSe<cnum>:MULTiplexer<id>:TSET9:PORT3?

Return Type

Character

Default

R1


SENSe<cnum>:MULTiplexer<id>:TSET9:PORT4 <char> Superseded

Note: This command is replaced with SENS:MULT:ALLPorts which sets ALL ports to the specified outputs.

(Read-Write)  Switches Port 4 of the specified E5091A to one of the available outputs.

Parameters

 

<cnum>

Any existing channel number; if unspecified, value is set to 1.

<id>

Id of the E5091A test set. Choose from 1 or 2. Learn how to set ID value.

<char>

Output port to be switched to. Choose from:

R1 (R1-)

R2 (R2-)

R3 (R3-) If option 007 (7port), R2 is selected.

Examples

SENS:MULT1:TSET9:PORT4 R2

Query Syntax

SENSe<cnum>:MULTiplexer<id>:TSET9:PORT4?

Return Type

Character

Default

R1


SENSe:MULTiplexer<id>:TYPe <name>

(Read-Write) Loads a configuration file for the specified type of external test set.

This command should be immediately followed by the SENSe:MULT:ADDRess command.

Parameters

 

<name>

 

String  The name of the type of test set. Must be one of the items in the list returned by the SENSe:MULT:CATalog? query.

<id>

Id of the external test set. Set by this command. Use consecutive values starting at 1.

Examples

SENS:MULT1:TYPE "Z5623AK66"   ' use K66 test set, and reference it through ID 1

Query Syntax

SENSe:MULTiplexer<id>:TYPe?

Return Type

String

Default

Not Applicable