Configurable Switch Matrix

The Configurable Switch Matrix device driver is a Switch Matrix which is supported by RadiMation^®.  

This switch matrix device driver can be used to control relays with RadiMation^®, even if no specific device driver is yet available for those relays. See RadiMation Application Note 167: Controlling a custom relay via the Configurable Switch Matrix driver for a simple example of how this device driver can be used.

On the Communication tab, the desired communication method can be selected and configured. Depending on the selected method, additional relevant settings are shown and can be configured.

Communication Streams

Selects the medium or method that should be used to communicate with the device. Depending on the capabilities of the device this can be one or more of: GPIB HTTP Manual RS-232 RSIB TCPIP UDP USB VISA Depending on the selected communication stream, additional configuration parameters can be configured. See the Communication Settings in Chapter 15, on how to configure each of these communication streams.

For all text fields the following applies: when a text field is left empty, no command is sent at that time.

Device Driver

Reset Text field to specify the reset command. The command is sent to the device during the test initialization. Init Text field to specify the initialize command. The command is sent to the device during the test initialization. Get ID Text field to specify the *IDN? query. The command is sent to the device during the device check. Returned ID Text field to specify the expected respond to have the Get ID compared with. The string is used during the device check in case a query is specified. Deinit Text field to specify the deinitialize command. The command is sent to the device during the test deinitialization.

Operation

During Test Commands (one per line) sent to the device just before starting the test. After Test Commands (one per line) sent to the device after finishing the test. After sending perform a read and discard result When selected the driver will perform a read after sending the command. Some devices need to be read out before sending the next command.

Operation Complete

Wait for Operation Completion after sending command(s) This will append the *OPC? to the commands being sent.

The following fields can be specified to sent commands at each event. In several of the commands a keyword can be specified, which will be replaced by the actual value.

Test	Test started Test stopped

Signal

Frequency changed Keyword __freq__ will be replaced by the frequency in MHz. Carrier Level changed Keyword __carrier__, will be replaced by the carrier level in dBm.

Dwell-time

Dwell-time started Dwell-time stopped

Modulation

Modulation on Modulation off

The following fields can be specified to sent commands at each event. Depending on the event, the keyword __result__ can be used and is replaced by a value. For example: "My forward power is __result__dBm" will be replaced by: "My forward power is -3.15dBm".

Measurements

Before Forward Power After Forward Power Keyword __result__ will be replaced by measured Forward power in dBm. Before Reflected Power After Reflected Power Keyword __result__ will be replaced by measured Reflected power in dBm. Net Forward Power Keyword __result__ will be replaced by measured Net power in dBm Field Sensor Keyword __result__ will be replaced by measured Field strength in V/m

The following fields can be specified to sent commands at each event.

Antenna Tower

Antenna Tower started Antenna Tower stopped Antenna Tower changed Antenna Tower polarization

Turntable

Turntable started Turntable stopped Turntable changed

In all of the commands, it is also possible to include a keyword to insert the latest known value of another measurement value. Several keywords are available can be included in these commands. When one of these keywords is detected, it will be replaced by the corresponding value.

keyword	inserted value
__freq__	the signal generator frequency expressed in MHz
__freqHz__	the signal generator frequency expressed in Hz
__freqkHz__	the signal generator frequency expressed in kHz
__freqMHz__	the signal generator frequency expressed in MHz
__freqGHz__	the signal generator frequency expressed in GHz
__carrier__	the signal generator carrier level expressed in dBm
__carrierdBm__	the signal generator carrier level expressed in dBm
__carrierW__	the signal generator carrier level expressed in Watt
__carriermW__	the signal generator carrier level expressed in milli-Watt
__forward__	the forward power expressed in dBm
__forwarddBm__	the forward power expressed in dBm
__forwardW__	the forward power expressed in Watt
__forwardmW__	the forward power expressed in milli-Watt
__reflected__	the reflected power expressed in dBm
__reflecteddBm__	the reflected power expressed in dBm
__reflectedW__	the reflected power expressed in Watt
__reflectedmW__	the reflected power expressed in milli-Watt
__height__	the height where the antenna is moving to expressed in metre
__heightm__	the height where the antenna is moving to expressed in metre
__heightcm__	the height where the antenna is moving to expressed in centimetre
__angle__	the angle where the turntable is turning to expressed in degrees
__degree__	the angle where the turntable is turning to expressed in degrees
__radian__	the angle where the turntable is turning to expressed in radians

Please note the following regarding these keywords:

• the keywords are case sensitive,
• the latest known value at that moment will be used,
• if no value is known at all, the keyword will not be replaced, and will remain in the command,
• the values are transmitted in non-scientific notation, and will use a '.' as a decimal point.

Power expressed in milliWatt in dB values.

• 1 mW = 0 dBm

• 2 mW = 3 dBm

• 100 mW = 20 dBm

• 1 W = 30 dBm

• 100 W = 50 dBm