Installation manual

Model 8210A-2-5 IM-377
Aeroflex / Weinschel
33
7-14. Switch Control
SWITCH Function: Set switch value
Syntax: SWITCH name setting (specific form) or SWITCH setting (non-specific form)
Argument(s): name string10 switch name
setting integer16 desired switch setting
Remarks: This function sets the outputs of switch name to setting. This command may be
used with both physical and virtual switch devices supporting the SwitchProtocol. The parameter
name must have been previously assigned using either the ASSIGN or ASSIGN SWITCH command.
The non-specific form of this command will set all switch devices found during the configuration
process to the value setting. It may be used to initialize the system, or as an easy method of
programming systems that contain a single switch. Also, this form allows the value of atten to be
specified as -1, which results in each device being programmed to it’s maximum attenuation value.
Return Value: none
Example(s): SWITCH SW1 1
SWITCH SwTwo 8 SWITCH 0
SWITCH? Function: Read switch setting
Syntax: SWITCH? name (specific form) or SWITCH? (non-specific form)
Argument(s): name string10 switch name
Remarks: In the specific form, this function reads the setting of switch name. This command may be
used with both physical and virtual switch devices supporting the SwitchProtocol. The parameter
name must have been previously assigned using either the ASSIGN or ASSIGN SWITCH command.
The non-specific form may be used in systems where there is only a single switch.
Return Value: setting integer16 setting
Example(s): SWITCH? SW1 returns ’1’
SWITCH? GETCAP Function: Reads the capability of a switch
Syntax: SWITCH? GETCAP name
Argument(s): name string10 switch name
Remarks: This function reads the capability information of switch name. This command may
be used with both physical and virtual switch devices supporting the SwitchProtocol. The parameter
name must have been previously assigned using either the ASSIGN or ASSIGN SWITCH command.
The capability information includes the switch mask value of the device, and the operational mode.
Return Value: mask integer16 switch output mask
mode integer operational mode (0=encoded, 1=decoded)
Example(s): SWITCH? GETCAP SW1 returns ’7, 1’