Configurable Turn Table: Difference between revisions

From RadiWiki
Jump to navigation Jump to search
(Redirected page to Configurable TurnTable)
Tag: New redirect
 
Line 1: Line 1:
{{DeviceDriverInfo
#REDIRECT [[Configurable TurnTable]]
|DLLFile=RADEMPTY.DLL
|DeviceDriverName=CONFIGTT
|DeviceType=Configurable Turn Table
|HideAutoData=1
|SupportedDeviceTypes=4096
}}
<!-- Include a space to get a newline!! --> <!-- Beware of the space!! -->
It can be used to control other measurement equipment, for which no RadiMation device driver is available yet. The Configurable Turn Table allows to manual create a device driver to control a Turn Table. The configured device driver can then be used in RadiMation, and the Turn Table can thus be used in immunity and emission tests.
 
== Configurable commands ==
[[Image:Configurable Turn Table Configuration Window.png]]
 
{{ScreenElementDescriptionStart}}
{{ScreenElementDescription|Reset|The reset code that needs to be send to device. When left blank, no command will be send.}}
{{ScreenElementDescription|Init|The command that is send to initialize the configured device. When left blank no command will be send.}}
{{ScreenElementDescription|Get Id|The command that is send to retrieve the ID of the device. This is used to check if the device is connected. A commonly used [[SCPI]] command is: *IDN?. When left blank, no command will be send.}}
{{ScreenElementDescription|Returned ID|The identifier is used to check if the correct device driver is selected and the device is connected. Leaving this blank, will skip the device check.}}
{{ScreenElementDescription|Deinit|Specifies the command that is send when the device is no longer controlled. This can for example be used to put the measurement device is an intrinsic safe state. Leaving this blank, will keep the device in its last state after controlling it.}}
{{ScreenElementDescription|Wait for Completion after sending command|The checkmark can be enabled so {{RadiMation}} will wait for all the commands to complete, before it continues. This is done by sending [[SCPI]] command *OPC? to the device.}}
{{ScreenElementDescriptionEnd}}
 
{{ScreenElementDescriptionStart}}
{{ScreenElementDescription|Goto angle|The command that should be send to turn the turn table. The command must include the keyword __angle__, __degree__ or __radian__, which will be replaced by the desired destination angle for the turntable.}}
{{ScreenElementDescription|Current Angle|This is the command to request the current angle of the device.}}
{{ScreenElementDescription|Current angle format|This is a [[regular expression]] to obtain the current angle from the response of the Current angle command. See regular expression examples below.}}
{{ScreenElementDescription|Movement ready|This is the command to request the current status of the turn table. This command is used to determine if the turntable is ready with the movement to the destination angle.}}
{{ScreenElementDescription|Movement ready response|This should be the response from the device when the turntable is not moving/rotating anymore.}}
{{ScreenElementDescription|Stop|This is the command to abort/stop any rotation.}}
{{ScreenElementDescriptionEnd}}
 
== Order of executed commands ==
This section describes which commands from the {{PAGENAME}} are transmitted to the actual device, when a specific operation in {{RadiMation}} is performed.
=== Check device ===
When a check for the connection to the device is performed, the following actions are performed:
# A connection to the device is opened.
# If no {{ScreenElement|Returned ID}} is specified, no actual check is performed, and it is assumed that the device is connected. Otherwise:
## The command specified at {{ScreenElement|Get ID}} is transmitted (if specified), and the response is read.
## The response is compared to the value specified in {{ScreenElement|Returned ID}}, if the response (partially or as a regular expression) matches, the device is assumed to be connected.
# The connection to the device is closed.
 
=== Device is initialised ===
When a device is initialised to be controlled from {{RadiMation}}, the following actions are performed:
# A connection to the device is opened.
# The command specified at {{ScreenElement|Reset}} is transmitted (if specified).
# The command specified at {{ScreenElement|Init}} is transmitted (if specified).
 
=== Device is deinitialised ===
When a device is deinitialised, the following actions are performed:
# The command specified at {{ScreenElement|Deinit}} is transmitted (if specified).
# The connection to the device is closed.
 
=== Retrieve the current angle from the turntable ===
When {{RadiMation}} wants to determine the actual angle from the turntable, the following actions are performed:
# The command specified at {{ScreenElement|Current Angle}} is transmitted (if specified), and the response is read.
# The response is interpreted using the regular expression specified at {{ScreenElement|Current angle format}}. The result of the regular expression lookup is converted to a number, and reported back as the actual angle (in degrees) of the turntable to {{RadiMation}}.
 
=== Turn the turntable to an angle ===
When a turntable in RadiMation is being turned to another angle, the following actions are performed:
# The command specified at {{ScreenElement|Goto angle}} is parsed, and a temporary string replacement is done on the command:
#* Every occurrence of __angle__ is replaced by the numeric value of the destination angle in degrees.
#* Every occurrence of __degree__ is replaced by the numeric value of the destination angle in degrees.
#* Every occurrence of __radian__ is replaced by the numeric value of the destination angle in radians.
# The temporarily modified command specified at {{ScreenElement|Goto angle}} is transmitted.
# To determine if the turntable has reached the destination angle or has stopped turning, the following actions are repeated multiple times:
## The current angle is retrieved as described at '[[#Retrieve the current angle from the turntable|Retrieve the current angle from the turntable]]'
## The command specified at {{ScreenElement|Movement ready}} is transmitted (if specified), and the response is read.
## The response is compared to the value specified in {{ScreenElement|Movement ready response}}, if the response (partially or as a regular expression) matches, the device is assumed to be ready with the movement.
# The command specified at {{ScreenElement|Stop}} is transmitted (if specified).
 
== Regular expression examples ==
The {{PAGENAME}} uses [[regular expression]] on some commands to interpret and parse the response of the actual device.
 
Some examples are:
{|class="wikitable"
|-
! Received information
! Regular expression
! {{RadiMation}} Readout
! Note
|-
| U_L_N 325
| (-?[0-9.,Ee-]+)
| 325
| Takes the first number.
|-
| I_L1;12.34
| ;(-?[0-9.,Ee-]+)
| 12.34
| Takes the first number after ";".
|-
| THD_U_L1;;14,5
| ;;(-?[0-9.,Ee-]+)
| 14.5
| Takes the first number after ";;".
|-
| AC_FREQ;Channel1;1.23E3
| ;.*;(-?[0-9.,Ee-]+)
| 1230
| Takes the first number after the appearance of a second ";".
|}

Latest revision as of 12:15, 25 May 2022