Version 4 (modified by murphpo, 8 years ago) (diff)


Using the 802.11 Reference Design: AP Application


User IO

Hex Displays: the AP uses the hex displays to show the number of associated stations. The displays will change in real time as stations join and leave the network. The right display also blinks slowly to indicate the AP will accept new associations. This blinking is a good way to distinguish the AP from other MAC applications when the displayed value is 0.

DIP Switch: the AP uses the left-most switch to enable or disable new associations at boot. When the switch is up the AP will not accept associations via wireless handshakes. Associations can still be established via wlan_exp commands. This mode is very useful for running experiments with networks of WARP nodes (some AP, some STA) without allowing associations from non-WARP devices.


Refer to the UART usage page for an overview of how the 802.11 design uses the UART cores on each CPU.

The normal UART output on boot of the AP application is:

----- Mango 802.11 Reference Design -----
----- v1.0 ------------------------------
----- wlan_mac_ap -----------------------

< High Framework Boot Messages - See Above >

WLAN MAC AP boot complete:
  Channel : 1
  MAC Addr: 40-D8-55-04-21-4A

Press the Esc key in your terminal to access the UART menu

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).

Hitting the ESC key will show the AP's interactive menu:

********************** AP Menu **********************
[1] - Interactive AP Status
[2] - Print Queue Status
[3] - Print all Observed Statistics

[c/C] - change channel (note: changing channel will
        purge any associations, forcing stations to
        join the network again)
[r/R] - change default unicast rate
[s]   - change SSID (note: changing SSID will purge)
        any associations)

Option 1 will show a sub-menu with commands to reset all Tx/Rx statistics and to de-authenticate all stations.

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):

Queue Status:
 FREE || MCAST|     1|     2|
  3159||     1|     5|     9|

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:

Authenticated, Unassociated Stations:

(MAC time = 404586220 usec)
|-ID-|----- MAC ADDR ----|
| 01 | F0:D1:A9:6C:86:A6 |

Authenticated, Associated Stations:

(MAC time = 404609451 usec)
|-ID-|----- MAC ADDR ----|
| 01 | F0:D1:A9:6C:86:A6 |

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.