Changes between Version 13 and Version 14 of Tutorials/g0WmLTE/Tutorial2

Timestamp:

Jul 3, 2012, 11:29:55 PM (12 years ago)

Author:

jeffrabi

Comment:

—

Tutorials/g0WmLTE/Tutorial2

@@ -16 +16 @@
 == About This Experiment ==
 
-This tutorial section is adapted from the tutorials at [http://witestlab.poly.edu/index.php/tutorials.html NYU-Polytech] and expanded from the more concise [http://wimax.orbit-lab.org/wiki/WiMAX/30/07#a18.GEC13:TutorialsfromPolyNYU ORBIT adaptations] done previously. As before, we will perform our experiment on Sandbox 4, providing some background information at each step. For more information, see the relevant documentation for each step at one of the source websites.
+This tutorial section is adapted from the tutorials at [http://witestlab.poly.edu/index.php/tutorials.html NYU-Polytech] and expanded from the more concise [http://wimax.orbit-lab.org/wiki/WiMAX/30/07#a18.GEC13:TutorialsfromPolyNYU ORBIT adaptations] done previously. As before, we will perform our experiment on Sandbox 4, providing some background information at each step. For more information, see the relevant documentation for each step at one of the source websites. '''This experiment uses OMF Version 5.3, also known as omf-5.3. This experiment very well may fail for other versions of OMF.'''
 
 ----
@@ -43 +43 @@
 ----
 
+== Dissecting the Experiment ==
+
+{{{
+defProperty('firstMCS',"http://wimaxrf:5052/wimaxrf/dlprofile?dlprof1=13","Set MCS to profile 13 - QPSK (CTC) 1/2 ")
+defProperty('secondMCS',"http://wimaxrf:5052/wimaxrf/dlprofile?dlprof1=16","Set MCS to profile 16 - 16-QAM (CTC) 1/2")
+defProperty('thirdMCS',"http://wimaxrf:5052/wimaxrf/dlprofile?dlprof1=21","Set MCS to profile 21 - 64-QAM (CTC) 5/6")
+defProperty('noMCS',"http://wimaxrf:5052/wimaxrf/dlprofiledlprof2=255&dlprof3=255dlprof4=255&dlprof5=255&dlprof6=255&
+            dlprof7=255&dlprof8=255&dlprof9=255&dlprof10=255&dlprof11=255&dlprof12=255","Set other MCS to none")
+}}}
+
+''defProperty'' is a method which appears in different scopes within OMF. In this global case, it creates methods of the ''property'' with the name of the first input (as a string), stores and releases the value of the second input, and takes the third input as a description. 
+
+ * As shown in the previous experiment, this URI accesses the base station and assigns it certain values.
+
+{{{
+defGroup('first_node', 'node1-1.sb4.orbit-lab.org')
+}}}
+
+''defGroup'' is a method which creates groups of resources (usually nodes), gives them a URI for later identification (first parameter), and identifies these resources by the second parameter (in OMF version 5.3, they are identified as above). The (optional) third parameter is a block argument. 
+ * We do not pass a block as an explicit parameter here, because it follows the method. 
+
+{{{
+defGroup('first_node', 'node1-1.sb4.orbit-lab.org') do |node|
+  node.net.x0.profile = '51'
+  node.addApplication("test:app:wimaxcu_app") do |app|
+    app.measure('status_link')
+  end
+  ...
+end
+}}}
+
+ * As those familiar with ''Ruby'' will note, this method receives additional instructions from a block. Here, ''node'' is a dummy variable referring to the group itself, although the exact behavior of ''Ruby'' blocks is outside the scope (pun intended) of this discussion.
+
+Here, ''net.x0.profile'' configures the WiMAX network profile default as 51. 
+
+''addApplication'' gives a group instructions to use the defined application in the specified manner. The principle parameter is the URI of the predefined application. 
+
+ * The ''wimaxcu_app'' application is actually already installed in the experiment image here, and "test:app:..." instructs OMF to search in the /test/app/ subdirectory of its primary directory of applications.
+
+ * ''app.measure('status_link')'' tells this application to use its predefined code to measure the 'status_link' property. OML will save these data for later. The exact behavior of this application is outside the scope of this discussion; suffice it to say that the implementation of the application is defined in the ''wimaxcu_app.rb'' and ''wmxstat'' programs mentioned previously.
+
+----
 == Launch Experiment ==