root/ossiedev/branches/hvolos/docs/OSSIETalkWithUSRP/OSSIETalkWithUSRP.tex @ 9481

\documentclass[10pt]{article}

\usepackage[pdftex]{graphicx}
\usepackage{listings}
\usepackage{color}
\usepackage[left=2cm,top=1cm,right=3cm,nohead,nofoot]{geometry}

\definecolor{darkgreen}{rgb}{0,0.5,0}
\definecolor{darkblue}{rgb}{0,0,0.5}

\lstloadlanguages{bash}
\lstset{%
        language=bash,
        basicstyle=\ttfamily,
        keywordstyle=\color{darkblue}\bfseries,
        morekeywords={chmod,cp,grep,man,mkdir,killall,ps,rm,su,sudo},
        morecomment=[l][\color{darkgreen}]{\#!},
        columns=fullflexible
}

\newcommand{\osfig}[2]%
{%
\begin{figure}[h!]
\label{fig:#1}
\centering
\includegraphics[width=300px]{#1.png}
\caption{#2}
\end{figure}
}

\newcommand{\osfigvs}[3]%
{%
\begin{figure}[h!]
\label{fig:#1}
\centering
\includegraphics[scale=#3]{#1.png}
\caption{#2}
\end{figure}
}

\newcommand{\osblock}%
{%
\begin{figure}[h!]
\label{fig:block}
\centering
\includegraphics[width=300px]{lab_6/figures/block.png}
\end{figure}
}


\newcommand{\osref}[1]%
{%
Figure~\ref{fig:#1}%
}

%opening
\title{OSSIE Lab \#:The OSSIETalk Waveform}
\author{Haris I. Volos, \textit{et al}\\
Virginia Tech, Blacksburg, VA\\
Developed using OSSIE 0.7.x\\
}
\date{July 2009}

\begin{document}

\maketitle

\section{Acknowledgments}
This work was supported in part by NSF award \#0520418, and would not be possible without
the contributions of numerous students on the OSSIE team and other OSSIE users and
developers.

\section{Objective}
The objective of this lab is to familiarize the user with the OSSIETalkUSRP waveform.

\section{Version}
This lab is for use with OSSIE version 0.7.x and the OSSIE Eclipse Feature (OEF), running on a
computer or VMware image that uses Fedora Core 7 or Ubuntu 8.04. The following components are required: OSSIETalk, PacketResizer, Conv\_Enc, DigitalModulator, FrameAssembler, amplifier, Interpolator, USRP\_Commander, amplifier, Decimator, AutomaticGainControl, FrameSynchronizer, DigitalDemodulator, and Conv\_Dec.

\section{Procedure}
\subsection{Procedure Overview}
\begin{enumerate}
 \item Using OEF, build the OSSIETalkUSRP waveform.
 \item Run nodeBooter
 \item Run the waveform 
\end{enumerate}

\subsection{Getting Started}
\subsection{Step 1}
\osfigvs{blockdiagram1}{Block Diagram}{0.6}

\subsection{Step 2}
\osfigvs{blockdiagram2}{Block Diagram}{0.6}

\subsection{Step 3}
\osfigvs{blockdiagram3}{Block Diagram}{0.6}

\subsection{Building the waveform}
\osfig{waveformOEF}{OEF Waveform Structure}
%\osfig{blockdiagram}{Block Diagram}

\begin{enumerate}
\item Start OEF
\item File $\rightarrow$ New $\rightarrow$ OSSIE Waveform
\item Project name: ``OSSIETalkUSRP''
\item Add the following components in the waveform panel:OSSIETalk, PacketResizer, Conv\_Enc, DigitalModulator, FrameAssembler, amplifier, Interpolator, USRP\_Commander, amplifier, Decimator, AutomaticGainControl, FrameSynchronizer, DigitalDemodulator, and Conv\_Dec
\item Add the default\_GPP\_USRP\_node to the platform panel
\item Expand the the node, and add all the components, one by one, the the GPP device.
\item Set the USRP\_Commander as the assemply controler
\item Make the following connections:
\begin{enumerate}
 \item OSSIETalk1.to\_radio $\rightarrow$ PacketResizer1.packet\_in
\item PacketResizer1.packet\_out  $\rightarrow$  Conv\_Enc1.bits\_to\_Enc
\item Conv\_Enc1.encoded\_bits $\rightarrow$ DigitalModulator1.bitsin
\item DigitalModulator1.symbolsOut $\rightarrow$ FrameAssembler1.SymbolsIn
\item FrameAssembler1.FrameSymbolsOut $\rightarrow$ amplifier1.datain
\item amplifer1.dataout $\rightarrow$ Interpolator1.inData
\item Interpolator1.outData  $\rightarrow$ USRP1.TX\_Data
\item USRP\_Commander1.TX\_Control  $\rightarrow$  USRP1.TX\_Control
\item USRP\_Commander1.RX\_Control  $\rightarrow$  USRP1.RX\_Control
\item amplifier2.dataIn  $\rightarrow$  USRP1.RX\_Data\_1
\item amplifier2.dataOut $\rightarrow$ Decimator1.inData
\item Decimator1.outData $\rightarrow$ AutomaticGainControl1.data\_in
\item AutomaticGainControl1.data\_out $\rightarrow$ FrameSynchronizer1.IF\_in
\item FrameSynchronizer1.symbols\_out $\rightarrow$ DigitalDemodulator1.SymbolsIn
\item DigitalDemodulator1.DataBitsOut $\rightarrow$ Conv\_Dec1.bits\_to\_dec\_in
\item Conv\_Dec1.decoded\_bits $\rightarrow$  OSSIETalk1.from\_radio
\end{enumerate}
\end{enumerate}
\subsubsection{Component Properties}
For each component set the listed properties.
\paragraph{PacketResizer1}
\begin{verbatim}
Packet Size=256
\end{verbatim} 

\paragraph{Conv\_Enc1 and Conv\_Dec1}
\begin{verbatim}
mode=1
rate_index=3
\end{verbatim} 

\paragraph{DigitalModulato1}
\begin{verbatim}
ModScheme=QPSK
\end{verbatim}

\paragraph{FrameAssembler1}
\begin{verbatim}
FrameSizeOption1=512
FrameSizeOption2=1584
FrameSizeOption3=3168
FrameSizeOption4=6336
mod_type=QPSK
FrameOptionNumber=3
\end{verbatim}

\paragraph{amplifier1}
\begin{verbatim}
I_gain=0.2
Q_gain=0.2
\end{verbatim}

\paragraph{Interpolator1}
\begin{verbatim}
beta=0.33
m=4
pulse_shape=rrcos
InterpFactor(k)=8
\end{verbatim}

\paragraph{USRP\_Commander1}
\begin{verbatim}
rx_start=1
tx_start=1
rx_gain=1
rx_size=2048
rx_decim=256
tx_interp=512
tx_freq=462.5625e6
rx_freq=462.5625e6
\end{verbatim}

\paragraph{amplifer2}
\begin{verbatim}
I_gain=1
Q_gain=-1
\end{verbatim}

\paragraph{Decimator1}
\begin{verbatim}
Filter Type=IIR
DecimateBy=4
\end{verbatim}

\paragraph{AutomaticGainControl1}
\begin{verbatim}
rssi_pass=1
g_max=2000
g_min=0.5
k_release=0.002
k_attack=0.01
energy_hi=10000
energy_lo=10000
\end{verbatim}

\paragraph{FrameSynchronizer1}
\begin{verbatim}
BufferSize=198
FrameSizeOption1=512
FrameSizeOption2=1584
FrameSizeOption3=3168
FrameSizeOption4=6336
Npfb=32
beta=0.33
m=4
k=2
pulse_shape=rrcos
\end{verbatim}

\paragraph{DigitalDemodulator1}
\begin{verbatim}
DemodScheme=QPSK
\end{verbatim}
\end{document}