Configurable AD Convertor: Difference between revisions

From RadiWiki
Jump to navigation Jump to search
No edit summary
Line 58: Line 58:


== Read Back examples ==
== Read Back examples ==
{| class="Regex example table"
Some examples for interpreting a response are:
{| class="wikitable"
|-
|-
! <div style="text-align: left; direction: ltr; margin-left: 0em;">Received information</div>
! Received information
! <div style="text-align: left; direction: ltr; margin-left: 1em;">Regex</div>
! Regular expression
! <div style="text-align: left; direction: ltr; margin-left: 1em;">RadiMation Readout</div>
! Determined measurement value
! <div style="text-align: left; direction: ltr; margin-left: 1em;">Note</div>
! Note
|-
|-
| U_L_N 325
| U_L_N 325
| <div style="text-align: right; direction: ltr; margin-left: 1em;">(-?[0-9.,Ee-]+)</div>
| (-?[0-9.,Ee-]+)
| <div style="text-align: right; direction: ltr; margin-left: 1em;">325
| 325
| <div style="text-align: left; direction: ltr; margin-left: 1em;">Takes the first number.</div>
| Takes the first number.
|-
|-
| I_L1;12.34  
| I_L1;12.34  
| <div style="text-align: right; direction: ltr; margin-left: 1em;">;(-?[0-9.,Ee-]+)</div>
| ;(-?[0-9.,Ee-]+)
| <div style="text-align: right; direction: ltr; margin-left: 1em;">12.34
| 12.34
| <div style="text-align: left; direction: ltr; margin-left: 1em;">Takes the first number after ";".</div>
| Takes the first number after ";".
|-
|-
| THD_U_L1;;14,5
| THD_U_L1;;14,5
| <div style="text-align: right; direction: ltr; margin-left: 1em;">;;(-?[0-9.,Ee-]+)</div>
| ;;(-?[0-9.,Ee-]+)
| <div style="text-align: right; direction: ltr; margin-left: 1em;">14.5</div>
| 14.5
| <div style="text-align: left; direction: ltr; margin-left: 1em;">Takes the first number after ";;".
| Takes the first number after ";;".
|-
|-
| AC_FREQ;Channel1;1.23E3
| AC_FREQ;Channel1;1.23E3
| <div style="text-align: right; direction: ltr; margin-left: 1em;">;.*;(-?[0-9.,Ee-]+)</div>
| ;.*;(-?[0-9.,Ee-]+)
| <div style="text-align: right; direction: ltr; margin-left: 1em;">1230</div>
| 1230
| <div style="text-align: left; direction: ltr; margin-left: 1em;">Takes the first number after the appearance of a second ";".
| Takes the first number after the appearance of a second ";".
|}
|}


The [[regular expression]] can always be tested trough the {{ScreenElement|Validate Expression}} function.
The correctness of the regular expression can be tested, verified and improved by using the {{ScreenElement|Validate Expression}} tool within the configurable device driver.


[[File:ValidateExpressionTool.png]]
[[File:ValidateExpressionTool.png]]

Revision as of 15:42, 30 January 2023


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[edit]

Multiple communication types can be selected for the configurable AD convertor. Depending on the connection that is used, select the correct Communication Stream, and configure the parameters correspondingly.
Note that when the selected communication type does not have the option to change the termination character, it will be expected that a new line feed is send by the connected device apppended to each message.


ConfigureCommunication.png

Initialisation and Check[edit]

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

AD convertors can have multiple channels on which AD values could be read. The Configurable AD Convertor device driver is able to retrieve up to 40 measurement values from the measurement device. For each AD channel, individual commands can be set, specific for the values that should be retrieved.

Trigger and Reading[edit]

ScreenElementDescription.svg 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.svg Read Back Different measurement devices will return different messages that contain the measurement value. The configurable AD convertor only needs the numeric value of the measurement device 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.

ScreenElementDescription.svg Validate Expression Shows a window where the expected output of the measurement device and a regular expression can be typed. The result of the interpretion will then automatically be shown. This window can be used to test the regular expression, to determine if the expected response results in the desired value.


Minimum and maximum value[edit]

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


ScreenElementDescription.svg 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.svg 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 won't be converted, but instead directly used as it is included in the response.

Read Back examples[edit]

Some examples for interpreting a response are:

Received information Regular expression Determined measurement value 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 correctness of the regular expression can be tested, verified and improved by using the Validate Expression tool within the configurable device driver.

ValidateExpressionTool.png