Changes between Version 8 and Version 9 of 802.11/Usage/UART


Ignore:
Timestamp:
Oct 22, 2014, 3:31:46 PM (10 years ago)
Author:
murphpo
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • 802.11/Usage/UART

    v8 v9  
    66
    77You can use the UART in your custom C code by calling {{{xil_printf()}}}. However keep in mind the UART is slow and {{{xil_printf}}} is a blocking call. Printing frequent or long messages will slow down your application, possibly affecting MAC state. Use the UART sparingly, and avoid runtime debug messages whenever possible.
     8
     9Use of the UART in CPU Low should be avoided whenever possible. Fast execution of code in CPU Low is critical to operation of the DCF MAC; blocking calls to {{{xil_printf()}}} in timing-critical sections of the CPU Low code can break normal Tx/Rx operation.
    810
    911== UART Mux ==
    … …  
    3840These messages include initialization of the DRAM contents (with Tx queues, BSS Info entries and Ethernet DMA buffer descriptors) and the wlan_exp framework.
    3941
    40 == AP UART ==
     42== MAC Application UART Usage ==
    4143
    42 The normal UART output on boot of the AP application is:
    43 {{{
    44 ----- Mango 802.11 Reference Design -----
    45 ----- v1.0 ------------------------------
    46 ----- wlan_mac_ap -----------------------
    47 
    48 < High Framework Boot Messages - See Above >
    49 
    50 WLAN MAC AP boot complete:
    51   SSID    : WARP-AP
    52   Channel : 1
    53   MAC Addr: 40-D8-55-04-21-4A
    54 
    55 Press the Esc key in your terminal to access the UART menu
    56 }}}
    57 
    58 The AP boot message includes the initial SSID (WARP-AP) and wireless MAC address for the node ({{{40-D8-55-04-21-4A}}} in this example).
    59 
    60 Hitting the {{{ESC}}} key will show the AP's interactive menu:
    61 {{{
    62 ********************** AP Menu **********************
    63 [1] - Interactive AP Status
    64 [2] - Print Queue Status
    65 [3] - Print all Observed Statistics
    66 
    67 [c/C] - change channel (note: changing channel will
    68         purge any associations, forcing stations to
    69         join the network again)
    70 [r/R] - change default unicast rate
    71 [s]   - change SSID (note: changing SSID will purge)
    72         any associations)
    73 *****************************************************
    74 }}}
    75 
    76 Option {{{1}}} will show a sub-menu with commands to reset all Tx/Rx statistics and to de-authenticate all stations.
    77 
    78 Option {{{2}}} will show the current allocation of Tx queue descriptors among the existing Tx queues. For example, the following shows 15 packets are queued for transmission (one multicast, 5 for AID 1, 9 for AID 2):
    79 {{{
    80 Queue Status:
    81  FREE || MCAST|     1|     2|
    82   3159||     1|     5|     9|
    83 }}}
     44Each MAC application uses the UART differently:
     45 * [wiki:./AP#UART AP]
     46 * [wiki:./STA#UART STA]
     47 * [wiki:./IBSS#UART IBSS]
    8448
    8549
    8650
    87 During normal operation the AP will print UART messages as stations join and leave the AP's network. For example, when the first client joins the AP:
    88 {{{
    89 Authenticated, Unassociated Stations:
    9051
    91 (MAC time = 404586220 usec)
    92 |-ID-|----- MAC ADDR ----|
    93 | 01 | F0:D1:A9:6C:86:A6 |
    94 |------------------------|
    95 
    96 Authenticated, Associated Stations:
    97 
    98 (MAC time = 404609451 usec)
    99 |-ID-|----- MAC ADDR ----|
    100 | 01 | F0:D1:A9:6C:86:A6 |
    101 |------------------------|
    102 }}}
    103 
    104 The first message shows the client part way through the association handshake (post authentication, pre association). The second message shows the client successfully authenticated. As more clients join and leave the BSS these node lists will grow and shrink.
    105 
    106 == STA UART ==
    107 
    108 The normal UART output on boot of the AP application is:
    109 {{{
    110 ----- Mango 802.11 Reference Design -----
    111 ----- v1.0 ------------------------------
    112 ----- wlan_mac_sta ----------------------
    113 
    114 < High Framework Boot Messages - See Above >
    115 
    116 WLAN MAC Station boot complete:
    117   Default SSID : WARP-AP
    118   Channel      : 1
    119   MAC Addr     : 40-D8-55-04-21-4A
    120 
    121 Press the Esc key in your terminal to access the UART menu
    122 }}}
    123 
    124 The STA boot message indicates the SSID it searches for by default (WARP-AP) and the node's wireless MAC address ({{{40-D8-55-04-21-4A}}} here).
    125 
    126 The STA application implements a simple UART menu, accessed by hitting {{{ESC}}} key:
    127 {{{
    128 ********************** Station Menu **********************
    129 [1] - Interactive Station Status
    130 [2] - Print all Observed Statistics
    131 
    132 [a] -   display BSS information
    133 [r/R] - change unicast rate
    134 
    135 }}}
    136 
    137 Option {{{1}}} will show a sub-menu with a command to reset all Tx/Rx statistics.
    138 
    139 Option {{{2}}} will print the Tx/Rx statistics for all traffic at the STA.
    140 
    141 Option {{{a}}} will print the list of wireless networks the STA has discovered during its active scan.
    142 
    143