1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
|
/*! \page page_ni_rio_kernel NI RIO Kernel Modules for X-Series PCIe Connectivity
\tableofcontents
\section linux_rio Linux NI RIO Installation and Usage
\subsection linux_requirements Requirements
In order to use the PCIe transport connection on the USRP X300 / X310 devices,
you must install the NI USRP RIO driver stack. These include kernel modules
which must be loaded.
Your kernel version must be supported by the kernel modules. Only 64-bit kernels
are supported.
<b>Currently, the latest supported kernel version is 4.2.x.</b>
\subsection linux_installation Installing the Drivers in Linux
The NI USRP RIO installer can be found <a
href=http://files.ettus.com/binaries/niusrprio/niusrprio-installer-18.0.0.tar.gz>here</a>.
Download the installer and extract it with the following command:
tar zxf niusrprio-installer-18.0.0.tar.gz
The files will be extracted into a directory called <b>niusrprio-installer</b>.
To install the NI USRPRIO kernel modules and RPC server, run the following
command:
sudo niusrprio-installer/INSTALL
Select 'y' for each prompt, and the script will install all necessary
components. This script will automatically load all necessary kernel modules
for the duration of the session.
\subsection linux_enabling Enabling and Disabling Usage
Once everything is installed, run the following commands to enable use of the
X300/X310 over PCI Express:
sudo /usr/local/bin/niusrprio_pcie start
To stop these processes, run the following command:
sudo /usr/local/bin/niusrprio_pcie stop
To check if the kernel modules are loaded and if the RPC server is running, run
the following command:
/usr/local/bin/niusrprio_pcie status
<b>NOTE:</b> niusrprio_pcie start does not run when the host system is booted.
If you would like the USRP PCIe device to be available automatically after
a system restart, please create an init.d script that runs niusrprio_pcie start.
\subsection linux_swapping Hot-Plugging and Power-Cycling
The USRP X3x0, NI USRP-294x and NI USRP-295x devices <b>cannot</b> be hot-swapped when connected over PCI Express.
Unplugging the PCI Express connection or powering the device should be done only after disabling the device or
powering off the host computer.
<b>WARNING:</b> If the device is unplugged without running the `niusrprio_pcie stop` command, the system could become unstable.
\subsection linux_upgrades Upgrading Kernels
The NI USRPRIO kernel modules are built for a specific kernel version. If the
kernel version is changed, the modules must be rebuilt for the current kernel.
The `niusrprio_pcie start` command checks for the necessary modules and rebuilds
them if necessary.
If it ever becomes necessary to rebuild the modules manually, run the following:
sudo /usr/local/bin/niusrprio_pcie stop
sudo /usr/local/bin/updateNIDrivers --no-prompt
sudo /usr/local/bin/niusrprio_pcie start
\subsection linux_uninstalling Uninstalling in Linux
To uninstall the NI USRP RIO kernel modules and RPC server, run the following
command:
sudo /usr/local/bin/niusrprio_uninstall
Select y at the prompt, and the script will uninstall all installed components.
\section windows_rio Windows NI RIO Installation and Usage
\subsection win_requirements Requirements
The latest NI-USRP installer can be found by visiting
<a href=http://ni.com/info>ni.com/info</a> and entering the Info Code
`USRPDRIVER`. System requirements can be found on the resulting
web page.
\subsection win_install Installing NI-USRP in Windows
The latest NI-USRP installer can be found by visiting
<a href=http://ni.com/info>ni.com/info</a> and entering the Info Code
`USRPDRIVER`. You will need to create a free NI User Account to download
the installer. Follow the installation instructions on the web page to
download and install the driver.
\subsection win_enabling Enabling and Disabling Usage
Once everything is installed and the system is rebooted, the X300/X310 PCI
Express device should automatically be detected by the Windows Device Manager.
The device should be enabled by default.
- To disable the USRPRIO device, navigate to "Device Manager", locate the USRPRIO-X3x0 device, right-click on it and choose "Disable"
- To enable the USRPRIO device, navigate to "Device Manager", locate the USRPRIO-X3x0 device, right-click on it and choose "Enable".
\subsection win_swapping Hot-plugging and Power-cycling
The USRP X3x0, NI USRP-294x and NI USRP-295x devices <b>cannot</b> be hot-swapped when connected over PCI Express.
Unplugging the PCI Express connection or powering the device should be done only after disabling the device or
powering off the host computer.
<b>WARNING:</b> If the device is unplugged without disabling it in device manager, the system could become unstable.
\subsection win_uninstall Uninstalling NI-USRP in Windows
Navigate to the Control Panel and open "Programs". Then select National
Instruments Software and select NI-USRP and NI-RIO from the list. Click on
uninstall to remove the drivers from your system.
*/
// vim:ft=doxygen:
|
