This version is outdated by a newer approved version.
This version (23 Jul 2014 11:08) was approved by Dan Nechita.The Previously approved version (23 Jun 2014 23:44) is available.
This version (23 Jul 2014 11:08) was approved by Dan Nechita.The Previously approved version (23 Jun 2014 23:44) is available.This is an old revision of the document!
Table of Contents
IIO Oscilloscope
About
The ADI IIO Oscilloscope is a example application, which demonstrates how to interface different evaluation boards from within a Linux system. The application supports plotting of the captured data in four different modes (time domain, frequency domain, constellation and cross-correlation). The application also allows to view and modify several settings of the evaluation board's devices.
Download
You can either download the IIO Oscilloscope here from the wiki or checkout the latest version from the git repository.
Git: https://github.com/analogdevicesinc/iio-oscilloscope / git://github.com/analogdevicesinc/iio-oscilloscope.git
Installation
Dependencies
The IIO Oscilloscope uses the following libraries:
- GTK+
- Gtkdatabox
- Matio
Before the IIO Oscilloscope can be build the following packages need to be installed:
Install Libiio library by following these instructions.
This specifies any shell prompt running on the target - Install IIO Oscilloscope build dependencies
> sudo apt-get install libgtkdatabox-0.9.1-1-dev libgtk2.0-dev libmatio-dev
Build
To build and install the IIO Oscilloscope you need to unpack the tar archive and run `make` and `make install` in the osc folder.
This specifies any shell prompt running on the host or target - Download and install the iio scope
> git clone https://github.com/analogdevicesinc/iio-oscilloscope.git > cd iio-oscilloscope > git checkout origin/master > make > sudo make install
User guide
Launching the application
Running Local
The application can run locally which means it runs on the same platform where your device is connected.
To start the IIO Oscilloscope open up the start menu of your system and search for “IIO Oscilloscope”. E.g. if you are using a Ubuntu Linux system move your mouse cursor to the left side of your screen and “Dash home” button and type “IIO Oscilloscope” into the search box.
Running Remote
The application can be used to connect to another platform that has a connected device in order to configure the device and read data from it.
This specifies any shell prompt running on the host or target - Run IIO Oscilloscope in remote mode
> export OSC_REMOTE=IP address of the remote platform > osc
Using the application
Capture Window
- Device list: Lists all available ADCs and the corresponding channels. It allows selecting the channels to be displayed.
- Plot type
- Time domain: Plots the signal in the time domain. Displays the raw samples.
- Frequency domain: Plots the signal in the frequency domain. Performs a FFT on the signal and displays it.
- Constellation: Plots the signal as a constellation plot. The I-channel will be plotted on the X-axis and the Q-channel on the Y-axis.
- Cross Correlation: Plots the signal as a cross-correlation plot.
- Sample count: Selects the number of samples for time domain, constellation and cross-correlation plotting
- FFT size: Selects the size of the FFT for frequency domain plotting
- FFT Average: Selects the average weight to be applied to the FFT samples.
- PWR Offset: Selects the offset of the FFT graph.
- Graph Type: Selects the type of all graphs: lines or dots.
- Info: Displays marker measurements.
- Plot Options
- Capture/stop: Starts or stops the data capture.
- Zoom In: Zooms in on a region of the plot.
- Zoom Out: Zooms out from a region of the plot.
- AutoZoom: Zooms automatically for the signal to fit the screen.
- Save As: Saves data to file.
- FullScreen: Enters/leaves fullscreen.
- Auto scale: When enabled the visible area will automatically be re-scaled to fit the entire plot.
- Show grid: Shows or hides the grid in the plot window.
- Y Max: Adjusts the upper limit of the vertical axis when Auto scale is disabled.
- Y Min: Adjusts the lower limit of the vertical axis when Auto scale is disabled.
- New Plot: Creates a new plot of the same type.
- Capture Window Settings
- Plot Title: Click Edit→Plot Title to change the name of the window.
- Show Settings: Click View→Show Settings to hide all settings in the left panel and allow the plot to fill the entire window.
Activating Markers
Markers are used for plot data measurement. To activate the markers right click on the plot and select from the marker menu the type of marker you want to enable. Make sure the capture process is running and the appropriate domain is selected in order to enable the markers properly. The following types of markers are available:
- FFT domain (1 channel enabled): Peak, Fixed and Single Tone markers.
- FFT domain (2 channels enabled): Peak, Fixed, Single Tone and Image markers.
- Constellation: Peak marker.
The enabling of a marker will display a set of 5 markers by default. You can add more markers by selecting Add Marker from the marker menu and remove some by selection Remove Maker.
Fixed markers are designed to have their position moved by the user. Once the fixed markers are visible on the plot right click on the marker symbol and while holding the right button pressed move the mouse to the desired location on the plot and release the right button.
To disable the markers select Markers Off from the marker menu.
Saving Captured Data
Once the data is captured, it can be saved using one of the following formats:
- Agilent VSA
- .csv
- .mat
- .png
Click on File→Save As to open the dialog needed to save the data.
Channel Settings
- Simple math operation can be applied to the channel data. Right click on the name of a channel listed in the Device list and select Math Settings to open the menu with the math operations.
- The graph color associated with the channel can be modified. Right click on the name of the channel and select Color Settings to open a color selection panel that will allow you to pick the desired color.
The settings can be applied only in Time domain.
Main Window
The Main Window is designed to display a configuration panel (plugin) for each device recognized by the system. Additional plugins will be loaded for device debugging and monitoring purposes such as:
- DMM Plugin: The Digital Multimeter continuously displays device specific data once the start button is activated.
- Device tab: Displays the list of all available devices.
- Active channels tab:Displays the list of channels that belong to the enabled devices. All channels can be enabled simultaneously by using the All Channels button.
- Right side tab: Displays data readings of the enabled channels in Active channels tab.
- Debug Plugin: Is a tool for device debugging.
- Device Selection: Sets the active device. Once a device is selected any other information displayed in the plugin related to this particular device.
- IIO Device Attributes: Allows Read/Write operation for the attributes of a device.
- Register: Provides low level access to the registers of the device.
- Detailed Register Map: When enabled it displays a graphical representation of a register and groups the bits by their functionality. When disabled the newly displayed option (Register Map Type) allows the selection of the register map to be used. SPI registers refer to the internal registers of the device while the AXI Core registers belong to the HDL core associated with the device.
- Enable AutoRead: When enabled it allows the register to be read automatically as the register address changes.
- Address: The address of the register.
- Value: The value of the register at the given address.
Each plugin can be detached from the main window simply by clicking on the button placed on the right side of the name of the plugin. Use the same button to attach the plugin back to the main window.
Source code
Files
The source code for the entire application is at github. You can ask questions about it on the EngineerZone.
More information
resources/tools-software/linux-software/iio_oscilloscope.1406106359.txt.gz · Last modified: 23 Jul 2014 11:05 by Dan Nechita