Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
test-and-measurement:analog-discovery-pro-3x50:gui [2021/10/13 21:06] – external edit 127.0.0.1test-and-measurement:analog-discovery-pro-3x50:gui [2022/10/04 11:38] (current) – external edit 127.0.0.1
Line 1: Line 1:
 +====== Adding a GUI for Linux on Analog Discovery Pro (ADP3450/ADP3250) ======
 +{{ reference:test-and-measurement:analog-discovery-pro-3x50:waveforms_gui.png?600 |}}
 +
 +~~TechArticle~~
 +
 +<WRAP group>
 +This guide discusses how and why to add a Graphical User Interface (GUI) for the Analog Discovery Pro (ADP3450/ADP3250) using Virtual Network Computing (VNC) and presents how to install WaveForms on your device and use it with a wireless screen. 
 +</WRAP>
 +----
 +
 +===== Inventory =====
 +=== Hardware ===
 +<WRAP group>
 +  * [[https://digilent.com/shop/analog-discovery-pro-3000-series-portable-high-resolution-mixed-signal-oscilloscopes/|Analog Discovery Pro]] in Linux mode
 +    * If you haven't used Linux mode before, check out the [[linux-mode|Getting Started in Linux Mode]] guide for information on how to switch from the default Standard mode into Linux mode, boot into Linux, and connect to it with a serial terminal.
 +  * A computer connected to the same network as the Test & Measurement device
 +  * Ethernet cable or a USB WiFi Dongle (see the [[test-and-measurement:analog-discovery-pro-3x50:specifications#compatible_wi-fi_dongles|Specifications]] for a list of compatible dongles)
 +  * A USB flash drive formatted with a FAT/FAT32 filesystem (Optional)
 +</WRAP>
 +
 +=== Software on Your PC===
 +<WRAP group>
 +  * [[https://ttssh2.osdn.jp/|TeraTerm]], or any other terminal emulator of your choice
 +  * [[https://www.realvnc.com/en/connect/download/viewer/|Real VNC Viewer]], or any other VNC viewer of your choice
 +</WRAP>
 +
 +<WRAP group>
 +**Note:** //To start, you are required to have the latest Linux image on your device, and your device has to be connected to the internet. To update the Linux image on Analog Discovery Pro (ADP3450/ADP3250), follow this guide: [[test-and-measurement:analog-discovery-pro-3x50:recover-linux-mode]]. To connect your device to the internet, follow this guide: [[test-and-measurement:analog-discovery-pro-3x50:connect-to-the-internet]].//
 +</WRAP>
 +----
 +
 +===== Setting Up a Remote Desktop =====
 +<WRAP group>
 +Connect your PC to the Analog Discovery Pro with a terminal emulator, either over a USB cable or with SSH. Log into the device. By default, the username and password are both "//digilent//".
 +
 +First, a desktop environment should be installed. In this guide, [[https://xfce.org/|XFCE]] will be used, as it is one of the most lightweight desktop environments. To install XFCE, enter the following line into the terminal and wait several minutes until the necessary packages are installed (the sudo password is "//digilent//" by default).
 +<code>sudo apt install xfce4 -y</code>
 +
 +As the Analog Discovery Pro doesn't have a display, a VNC server must also be installed to stream the desktop to another device (PC, phone, or tablet). Install the VNC server with the following command:
 +<code>sudo apt install tightvncserver -y</code>
 +</WRAP>
 +
 +<WRAP group><WRAP half column>
 +Start and stop the server to create the necessary configuration files, by typing:
 +<code>vncserver</code>
 +At the first start, you are required to enter a password for your remote desktop. When you are asked if you would like a view-only password or not, choose "no". Stop the server by entering:
 +<code>vncserver -kill :1</code>
 +
 +Now open the configuration file:
 +<code>sudo nano ~/.vnc/xstartup</code>
 +and add the following line to the end of the file:
 +<code>startxfce4</code>
 +Hit Ctrl+O and enter to save the changes and Ctrl+X to exit from the editor.
 +
 +Start the server again with:
 +<code>vncserver</code>
 +Note the X desktop name (here it is //ADPro:1//).
 +</WRAP><WRAP half column>
 +{{ reference:test-and-measurement:analog-discovery-pro-3x50:tightvnc_config.png?400 |}}
 +{{ reference:test-and-measurement:analog-discovery-pro-3x50:tightvnc_start.png?400 |}}
 +</WRAP></WRAP>
 +
 +<WRAP group><WRAP half column>
 +Open the VNC viewer and add a new connection with the noted X desktop name. Enter your password and connect to the device.
 +</WRAP><WRAP half column>
 +{{ reference:test-and-measurement:analog-discovery-pro-3x50:vncviewer_add.png?400 |}}
 +</WRAP></WRAP>
 +
 +<WRAP group><WRAP half column>
 +On the first start, choose "//Use default config//". At this point, you have a working GUI for Analog Discovery Pro, but the server will stop when you turn off the device.
 +</WRAP><WRAP half column>
 +{{ reference:test-and-measurement:analog-discovery-pro-3x50:vncviewer_config.png?600 |}}
 +</WRAP></WRAP>
 +
 +<WRAP group><WRAP half column>
 +To enable autorun for the VNC server, open //Applications// -> //Settings// -> //Settings Manager// and select //Session and Startup// from the //System// group. Select the //Application Autostart// tab and add a new entry. Set the name and the description of the entry to something suggestive and the command to:
 +<code>vncserver</code>
 +
 +Save the changes. Now the VNC server will be started on boot. You can connect to the device after booting by double-clicking on its icon in the VNC viewer.
 +
 +**Note:** //You may have to wait a few minutes after booting, for the network connection to be established.//
 +</WRAP><WRAP half column>
 +{{ reference:test-and-measurement:analog-discovery-pro-3x50:startup_settings.png?600 |}}
 +</WRAP></WRAP>
 +----
 +
 +===== Using the Remote Desktop =====
 +<WRAP group>
 +In this part, we will install the WaveForms GUI on the Analog Discovery Pro, then use an Android tablet as a wireless screen. Before continuing, check your browser. If the browser doesn't open, expand the drop-down below for detailed instructions about how to fix it.
 +</WRAP>
 +
 +<WRAP group>
 +--> Fixing the Browser on XFCE #
 +<WRAP group><WRAP half column>
 +If you receive an error when opening the browser, you will have to install a new one and set that as default. Open the terminal, then type:
 +<code>sudo apt-get install falkon -y</code>
 +
 +When the installation finishes, open //Applications// -> //Settings// -> //Preferred Application//. Open the //Web Browser// drop-down and choose //Other...//. In the window that appears enter:
 +<code>falkon --no-sandbox</code>
 +Save the changes. Now you should have a working browser.
 +</WRAP><WRAP half column>
 +{{ reference:test-and-measurement:analog-discovery-pro-3x50:falkon_setup.png?600 |}}
 +</WRAP></WRAP>
 +<--
 +</WRAP>
 +----
 +
 +==== Installing the WaveForms GUI ====
 +<WRAP group><WRAP half column>
 +On your device, open the [[https://mautic.digilentinc.com/waveforms-download|WaveForms Download]] page. Fill in the required fields, then download WaveForms for **Linux ARM-32-bit.deb**.
 +
 +Alternatively, if you want to download the WaveForms installer to your computer first, then transfer it to the ADP, rather than using a browser on the device, you can download the installer now and place it on your FAT/FAT32 flash drive.
 +</WRAP><WRAP half column>
 +{{ reference:test-and-measurement:analog-discovery-pro-3x50:download_wf_gui.png?600 |}}
 +</WRAP></WRAP>
 +
 +<WRAP group><WRAP half column>
 +Open **Downloads** folder with the file manager, or after inserting the usb stick, click on the new icon from desktop and enter the password in the pop up window to mount the USB flash drive. Then, from the //File// menu, select //Open Terminal Here//. Install the downloaded package with the following commands (don't forget to change the name of the file according to its version):
 +<code>
 +sudo dpkg -i digilent.waveforms_3.14.3_armhf.deb
 +sudo apt-get install -f
 +</code>
 +</WRAP><WRAP half column>
 +{{ reference:test-and-measurement:analog-discovery-pro-3x50:install_wf_gui.png?600 |}}
 +</WRAP></WRAP>
 +----
 +
 +==== Using the WaveForms GUI ====
 +<WRAP group><WRAP half column>
 +WaveForms can be opened from //Applications// -> //Development// or //Education// -> //WaveForms//. WaveForms will connect to the Analog Discovery Pro on startup.
 +
 +<WRAP round tip>
 +You can connect other Test & Measurement devices to the Analog Discovery Pro and use them with WaveForms.
 +</WRAP>
 +
 +<WRAP round tip>
 +While WaveForms is not supported on Android, you can still install a VNC viewer to your tablet and use it as a wireless display for Analog Discovery Pro.
 +</WRAP>
 +</WRAP><WRAP half column>
 +{{ reference:test-and-measurement:analog-discovery-pro-3x50:waveforms_gui.png?600 |}}
 +</WRAP></WRAP>
 +----
 +
 +==== Exchanging Files with the Analog Discovery Pro (ADP3450/ADP3250) ====
 +<WRAP group><WRAP half column>
 +To copy/move files between your PC and the Analog Discovery Pro, you can use the Secure File Transfer Protocol (SFTP). To start the file transfer, open a command prompt, or terminal on your PC, then type:
 +<code>sftp digilent@ADPro</code>
 +When required, enter your password.
 +
 +You can use the following commands to set the working path:
 +<code>lpwd - view the local working directory
 +pwd - view the remote working directory
 +lcd directoryname - change the local working directory
 +cd directoryname - change the remote working directory
 +lls - list files from the local working directory
 +ls - list files from the remote working directory</code>
 +
 +/*You can view the local working directory with the "//lpwd//" command and the remote working directory with the "//pwd//" command. To change the local directory, use the "//lcd//" command. To change the remote directory, enter "//cd//" and the directory name. You can list the content of the directories with "//lls//" (for the local directory) and "//ls//" (for the remote directory).*/
 +</WRAP><WRAP half column>
 +{{ reference:test-and-measurement:analog-discovery-pro-3x50:sftp_path.png?600 |}}
 +</WRAP></WRAP>
 +
 +<WRAP group><WRAP half column>
 +When the local and the remote paths are set, you can copy files from the remote directory to the local directory with the following command:
 +<code>get filename.extension</code>
 +To copy a file from the local directory to the remote one, use:
 +<code>put filename.extension</code>
 +
 +When finished, you can exit with:
 +<code>bye</code>
 +</WRAP><WRAP half column>
 +{{ reference:test-and-measurement:analog-discovery-pro-3x50:sftp_copying.png?600 |}}
 +</WRAP></WRAP>
 +----
 +===== Next Steps =====
 +<WRAP group>
 +For more guides on how to use your Digilent Test & Measurement device, return to the device's Resource Center, linked from the [[test-and-measurement:start]] page of this wiki.
 +
 +For technical support, please visit the [[https://forum.digilentinc.com/forum/8-test-and-measurement/|Test and Measurement]] section of the Digilent Forums.
 +</WRAP>