[[TracNav(802.11/TOC)]]

= Using the 802.11 Reference Design: IBSS Application =

== Ethernet ==
The IBSS uses ETH A as its source and sink for all wireless data packets. The IBSS code assumes a single Ethernet device is connected to ETH A, such as a PC or network camera. The IBSS code bridges the wired and wireless interfaces, translating between the wired device's MAC address and the WARP node's wireless MAC address. This translation will not work if multiple Ethernet devices are connected to the IBSS node's ETH A interface via a switch.

The IBSS uses ETH B for interaction with the [wiki:../../wlan_exp experiments framework].

== User IO ==

'''Hex Displays''': the STA uses the hex displays to show the node's current association ID (AID) as assigned by the AP during the association handshake. The displays will change in real time as the station joins and leaves networks. The displays will show 00 when the STA is not associated with an AP (0 is not a valid AID).

'''DIP Switch''': the IBSS uses the left-most switch to enable or disable active scan and creation of a BSS on boot. When the left switch is up the IBSS will not search for or create a new BSS on boot. The node can still be added to a BSS via wlan_exp commands.

== UART ==

Refer to the [wiki:../UART 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_ibss ----------------------

< High Framework Boot Messages - See Above >

WLAN MAC IBSS boot complete:
  MAC Addr     : 40-D8-55-04-21-4A


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

After a short while the IBSS application will then print:

{{{
Unable to find 'WARP-IBSS' IBSS. Creating new network.
Remove self from BSS
IBSS Details:
  BSSID           : 42-D8-55-04-21-4A
   SSID           : WARP-IBSS
   Channel        : 1
   Beacon Interval: 100 TU (102400 us)
}}}

This is the normal behavior, indicating the IBSS did not find any existing IBSS network using the SSID "WARP-IBSS", so it creates one and starts sending beacons.

The IBSS application implements a simple UART menu, accessed by hitting {{{ESC}}} key:
{{{
********************** Station Menu **********************
[1] - Interactive Station Status
[2] - Print all Observed Statistics

[a] -   display BSS information
[r/R] - change unicast rate

}}}

Option {{{1}}} will show a sub-menu with a command to reset all Tx/Rx statistics.

Option {{{2}}} will print the Tx/Rx statistics for all traffic at the IBSS node.

Option {{{a}}} will print the list of wireless networks the IBSS has discovered during its active scan.