RadiMation Application Note 163: Difference between revisions

From RadiWiki
Jump to navigation Jump to search
 
(13 intermediate revisions by the same user not shown)
Line 1: Line 1:
__NOTOC__
__NOTOC__
== Automatically Retrieve and Log the Operating Mode of the Tested EUT ==
== Automatically retrieve and log the operating mode of the tested EUT ==
In EMC testing, it is sometimes necessary to check and document specific information about the Equipment Under Test (EUT), such as its operating mode, model number, firmware version, or activated options. RadiMation includes a 'General test information retriever' device driver, classified as an 'EUT controller' device driver, which can be configured to automatically retrieve this information during testing.
During EMC testing, it is often necessary to retrieve and document critical information about the Equipment Under Test (EUT), such as its operating mode, model number, firmware version, or activated options. RadiMation includes a [[General test information retriever]] device driver, classified as an 'EUT controller' device driver, which can be configured to automatically retrieve this information during testing.


This application note explains how to configure and use the 'General test information retriever' device driver in RadiMation, providing examples of commands and regular expressions to extract specific information. This feature is particularly useful for repetitive or production testing on similar EUTs.
This application note explains how to configure and use the [[General test information retriever]] device driver in RadiMation, providing examples of commands and regular expressions to extract specific information. This feature is particularly useful for repetitive or production testing on similar EUTs.


Manually documenting the operating mode or other key characteristics of the EUT during tests can be time-consuming and error-prone. To automate and standardize this process, RadiMation allows users to configure a device driver that retrieves information directly from the EUT and logs it into the general information of the test.
Manually documenting the operating mode or other key characteristics of the EUT during tests can be time-consuming and error-prone. To automate and standardize this process, RadiMation allows users to configure a device driver that retrieves information directly from the EUT and logs it into the general information of the test.
Line 12: Line 12:
# Navigate to the {{ScreenElement|Device Drivers}} tab in the {{ScreenElement|Configuration}} window.   
# Navigate to the {{ScreenElement|Device Drivers}} tab in the {{ScreenElement|Configuration}} window.   
# Select the {{ScreenElement|EUT Controller}} list.
# Select the {{ScreenElement|EUT Controller}} list.
# Create a new device driver: 'General test information retriever', and specify a logical name, for example: 'Operating mode retriever'.  <BR /> <SCREENSHOT: Createnew OperatingModeRetriever.png> 
# Create a new device driver: 'General test information retriever', and specify a logical name, for example: 'Operating mode retriever'.  <BR />[[File:CreateNewOperatingModeRetriever.png|500px]]
# Click on {{ScreenElement|Advanced}}, and select the {{
# Click on {{ScreenElement|Advanced}}
=== Step 2: Configure the Device Driver ===
# The communication settings to communicate with the device can be configured on the {{ScreenElement|Communication}} tab.
# A check for the identification to ensure that the correct device is connected can be set on the {{ScreenElement|Identification}} and {{ScreenElement|Main}} tabs.
# The settings for retrieving the desired information can be configured on the {{ScreenElement|General information}} tab.


The following parameters must be configured in the 'General test information retriever' device driver:


* **Request Command**: The command that will be sent to the EUT to request the required information. 
[[File:GeneralTestInformationRetriever GeneralInformationTab.png]]
* **Response Regular Expression**: A regex pattern used to extract specific information from the EUT's response. 
* **Information Item Name**: The name under which the retrieved information will be stored in the test's general information.


<SCREENSHOT> 
The following parameters must be configured in the 'General test information retriever' device driver:
 
* {{ScreenElement|Request command}}: The command that will be sent to the EUT to request the required information.  
=== Step 3: Example Configurations ===
* {{ScreenElement|Response regex}}: A regular expression pattern used to extract specific information from the EUT's response.
 
* {{ScreenElement|Validate Expression}}: Shows a new window that can be used to check the correctness of the regular expression. This feature allows users to test the correctness of the configured regular expression using sample responses from the EUT.
Below are examples of commands, regular expressions, and their corresponding information item names:
* {{ScreenElement|Information item name}}: The name under which the retrieved information will be stored in the test's general information.
 
1. **Retrieve the Operating Mode**
  - Request Command: `GET_MODE`  
  - Response Regular Expression: `MODE: ([A-Za-z0-9]+)` 
  - Information Item Name: `Operating Mode`
 
2. **Retrieve the Model Number**
  - Request Command: `GET_MODEL` 
  - Response Regular Expression: `MODEL: ([A-Za-z0-9-]+)` 
  - Information Item Name: `Model Number`


3. **Retrieve the Firmware Version**  
Once the device driver is configured, it can be selected as an {{ScreenElement|EUT Controller}} in the testsite that is used by the test.  
  - Request Command: `GET_FW`  
The following will occur automatically during the initialisation of each test:  
  - Response Regular Expression: `FW_VERSION: ([0-9\.]+)`  
# At the start of every test, the configured {{ScreenElement|Request command}} is sent to the EUT.  
  - Information Item Name: `Firmware Version`
# The response from the EUT is processed using the regular expression that is specified as the {{ScreenElement|Response regex}}.   
# The extracted information is stored in the test's general information under the name set as {{ScreenElement|Information item name}}.


4. **Retrieve Installed Options** 
The retrieval of the operating mode of the EUT (assuming that it was in 'Bridge' mode) could for example result in:
  - Request Command: `GET_OPTIONS` 
  - Response Regular Expression: `OPTIONS: ([A-Za-z0-9, ]+)` 
  - Information Item Name: `Installed Options`


=== Step 4: Using the Device Driver ===
[[File:GeneralTestInformationRetriever GeneralInformationItemsResult.png]]


After configuring the device driver and including it in a test site, the following will occur automatically during each test: 
{{ReportGeneratorInfo|The information from the {{ScreenElement|General Information}} can also be used by the report generator to include it automatically in the report by using the code: {{ReportGeneratorCode|EUT Operating mode}}.}}
1. At the start of every test, the configured command is sent to the EUT. 
2. The response from the EUT is processed using the specified regex. 
3. The extracted information is stored in the test's general information under the configured name.


== 4. Conclusion ==
== Example Configurations ==
Below are a few examples of commands, regular expressions, and their corresponding information item names, which can be used in the combination with the [[General test information retriever]].


The 'General test information retriever' device driver in RadiMation is a powerful tool for automating the retrieval and logging of specific EUT information during testing. By configuring a command, response regex, and information item name, users can ensure that vital details—such as operating mode, model number, firmware version, and installed options—are accurately documented for every test.
{| class="wikitable"
|-
! Purpose
! Request command
! Response regex
! Information item name
|-
| Retrieve the EUT's operating mode
| MODE?
| .*
| EUT Operating mode
|-
| Retrieve the Model name of the EUT
| *IDN?
| ,([A-Za-z0-9\-]+),
| Model
|-
| Retrieve the Firmware Version
| FW_VERSION? 
| Version: ([0-9\.]+)
| Firmware Version
|-
| Retrieve installed options of the EUT
| *OPT?
| .*
| Installed Options
|}


This feature is especially beneficial for repetitive and production testing scenarios, as it saves time and ensures consistency across tests.   
== Conclusion ==
The [[General test information retriever]] device driver in {{RadiMation}} is a powerful tool for automating the retrieval and logging of specific EUT information during testing. By configuring a command, response regex, and information item name, users can ensure that vital details—such as operating mode, model number, firmware version, and installed options—are accurately documented for every test.   


For additional details or troubleshooting, please refer to the RadiMation wiki or contact technical support.
This feature is especially beneficial for repetitive and production testing scenarios, as it saves time and ensures consistency across tests.


[[Category:RadiMation Application Note]]
[[Category:RadiMation Application Note]]

Latest revision as of 14:59, 24 January 2025

Automatically retrieve and log the operating mode of the tested EUT[edit]

During EMC testing, it is often necessary to retrieve and document critical information about the Equipment Under Test (EUT), such as its operating mode, model number, firmware version, or activated options. RadiMation includes a General test information retriever device driver, classified as an 'EUT controller' device driver, which can be configured to automatically retrieve this information during testing.

This application note explains how to configure and use the General test information retriever device driver in RadiMation, providing examples of commands and regular expressions to extract specific information. This feature is particularly useful for repetitive or production testing on similar EUTs.

Manually documenting the operating mode or other key characteristics of the EUT during tests can be time-consuming and error-prone. To automate and standardize this process, RadiMation allows users to configure a device driver that retrieves information directly from the EUT and logs it into the general information of the test.

Configuration of the 'General test information retriever' device driver[edit]

The 'General test information retriever' device driver in RadiMation can be configured in three main steps. These are detailed below:

  1. Navigate to the Device Drivers tab in the Configuration window.
  2. Select the EUT Controller list.
  3. Create a new device driver: 'General test information retriever', and specify a logical name, for example: 'Operating mode retriever'.
    CreateNewOperatingModeRetriever.png
  4. Click on Advanced
  5. The communication settings to communicate with the device can be configured on the Communication tab.
  6. A check for the identification to ensure that the correct device is connected can be set on the Identification and Main tabs.
  7. The settings for retrieving the desired information can be configured on the General information tab.


GeneralTestInformationRetriever GeneralInformationTab.png

The following parameters must be configured in the 'General test information retriever' device driver:

  • Request command: The command that will be sent to the EUT to request the required information.
  • Response regex: A regular expression pattern used to extract specific information from the EUT's response.
  • Validate Expression: Shows a new window that can be used to check the correctness of the regular expression. This feature allows users to test the correctness of the configured regular expression using sample responses from the EUT.
  • Information item name: The name under which the retrieved information will be stored in the test's general information.

Once the device driver is configured, it can be selected as an EUT Controller in the testsite that is used by the test. The following will occur automatically during the initialisation of each test:

  1. At the start of every test, the configured Request command is sent to the EUT.
  2. The response from the EUT is processed using the regular expression that is specified as the Response regex.
  3. The extracted information is stored in the test's general information under the name set as Information item name.

The retrieval of the operating mode of the EUT (assuming that it was in 'Bridge' mode) could for example result in:

GeneralTestInformationRetriever GeneralInformationItemsResult.png

Report generator.png
The information from the General Information can also be used by the report generator to include it automatically in the report by using the code: ||EUT Operating mode||.

Example Configurations[edit]

Below are a few examples of commands, regular expressions, and their corresponding information item names, which can be used in the combination with the General test information retriever.

Purpose Request command Response regex Information item name
Retrieve the EUT's operating mode MODE? .* EUT Operating mode
Retrieve the Model name of the EUT *IDN? ,([A-Za-z0-9\-]+), Model
Retrieve the Firmware Version FW_VERSION? Version: ([0-9\.]+) Firmware Version
Retrieve installed options of the EUT *OPT? .* Installed Options

Conclusion[edit]

The General test information retriever device driver in RadiMation® is a powerful tool for automating the retrieval and logging of specific EUT information during testing. By configuring a command, response regex, and information item name, users can ensure that vital details—such as operating mode, model number, firmware version, and installed options—are accurately documented for every test.

This feature is especially beneficial for repetitive and production testing scenarios, as it saves time and ensures consistency across tests.

ElectroMagnetic Compatibility

Retrieved from "https://wiki.radimation.com/wiki/index.php?title=RadiMation_Application_Note_163&oldid=102805"