Changes between Version 4 and Version 5 of 802.11/wlan_exp/app_notes/tutorial_token_mac/extensions

Timestamp:

Jul 13, 2015, 3:24:16 PM (9 years ago)

Author:

chunter

Comment:

--

802.11/wlan_exp/app_notes/tutorial_token_mac/extensions

@@ -59 +59 @@
                 case IPC_MBOX_TOKEN_NEW_RESERVATION:
                         token_stats_start_callback( ((ipc_token_new_reservation*)msg->payload_ptr)->addr,
-                                                                   ((ipc_token_new_reservation*)msg->payload_ptr)->res_duration );
+                                                                                ((ipc_token_new_reservation*)msg->payload_ptr)->res_duration );
                 break;
+}}}
+
+----
+
+Next, we need to make a small addition to an existing struct definition that tracks details about each associated device to an AP. The reasons behind this addition will be clear once we make our changes to the AP code. In the meantime, find the definition of {{{station_info}}} in [browser:ReferenceDesigns/w3_802.11/c/wlan_mac_high_framework/include/wlan_mac_high.h wlan_mac_high.h]. Simply add the following element somewhere after the {{{MY_STATION_INFO_COMMON_FIELDS}}}:
+
+{{{
+#!c
+u8      token_res_mult_factor;
+}}}
+
+Next, let us add a few new definitions that will act as parameters for our new TokenMAC extensions. The easiest place to add these is to the top of {{{[browser:ReferenceDesigns/w3_802.11/c/wlan_mac_high_framework/include/wlan_mac_high.h wlan_mac_high.h]}}}. This will ensure that both the MAC High Framework as well as the AP has visibility of these definitions.
+
+{{{
+#!c
+
+#define TOKEN_RES_MULT_FACTOR_MIN 1
+#define TOKEN_RES_MULT_FACTOR_MAX 50
+
+#define DEFAULT_RESERVATION_DURATION_USEC 2000
+
+//Ignoring all overhead, a 6 Mbps PHY rate
+//could theoretically deliver (6e6*2000e-6) = 12 kBytes
+//in 2ms. Let's define our "success" threshold at (an arbitrary) 1/6 of that: 2000 bytes.
+//Delivering more than this threshold in 2ms will grant access to the larger
+//token reservation period
+#define TOKEN_RES_BYTES_EFFICIENCY_THRESH 2000
+}}}
+
+Note that we moved the {{{DEFAULT_RESERVATION_DURATION_USEC}}} definition to the above code snippet. We will remove it from the AP code in the next section.
+
+Finally, we should set this new {{{token_res_mult_factor}}} field to {{{TOKEN_RES_MULT_FACTOR_MIN}}} whenever a {{{station_info}}} is created. To do this, add the following line to {{{wlan_mac_high_add_association()}}} just prior to the {{{entry->data = (void*)station;}}} line.
+{{{
+#!c
+
+station->token_res_mult_factor = TOKEN_RES_MULT_FACTOR_MIN;
 }}}