Wiki

This version is outdated by a newer approved version.DiffThis version (25 Aug 2023 11:13) was approved by Alexandra Trifan, Andrei Cozma.

This is an old revision of the document!


Scopy AD-SWIOT1L-SL plugin

The Scopy AD-SWIOT1L-SL plugin is responsible with the operation and control of the AD-SWIOT1L-SL platform.
The Scopy AD-SWIOT1L-SL plugin, while based on the Scopy application infrastructure, is tailored to provide all the specific functionalities of this system.

For an overview of the AD-SWIOT1L-SL system, check the complete user guide: AD-SWIOT1L-SL User Guide
For an overview of the Scopy application, check the Scopy user guide
The Scopy application is in the process of a major rework so a mismatch between some parts of the documentation and the actual application may exist. The new Scopy version is not officially released, so the installers for Scopy with AD-SWIOT1L-SL plugin will be available at the links provided below.

Software setup

Scopy for Windows

Scopy for Windows portable

Scopy for Linux

Scopy for OSX

Software installation

Windows

Once you downloaded the installer, run it and follow all the required steps. After completion, system reboot is required.

Linux

Setup Flatpak using this setup guide for your Linux distribution.

After Flatpak is setup get the Scopy.flatpak file from the downloaded archive and run:

    flatpak install scopy--flatpak.flatpak

MacOS

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.

The AD-SWIOT1L-SL system is not compatible with Scopy v1.4.1 or older

Launching the application

Scopy is able to control and operate multiple devices. In order to use it for the AD-SWIOT1L-SL system, the user should click the “Add Device”(+) button displayed on the front page of the application.

The video attached above demonstrates the process of connecting to the board. First it will scan the network in order to detect the device. If the device is connected to the network and able to be scanned, it will appear in the list as ip:swiot.local. If the device is not available in the list, but the IP is known, the user can manually write the IP in the URI textbox and proceed forward.

Once found and verified Scopy will present a list of compatible instruments. The list of instruments is explained below, but during this step the user can enable or disable Scopy functionalities for this board.

Going forward the homepage of the board is displayed. The homepage displays some basic information about the board, including its network IP. It also contains three buttons. One will perform the connection to the device, the second one performs identification and will blink a led on the board and the third one will start a quick tutorial for Scopy first time users. The tutorial is recommended in addition to this user guide as it will highlight and explain the user interface controls for the SWIOT1L available instruments.

Power Supply Options

This warning may appear in any of the instruments that interact with AD-SWIOT1L-SL. The user should check the external power supply switch position and verify which option is used to power the system.

For more details on the power supply options, check the hardware user guide: AD-SWIOT1L-SL Hardware User Guide

Understanding the system operation modes

  • Configuration mode: When the system is powered up it will enter the Configuration mode. This mode allows the user to choose device and function configuration for each of the 4 physical channels. When entering the Configuration mode, everything is reset to default values. Other than the initial state after power up, the user can enter this mode by using the Config button available in all the runtime instruments of Scopy (instruments: AD74413R, MAX14906, Faults).
  • Runtime mode: In order to enter the Runtime mode, the user needs to configure the required channels and use the Apply button provided in the Config Instrument. In this mode the physical channels are configured and can be used to control or acquire data. If any changes are needed, the user can go back into Configuration mode by using the Config button mentioned above.

More details on switching through the board states are provided on specific instrument documentation.

Switching between operation modes might take some time depending on the network status.
When switching from one mode to another the board is briefly disconnected from Scopy, that is because the IIO Context that it relies on needs to be destroyed and recreated based on the selected configuration.

Available instruments in config mode

Available instruments in runtime mode

university/tools/m2k/scopy/plugins/swiot1l.1692954750.txt.gz · Last modified: 25 Aug 2023 11:12 by Alexandra Trifan