Scopy Overview#
About#
Scopy is a multi-functional software toolset with strong capabilities for signal analysis.
Note
Scopy v2.0.0 is now compatible with any IIO system.
Download#
Tip
Scopy for Windows
Scopy for Linux
Download: Scopy Flatpak installer
Scopy for OSX
Download:OSX installer
Scopy for Android
Download: Android installer
Google Play store link: Scopy
Scopy all platforms latest(nightly) builds
Download:Installer for latest (nightly) build
Warning
In order to have Scopy working with ADALM2000 or ADALM-Pluto please make sure that the Device Drivers are installed. A guide on this topic can be found in the section:
Installation#
Scopy for Windows
Once you downloaded the installer, run it and follow all the required steps. After completion, system reboot is required.
Video installation guide:
Scopy for Linux
Before downloading and extracting the scopy-Linux-flatpak.zip archive, you need to setup Flatpak using this setup guide for your Linux distribution.
For Ubuntu, you can use the following steps:
sudo add-apt-repository ppa:alexlarsson/flatpak
sudo apt update
sudo apt install flatpak
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
After this, get the Scopy.flatpak file from the downloaded archive and run:
flatpak install scopy-Linux-flatpak.flatpak
Video installation guide:
Scopy for OSX
Double click the downloaded .dmg to make its content available. “Scopy” will show up in the Finder sidebar and a window showing the content should open up. Drag the application from the .dmg window into Applications to install and wait for the process to finish.
Video installation guide:
Scopy for Android
Tap on the downloaded .apk file to start the installation process and proceed by hitting the “Install” button. Optionally, you may be warned that this application comes from unknown sources, hit the “Install anyway” button. Now, you can find “Scopy” together with your other apps.
In order to connect ADALM2000 to your device, you will need an OTG adapter that will mediate the connection between your device and the USB cable, as shown in the image below.
Launch#
Run Scopy from the Desktop Shortcut / Start Menu / Installation Folder.
On Linux, you can also run it using:
flatpak run org.adi.Scopy
Application Overview#
Homepage layout#
The Home view is divided into multiple sections:
Device browser#
Contains a list of devices (USB/serial/network/emulated) that Scopy can connect to.
USB devices are scanned automatically at startup when the top right “Scan” switch is ON.
Add(+) device page#
Can be used to connect to devices that are not automatically detected in the above mentioned list.
The interface has two tabs for device configuration:
IIO: adding and configuring IIO devices.
EMU: adding and configuring virtually emulated devices using the iio-emulator.
The IIO tab includes settings for scanning, connecting, and configuring various connected devices.
SCAN Section
Filter: Allows the user to choose which connection types to scan for.
If none is selected, the application will scan for all types.
A new scan is triggered every time one of the following options is selected.
Local: Scans local devices, usually on target.
IP: Scans network devices.
USB: Scans USB devices.
Context: List of currently scanned contexts.
Refresh: Button to re-scan and detect available devices.
SERIAL Section
Port Name: Drop-down to select available serial devices.
Baud Rate: Allows setting the communication speed.
Port Config: Specifies the data format and parity.
Refresh: Refreshes the list of available serial devices.
URI
URI Input: This is where the user specifies the connection URI. This field is automatically populated based on the selection from one of the previous sections but the user can manually input the URI of the required device.
Verify: Button to verify the connection based on the provided URI. This will display an error if no such context is available. On success a different page will be displayed allowing the user to configure compatible plugins.
The EMU tab includes settings for selecting the emulation mode, XML configuration files, RX/TX devices, and URI for the emulated device.
- DEMO OPTION:
Drop-down menu to select one of the predefined emulated devices.
Options are: adalm2000, pluto, swiot, pqm and generic. When using the generic option, the user must provide a path of the XML for the emulated device. If an existing option is selected, the XML path will be automatically completed in the field.
- XML PATH:
Specifies the path to the XML configuration file required for the emulation.
- RX/TX DEVICES:
Specifies the RX (receive) and TX (transmit) device files for the emulation mode. These are .bin files containing samples to be used on RX/TX devices.
For detailed examples check the official iio-emu Github docs .
- URI:
The URI is automatically set to ip:127.0.0.1 or ip:localhost.
- Enable Demo Button:
Validates and activates the demo mode based on the selected configuration.
Automatically displays the IIO tab and populates the URI field if the EMU validation is successful.
The add device plugin configuration page will allow the user to select compatible plugins for the newly added device.
By default, the plugins with the highest priority will be selected. Clicking the ADD DEVICE button will finalize the process and create a new device entry in the device browser.
Tip
Scopy can be connected to multiple IIO devices simultaneously starting with v2.0. All the connected or available IIO devices will be available in the device browser.
Information Window#
This area contains the welcome page, add device page and for each device a device page.
The device page will contain context attributes extracted from the IIO context, as well as specific buttons or controls that can be provided by any compatible plugin (Example: The ADALM2000 has a “Calibrate” button which is only specific to this type of device).
Save & Load session#
Scopy can save or load different configurations in an .ini file format.
Preferences#
Scopy Preferences can be accessed using the bottom left side preferences button. On the right side of the page, preferences for each plugin are available. More details can be found in their specific plugin documentation section.
Clicking the Reset Scopy button will reset the application to a default configuration.
Changing some of the listed preferences will require an application restart.
About page#
Scopy About page can be accessed using the bottom left side about button. On the right side of the page, about pages specific for each plugin are available if necessary. More details can be found in their specific plugin documentation section.
The General About page contains different useful links:
Build info will display the application version, Git commit, build date and whether it was created locally or in a continuous integration environment, a list of dependencies and their specific versions or Git commit hashes, a list of the last 100 commits and the Scopy branch.
Warning
These are all important in the debugging process and most of this information should be specified when reporting an issue.
License link to the open-source LICENSE file in the Github repository.
Open-source dependencies list of Scopy includes a number of open source libraries, released under their own licenses.
Latest release for quick access to the latest Github release page.
Documentation for quick access to this documentation.
Support forum for quick access to Engineer Zone.
Connecting to a device#
To connect to any device on the Device Browser click on the device and then click the Connect button in the Information Window.
If the connection was established, the device will have a green status line under it and you will be able to disconnect from it in the same Information Window.
Clicking the
button will remove the device from the list.The device title can be modified by hovering over the top right corner of the icon and clicking the
pen icon.If errors are encountered during the connection phase a warning sign
will appear on the top right side of the
device icon.
User Guides#
Scopy can now interact with multiple hardware devices at a time. Once a device is selected to be used with the application, a list of instruments that are available for that device will be visible as a preview. Once connected to a device the instruments will be enabled and available.
Each instrument can be opened from the left menu. The icon on the right of the instrument name specifies that the instrument is enabled and provides a shortcut that allows an instrument to be turned on or off.
For each connected device, there is an entry in the left side menu, above all the instruments, displaying the Name and URI of the connected device.
The instruments menu can be minimized by clicking on the Scopy button near the top-left window.
Detaching Instruments#
Scopy provides the detaching into multiple windows feature for each instrument available, providing a better view/manipulation.
This can be done by double clicking the instrument to detach it.
Please make sure that the Double click to detach a tool option is enabled in the Preferences menu.
Instruments Overview#
Scopy provides a list of plugins and instruments described in the Plugins page
Scripting#
User guide on how to use scripts with Scopy:
Building from source#
Complete Scopy build guides on:
Source code#
The source code for the entire application can be found on github