Changes between Version 2 and Version 3 of Tutorials/c0WiFi/Tutorial3

Timestamp:

Oct 8, 2014, 5:46:32 PM (10 years ago)

Author:

nilanjan

Comment:

—

Tutorials/c0WiFi/Tutorial3

@@ -13 +13 @@
      2  # Tutorial experiment
      3  #
-     4  defProperty('master', 'node15-1', "node ID for access point")
+     4  defProperty('accesspoint', 'node15-1', "node ID for access point")
      5  defProperty('client', 'node16-1,node17-1', "node ID for client nodes")
      6  defProperty('duration', 60, "Seconds to run the application.")
      7
-     8  defApplication('oml:app:iperf', 'iperf') do |app|
+     8  defApplication('iperf', 'iperf-oml2') do |app|
      9
     10    app.version(2, 10, 0)
@@ -159 +159 @@
    148
    149
-   150  defGroup('AP', property.master) do |node|
-   151    node.addApplication("oml:app:iperf") do |app|
+   150  defGroup('AP', property.accesspoint) do |node|
+   151    node.addApplication("iperf") do |app|
    152      app.setProperty('server', true)
    153    end
@@ -171 +171 @@
    160
    161  defGroup('client', property.client) do |node|
-   162    node.addApplication("oml:app:iperf") do |app|
+   162    node.addApplication("iperf") do |app|
    163      app.setProperty('client', "192.168.0.254")
    164      app.setProperty('time', 20)
@@ -201 +201 @@
 Here's brief run down with some details from top to bottom.
 
-In Lines 4-6 we use ''defProperty'' to define a few experiment properties along with default values which allows the script to be executed with arguments passed from the command line.
-
-From Lines 8 - 146 we use ''defApplication'' to define the application header for iperf. 
-
-
-
+* In Lines 4-6 we use ''defProperty'' to define a few experiment properties along with default values which allows the script to be executed with arguments passed from the command line.
+
+* From Lines 8 - 146 we use ''defApplication'' to define the application header for iperf.
+
+ Here we defined a reference name ''iperf'' that can be used later in the script.
+{{{
+defApplication('iperf', 'iperf-oml2') do |app|
+}}}
+
+ The actual path to the iperf application in the node is defined.
+{{{
+app.path = "/usr/bin/iperf-oml2"
+}}}
+
+ The numerous ''defProperty'' that follows defines a reference to the various arguments for the application. In the following definition the reference name ''interval'' is mapped to the application argument specified with the ''-i'' flag. The default value and the other properties can also be specified.
+{{{
+app.defProperty('interval', 'pause n seconds between periodic bandwidth reports', '-i',
+                  :type => :double, :unit => "seconds", :default => '1.')
+}}}
+
+* We define a reference name ''AP'' for the access point node using ''defGroup''
+{{{
+defGroup('AP', property.accespoint) do |node|
+  node.addApplication("iperf") do |app|
+    app.setProperty('server', true)
+  end
+  node.net.w0.mode = "master"
+  node.net.w0.type = 'g'
+  node.net.w0.channel = "6"
+  node.net.w0.essid = "TEST1234"
+  node.net.w0.ip = "192.168.0.254"
+end
+}}}
+ Several things are happening here:
+ 1. The group name ''AP'' references the node specified in ''property.master''. This group only consists of a single node.
+ 2. ''node.addApplication'' connect the previous defined ''iperf'' application to this node with the specified arguments and values using ''setProperty''
+ 3. The wireless card properties are set using with the ''node.net.w0'' parameters. Here we set ''node.net.w0.mode'' to ''master'' to configure the wireless card as an access point. Other relevant parameters are also set here as well.
+
+* Likewise we use ''defGroup'' again to define a reference name ''client'' for the client node(s).
+{{{
+defGroup('client', property.client) do |node|
+  node.addApplication("iperf") do |app|
+    app.setProperty('client', "192.168.0.254")
+    app.setProperty('time', 20)
+    app.setProperty('interval', 5)
+  end
+  node.net.w0.mode = "managed"
+  node.net.w0.type = 'g'
+  node.net.w0.channel = "6"
+  node.net.w0.essid = "TEST1234"
+  node.net.w0.ip = "192.168.0.%index%"
+end
+}}}