Changes between Version 14 and Version 15 of Tutorials/Wireless/Basic Usage

Timestamp:

Jan 7, 2020, 5:06:37 PM (5 years ago)

Author:

nilanjan

Comment:

—

Tutorials/Wireless/Basic Usage

@@ -192 +192 @@
 }}}
 
-=== Run the application ===
-Download the application source code from the attachment section below. 
+=== Configure and run the application ===
+Download the application source code from the attachment section below.
 {{{
 root@sdr-console> wget https://wiki.cosmos-lab.org/raw-attachment/wiki/tutorials/basic_usage/spectrum_view.tar.gz
 
 root@sdr-console> tar -zxvf spectrum_view.tar.gz
-
-}}}
-
-Please refer to the README file in SPECTRUM_VIEW directory for instructions on compiling and running the application. Before compiling the application, install and compile a few dependencies.
+root@sdr-console> cd SPECTRUM_VIEW
+}}}
+
+Please refer to the README file in SPECTRUM_VIEW directory for instructions on compiling and running the application. Before compiling install a few required libraries.
 {{{
 root@sdr-console> apt update
 root@sdr-console> apt-get -y install libboost-all-dev liblog4cxx-dev cmake libfftw3-dev libxml2-dev libpopt-dev libsqlite3-dev pkg-config libxml2-utils gnulib
-
-root@sdr-console> git clone https://github.com/zaphoyd/websocketpp.git
-root@sdr-console> pushd websocketpp
-root@sdr-console> cmake . -DBUILD_EXAMPLES=ON -DBUILD_TESTS=ON
-root@sdr-console> make -j 4
-root@sdr-console> make install
-root@sdr-console> popd
-}}}
-
-Now if all the dependencies installed successfully, compile application.
+}}}
+
+
+Now compile and make the websocket library.
+{{{
+root@sdr-console> make websocket
+}}}
+
+Lastly compile the application - this will generate the executable ''app_read_sdr_samples'' that reads samples from the SDR.
 {{{
 root@sdr-console> make
 }}}
 
-From within the ''SPECTRUM_VIEW'' directory make and run the application to read samples from the Krypton's radio. There are two channels inside the radio which are being read out but only the first channel is displayed. 
+
+Run the application - this will start a server that listens for commands to configure the radio and stream received spectrum samples.
 {{{
 root@sdr-console> ./app_read_sdr_samples
@@ -227 +227 @@
 }}}
 
-In short the application runs a server listening for commands. Just to briefly demonstrate some functionality, open the spectrum_view.html file in a Chrome browser. 
+
+=== Visualize spectrum samples  ===
+Download the spectrum visualizer web client to your desktop. It is all in another zip file - ''spectrum_view.zip''. Unzip this folder and open ''spectrum_view.html'' in a Chrome browser.
 
 When the viewer is first opened, the page display should be similar to the following
  || [[Image(basic_usage_spectrum_view_1.png, width=500px)]] ||
 
-Ensure the localhost field is set to ''localhost:5002'' and the device type field is set to ''type=x300''.
-
-Click the ''connect'' button once and a "WebSocket Connection" statement should be output by the application.
-Now click on ''make'' to create a device handle. Finally click on ''submit'' to adjust the radio parameters and the ''Go'' button to display a short spectrum bandwidth.
-
-Keep the default values for RATE, FREQ, GAIN and click on the HALTED button. This should display the spectrum if all went well.
+
+##Just to briefly demonstrate some functionality, open the spectrum_view.html file in a Chrome browser. 
+
+
+
+Ensure the localhost field is set to ''localhost:5002''. (Recall from the set up section to create a tunnel from localhost:5002 to sdr2-lg1.sb1.cosmos-lab.org:9002 since the ''app_read_sdr_samples'' application has a websock server listening on that host:port.)
+Ensure the device type field is set to ''type=x300''.
+
+
+Click the ''connect'' button once and a "Websocket Connection" statement should be output by the application.
+Now click on ''make'' to create a device handle.
+
+The RF radio parameters are already populated with default values for 2.4 GHz WIFI band. To view other active spectrum bands change the RATE, FREQ, GAIN fields to
+
+ || RF Parameter || value || description || 
+ || RATE || 50e6 || Sampling rate ||
+ || FREQ || 1925e6 || Center frequency ||
+ || GAIN || 30 || Receive gain ||
+Then click on ''Submit'' to update the SDR.
+
+Click on the ''Halted'' button to begin streaming samples from the radio to the browser. This should display the spectrum if all went well.
  || [[Image(basic_usage_spectrum_view_2.png, width=500px)]] ||