A Software_bug is a flaw, error in a software application that causes it to behave unexpected, hang or even crash. No matter how sharp our skills are, or rigorous our testing, a few bugs are bound to slip through the cracks every now and then. As much as you don't want them; we don't want/like them either. However, some bugs can be difficult to replicate, track down and eventually fix without a well written bug report. If you encounter one of the what you believe is a software bug, this guide is here to provide a step by step approach into reporting the bug on our issue tracker.
What we need is:
Is it a bug? or is it a feature request? Something not working properly (a bug) is different than something working differently than you want. Feature requests are tracked in the same place as bugs, but will not have a
Some troubleshooting steps that might be worth looking at to understand if you have a potential common hardware problem.
Scopy is continuously being improved from one version to another, (with bug fixes) and with new features.
If the bug exists in the nightly - You will need to report a bug (sorry). First check to see if someone else has reported the same bug.
The easiest/most straightforward way to describe the bug, is to let us see how scopy was configured when the bug occurred. From one session to another, Scopy uses
.ini files to load its previous state when it was closed. These file are located in:
C:\Users\<your_username>\AppData\Roaming\ADISometimes this is a hidden directory, and you unhide it.
*.ini files are simple text files:
Scopy.ini: captures the state of all the instruments, and menu settings, and locations of all windows.
Preferences.ini: controls the preferences of scopy
When a bug/crash occurs, this files can be trivial in inspecting the configuration that caused Scopy to fail, and can be critical in getting allowing a developer to easily replicate the problem.
In the Windows folder where the “.ini”, a
crashdmp folder will also be there that will contain additional information about the crash and where it happened. This is a Windows small memory dump file. The memory dump file contains the following information:
This can allow scopy developers to troubleshoot the issue with the Windows Debugger (
WinDbg.exe) tool and understand where things crashed, without even having to replicate the steps that caused the crash. The easier it is to find the problem, the easier it is to fix it, and faster you can get back to work.
Alongside the “.ini” files, if logging is enabled in Scopy, there should also be a file with the name “ScopyLog-yymmdd-hhmmss.id”. In order to generate a log file, the debug logging must first be enabled via the Preferences Menu from the Debug Section(Enable Session Logging). Once Scopy is closed the debug logging is disabled. For each connection a new logging file is generated. This files will never be deleted by Scopy, they can be manually deleted by the user.
In order to generate a logging file that provides the most information, after encountering a bug, restart Scopy, enable the session logging from the Preferences menu, then connect to the board and reproduce the exact steps that lead to the bug.
Making a backup of the entire folder where the
.ini files are located and adding it to the bug report is critical for developers.
Older Versions of Scopy (v 1.2.0 and older) do not capture:
Some bugs might be obvious to reproduce (always clicking a button crashes Scopy), but some are hard and only happen in a specific configuration. Mentioning the exact steps that lead to the bug are trivial for us in order to properly reproduce it.
Operating System: Linux
Scopy Version: v1.2.0 or git tag
Firmware Version: 0.25
Steps to reproduce the bug:
- Started the Signal Generator with the following configuration: 5khz 2V sine wave on channel 1 …
- Started the Oscilloscope
- On the Oscilloscope, selected the measurements menu
- When enabling statistics in the measurements menu, Scopy crashes.
Attached the “.ini” files also containing the “crashdump” folder (if on Windows) and the logging files if present