Skip to content

SPDT Switch Commands

SPDT:MAIN:STATE?

Query the current switch state (canonical SPDT mnemonic).

Response: 0 or 1

Value Description
0 RF0
1 RF1

Example:

SPDT:MAIN:STATE?
1

SPDT:MAIN:STATE \<value>

Set the switch state (canonical SPDT mnemonic).

Parameters:

Value Description
0 Switch to RF0
1 Switch to RF1

Example:

SPDT:MAIN:STATE 1

Errors:

  • -101 — Invalid parameter (expected an integer state)
  • -102 — Invalid state; expected 0 or 1

Legacy SWITCH Alias

The legacy SWITch:MAIN[:STATe] commands are still registered on SPDT hardware and keep their documented short forms. They carry the same 0–1 range as the canonical SPDT:MAIN commands.

SWITCH:MAIN:STATE?

Query the current switch state.

Short form: SWIT:MAIN:STAT?

Aliases: SWITCH:MAIN?, SWIT:MAIN?

SWITCH:MAIN:STATE \<value>

Set the switch state.

Short form: SWIT:MAIN:STAT

Aliases: SWITCH:MAIN, SWIT:MAIN

*RST Behaviour

*RST returns the switch to RF1 (GPIO low), preserving the pre-rename physical effect. See common-commands.md.

Quick Reference

Command Description
*IDN? Query identification
*RST Reset to default state (RF1)
*CLS Clear error queue
SPDT:MAIN? Query switch state (canonical)
SPDT:MAIN <0\|1> Set switch state (canonical)
SWITCH:MAIN? Query switch state (legacy alias)
SWITCH:MAIN <0\|1> Set switch state (legacy alias)
:SYSTem:FIRMware:VERSion? Query firmware version
:SYSTem:FIRMware:STATus? Query update status
:SYSTem:FIRMware:UPDate <url> Install firmware from URL
:SYSTem:REBoot Reboot device