Configurable Switch Matrix: Difference between revisions

From RadiWiki
Jump to navigation Jump to search
(Updated DeviceDriverInfo template)
No edit summary
 
(18 intermediate revisions by 2 users not shown)
Line 33: Line 33:
[[Image:Configurable_switch_matrix_configuration_window_custom2.png]]
[[Image:Configurable_switch_matrix_configuration_window_custom2.png]]


The following fields can be specified to send 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 send 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|Text field to specify the command which will be send to the device before a Forward Power measurement.}}
{{ScreenElementDescription|Before Forward Power|}}
{{ScreenElementDescription|After Forward Power|Text field to specify the command which will be send to the device after a Forward Power measurement.}}
{{ScreenElementDescription|After Forward Power| Keyword __result__ will be replaced by measured Forward power in dBm.}}
{{ScreenElementDescription|Before Reflected Power|Text field to specify the command which will be send to the device before a Reflected Power measurement.}}
{{ScreenElementDescription|Before Reflected Power|}}
{{ScreenElementDescription|After Reflected Power|Text field to specify the command which will be send to the device after a Reflected Power measurement.}}
{{ScreenElementDescription|After Reflected Power|Keyword __result__ will be replaced by measured Reflected power in dBm. }}
{{ScreenElementDescription|Net Forward Power|Text field to specify the command which will be send to the device when Net Power measurement is performed.}}
{{ScreenElementDescription|Net Forward Power|   Keyword __result__ will be replaced by measured Net power in dBm}}
{{ScreenElementDescription|Field Sensor|Text field to specify the command which will be send to the device when a Field Sensor measurement is performed.}}
{{ScreenElementDescription|Field Sensor|         Keyword __result__ will be replaced by measured Field strength in V/m}}
}}
}}


[[Image:Configurable_switch_matrix_configuration_window_custom4.png]]
[[Image:Configurable_switch_matrix_configuration_window_custom4.png]]
The following fields can be specified to send 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
|}
Some remarks should be taken into account with 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 21:08, 16 January 2022

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

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.

ScreenElementDescription.svg Device Driver
ScreenElementDescription.svg Reset Text field to specify the reset command. The command is send to the device during the test initialization.
ScreenElementDescription.svg Init Text field to specify the initialize command. The command is send to the device during the test initialization.
ScreenElementDescription.svg Get ID Text field to specify the *IDN? query. The command is send 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 send to the device during the test deinitialization.
ScreenElementDescription.svg Operation
ScreenElementDescription.svg During Test The command is send to the device just before starting the test.
ScreenElementDescription.svg After Test The command is send 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 device 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 send.

Configurable switch matrix configuration window custom2.png

The following fields can be specified to send 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 send 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 send 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

Some remarks should be taken into account with 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.