USRP N2x0 and X3x0 installation notes (Gigabit Ethernet) » History » Version 5

ROQUE, Damien, 01/21/2015 03:41 PM

1 1 ROQUE, Damien
h1. USRP X310 installation notes
2 1 ROQUE, Damien
3 4 ROQUE, Damien
This documentation explains how to install an USRP device operated through Gigabit Ethernet interface (e.g. X300 and X310). In the following, we assume that a Debian based operating system has been successfully installed along with UHD and GNURadio (see for example [[Debian Wheezy 7 installation guidelines]] and [[UHD and GNURadio installation]]).
4 1 ROQUE, Damien
5 4 ROQUE, Damien
6 4 ROQUE, Damien
h2. Network interface configuration
7 4 ROQUE, Damien
8 4 ROQUE, Damien
Let us assume that a Gigabit Ethernet interface (denoted @eth1@) will be dedicated for the link between the computer and the USRP device. They will be both addressed statically on a @/24@ subnet:
9 4 ROQUE, Damien
* computer host: 192.168.10.1 ;
10 4 ROQUE, Damien
* USRP device: 192.168.10.2.
11 4 ROQUE, Damien
12 4 ROQUE, Damien
In order to obtain set this configuration, is it recommended to override the Network Manager program. The configuration is directly performed in @/etc/network/interfaces@ using the following instructions.
13 4 ROQUE, Damien
14 4 ROQUE, Damien
<pre>
15 4 ROQUE, Damien
auto eth1
16 4 ROQUE, Damien
iface eth1 inet static
17 1 ROQUE, Damien
        address 192.168.10.1
18 1 ROQUE, Damien
        netmask 255.255.255.0
19 4 ROQUE, Damien
</pre>
20 1 ROQUE, Damien
21 4 ROQUE, Damien
In order to improve transfers efficiency, it is also recommended to increase the maximum socket buffer size in @/etc/sysctl.conf@.
22 1 ROQUE, Damien
23 4 ROQUE, Damien
<pre>
24 4 ROQUE, Damien
net.core.rmem_max=33554432
25 4 ROQUE, Damien
net.core.wmem_max=33554432
26 4 ROQUE, Damien
</pre>
27 1 ROQUE, Damien
28 4 ROQUE, Damien
At this step the system should be rebooted in order to configure both the network interface and the maximum socket buffer size.
29 4 ROQUE, Damien
30 4 ROQUE, Damien
h2. Hardware detection and firmware update
31 4 ROQUE, Damien
32 4 ROQUE, Damien
33 4 ROQUE, Damien
Power/connect the USRP device and try to detect it.
34 4 ROQUE, Damien
<pre>
35 4 ROQUE, Damien
uhd_find_devices
36 4 ROQUE, Damien
</pre>
37 4 ROQUE, Damien
Then, inspect the hardware configuration of the transceiver.
38 4 ROQUE, Damien
<pre>
39 1 ROQUE, Damien
uhd_usrp_probe
40 4 ROQUE, Damien
</pre>
41 1 ROQUE, Damien
42 4 ROQUE, Damien
Optionnally, update the firmware of the USRP device.
43 4 ROQUE, Damien
<pre>
44 1 ROQUE, Damien
/usr/local/lib/uhd/utils/usrp_x3xx_fpga_burner --addr=192.168.10.2
45 4 ROQUE, Damien
</pre>
46 2 ROQUE, Damien
47 2 ROQUE, Damien
48 4 ROQUE, Damien
h2. Performances assessment
49 1 ROQUE, Damien
50 4 ROQUE, Damien
You can perform a rate benchmarking.
51 4 ROQUE, Damien
<pre>
52 4 ROQUE, Damien
/usr/local/lib/uhd/examples/benchmark_rate --duration 20 --rx_rate <wanted-rate>     # Reception test
53 4 ROQUE, Damien
/usr/local/lib/uhd/examples/benchmark_rate --duration 20 --rtx_rate <wanted-rate>    # Transmission test
54 4 ROQUE, Damien
</pre>
55 4 ROQUE, Damien
where @<wanted-rate>@ should be less than 50 MS/s for Gigabit Ethernet.
56 1 ROQUE, Damien
57 4 ROQUE, Damien
If @OOOOOO...@ or @UUUUUUU...@ appears on the standard output, it means that incoming samples (from the computer to the USRP) are dropped or outgoing samples (from the USRP to the computer) are not provided at expected rate. This defect can result from various causes: lack of CPU-time of the computer, overloaded interface... See "this page": for detailed explanation.