Changes between Version 4 and Version 5 of 802.11/wlan_exp/Extending

Timestamp:

Dec 14, 2015, 5:27:58 PM (8 years ago)

Author:

murphpo

Comment:

--

802.11/wlan_exp/Extending

@@ -63 +63 @@
 CMDID_USER_TX_QUEUE_STATUS = 100
 
-my_node.send_user_command(CMDID_USR_QUEUE_STATUS, args=None)
-
+#Define a user command ID
+USER_CMDID_TX_QUEUE_STATUS = 100
+
+#Define method for sending command and processing the response
+def get_tx_queue_status(node, queue_id=None):
+
+    if(queue_id is not None):
+        #Arguments must be a list of ints - listify/cast the scaler queue_id
+        args = [int(queue_id)]
+    else:
+        args = None
+
+    resp = node.send_user_command(USER_CMDID_TX_QUEUE_STATUS, args)
+
+    #Response should be list of ints with 2 values per queue
+    # Each pair of response values is (queue_id, queue_occupancy)
+    # Sanity check the response, then convert to a list of 2-tuples and return
+    if(len(resp) % 2 != 0):
+        print('ERROR: Tx Queue Status command response lenth ({0} values) was not even!'.format(len(resp)))
+        return
+    else:
+        #Group each pair of response values into 2-tuple and return list of 2-tuples
+        ret = zip(*[iter(resp)]*2)
+
+    return ret
+}}}
+
+This method takes one node object as its argument, sends the {{{USER_CMDID_TX_QUEUE_STATUS}}} command to the node, then parses the response. If the response is valid it returns the list of queue id/occupancy values.
+
+To use this function:
+
+{{{
+
+#Assume n0 is a wlan_exp node object that has already been initialized
+q_stat = get_tx_queue_status(n0)
+
+#Print the queue status response
+if(q_stat):
+  print('Tx Queue Status for node {0}'.format(n0.sn_str))
+  print('ID Occupancy')
+
+  for q_id,q_occ in q_stat:
+      print('{0:2d} {1:3d}'.format(q_id, q_occ))
+else:
+  print('No Tx Queue Status received for {0}'.format(n0_str))
 }}}