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

ROQUE, Damien, 01/26/2015 04:58 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
h2. Network interface configuration
6 4 ROQUE, Damien
7 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:
8 4 ROQUE, Damien
* computer host: 192.168.10.1 ;
9 4 ROQUE, Damien
* USRP device: 192.168.10.2.
10 4 ROQUE, Damien
11 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.
12 4 ROQUE, Damien
13 4 ROQUE, Damien
<pre>
14 4 ROQUE, Damien
auto eth1
15 4 ROQUE, Damien
iface eth1 inet static
16 1 ROQUE, Damien
        address 192.168.10.1
17 1 ROQUE, Damien
        netmask 255.255.255.0
18 4 ROQUE, Damien
</pre>
19 1 ROQUE, Damien
20 4 ROQUE, Damien
In order to improve transfers efficiency, it is also recommended to increase the maximum socket buffer size in @/etc/sysctl.conf@.
21 1 ROQUE, Damien
22 4 ROQUE, Damien
<pre>
23 4 ROQUE, Damien
net.core.rmem_max=33554432
24 4 ROQUE, Damien
net.core.wmem_max=33554432
25 4 ROQUE, Damien
</pre>
26 1 ROQUE, Damien
27 6 ROQUE, Damien
At this step the following services should be rebooted in order to configure both the network interface and the maximum socket buffer size.
28 6 ROQUE, Damien
<pre>
29 6 ROQUE, Damien
/etc/init.d/networking stop
30 6 ROQUE, Damien
/etc/init.d/networking start
31 6 ROQUE, Damien
sysctl -p /etc/sysctl.conf
32 6 ROQUE, Damien
</pre>
33 4 ROQUE, Damien
34 4 ROQUE, Damien
h2. Hardware detection and firmware update
35 4 ROQUE, Damien
36 4 ROQUE, Damien
37 4 ROQUE, Damien
Power/connect the USRP device and try to detect it.
38 4 ROQUE, Damien
<pre>
39 4 ROQUE, Damien
uhd_find_devices
40 4 ROQUE, Damien
</pre>
41 4 ROQUE, Damien
Then, inspect the hardware configuration of the transceiver.
42 4 ROQUE, Damien
<pre>
43 1 ROQUE, Damien
uhd_usrp_probe
44 4 ROQUE, Damien
</pre>
45 1 ROQUE, Damien
46 4 ROQUE, Damien
Optionnally, update the firmware of the USRP device.
47 4 ROQUE, Damien
<pre>
48 1 ROQUE, Damien
/usr/local/lib/uhd/utils/usrp_x3xx_fpga_burner --addr=192.168.10.2
49 4 ROQUE, Damien
</pre>
50 2 ROQUE, Damien
51 2 ROQUE, Damien
52 4 ROQUE, Damien
h2. Performances assessment
53 1 ROQUE, Damien
54 4 ROQUE, Damien
You can perform a rate benchmarking.
55 4 ROQUE, Damien
<pre>
56 4 ROQUE, Damien
/usr/local/lib/uhd/examples/benchmark_rate --duration 20 --rx_rate <wanted-rate>     # Reception test
57 4 ROQUE, Damien
/usr/local/lib/uhd/examples/benchmark_rate --duration 20 --rtx_rate <wanted-rate>    # Transmission test
58 4 ROQUE, Damien
</pre>
59 4 ROQUE, Damien
where @<wanted-rate>@ should be less than 50 MS/s for Gigabit Ethernet.
60 1 ROQUE, Damien
61 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.