Differences

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

Link to this comparison view

test-and-measurement:analog-discovery-pro-3x50:connect-to-the-internet [2022/09/09 14:11] – changed forum.digilentinc.com to forum.digilent.com jeff.greenberg_ni.comtest-and-measurement:analog-discovery-pro-3x50:connect-to-the-internet [2022/10/04 11:38] (current) – external edit 127.0.0.1
Line 1: Line 1:
 +====== Connecting the Analog Discovery Pro (ADP3450/ADP3250) to the Internet ======
 +~~TechArticle~~
 +=====Overview=====
 +The Analog Discovery Pro can be connected to the internet, which gives users the ability to configure Linux mode with many available software packages and makes the device available for remote use. This guide walks you through the steps required to establish the connection and ends with using the connection to update the preinstalled ''apt'' package manager.
 +
 +----
 +=====Inventory=====
 +  * 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 with [[https://mautic.digilentinc.com/waveforms-download|WaveForms]] installed, version 3.16.3 or later
 +  * USB cable
 +  * Ethernet cable or a USB WiFi Dongle (see the [[test-and-measurement:analog-discovery-pro-3x50:specifications#compatible_wi-fi_chipsets|Specifications]] for a list of compatible dongles)
 +
 +===== A Note Before Beginning =====
 +Connecting the Analog Discovery Pro to the network and the broader internet will allow other users on the local network to connect to the device via WaveForms. This will prevent any one else trying to connect via WaveForms from doing so. Respect your fellow engineers and their equipment.
 +
 +----
 +===== Setting up the Connection =====
 +
 +<WRAP group><WRAP column half>
 +The first step is to connect a serial terminal to your device, which will be used later when logging into Linux mode. Make sure that the Analog Discovery Pro is connected to the host computer and powered on.
 +
 +Find out which serial port the device is connected to and make note of it. For example, if you are running Windows, this will be a COM port listed in the Device Manager.
 +
 +Note that the serial connection should be established before booting into Linux mode, to ensure that no boot messages are missed.
 +</WRAP><WRAP column half>
 +{{ reference:test-and-measurement:analog-discovery-pro-3x50:device_manager_com_port.png?400 |}}
 +</WRAP></WRAP>
 +
 +<WRAP group><WRAP column half>
 +Open a terminal emulator, such as TeraTerm, and connect to the noted serial port using 115200 Baud, 8 data, 1 stop, and no parity bits.
 +
 +Note that if the Analog Discovery Pro is connected to immediately after booting, it may take approximately 20 seconds for the login prompt to be presented. If the screen is blank upon successful connection, press **Enter** on the keyboard and the login prompt should now be displayed.
 +</WRAP><WRAP column half>
 +<columns 100% 55% 45%>
 +{{ reference:test-and-measurement:analog-discovery-pro-3x50:teraterm_start.png?400 |}}
 +<newcolumn>
 +{{ reference:test-and-measurement:analog-discovery-pro-3x50:teraterm_set.png?400 |}}
 +</columns>
 +</WRAP></WRAP>
 +
 +
 +<WRAP group><WRAP column half>
 +Open WaveForms. The application will be used to configure the network settings of the device.
 +
 +If the Device Manager hasn't opened, then select Settings -> Device Manager. Make sure your device appears and is selected in the list of devices, boot into Linux Mode if you have not done so already, then click the **Network** button to open the Network Settings window.
 +</WRAP><WRAP column half>
 +{{ reference:test-and-measurement:analog-discovery-pro-3x50:select-network-device-manager.png?400 |}}
 +</WRAP></WRAP>
 +
 +----
 +<columns 100% 50% 50%>
 +Make sure to check the //Apply these settings on Linux boot// box.
 +
 +It is important to note that you can later change these settings from within Linux itself, however, the settings seen here in the Network settings screen will be applied each time the device is rebooted.
 +<newcolumn>
 +{{ reference:test-and-measurement:analog-discovery-pro-3x50:network-settings-title.png?​400 }}
 +
 +{{ reference:test-and-measurement:analog-discovery-pro-3x50:network-settings-mode.png?400 }}
 +</columns>
 +<columns 100% 50% 50%>
 +To most easily connect to the internet, you should be connected to an access point that provides DHCP, typically a router. Check each of the "obtain automatically" boxes in order to take advantage of this.
 +<newcolumn>
 +{{ reference:test-and-measurement:analog-discovery-pro-3x50:network-settings-ip-address.png?400 |}}
 +
 +{{ reference:test-and-measurement:analog-discovery-pro-3x50:network-settings-dns.png?400 }}
 +</columns>
 +<columns 100% 50% 50%>
 +Click **Apply and Reboot** in order to save the changed settings to the device and to reboot it.
 +<newcolumn>
 +{{ reference:test-and-measurement:analog-discovery-pro-3x50:standard-apply-and-reboot-crop.png?400 }}
 +</columns>
 +----
 +<WRAP group><WRAP column half>
 +You can observe the boot process with the previously-connected serial terminal. When it completes, a login prompt will be seen.
 +
 +Log into the device. By default, the username and password are both "//digilent//".
 +
 +Note that upon login, a "urandom warning" may be printed to the terminal, and can safely be ignored.
 +</WRAP><WRAP column half>
 +{{ reference:test-and-measurement:analog-discovery-pro-3x50:teraterm_login.png?600 |}}
 +</WRAP></WRAP>
 +
 +----
 +Check out the dropdowns below for instructions on setting up an internet connection through the corresponding interfaces:
 +
 +-->Ethernet#
 +
 +<WRAP group>
 +<WRAP column half>
 +**Plug** one end of the ethernet cable into the back of the Analog Discovery Pro and the other end into the router.
 +</WRAP>
 +<WRAP column half>
 +{{ reference:test-and-measurement:analog-discovery-pro-3x50:ethernet-connected.jpg?600 |}}
 +</WRAP>
 +</WRAP>
 +
 +<WRAP group>
 +<WRAP column half>
 +Run the ''ip addr show dev eth0'' command, which will print the network information of the ethernet interface. If successfully connected to the local network it should be assigned an IP address, Gateway, etc.
 +</WRAP>
 +<WRAP column half>
 +{{ reference:test-and-measurement:analog-discovery-pro-3x50:eth0-show-ip.png?600 |}}
 +</WRAP>
 +</WRAP>
 +
 +<--
 +
 +-->WiFi#
 +
 +<WRAP group>
 +<WRAP column half>
 +Enter superuser mode by **running** the command ''sudo su'', entering the user's password when asked. On success, the active user should change to 'root'.
 +</WRAP>
 +<WRAP column half>
 +{{ reference:test-and-measurement:analog-discovery-pro-3x50:wifi-sudo-saiyan.png?600 |}}
 +</WRAP>
 +</WRAP>
 +
 +<WRAP group>
 +<WRAP column half>
 +Plug the USB WiFi dongle into the bottom left USB port. 
 +</WRAP>
 +<WRAP column half>
 +{{ reference:test-and-measurement:analog-discovery-pro-3x50:wifi-usb-dongle.jpg?600 |}}
 +</WRAP>
 +</WRAP>
 +
 +<WRAP group>
 +<WRAP column half>
 +
 +In the terminal, run ''ip l'' to get a list of network interfaces. 
 +In this case, the WiFi interface is `wlx00c0caad6c4b`, the final network interface in the screenshot to the right. Notice that the MAC address is included in the name. Yours will differ.
 +</WRAP><WRAP column half>
 +{{ reference:test-and-measurement:analog-discovery-pro-3x50:wifi-ip-l.png?600 |}}
 +</WRAP></WRAP>
 +
 +<WRAP group><WRAP column half>
 +Create the WIF, WSSID, and WPWD environment variables to be used in the following commands. The WIF is the WiFi interface you found in the last step, while the WSSID and WPWD are the name and password of your WiFi network. This can be done as follows:
 +
 +<code>
 +WIF=your-interface
 +WSSID=your-ssid-here
 +WPWD=your-password-here
 +</code>
 +
 +**Note:** //If the SSID or WPWD has '!' as a special character, history substitution must first be disabled by running ''set +H'', and can be re-enabled by running ''set -H'' after completing this setup.//
 +</WRAP><WRAP column half>
 +{{ reference:test-and-measurement:analog-discovery-pro-3x50:wifi-set-env.png?600 |}}
 +</WRAP></WRAP>
 +
 +<WRAP group><WRAP column half>
 +For a connection that will persist after a system reboot, run the following:
 +<code bash>
 +wpa_passphrase "$WSSID" "$WPWD" > /etc/wpa_supplicant/wpa_supplicant-${WIF}.conf
 +systemctl enable wpa_supplicant@${WIF}.service
 +systemctl start wpa_supplicant@${WIF}.service
 +</code>
 +
 +Note that it may take some time for a WiFi connection to be established when rebooting the device, potentially several minutes.
 +</WRAP><WRAP column half>
 +{{ reference:test-and-measurement:analog-discovery-pro-3x50:wifi-start-wpa-service.png?600 |}}
 +</WRAP></WRAP>
 +
 +<WRAP group>
 +<WRAP column half>
 +For a connection that will only exist until a reboot, run the following:
 +<code bash>
 +wpa_supplicant -B -i $WIF -c <(wpa_passphrase "$WSSID" "$WPWD")
 +</code>
 +
 +Note that it may take some time for a WiFi connection to be established when rebooting the device, potentially several minutes.
 +</WRAP>
 +<WRAP column half>
 +{{ reference:test-and-measurement:analog-discovery-pro-3x50:wifi-start-temporary.png?600 |}}
 +</WRAP>
 +</WRAP>
 +<--
 +
 +----
 +===== Final Steps =====
 +
 +<WRAP group>
 +<WRAP column half>
 +Finally, verify the connection to the internet by running ''sudo apt install && sudo apt update -y''. These commands update the currently-installed software packages to the latest available versions and only succeeds if the Analog Discovery Pro has successfully connected to the internet.
 +</WRAP>
 +<WRAP column half>
 +{{ reference:test-and-measurement:analog-discovery-pro-3x50:successful-upgrade.png?600 |}}
 +</WRAP>
 +</WRAP>
 +
 +----
 +===== Other Resources =====
 +For an example of using the networking capabilities of the Analog Discovery Pro, check out [[test-and-measurement:analog-discovery-pro-3x50:linux-thingspeak-demo]].
 +
 +Check out the [[start|Analog Discovery Pro (ADP3450/ADP3250) Resource Center]] for more guides on using your device.
 +
 +For technical support, please visit the [[https://forum.digilentinc.com/forum/8-test-and-measurement/|Test and Measurement]] section of the Digilent Forums.
 +