Changes between Version 5 and Version 6 of Tutorials/Wireless/intro Tutorial

Timestamp:

Jul 20, 2022, 5:22:24 PM (2 years ago)

Author:

jennyshane

Comment:

—

Tutorials/Wireless/intro Tutorial

@@ -4 +4 @@
 
 === Description ===
-In this tutorial we'll demonstrate how to run a basic wireless experiment using software defined radios in the COSMOS testbed. Two COSMOS nodes will be used: one to transmit a signal, and the other to receive it.
+In this tutorial we'll demonstrate how to run a basic wireless experiment using software defined radios in the COSMOS testbed. Two COSMOS nodes will be used: one to transmit a signal, and the other to receive it. This tutorial will also give some information about the basic orbit workflow, so be sure to read to the end.
 
 === Prerequisites ===
@@ -21 +21 @@
  YOUR_USERNAME@console.sb1.cosmos-lab.org
  }}}
- 3. Use OMF commands to [GettingStarted#ControlResourceswithOMF load the baseline-uhd.sdr image] on your resources.
+ 3. Use OMF commands to load the baseline-uhd.sdr image on your resources. 
+
+ OMF is a command line utility is run from the console in order to manage nodes-- turn them on and off, save the contents of the hard disk as an "image", and load saved images back onto them.
+
+ In this case, we're loading the "baseline-uhd.ndz" image, which is a pre-built image provided for researchers to use as a starting point. The image contains UHD 3.15 and Gnuradio 3.8 and uses Ubuntu 18.04.
  {{{#!shell
- omf load -i baseline-uhd.ndz -t sdr2-s1-lg1,sdr2-md1
+ omf load -i baseline-sdr.ndz -t sdr2-s1-lg1,sdr2-md1
  }}}
  This is a good opportunity to look at the output of the image loading process. At first glance, it can look like a lot of text, but there is some useful information there to help you understand what is going on. Here is the output of running the above command:
  
  [[Image(image-save.png)]]
+ 
+ We can see from this output that the image loading process has two phases: the first, noted in red, in which OMF is waiting for the nodes to boot up and load a client which will receive the omf image data and write it to disk; and the second, noted in blue, in which OMF actually performs the imaging process. This output shows a successful imaging process-- we can tell because of the text noted in pink, which says that the imaging process is done and there were two nodes successfully imaged. The filename displayed there will contain a list of all the nodes which were successfully imaged.  
+
+ Once in a while, you may see an imaging process where some or all of the nodes fail to image. This can happen because something goes wrong either in the first step (a node fails to boot up and register with the imaging process) or in the second step (the node fails to load the image onto its hard disk). If there is a failure, it will be noted in the output at the end of the imaging process-- there will be additional files listed for nodes that fail to check in, and nodes in which imaging failed. 
+
+ Always check the output to make sure that your nodes were successfully imaged.
+
  1. Once the nodes are successfully imaged, turn them on and check the status
  {{{#!shell