wifi

Interface Dot11Interface

All Known Implementing Classes:

LinkLayer

public interface Dot11Interface

This interface describes the methods that a conforming 802.11~ implementation must support. In addition, it is expected that your implementations will have a constructor that takes a MAC address (a short) and a PrintWriter to which output can be written.

Author:

richards

Method Summary

Modifier and Type	Method and Description
int	command(int cmd, int val) This function provides a mechanism to pass command or configuration data to an 802.11~ layer at runtime.
int	recv(Transmission t) This function blocks until data arrives, at which point it writes the incoming data and address information into the Transmission instance passed as argument (respecting the size of the byte array in the Transmission) and returns the number of bytes received.
int	send(short dest, byte[] data, int len) Send len bytes from data to the address specified in dest.
int	status() Returns the current status of the 802.11~ layer.

Method Detail

send

int send(short dest,
         byte[] data,
         int len)

Send len bytes from data to the address specified in dest.

Parameters:

dest - MAC address to which data should be sent

data - Buffer containing data

len - Number of bytes of data to send

Returns:

The number of bytes accepted for transmission, or -1 on error.

recv

int recv(Transmission t)

This function blocks until data arrives, at which point it writes the incoming data and address information into the Transmission instance passed as argument (respecting the size of the byte array in the Transmission) and returns the number of bytes received. (Only data addressed to this station is returned via recv(), but destAddr can help a station determine whether the frame was broadcast to all stations, or addressed specifically to this station.) If the buffer in Transmission is too small to hold the entire data payload of the incoming transmission, the rest should be discarded. The function returns -1 on error, and sets an internal error code.

Parameters:

t - A Transmission instance to which the incoming data and address information is written.

Returns:

The number of bytes received, or -1 on error.

status

int status()

Returns the current status of the 802.11~ layer.

Returns:

Status code

command

int command(int cmd,
            int val)

This function provides a mechanism to pass command or configuration data to an 802.11~ layer at runtime. One could use it to enable or disable debugging output on-the-fly, change system parameters, or prompt the 802.11~ layer to summarize network activity, for example. Note: User-defined command values should be greater than 10. The 802.11~ specification committee has reserved the values 0 through 10 and is still debating their functionality.

Parameters:

cmd - Specifies the command to send

val - The value passed with the command

Returns:

Response from the command