RadiMation Application Note 107: Difference between revisions

From RadiWiki
Jump to navigation Jump to search
No edit summary
 
(29 intermediate revisions by 3 users not shown)
Line 15: Line 15:
== Different types of problems ==
== Different types of problems ==


There are different types of problems you can encounter. Problems can originate from tsf settings, report generator or device related issues.
There are different types of problems you can encounter. Problems can originate from TSF settings, report generator templates or device related issues.
As these different type problems have different causes we need different information according to the type of the issues.
As these different type of problems have different causes we need different information according to the type of the issues.


Below we will state some of the issues and will inform you which information is needed to investigate.
Below we will state some of the issues and will inform you of additional information that is very helpful to investigate such issues.


=== Device driver / Controlling Equipment issue ===
=== Device driver / Controlling Equipment issue ===
If you receive errors from the equipment, during a device check, initialization of a test. Almost certain, only an error report is required.
If you receive errors from the equipment, during a device check, initialization of a test. Almost certain, only an error report is required.
The report will contain log information regarding messages send to the device. And also internal RadiMation information.
The report will contain log information regarding commands send to the device. And the report also contains internal RadiMation information. With this information, we most likely can find the cause of the issue, and provide a solution.
With this information, we most likely can find the cause of the issue, and provide a solution.


Please provide:
Please provide:
* [http://wiki.dare.nl/wiki/index.php/RadiMation_Application_Note_107#Error_Report Error Report]
* [[#Error Report | Error Report]]


=== Report Generator issues ===
=== Report Generator issues ===
Line 32: Line 31:


Please provide:
Please provide:
* [http://wiki.dare.nl/wiki/index.php/RadiMation_Application_Note_107#Test_result_files Test result]
* [[#Test result files  | Test result]]
* [http://wiki.dare.nl/wiki/index.php/RadiMation_Application_Note_107#TSF TSF File]
* [[#TSF | TSF File]]
* [http://wiki.dare.nl/wiki/index.php/RadiMation_Application_Note_107#Report_Generator_Files Report Generator Files]
* [[#Report_Generator_Files | Report Generator Files]]
 


=== Unexpected behaviour in RadiMation ===
=== Unexpected behaviour in RadiMation ===
Line 41: Line 39:


Please provide:
Please provide:
* [http://wiki.dare.nl/wiki/index.php/RadiMation_Application_Note_107#Error_Report Error Report]
* [[#Error Report  | Error Report]]
* [http://wiki.dare.nl/wiki/index.php/RadiMation_Application_Note_107#TSF TSF File]
* [[#TSF | TSF File]]
* [http://wiki.dare.nl/wiki/index.php/RadiMation_Application_Note_107#Test_result_files Test result]
* [[#Test result files  |  Test result]]


= Providing information =
= Providing information =
Line 50: Line 48:


=== Error Report ===
=== Error Report ===
In case of an error a screen will pop up and will also give you the ability to send a report. This report includes system information (Version, windows version etc.), a log file from the session in which the error occurred and some other details regarding {{RadiMation}}


In case of a error a screen will pop up and will also give you the ability to send a report. This report includes system information (Version, windows version etc.), a log file from the session in which the error occurred and some other details regarding {{Radimation}
The information in this report is help full to track communication between the software and the devices. When the error is setting specific it is good practice to also supply the [[#TSF | TSF file]].
 
The information in this report is help full to track communication between the software and the devices. When the error is setting specific it is good practice to add the tsf file.


We then need the specific settings to see if it is the device reacting differently to the settings. Keep in mind that we need to reproduce the error so that we need the information that was available to you when performing the test.  
We then need the specific settings to see if it is the device reacting differently to the settings. Keep in mind that we need to reproduce the error so that we need the information that was available to you when performing the test.  
Line 60: Line 57:
In these cases a manual error report is needed together with the tsf file that was used during the creation of the report. This helps us to investigate the settings used and see the way the software/hardware responded.
In these cases a manual error report is needed together with the tsf file that was used during the creation of the report. This helps us to investigate the settings used and see the way the software/hardware responded.


More information on how to make a manual report can be found here. There is a step by step description and screenshots explaing how to do this.
More information on how to make a manual report can be found [[Error Report | here]]. There is a step by step description and screenshots explaining how to send an error report.
 
http://wiki.dare.nl/wiki/index.php/Error_Report


=== TSF ===
=== TSF ===


TSF files are the test setting files of {{Radimation}}. They contain the test settings for the tests.
TSF files are the test setup files of {{RadiMation}}. They contain the test settings for the tests.


TSF files are saved in the TSF directory configured in RadiMation configuration window. There is not a easy way to directly access the files as they are in a embedded file system.  
TSF files are saved in the TSF directory configured in RadiMation configuration window. There is not a easy way to directly access the files as they are in an embedded file system. The easiest way is to access them by adding a test in the category that your test was in.  
The easiest way is to access them by adding a test in the category that your test was in.  


If you where doing Radiated Emision Multiband test, go to "Tests" and open the Radiated emission multi band. This will open the TSF file window.  
If you where doing Radiated Emision Multiband test, go to "Tests" and open the Radiated emission multi band. This will open the TSF file window.  
In the file name column, you can find the path and filename. If the file name is not shown, right click on the column header and then click the column chooser to add the required column.  
In the file name column, you can find the path and filename. If the file name is not shown, right click on the column header and then click the column chooser to add the required column.  
You can drag or double click it. You can now see the path of the TSF. In the picture below you see the "Select TSF file" window and the column chooser.
You can drag the column to the header row or double click it in the column chooser. The path of the TSF is now visible in the list. In the picture below you see the "Select TSF file" window and the column chooser.


[[File:TSF_File_Location.png|600px]]
[[File:TSF_File_Location.png|600px]]


Advanced tip: If you want to be able to go to the TSF quickly now you have found the path name of the file. Select the tsf file in the "Select TSF file" window. Now right-click and choose "Copy". You can now open text edit and past the line. Here you see the path, select and copy it and paste it in the path field of windows file explorer.
Advanced tip: If you want to be able to go to the TSF quickly now you have found the path name of the file. Select the desired TSF file in the "Select TSF file" window. Now right-click and choose {{ScreenElement|Copy}}. You can now open text edit and past the line. Here you see the path, select and copy it and paste it in the path field of windows file explorer.


[[File:TSFPath.png]]
[[File:TSFPath.png]]
   
   
Please include the TSF file in a mail, send to support@radimation.com
Please include the TSF file in an e-mail, send to {{MailSupport}}
 
=== Test result files (*.tsf)===


These are the output files of a test containing the measured data.
=== Test result files ===
The test result files are saved next to the EUT file.
A test result file is the data file of a single test, which contains the measurement data of that test. The test result files are saved in the same directory as where the EUT file is saved. And their name is the same name as the EUT file, however they have a .T<xx> extension where <xx> is an increasing number.


In the EUT window, you can view all the stored test result files.
In the EUT window, you can view all the stored test result files.
You can change the column filtering by right clicking on the table and click Column Chooser.
You can change the column filtering by right clicking on the table and click {{ScreenElement|Column Chooser}}.
Then drag the "Test Filename" column to the table. In the table, the location of the file is now shown.
Then drag the {{ScreenElement|Test Filename}} column to the header row of the list. In the list, now also the exact location of the Test result file is shown.


[[File:EUTColumnChooser.png|600px]]
[[File:EUTColumnChooser.png|600px]]


=== Report Generator Files ===
=== Report Generator Files ===
For the report generator files, the template and output documents are required.
For the report generator files, the template and output documents are required. Please include the documents in an e-mail, send to {{MailSupport}}.
Please include the documents in a mail, send to support@radimation.com


[[File:ReportGeneratorDocumentLocation1.png|600px]]
[[File:ReportGeneratorDocumentLocation1.png|600px]]


[[File:ReportGeneratorDocumentLocation2.png|600px]]
[[File:ReportGeneratorDocumentLocation2.png|600px]]
=== ConfdvdrFolder ===
The CONFDVDR sub-directory of the {{RadiMation}} main installation directory contains the complete configuration of the {{RadiMation}} software.
Sometimes it can be useful to us to request a copy of the confdvdr folder. This is normally not included in the error log and we will request for it if needed.
It allows us to load the configuration and see if there are issues with the configuration. Because it is send to us on request and there is no automatic procedure we request to make a copy of the folder, zip it and send it to us.
Below is the procedure that explains how to find the folder and create a zip file from it.
== Locating and zipping the confdvdr folder ==
- To locate the folder go to configuration -> Configuration -> Directories
[[File:ConfdvdrFolder.png]]
- Click on the magnifying glass to view the directory. This will open windows file explore in the right location.
[[File:Explorer.png]]
- Right click on the confdvdr folder in the left pane:
[[File:RightClickConfdvdr.png]]
- Click copy
- Now go to the desktop, right click and select paste
This will copy the folder to the desktop. This will also make sure that the original is not affected by changes to this folder.
Now we need to compress the folder (This is recommended, some mailservers will block the mail if these files are sent in a folder as they contain program files.)
This can be done by right clicking on the copied folder and select Send to
[[File:SendTo.png]]
Now you have a zip file on the desktop that can be sent via e-mail to {{MailSupport}}.


=== Other files ===
=== Other files ===
Incase any other file is required, you can find the default folder configuration on the configuration window.
In case any other file is required, you can find the default folder location on the configuration window.
The default save directorys can be found here:
The default directories for the file type can be found here:


[[File:RadiMationPathSettings.png]]
[[File:RadiMationPathSettings.png]]

Latest revision as of 18:51, 6 October 2024

How to provide detailed information of problems[edit]

When you send a e-mail or error report to radimation-support@raditeq.com it helps us a lot when the report is detailed. In this application note we provide you with the information we need to investigate a error.

The most important information of an error report is the answer on the following questions:

  • What was the behaviour that you expected?
  • What happened in reality?
  • Version number of RadiMation?
  • How often does it happen, and can it be reproduced?

Please provide us with this extra information, which is needed to research the issue. If there were recent changes to the system which can have influence, we also would like to be informed of those changes. For example, recent update of Microsoft Windows, RadiMation or recently changed test configurations.

Different types of problems[edit]

There are different types of problems you can encounter. Problems can originate from TSF settings, report generator templates or device related issues. As these different type of problems have different causes we need different information according to the type of the issues.

Below we will state some of the issues and will inform you of additional information that is very helpful to investigate such issues.

Device driver / Controlling Equipment issue[edit]

If you receive errors from the equipment, during a device check, initialization of a test. Almost certain, only an error report is required. The report will contain log information regarding commands send to the device. And the report also contains internal RadiMation information. With this information, we most likely can find the cause of the issue, and provide a solution.

Please provide:

Report Generator issues[edit]

In case of unexpected behavior during generating reports, or when you are missing a Report Generator key.

Please provide:

Unexpected behaviour in RadiMation[edit]

In case of unexpected behavior, during a test, or at configuring a test.

Please provide:

Providing information[edit]

Now that we have established that there can be a couple of different types of errors based on the part of the application where the error occurs, we will look into the methods to deliver the right information according to the type of error.

Error Report[edit]

In case of an error a screen will pop up and will also give you the ability to send a report. This report includes system information (Version, windows version etc.), a log file from the session in which the error occurred and some other details regarding RadiMation®

The information in this report is help full to track communication between the software and the devices. When the error is setting specific it is good practice to also supply the TSF file.

We then need the specific settings to see if it is the device reacting differently to the settings. Keep in mind that we need to reproduce the error so that we need the information that was available to you when performing the test.

A manual report button is also available on the main window help menu. When there are issues that do not generate errors this is the way to capture the communication between the software and the device. In these cases a manual error report is needed together with the tsf file that was used during the creation of the report. This helps us to investigate the settings used and see the way the software/hardware responded.

More information on how to make a manual report can be found here. There is a step by step description and screenshots explaining how to send an error report.

TSF[edit]

TSF files are the test setup files of RadiMation®. They contain the test settings for the tests.

TSF files are saved in the TSF directory configured in RadiMation configuration window. There is not a easy way to directly access the files as they are in an embedded file system. The easiest way is to access them by adding a test in the category that your test was in.

If you where doing Radiated Emision Multiband test, go to "Tests" and open the Radiated emission multi band. This will open the TSF file window. In the file name column, you can find the path and filename. If the file name is not shown, right click on the column header and then click the column chooser to add the required column. You can drag the column to the header row or double click it in the column chooser. The path of the TSF is now visible in the list. In the picture below you see the "Select TSF file" window and the column chooser.

TSF File Location.png

Advanced tip: If you want to be able to go to the TSF quickly now you have found the path name of the file. Select the desired TSF file in the "Select TSF file" window. Now right-click and choose Copy. You can now open text edit and past the line. Here you see the path, select and copy it and paste it in the path field of windows file explorer.

TSFPath.png

Please include the TSF file in an e-mail, send to radimation-support@raditeq.com

Test result files[edit]

A test result file is the data file of a single test, which contains the measurement data of that test. The test result files are saved in the same directory as where the EUT file is saved. And their name is the same name as the EUT file, however they have a .T<xx> extension where <xx> is an increasing number.

In the EUT window, you can view all the stored test result files. You can change the column filtering by right clicking on the table and click Column Chooser. Then drag the Test Filename column to the header row of the list. In the list, now also the exact location of the Test result file is shown.

EUTColumnChooser.png

Report Generator Files[edit]

For the report generator files, the template and output documents are required. Please include the documents in an e-mail, send to radimation-support@raditeq.com.

ReportGeneratorDocumentLocation1.png

ReportGeneratorDocumentLocation2.png

ConfdvdrFolder[edit]

The CONFDVDR sub-directory of the RadiMation® main installation directory contains the complete configuration of the RadiMation® software.


Sometimes it can be useful to us to request a copy of the confdvdr folder. This is normally not included in the error log and we will request for it if needed. It allows us to load the configuration and see if there are issues with the configuration. Because it is send to us on request and there is no automatic procedure we request to make a copy of the folder, zip it and send it to us. Below is the procedure that explains how to find the folder and create a zip file from it.


Locating and zipping the confdvdr folder[edit]

- To locate the folder go to configuration -> Configuration -> Directories

ConfdvdrFolder.png

- Click on the magnifying glass to view the directory. This will open windows file explore in the right location.

Explorer.png

- Right click on the confdvdr folder in the left pane:

RightClickConfdvdr.png

- Click copy

- Now go to the desktop, right click and select paste

This will copy the folder to the desktop. This will also make sure that the original is not affected by changes to this folder. Now we need to compress the folder (This is recommended, some mailservers will block the mail if these files are sent in a folder as they contain program files.)

This can be done by right clicking on the copied folder and select Send to

SendTo.png

Now you have a zip file on the desktop that can be sent via e-mail to radimation-support@raditeq.com.

Other files[edit]

In case any other file is required, you can find the default folder location on the configuration window. The default directories for the file type can be found here:

RadiMationPathSettings.png