Difference between revisions of "Configurable AD Convertor"

From RadiWiki
Jump to: navigation, search
(Updated DeviceDriverInfo template)
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!! -->
 +
It can be used to control other measurement equipment, for which no RadiMation device driver is available yet. The Configurable AD Convertor allows to retrieve a measurement value from the measurement equipment, where the measured value can then be used in RadiMation as an EUT Monitoring input. These values can thus be measured and shown in graphs during immunity tests.
  
 
[[Image:Configurable AD Converter Configuration Window.png]]
 
[[Image:Configurable AD Converter Configuration Window.png]]
Line 20: Line 21:
 
== Initialisation and Check ==
 
== Initialisation and Check ==
 
{{ScreenElementDescriptionStart}}
 
{{ScreenElementDescriptionStart}}
{{ScreenElementDescription|Reset|The reset code that needs to be send to device. When left blank no command will be send.}}
+
{{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|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 common used [[SCPI]] command is *IDN?. 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|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 in use. Leaving this blank will keep the device in its last state after controlling it.}}
+
{{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.}}
 
 
A checkmark can be enabled so RadiMation will wait for all the commands to complete. This is done by sending [[SCPI]] command *OPC? to the device.
 
 
 
 
{{ScreenElementDescriptionEnd}}
 
{{ScreenElementDescriptionEnd}}
  
Line 38: Line 36:
 
==== Trigger and Reading ====
 
==== Trigger and Reading ====
  
{{ScreenElementDescription|Trigger|A trigger command can be specified to request a measurement from the device. A common used [[SCPI]] is *TRG. When left blank no command will be send.}}
+
{{ScreenElementDescription|Trigger|A trigger command can be specified to request a measurement from the device. A commonly used [[SCPI]] command is: *TRG. When left blank, no command will be send.}}
  
{{ScreenElementDescription|Read Back|Different devices return different messages with measurement values. The configurable AD convertor only need the numeric value of the measurement message. There for, a [[regular expressions]] can be set in the Read Back.
+
{{ScreenElementDescription|Read Back|Different measurement devices will return different messages that contain the measurement value. The configurable AD convertor only need the numeric value of the measurement devoce response. The text that is specified in the {{ScreenElement|Read Back}} box, is used as a [[regular expressions]] to determine the returned value.
 
A good regular expression for finding the first number in scientific notation in a text is:
 
A good regular expression for finding the first number in scientific notation in a text is:
  
Line 58: Line 56:
  
  
== Readback example(s) ==
+
== Read Back examples ==
 
{| class="Regex example table"
 
{| class="Regex example table"
 
|-
 
|-

Revision as of 11:59, 18 September 2017

The Configurable AD Convertor device driver is a AD Converter which is supported by RadiMation®. It can be used to control other measurement equipment, for which no RadiMation device driver is available yet. The Configurable AD Convertor allows to retrieve a measurement value from the measurement equipment, where the measured value can then be used in RadiMation as an EUT Monitoring input. These values can thus be measured and shown in graphs during immunity tests.

Configurable AD Converter Configuration Window.png


Communication

Multiple communication types can be selected for the configurable AD convertor

ConfigureCommunication.png


Initialisation and Check

ScreenElementDescription.png Reset The reset code that needs to be send to device. When left blank, no command will be send.
ScreenElementDescription.png Init The command that is send to initialize the configured device. When left blank no command will be send.
ScreenElementDescription.png 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.png 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.png 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.png 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.


Channels

AD convertors can have multiple channels on which AD values could be read. For each AD channel, individual commands can be set.

Trigger and Reading

ScreenElementDescription.png Trigger A trigger command can be specified to request a measurement from the device. A commonly used SCPI command is: *TRG. When left blank, no command will be send.
ScreenElementDescription.png Read Back Different measurement devices will return different messages that contain the measurement value. The configurable AD convertor only need the numeric value of the measurement devoce response. The text that is specified in the Read Back box, is used as a regular expressions to determine the returned value.

A good regular expression for finding the first number in scientific notation in a text is:

([+-]?[0-9]*\.?[0-9]+([eE][+-]?[0-9]+)?)

For more possibilities see the example section.

Minimum and maximum value

The minimum and maximum must be set to calculate the raw AD convertor value to a digital value with a specific type.

ScreenElementDescription.png Minimum value The lowest value that can be measured with this device. The value must be the same as filled in the EUT window.
ScreenElementDescription.png Maximum value The highest value that can be measured with this device. The value must be the same as filled in the EUT window.

With minimum set to 0 and maximum set to 1, the raw value wont be converted, but instead directly used.


Read Back examples

Received information
Regex
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 ";".


The regular expressions can always be tested trough the Validate Expression function.