RadiMation Application Note 114: Difference between revisions
| Line 29: | Line 29: | ||
{{ScreenElementDescription|Wait for Completion after sending command|If the checkbox is ticked, {{RadiMation}} will wait for all the commands to complete, before it continues. This is achieved by also transmitting the [[SCPI]] query-command '*OPC?' to the device, and waiting for the response.}} | {{ScreenElementDescription|Wait for Completion after sending command|If the checkbox is ticked, {{RadiMation}} will wait for all the commands to complete, before it continues. This is achieved by also transmitting the [[SCPI]] query-command '*OPC?' to the device, and waiting for the response.}} | ||
{{ScreenElementDescriptionEnd}} | {{ScreenElementDescriptionEnd}} | ||
None of these commands have to be specified, as the central heating boiler doesn't need to be initialized or deinitialized. | None of these commands have to be specified, as the central heating boiler doesn't need to be initialized or deinitialized. | ||
Revision as of 18:51, 30 January 2023
How to measure data from the EUT using the Configurable AD Convertor device driver[edit]
This Application Note explains how the Configurable AD Convertor can be used to monitor an EUT. With the Configurable AD convertor, any type of signal can be measured, monitored and plotted within RadiMation® during an immunity test.
Let's assume that the EUT is a central heating boiler, and that the temperature of the water inside the boiler should be measured and monitored. The central heating boiler has a serial port (which is connected to COM3 on the testing PC), and if the command: "TEMP?" is transmitted, the microcontroller on the boiler will respond with: "Temp: 46.5".
The configuration in RadiMation® can be separated in two steps:
- Configure the Configurable AD Convertor device driver to retrieve the value from the measurement device.
- Plot the measured value during an immunity test using the correct unit.
Configuring the Configurable AD convertor[edit]
First create a new Configurable AD Convertor device driver. It is best to give this new device driver a descriptive description to identify it clearly for the task that it is used for. In this example 'Central heating boiler' would be a suitable name.
After the device driver is created, open the Advanced settings window of the new device driver, which allows to further specialise how the driver should communicate with the actual device.
Configure the commands for the initialisation of the device[edit]
The Configurable AD Convertor device driver has several boxes, in which the remote programming commands can be specified, which should be transmitted to the measurement device on defined moments.
 Reset
|
The reset code that needs to be transmitted to device. When left blank, no command will be transmitted. |
| Init
|
The command that is transmitted to initialise the configured device. When left blank, no command will be transmitted. |
| Get ID
|
The query-command that is transmitted 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 transmitted. |
| Returned ID
|
The expected response of the device on the Get ID query. The text that is specified will be searched in the real response on Get ID query. If the specified text can be found in the response, the check for the connection is successful, otherwise it is reported that the measurement device is not connected. Leaving this blank, will skip the check if the measurement device is connected, and it is always assumed that the device is connected. |
| Deinit
|
Specifies the command that is transmitted when the device will not be controlled anymore.This can for example be used to put the measurement device in an intrinsic safe state. When left blank, no command will be transmitted. |
| Wait for Completion after sending command
|
If the checkbox is ticked, RadiMation® will wait for all the commands to complete, before it continues. This is achieved by also transmitting the SCPI query-command '*OPC?' to the device, and waiting for the response. |
None of these commands have to be specified, as the central heating boiler doesn't need to be initialized or deinitialized.
Configure the measurement and interpretation of the measured value[edit]
AD convertors can have multiple channels from which values can be read. The Configurable AD Convertor device driver is able to retrieve the values from up to 50 different channels from the measurement device. For each AD channel, an individual query-command can be specified, specific for the measurement value that should be retrieved. For this example we only need a single channel, as we are are only interested to retrieve the water temperature.
The configuration of the single channel can be configured on the Channel 1.
| Trigger
|
The trigger query-command can be specified to trigger and request a new measurement value from the device. For the central heating boiler, the command 'TEMP?' should be transmitted to request a reading. |
| Timeout ms
|
The timeout (specified in milliseconds) that should be used to read the response from the device. We can leave this on the default 2000 milliseconds. |
| Read Back
|
The regular expression that should be used to determine the numeric value in the response from the central heating boiler. As the response is something like: "Temp: 46.5", the regular expression can be: "Temp: ([0-9.]+)".
|
| Validate Expression
|
Shows a small window where the expected response of the measurement device and a regular expression can be typed. |
The minimum and maximum measurable value of the measurement device can be specified to correctly scale the measured value. This will also be used to re-calculate the retrieved measurement value to another value with another unit.
| Minimum value
|
The lowest value of the channel that can be measured with the controlled measurement device. The value must be the same as filled in the EUT window. It normally is the best to configure this value to be 0. |
| Maximum value
|
The highest value of the channel that can be measured with the controlled measurement device. The value must be the same as filled in the EUT window. It normally is the best to configure this value to be 1. |
The correctness of the regular expression can be tested, verified and improved by using the Validate Expression tool within the configurable device driver. In the Regular Expression Tester, the following fields are available to verify the regular expression:
| Input
|
Any text that is expected to be returned by the device. In this example this will be "Temp: 46.5" |
| Regular Expression
|
The Regular expression that is being tested. For this example we can verify if the "Temp: ([0-9.]+)" regular expression is sufficient. |
| Result
|
The numerical value that is determined by the device driver using the Regular Expression on the Input. This should show the 46.5 value that we are expecting. |
By changing the Input field, we can easily test if the regular expression is able to determine the correct water temperature.
Specify the communication type[edit]
The correct settings for the communication with the measurement device (which is the actual EUT in this example) must also still be configured. The Configurable AD Convertor supports several communication types, which can be used to communicate with the measurement device. Click on the Communication button, to open the configuration dialog to specify the actual details of the medium to use for the communication. Depending on the connection that is used, select the correct Communication Stream, and configure the parameters correspondingly to communication settings that are used by device. Different Communication Streams are available, which are described in more detail in the Communication settings section of Chapter 15.
In this example the RS-232 stream is selected, and the COM Port is set to COM3 to allow communication with the central heating boiler.
After this last configuration, the device driver is configured correctly and all configuration windows can be closed.
Plot the measured value during an immunity test using the correct unit[edit]
Create a new monitoring input channel[edit]
- The monitoring functionality is applied to the EUT. Therefor we first need to have an EUT file opened.
- In the opened EUT file, we can select the Monitoring input channels tab.
- Double click an existing input channel or add a new input by using the add button.
- A new window will open to configure the monitoring input channel.
Configure a monitoring input channel[edit]
- At the device menu, the newly configured AD convertor can be selected.
- The selected AD channel must be selected.
- The Unit type can be specified as text.
- With Calculation, the raw value from the AD convertor can be modified to match the preferred unit. More information can be found here.
- The Monitoring Input channel description will be shown in the graph title.
- After pressing Ok to save the configurations, ensure that the configured monitoring channel is marked as Active in the monitoring input channels list.
Running a test[edit]
When an immunity test is performed, RadiMation will also measure the value from the measurement device and it will plot the line(s) of the activated monitoring input channel(s). By switching to the Table tab, the measurement values will be shown in a tabular style.
