:CONFigure:PORT:PRESent?
Query Syntax
:CONFigure:PORT:PRESent? "<device-name>", "<port-name>"
Where <device-name> is a string that identifies a block on the Hardware Diagram.
Where <port-name> is a string that identifies a port on the specified block.
Query Response
{1 | 0}
Description
Confirms if the specified port is on the Hardware Diagram. The returned values can be:
- 1
- The specified port is on the Hardware Diagram. To determine if the port is connected to another port, use the
:CONFigure:PORT:CONNect?query. To connect the port, use the:CONFigure:PORT:CONNectcommand. To return the identity of any connected port, use the:CONFigure:PORT:CONNect:ALL?query. - 0
- The specified port does not exist on the Hardware Diagram.
| Device | <device-name> Argument Fields | Argument Examples | To Rename a Device 1 |
|---|---|---|---|
| Switches | |||
| Keysight N7731A | "N7731A (Switch <switch-number>)" | "N7731A (Switch 1)" "N7731A (Switch 2)" |
— |
| Keysight N7733C | "N7733C" | "N7733C" | — |
| Keysight N7734A | "N7734A" | "N7734A" | — |
| DiCon GP750 | "DiCon GP750 (<module-slot>:<module>)" | "DiCon GP750 (SL1:M3)" 2 "DiCon GP750 (SL2:X1)" |
— |
| DiCon GP600 | "DiCon GP600 (<module>)" | "DiCon GP600 (M1)" 2 "DiCon GP600 (X1)" |
— |
| Polatis 6000 | "Polatis 6000" | "Polatis 6000" | — |
| Switch (installed with custom driver) | "<model number> (<serial number>)" | "Acme 1200A (A12345)" | — 3 |
| DCA-M Modules | |||
| N1092-series DCA-M | "<model number>-<serial number>" | "N1092D-US92000003" | — |
| N107x-series DCA-M | "<model number>-<serial number>" | "N1078A-US78000002" | — |
| Fixtures | |||
| DUT Fixture | "<name>" | "DUT Fixture 1" | :CONFigure:FIXTure:REName
|
| WDM DUT Fixture | "<name>" | "WDM DUT Fixture 2" | :CONFigure:FIXTure:REName
|
| Impairments, Instrument, and Demultiplexers | |||
| Impairment | "<name>" | "Impairment 1" | :CONFigure:IMPairment:REName
|
| Instrument (installed with custom driver) | "<model number> (<serial number>)" | "Power Meter (US123456PM)" | — 4 |
| Demultiplexer | "<name>" | "Demux 4" | :CONFigure:DEMux:REName
|
A dash character (—) indicates that the name of the device cannot be changed.
The module identification strings (for example, "X1" and "M1") match the module identification label shown on Switch blocks. These example strings may not match the modules installed in your switch.
A name for a Switch (model number and serial number) is defined in a Switch driver and read by FlexOTO.
A name for an Instrument (model number and serial number) is defined in your Instrument driver and read by FlexOTO.
| Input Ports 1 | Output Ports 1 | |
|---|---|---|
| Switches | ||
| Keysight N7731A | "1" | "2" | "3" | "4" | "A" |
| Keysight N7733C | "1" | "2" | "3" | .... "16" | "A" |
| Keysight N7734A | "1" | "2" | "3" | .... "13" | "A" |
| DiCon GP750 | ||
| X1 module | "1" | "2" | "3" | "4" ... | "IN 1" | "IN 2" ... |
| M1 module | "1" | "2" | "3" | "4" ... | "IN" |
| DiCon GP600 | ||
| X1 module | "1" | "2" | "3" | "4" ... | "IN 1" | "IN 2" .... |
| M1 module | "1" | "2" | "3" | "4" ... | "IN" |
| Polatis 6000 | "1" to "24" | "25" to "48" |
| Switch (installed with custom driver) | defined in driver 2 | — |
| DCA-M Modules | ||
| N107x-series DCA-M | "Data In" | "Data Out" |
| — | "Clock Out" | |
| N1092-series DCA-M | "Clock In" | "Clock Out" |
| "A" | — | |
| "B" | — | |
| "C" | — | |
| "D" | — | |
| Fixtures | ||
| DUT Fixture | — | "1" | "2" | "3" ... | "8" |
| WDM DUT Fixture | — | "1" |
| Impairments, Instrument, and Demultiplexers | ||
| Impairment | "In" | "Out" |
| Instrument (installed with custom driver) | defined in driver 3 | — |
| Demux | "In" | "1" | "2" | "3" ... | "8" |
Port argument strings match the port labels shown on Switch blocks. Argument strings may or may not match the label on the switch's front panel. These example strings may not match the modules installed in your switch. Use the :CONFigure:PORT:ALL? query to return all valid port names for a hardware block.
Switch measurement port argument strings are defined in your Switch driver and read by FlexOTO.
Instrument measurement port argument strings are defined in your Instrument driver and read by FlexOTO.
Examples
| Optical Switch | Example Command Arguments for :CONFigure:PORT:CONNect 12 |
|---|---|
| Keysight N7731A | :CONFigure:PORT:PRESent? "N7731A Switch 1", "2"
|
:CONFigure:PORT:PRESent? "N7731A Switch 2", "1"
|
|
| Keysight N7733C | :CONFigure:PORT:PRESent? "N7733C", "6"
|
| Keysight N7734A | :CONFigure:PORT:PRESent? "N7734A", "5"
|
| DiCon GP750 | :CONFigure:PORT:PRESent? "DiCon GP750 (SL2:X1)", "12"
|
:CONFigure:PORT:PRESent? "DiCon GP750 (SL1:M1)", "8"
|
|
:CONFigure:PORT:PRESent? "DiCon GP750 (SL3:X1)", "28"
|
|
| DiCon GP600 | :CONFigure:PORT:PRESent? "DiCon GP600 (X1)", "15"
|
:CONFigure:PORT:PRESent? "DiCon GP600 (M1)", "4"
|
|
| Polatis 6000 | :CONFigure:PORT:PRESent? "Polatis 6000", "5"
|
Due to the variety of options available, use FlexOTO's SCPI recorder when not sure about valid parameter strings.
Maximum port number depends on installed switch module.