Skip to content

SP4T Switch Commands

The SP4T routes a common port (COM) to one of four throws (RF0..RF3). Only one throw is closed at a time; states are zero-based and there is no "all open" state.

SP4T:MAIN:STATE?

Query the currently routed throw.

Response: 0 to 3

Value Description
0 COMRF0
1 COMRF1
2 COMRF2
3 COMRF3

Example:

SP4T:MAIN:STATE?
2

SP4T:MAIN:STATE \<value>

Set the routed throw.

Parameters:

Value Description
0 Route COM to RF0
1 Route COM to RF1
2 Route COM to RF2
3 Route COM to RF3

Example:

SP4T:MAIN:STATE 2

Errors:

  • -101 — Invalid parameter (expected an integer state)
  • -102 — Invalid state; expected 0 to 3
  • -200 — Switch write failed

Short Forms and Aliases

Both mnemonics are all-caps, so SP4T has no abbreviated form:

Command Short form
SP4T:MAIN:STATE?
SP4T:MAIN:STATE
SP4T:MAIN?
SP4T:MAIN

The legacy SWITch:MAIN[:STATe] alias is also registered on SP4T hardware and keeps its documented SWIT:MAIN:STAT short form. It carries the SP4T valid range (0–3).

*RST Behaviour

*RST returns the switch to its power-on/reset state, RF0 (both select lines low). Note the asymmetry with the SPDT variant, where *RST restores RF1 — see common-commands.md.

Common (inherited)

*IDN?, *RST, *CLS per common-commands.md.

*IDN? response:

Nine Fives,POE-SP4T,<serial>,<version>