AD-SWIOT1L-SL plugin¶
Overview¶
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.
Note
For an overview of the AD-SWIOT1L-SL system, check the complete user guide: AD-SWIOT1L-SL User
Warning
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 Download: Installer for latest release (Windows 64/32-bit); Updated: November 2023
Scopy for Windows portable Download: Portable version for latest release (Windows 64/32-bit); Updated: November 2023
Scopy for Linux Download: Scopy Flatpak installer; Updated: November 2023
Scopy for OSX Download: Scopy MacOS installer
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 the 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.
Warning
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:analog.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.
Note
The default static IP for all the boards is 169.254.97.40 .
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.
Note
For more details on the power supply options, check the hardware user guide: AD-SWIOT1L-SL Hardware User Guide
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.
Note
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.