View source for Troubleshooting X300/X310 Device Discovery Issues

==Application Note Number==
'''AN-620 '''

==Revision History==
{| class="wikitable"
!Date
!Author
!Details
|-
|style="text-align:center;"| 2019-06-14   
|style="text-align:center;"| Sam Reiter
|style="text-align:center;"| Initial creation
|}

==Introduction==
There are two methods of connecting a USRP X3xx device to a host PC (Ethernet and PCIe), both of which are covered in this guide. We will be using a Linux machine (Ubuntu 18.04) for the following steps, but the troubleshooting steps can be generalized across other operating systems. It is also assumed that UHD has been installed on the host machine. See [https://kb.ettus.com/Building_and_Installing_the_USRP_Open-Source_Toolchain_(UHD_and_GNU_Radio)_on_Linux here] for guidance on building and installing UHD from source.


==Ethernet Connection==
The X310 has a pair of SFP+ ports located on the rear panel of the device near the power input. These interfaces are labeled 0 and 1:

<center>
<div><ul>
<li style="display: inline-block;"> [[File:X310_RedBox_Ethernet.jpg|thumb|800px|center|Figure 1: X310 Rear Panel with SFP+ ports emphasized.]] </li>
</ul></div>
</center>


It is possible to connect to the X310 over 1 Gigabit Ethernet via an SFP+ to RJ45 adapter or a 10 Gigabit Ethernet capable SFP+ cable. Whether or not your X3xx device is capable of using 1GbE is dependent on the FPGA image being used. With the HG image port 0 is 1GbE and port 1 is 10GbE. Using the XG image enabled dual 10GbE links (ports 0 and 1). See the [https://files.ettus.com/manual/page_usrp_x3x0.html#x3x0_getting_started_fpga_update UHD Manual] for instructions regarding updating the FPGA image of your device. 

===1 Gigabit Ethernet (1GbE)===

This protocol is supported only on X3xx SFP+ port 0 when using the HG FPGA image. If both of these conditions are met, you will see the green LINK LED illuminate when a working SFP+ adapter is inserted into the powered-on X310. On X3xx devices, this LED should light up regardless of successful connection to host when a working SFP+ adapter is inserted.

<center>
<div><ul>
<li style="display: inline-block;"> [[File:X310_LINK_LED.jpg|thumb|200px|center|Figure 2: X310 SFP+ ports with link and data LEDs.]] </li>
</ul></div>
</center>

<OL>
<LI> <u>Issue: Ethernet LINK LED (Port 0) does not illuminate</u>
<UL>
<LI> Ensure your USRP is powered on.
<LI> If the green LINK LED does not illuminate in port 0, you should try a different (known working) SFP+ adapter.  
<LI> If a known good SFP+ adapter does not elicit a green LINK LED, you should attempt recovery using the HG image. See [[X300/X310 Device Recovery]].  
<LI> If this device recovery doesn't complete successfully or recovery doesn't bring back the link LED, contact Ettus Support.
</UL>
</OL>

With the HG FPGA image and a good SFP+ adapter confirmed, the device can be connected to a host PC directly from the computer's RJ45 ethernet port. The host machine should be able to ping the radio using a "ping <X310 Port0 IP address>" command.

<OL START="2">
<LI> <u>Issue: Host PC is unable to ping the USRP</u>
<UL>
<LI> Ensure your USRP is powered on. Ensure your host network settings are correct. See [https://files.ettus.com/manual/page_usrp_x3x0.html#x3x0_setup_network_host_interface USRP Manual: Setup the host interface]. Note that many systems require a user to unplug / replug the ethernet interface for configuration changes to take effect.  
<LI> Ensure host is connected directly to the X310. Eliminate all routers and switches in between USRP and host machine. (Note: some communication issues with KTE have been observed requiring a network switch between Host and USRP - adding an intermediate switch is worth exploring in the event all steps in this list fail.)
<LI> Use uhd_find_devices to discover the IP of USRP devices on the same subnet as the host. If discovered, ping the IP address returned by uhd_find_devices. 
<LI> Use an interface probe utility (such as [https://www.wireshark.org/ Wireshark]) to "sniff" the ethernet port being used. The X310 should emit a gratuitous ARP request every 15 seconds. When this request reveals the X310’s IP, you can adjust your host IP and subnet configuration and ping the radio.
<LI> Replace your RJ45 cable and repeat steps the above steps for this issue.
<LI> If you are still unable to ping your X310, contact Ettus support.
</UL>
</OL>

If you're able to ping the device, then you have successfully connected to it. At this point, it is recommended to run uhd_usrp_probe to pull device information. If your FPGA image is not consistent with your version of UHD on the host side, you may get errors or warnings regarding FPGA version numbers. See the [https://files.ettus.com/manual/page_usrp_x3x0.html#x3x0_getting_started_fpga_update USRP Manual: Updating the FPGA section].

===10 Gigabit Ethernet (10GbE)===

This protocol is supported on USRP Ethernet port 1 when using the HG FPGA image. When using the XG image, 10 Gigabit Ethernet is supported on ports 0 and 1. Unlike the SFP+ adapter's behavior the section “1 Gigabit Ethernet” section above, you should only expect to see the LINK LED turn green for a 10 Gigabit port upon successful connection to a host machine.

<OL>
<LI> <u>Issue: Ethernet LINK LEDs do not illuminate when connected to host machine</u>
<UL>
<LI> Ensure your USRP is powered on.
<LI> Ensure the SFP+ cable is plugged into port 1 of the USRP. This is a 10 Gig interface on both the HG and XG images.
<LI> If your host machine is using a PCIe adapter for SFP+ interfaces, ensure it was enumerated correctly by your operating system. You may need to reinstall drivers or try a different PCIe port.  
<LI> Check that the SFP+ interface on your host machine is configured to support a 10 Gigabit link. If your NIC supports dual 10 GbE links, you can put it in loopback with your SFP+ cable and confirm that both ports recognize a 10GbE connection:

<center>
<div><ul>
<li style="display: inline-block;"> [[File:Ethernet_toggle.png|thumb|600px|center|Figure 3: Ubuntu 18.04 Network Manager with 2 10GbE interfaces in loopback]] </li>
</ul></div>
</center>

<LI> Swap your cable for a different (known good SFP+ to SFP+ cable).  
<LI> If a known good SFP+ cable connected to a known working SFP+ port does not elicit a green LINK LED, you should attempt device recovery with the XG image. See [[X300/X310 Device Recovery]]. With the XG image, try the above steps on Port 0 of your X310. 
<LI> If this device recovery doesn't complete successfully or recovery doesn't bring back the link LED, contact Ettus Support.
</UL>
</OL>

Once the device has a successful 10GbE connection to the host, the host machine should be able to ping the radio using a "ping <X310 Port IP address>" command.

<OL START="2">
<LI> <u>Issue: Host PC is unable to ping the USRP</u>
<UL>
<LI> Ensure your USRP is powered on
<LI> Double check that you're pinging the correct IP address. Each port will have a unique IP depending on whether you're using the HG or XG image. Note that the values in the figure shown below may have been changed from their default IP settings:


<center>
<div><ul>
<li style="display: inline-block;"> [[File:IP_Addresses.png|thumb|700px|center|Figure 4: Default USRP network configuration reported by uhd_usrp_probe]] </li>
</ul></div>
</center>


<LI> Ensure your host network settings are correct. See [https://files.ettus.com/manual/page_usrp_x3x0.html#x3x0_setup_network_host_interface USRP Manual: Setup the host interface]. Note that many systems require a user to unplug / replug the ethernet interface for configuration changes to take effect.  
<LI> Ensure host is connected directly to the USRP. Eliminate all routers and switches in between USRP and host machine.
<LI> Use uhd_find_devices to discover the IP of USRP devices on the same subnet as the host. If discovered, ping the IP address returned by uhd_find_devices.
<LI> Use an interface probe utility (such as [https://www.wireshark.org/ Wireshark]) to "sniff" the ethernet port being used. The X310 should emit a gratuitous ARP request every 15 seconds. When this request reveals the X310’s IP, you can adjust your host IP and subnet configuration and ping the radio.
<LI> Replace your SFP+ cable and repeat the above steps of this section.
<LI> If you are still unable to ping your device, contact Ettus Support.
</UL>
</OL>

If you're able to ping the device, then you have successfully connected to it. At this point, it is recommended to run uhd_usrp_probe to pull device information. If your FPGA image is not consistent with your version of UHD on the host side, you may get errors or warnings regarding FPGA version numbers. See the [https://files.ettus.com/manual/page_usrp_x3x0.html#x3x0_getting_started_fpga_update USRP Manual: Updating the FPGA section].

==PCIe Connection==
The X310 has a  PCIe x4 located on the rear panel of the device near the power input. This interface is labeled PCIe x4 (also referred to as a MXI connection when used with a PXI system)

<center>
<div><ul>
<li style="display: inline-block;"> [[File:X310_RedBox_PCIe.jpg|thumb|800px|center|Figure 5: X310 Rear Panel with PCIe port emphasized.]] </li>
</ul></div>
</center>

It is possible to connect an X310 directly to a PC using an appropriate PCIe x4 link cable. It is necessary to install the [https://files.ettus.com/manual/page_ni_rio_kernel.html NI RIO Kernel Modules] to use this protocol on a system using UHD. On a Windows system using the [http://www.ni.com/en-us/support/downloads/drivers/download.ni-usrp.html NI-USRP driver], the NI-USRP installation will eliminate the need to install NI-RIO Kernel Modules. The first step in establishing connectivity is starting the NI RIO Kernel Module drivers on your machine with: 

    sudo /usr/local/bin/niusrprio_pcie start

<OL>
<LI> <u>Issue: Unable to start the NI RIO Kernel Modules on my machine</u>
<UL>
<LI> Make sure you're not omitting the "sudo" part of the command. Root permissions are required.
<LI> Uninstall and reinstall the Kernel Modules on your machine using this section in the [https://files.ettus.com/manual/page_ni_rio_kernel.html UHD Manual: NI RIO Kernel Modules for X-Series PCIe Connectivity]
<UL>
<LI> If this module fails to build, it's often a permissions issue. Disabling SecureBoot has helped in certain cases.
<LI> As of the writing of this post, the kernel modules are supported up to Ubuntu 18.04 LTS
</UL>
<LI> Drivers may auto-update. A computer restart is encouraged in these cases.
<LI> If you are still experiencing difficulty starting the driver, contact Ettus Support.
</UL>
</OL>

With the driver started, you can confirm it is running with:

    sudo /usr/local/bin/niusrprio_pcie status

If the driver is running, you should now be able to discover your X310/X300 with "uhd_find_devices". 

<OL START="2">
<LI> <u>Issue: The uhd_find_devices call returns "No USRP Devices Found"</u>
<UL>
<LI> Ensure your USRP is powered on.
<LI> Because this is a PCIe connection, the USRP must be powered on <u>before</u> the PC is booted. With your USRP on, reboot your PC and try the uhd_find_devices command again.
<LI> Check that the LED on the PCIe card (connected to the PC motherboard) is illuminated green.
<UL>
<LI> If the LED is off, power the system off and move the card to a different PCIe slot. Ensure boot order is correct.
<LI> If LED is orange, power cycle the system ensuring the cable is securely connected on both ends. If this fails, try a different cable.
<LI> If LED color issues persist, try using a different PC to confirm the PCIe card is functional. Cross check with the [http://www.ni.com/pdf/manuals/377431a.pdf#page=12 PCIe card's manual].
</UL>
<LI> If you are still experiencing difficulty discovering the USRP, contact Ettus Support.
</UL>
</OL>

If you're able to find the device with uhd_find_devices, then you have successfully connected to it via PCIe. At this point, it is recommended to run uhd_usrp_probe to pull device information. If your FPGA image is not consistent with your version of UHD on the host side, you may get errors or warnings regarding FPGA version numbers. See the [https://files.ettus.com/manual/page_usrp_x3x0.html#x3x0_getting_started_fpga_update USRP Manual: Updating the FPGA section].

==Additional Resources==
<UL>
<LI> [https://files.ettus.com/manual/page_usrp_x3x0.html USRP Hardware Driver and USRP Manual: USRP X3x0 Series]
<LI> [https://kb.ettus.com/X300/X310 Ettus Knowledge Base: X300/X310]
<LI> [https://kb.ettus.com/Verifying_the_Operation_of_the_USRP_Using_UHD_and_GNU_Radio Verifying the Operation of the USRP Using UHD and GNU Radio]
</UL>


[[Category:Application Notes]]