Changes between Version 1 and Version 2 of 802.11/wlan_exp/bss

Timestamp:

Mar 28, 2016, 11:02:38 AM (8 years ago)

Author:

welsh

Comment:

--

802.11/wlan_exp/bss

@@ -13 +13 @@
 || channel || Primary channel ||
 || channel_type || Channel Type ||
+|| ssid || SSID (32 chars max) ||
 || latest_beacon_rx_time || Value of System Time in microseconds of last beacon Rx ||
-|| ssid || SSID (32 chars max) ||
 || latest_beacon_rx_power || Last observed Rx Power (dBm) ||
 || flags || BSS flags ||
@@ -23 +23 @@
 === Python ===
 
-The 802.11 Reference Design Experiments Framework provides methods to interact with BSS information.  In addition to the fields above, the BSS information structures in Python also contain a {{{timestamp}}} field which is the value of the MAC time in microseconds when the structure was created.  The following methods are used to interact with BSS information:
+The 802.11 Reference Design Experiments Framework provides methods to interact with BSS information.  In addition to the fields above, the BSS information structures in Python also contain a {{{timestamp}}} field which is the value of the MAC time in microseconds when the structure was requested from the node.  The following methods are used to interact with BSS information:
 
   * [http://warpproject.org/docs/mango-wlan-exp-dev/node.html#wlan_exp.node.WlanExpNode.get_bss_info get_bss_info()]
@@ -51 +51 @@
 '''Arguments:'''
 
- * {{{bssid}}}: depends on node type; {{{None}}} means wipe BSS state; {{{False}}} means no change
+ * {{{bssid}}}: depends on node type; {{{None}}} means to remove all BSS state; {{{False}}} means no change
   * '''AP''': must be node's wireless MAC address
   * '''STA''': must be BSSID of BSS with which to associate
@@ -84 +84 @@
 === Example: Configuring BSS ===
 
-
 {{{#!python
 # Setup a new network with 1 AP, 1 STA
-#     - Assumes that both nodes started with no default BSS (i.e. 
+#     - Assumes that both nodes started with no default BSS 
 >>> n_ap.configure_bss(ssid='My Network', beacon_interval=100, channel=6, ht_capable=True)
 >>> n_ap.get_bss_info()
@@ -96 +95 @@
 
 >>> n_ap.add_association(n_sta)
-
 >>> n_sta.get_bss_info()
 {'bssid': AP_WLAN_MAC_ADDR, 'ssid': 'My Network', 'beacon_interval': 100, 'channel': 6, 'ht_capable': True, ...}
+}}}
 
+=== Example:  Changing Channel ===
+
+{{{#!python
+# Re-tune both nodes by adjusting the BSS channel
+#     - Assumes both AP and STA are already part of a BSS
+>>> for n in [n_ap, n_sta]:
+...     n.configure_bss(channel=7)
+}}}
+
+=== Example:  Adjusting Beacon Interval ===
+
+{{{#!python
 # Update the beacon interval
+#     - Assumes both AP and STA are part of a BSS
 >>> n_ap.configure_bss(beacon_interval=250)
 >>> n_ap.get_bss_info()
@@ -114 +126 @@
 {'bssid': AP_WLAN_MAC_ADDR, 'ssid': 'My Network', 'beacon_interval': 250, 'channel': 6, 'ht_capable': True, ...}
 
-# Retune both nodes by adjusting the BSS channel
-for n in [n_ap, n_sta]:
-    n.configure_bss(channel=7)
-
 # Disable AP beacon Tx
 >>> n_ap.configure_bss(beacon_interval=None)
+
+# When beacons are disabled, the STA will not receive any new information to update 
+# beacon interval.  Therefore, it will retain its previous value.
+>>> n_sta.get_bss_info()
+{'bssid': AP_WLAN_MAC_ADDR, 'ssid': 'My Network', 'beacon_interval': 250, 'channel': 6, 'ht_capable': True, ...}
 }}}
 
-=== Example:  Changing Channel ===
-
-
+=== Example: Configuring IBSS ===
 
 {{{#!python
-# No command arguments, no response payload
-my_node.send_user_command(CMDID_USER_MYCMD, args=None)
+# Setup an IBSS network for all IBSS nodes
+bssid = util.create_locally_administered_bssid(node1.wlan_mac_address)
+
+>>> for n in ibss_nodes:
+...    n.configure_bss(bssid=bssid, ssid='WARP-IBSS', beacon_interval=100, channel=6)
+
+# Change the IBSS network beacon interval
+>>> for n in ibss_nodes:
+...    n.configure_bss(beacon_interval=250)
+
+# Disable beacon Tx by all but the first node
+>>> for n in ibss_nodes[1:]:
+...    n.configure_bss(beacon_interval=None)
 }}}
 
-
-=== Example:  Adjusting Beacon Interval ===
+=== Example:  Reset ===
 
 {{{#!python
-# No command arguments, no response payload
-my_node.send_user_command(CMDID_USER_MYCMD, args=None)
+>>> n_ap.configure_bss(ssid='My Network', beacon_interval=100, channel=6, ht_capable=True)
+>>> n_ap.add_association(n_sta1)
+>>> n_ap.add_association(n_sta2)
+
+# Clear STA1 station info and BSS
+#     - Will send OTA disassociate packet to AP
+>>> n_sta1.get_bss_info()
+{'bssid': AP_WLAN_MAC_ADDR, 'ssid': 'My Network', 'beacon_interval': 100, 'channel': 6, 'ht_capable': True, ...}
+
+>>> n_sta1.reset(bss=True)
+>>> n_sta1.get_bss_info()
+None
+
+>>> n_ap.get_station_info()
+[{'mac_addr': STA2_MAC_ADDR, 'AID': 2, ...}]
 }}}
-
 
 === Example:  Scanning for Networks ===
 
 {{{#!python
-# No command arguments, no response payload
-my_node.send_user_command(CMDID_USER_MYCMD, args=None)
- args=[ARG0 ARG1])
+# To perform a scan using the current scan parameters, get the 
+# resulting network list and restore the current BSS:
+
+my_bss = n.get_bss_info()             # Get current BSS info
+n.configure_bss(None)                 # Set BSS info to None
+n.start_network_scan()               # Start network scan
+time.sleep(5)                         # Wait for node to scan
+n.stop_network_scan()                # Stop network scan
+networks = n.get_network_list()       # Get networks seen in scan
+                
+# Restore BSS
+n.configure_bss(bssid=my_bss['bssid'], ssid=my_bss['ssid'], channel=my_bss['channel'], 
+                beacon_interval=my_bss['beacon_interval'], ht_capable=my_bss['ht_capable'])
 }}}
 
-
-