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

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

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