Configurable Switch Matrix: Difference between revisions

From RadiWiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(19 intermediate revisions by 3 users not shown)
Line 7: Line 7:
}}
}}
<!-- Include a space to get a newline!! --> <!-- Beware of the space!! -->
<!-- Include a space to get a newline!! --> <!-- Beware of the space!! -->
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: [[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.
{{:DeviceDriverCommunicationTab}}


[[Image:Screenshot configurable switch matrix configuration window.png]]
[[Image:Screenshot configurable switch matrix configuration window.png]]


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


{{ScreenElementDescription|Device Driver|
{{ScreenElementDescription|Device Driver|
{{ScreenElementDescription|Reset|Text field to specify the reset command. The command is send to the device during the test initialization.}}
{{ScreenElementDescription|Reset|Text field to specify the reset command. The command is sent to the device during the test initialization.}}
{{ScreenElementDescription|Init|Text field to specify the initialize command. The command is send to the device during the test initialization.}}
{{ScreenElementDescription|Init|Text field to specify the initialize command. The command is sent to the device during the test initialization.}}
{{ScreenElementDescription|Get ID|Text field to specify the *IDN? query. The command is send to the device during the device check.}}
{{ScreenElementDescription|Get ID|Text field to specify the *IDN? query. The command is sent to the device during the device check.}}
{{ScreenElementDescription|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.}}
{{ScreenElementDescription|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.}}
{{ScreenElementDescription|Deinit|Text field to specify the deinitialize command. The command is send to the device during the test deinitialization.}}
{{ScreenElementDescription|Deinit|Text field to specify the deinitialize command. The command is sent to the device during the test deinitialization.}}
}}
}}


{{ScreenElementDescription|Operation|
{{ScreenElementDescription|Operation|
{{ScreenElementDescription|During Test|The command is send to the device just before starting the test.}}
{{ScreenElementDescription|During Test|Commands (one per line) sent to the device just before starting the test.}}
{{ScreenElementDescription|After Test|The command is send to the device after finishing the test.}}
{{ScreenElementDescription|After Test|Commands (one per line) sent to the device after finishing the test.}}
{{ScreenElementDescription|After sending perform a read and discard result|When selected the driver will perform a read after sending the command. Some device need to be read out before  
{{ScreenElementDescription|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.}}
sending the next command.}}
}}
}}


{{ScreenElementDescription|Operation Complete|
{{ScreenElementDescription|Operation Complete|
{{ScreenElementDescription|Wait for Operation Completion after sending command(s)|This will append the *OPC? to the commands being send.}}
{{ScreenElementDescription|Wait for Operation Completion after sending command(s)|This will append the *OPC? to the commands being sent.}}
}}
}}


[[Image:Configurable_switch_matrix_configuration_window_custom2.png]]
[[Image:Configurable_switch_matrix_configuration_window_custom2.png]]


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.
{{ScreenElementDescription|Test|
{{ScreenElementDescription|Test|
{{ScreenElementDescription|Test started|Text field to specify the command, which is send to the device at start of a test.}}
{{ScreenElementDescription|Test started|}}
{{ScreenElementDescription|Test stopped|Text field to specify the command, which is send to the device when a test has ended.}}
{{ScreenElementDescription|Test stopped|}}
}}
}}
{{ScreenElementDescription|Signal|
{{ScreenElementDescription|Signal|
{{ScreenElementDescription|Frequency changed|Text field to specify the command, which is send to the device when the frequency has changed. The __freq__ will be replaced by the frequency value in case the retrieval of the respond was successful.}}
{{ScreenElementDescription|Frequency changed|     Keyword __freq__ will be replaced by the frequency in MHz.}}
{{ScreenElementDescription|Carrier Level changed|Text field to specify the command, which is send to the device when the carrier level has changed. The __carrier__ will be replaced by the carrier level value in case the retrieval of the respond was successful.}}
{{ScreenElementDescription|Carrier Level changed| Keyword __carrier__, will be replaced by the carrier level in dBm.}}
}}
}}
{{ScreenElementDescription|Dwell-time|
{{ScreenElementDescription|Dwell-time|
{{ScreenElementDescription|Dwell-time started|Text field to specify the command, which is send to the device when the dwell-time has started.}}
{{ScreenElementDescription|Dwell-time started|}}
{{ScreenElementDescription|Dwell-time stopped|Text field to specify the command, which is send to the device when the dwell-time has stopped.}}
{{ScreenElementDescription|Dwell-time stopped|}}
}}
}}
{{ScreenElementDescription|Modulation|
{{ScreenElementDescription|Modulation|
{{ScreenElementDescription|Modulation on|Text field to specify the modulation on command. The command is send to the device when the modulation must be turned on.}}
{{ScreenElementDescription|Modulation on|}}
{{ScreenElementDescription|Modulation off|Text field to specify the modulation off command. The command is send to the device when the modulation must be turned off.}}
{{ScreenElementDescription|Modulation off|}}
}}
}}


[[Image:Configurable_switch_matrix_configuration_window_custom3.png]]
[[Image:Configurable_switch_matrix_configuration_window_custom3.png]]


For the following specified commands is applicable that the __result__ will be replaced by the results in case the respond was retrieved successfully.
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".


{{ScreenElementDescription|Measurements|
{{ScreenElementDescription|Measurements|
{{ScreenElementDescription|Before Forward Power|}}
{{ScreenElementDescription|Before Forward Power|}}
{{ScreenElementDescription|After Forward Power|  Keyword __result__ will be replaced by measured Forward power in dBm}}
{{ScreenElementDescription|After Forward Power|  Keyword __result__ will be replaced by measured Forward power in dBm.}}
{{ScreenElementDescription|Before Reflected Power|}}
{{ScreenElementDescription|Before Reflected Power|}}
{{ScreenElementDescription|After Reflected Power|Keyword __result__ will be replaced by measured Reflected power in dBm}}
{{ScreenElementDescription|After Reflected Power|Keyword __result__ will be replaced by measured Reflected power in dBm. }}
{{ScreenElementDescription|Net Forward Power|    Keyword __result__ will be replaced by measured Net power in dBm}}
{{ScreenElementDescription|Net Forward Power|    Keyword __result__ will be replaced by measured Net power in dBm}}
{{ScreenElementDescription|Field Sensor|        Keyword __result__ will be replaced by measured Field strength in V/m}}
{{ScreenElementDescription|Field Sensor|        Keyword __result__ will be replaced by measured Field strength in V/m}}
Line 64: Line 70:


[[Image:Configurable_switch_matrix_configuration_window_custom4.png]]
[[Image:Configurable_switch_matrix_configuration_window_custom4.png]]
The following fields can be specified to sent commands at each event.


{{ScreenElementDescription|Antenna Tower|
{{ScreenElementDescription|Antenna Tower|
{{ScreenElementDescription|Antenna Tower started|Text field to specify the command. The command is send to the device at start of movement of the Antenna Tower.}}
{{ScreenElementDescription|Antenna Tower started|}}
{{ScreenElementDescription|Antenna Tower stopped|Text field to specify the command. The command is send to the device when the movement of the Antenna Tower stopped.}}
{{ScreenElementDescription|Antenna Tower stopped|}}
{{ScreenElementDescription|Antenna Tower changed|Text field to specify the command. The command is send to the device when the Antenna Tower height has changed.}}
{{ScreenElementDescription|Antenna Tower changed|}}
{{ScreenElementDescription|Antenna Tower polarization|Text field to specify the command. The command is send to the device when the Antenna Tower Polarization has changed.}}
{{ScreenElementDescription|Antenna Tower polarization|}}
}}
}}


{{ScreenElementDescription|Turntable|
{{ScreenElementDescription|Turntable|
{{ScreenElementDescription|Turntable started|Text field to specify the command. The command is send to the device at start of movement of the Turntable.}}
{{ScreenElementDescription|Turntable started|}}
{{ScreenElementDescription|Turntable stopped|Text field to specify the command. The command is send to the device when the movement of the Turntable stopped.}}
{{ScreenElementDescription|Turntable stopped|}}
{{ScreenElementDescription|Turntable changed|Text field to specify the command. The command is send to the device when the Turntable angle has changed.}}
{{ScreenElementDescription|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.
{|class="wikitable"
!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.


[[Category:Configurable Drivers]]
[[Category:Configurable Drivers]]

Latest revision as of 10:52, 4 November 2025

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.

GPIB DeviceStream Configuration.png

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.

ScreenElementDescription.svg 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:

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.


Screenshot configurable switch matrix configuration window.png

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

ScreenElementDescription.svg Device Driver
ScreenElementDescription.svg Reset Text field to specify the reset command. The command is sent to the device during the test initialization.
ScreenElementDescription.svg Init Text field to specify the initialize command. The command is sent to the device during the test initialization.
ScreenElementDescription.svg Get ID Text field to specify the *IDN? query. The command is sent to the device during the device check.
ScreenElementDescription.svg 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.
ScreenElementDescription.svg Deinit Text field to specify the deinitialize command. The command is sent to the device during the test deinitialization.
ScreenElementDescription.svg Operation
ScreenElementDescription.svg During Test Commands (one per line) sent to the device just before starting the test.
ScreenElementDescription.svg After Test Commands (one per line) sent to the device after finishing the test.
ScreenElementDescription.svg 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.

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

Configurable switch matrix configuration window custom2.png

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.

ScreenElementDescription.svg Test
ScreenElementDescription.svg Test started
ScreenElementDescription.svg Test stopped
ScreenElementDescription.svg Signal
ScreenElementDescription.svg Frequency changed Keyword __freq__ will be replaced by the frequency in MHz.
ScreenElementDescription.svg Carrier Level changed Keyword __carrier__, will be replaced by the carrier level in dBm.
ScreenElementDescription.svg Dwell-time
ScreenElementDescription.svg Dwell-time started
ScreenElementDescription.svg Dwell-time stopped
ScreenElementDescription.svg Modulation
ScreenElementDescription.svg Modulation on
ScreenElementDescription.svg Modulation off


Configurable switch matrix configuration window custom3.png

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".

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

Configurable switch matrix configuration window custom4.png

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

ScreenElementDescription.svg Antenna Tower
ScreenElementDescription.svg Antenna Tower started
ScreenElementDescription.svg Antenna Tower stopped
ScreenElementDescription.svg Antenna Tower changed
ScreenElementDescription.svg Antenna Tower polarization
ScreenElementDescription.svg Turntable
ScreenElementDescription.svg Turntable started
ScreenElementDescription.svg Turntable stopped
ScreenElementDescription.svg 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
Retrieved from "https://wiki.radimation.com/wiki/index.php?title=Configurable_Switch_Matrix&oldid=104188"