Changeset 8258

Timestamp:

09/02/08 17:38:04 (5 years ago)

Author:

mcarrick

Message:

added gnuradio installation portion required by usrp

Files:

• documentation/ossie/user-guide-0.7.0/Installation.tex (modified) (2 diffs)

documentation/ossie/user-guide-0.7.0/Installation.tex

@@ -105 +105 @@
 \end{lstlisting}
 
-
 Now move onto Section~\ref{section:installation:source:dependencies:configomni}
 
@@ -175 +174 @@
 
 At this time it is a good idea to restart your machine.
+
+\subsubsection{Installing Portions of GNU Radio}
+\label{section:installation:source:dependencies:ubuntu}
+OSSIE uses a small subset of GNU Radio to communicate and configure the USRP. The
+following steps will walkthrough installing portions of GNU Radio.
+
+First, GNU Radio's dependencies must be installed. Install the Engineering 
+and Scientific packages as well as the Software Development packages as root entering 
+the command:
+
+\begin{lstlisting}[]
+ # yum groupinstall "Engineering and Scientific" "Development Tools"
+\end{lstlisting}
+
+Additional utilities such as the FFT library and the CPP Test Framework must also be 
+installed. As root, enter the following command
+
+\begin{lstlisting}[]
+ # yum install fftw-devel cppunit-devel wxPython-devel libusb-devel  \
+   guile boost-devel alsa-lib-devel numpy
+\end{lstlisting}
+
+The Small Device C Compiler, SDCC, must be installed:
+
+\begin{lstlisting}[]
+ # yum install sdcc
+\end{lstlisting}
+
+The path for the SDCC must be set. Open the .bashrc file and add the path to the end 
+of the file. To open the file, enter the command:
+
+\begin{lstlisting}[]
+ $ vim ~/.bashrc
+\end{lstlisting}
+
+Add the following path to the end of the file:
+\begin{lstlisting}[]
+ export PATH=/usr/libexec/sdcc:$PATH
+\end{lstlisting}
+
+At this point, all of the GNU Radio dependencies have been installed. Now, the GNU Radio
+software must be installed.
+
+Download the GNU Radio source code by entering the command:
+\begin{lstlisting}[]
+ $ svn co http://gnuradio.org/svn/gnuradio/branches/releases/3.1 gnuradio
+\end{lstlisting}
+
+Move into the {\tt gnuradio} directory and start building the source code by entering the
+following commands:
+
+\begin{lstlisting}[]
+ $ cd gnuradio/
+ $ ./bootstrap
+ $ ./configure --disable-all-components --enable-gnuradio-core \
+   --enable-usrp --enable-gr-usrp --enable-omnithread
+\end{lstlisting}
+
+This sets up the install to only build resources for the USRP which OSSIE requires.
+Compile the source code by entering the command:
+
+\begin{lstlisting}[]
+ $ make
+\end{lstlisting}
+
+Verify that the compile worked by running a check:
+
+\begin{lstlisting}[]
+ $ make check
+\end{lstlisting}
+
+Install the portions of GNU Radio by running the following command as root:
+
+\begin{lstlisting}[]
+ # make install
+\end{lstlisting}  
+
+The libraries installed by GNU Radio need to be linked:
+
+\begin{lstlisting}[]
+ # /sbin/ldconfig
+\end{lstlisting}
+
+At this point, GNU Radio and its dependencies have been installed. Now setup the
+proper permissions for the USRP. As root, create a group which will have access
+to the USRP:
+
+\begin{lstlisting}[]
+ # /usr/sbin/groupadd usrp
+\end{lstlisting}
+
+Add users to the group which need access to the USRP:
+
+\begin{lstlisting}[]
+ # /usr/sbin/usermod -G usrp -a USERNAME
+\end{lstlisting}
+
+Now that users will have access to the USRP, read and write access to the device
+must be created. As root, open the file {\tt /etc/udev/rules.d/10-usrp.rules} in
+a text editor:
+
+\begin{lstlisting}[]
+ # vim /etc/udev/rules.d/10-usrp.rules
+\end{lstlisting}
+
+Add the following text to the file:
+
+\begin{lstlisting}[]
+ ACTION=="add", BUS=="usb", SYSFS{idVendor}=="fffe", \
+ SYSFS{idProduct}=="0002", GROUP:="usrp", MODE:="0660"
+\end{lstlisting}
+
+The text above is displayed on two lines due to the contraints on page size, however
+the text must appear on a single line, without the backslash, in the file for the
+access to the USRP to work properly. You may also add the following comment lines to
+the file for future reference:
+
+\begin{lstlisting}[]
+ # rule to grant read/write access on USRP to group named usrp.
+ # to use, install this file in /etc/udev/rules.d/ as
+ # 10-usrp.rules
+\end{lstlisting}
+
+The USRP interface has now been created. As an optional test, connect the USRP
+to the computer and run the following command:
+
+\begin{lstlisting}[]
+ $ ls -lR /dev/bus/usb
+\end{lstlisting}
+
+The users root and usrp should now be listed under the user groups.
 
 \subsubsection{Install OSSIE}