Connection Management functions


Functions

VOID CuCmd_Connect (THandle hCuCmd, ConParm_t parm[], U16 nParms)
 Connects to a BSSID.
VOID CuCmd_Disassociate (THandle hCuCmd, ConParm_t parm[], U16 nParms)
 Disconnects from the BSSID.
VOID CuCmd_ModifyChannel (THandle hCuCmd, ConParm_t parm[], U16 nParms)
 Modifies the applicable channel.
VOID CuCmd_ModifyConnectMode (THandle hCuCmd, ConParm_t parm[], U16 nParms)
 Modifies the applicable connection mode.

Detailed Description


Function Documentation

VOID CuCmd_Connect ( THandle  hCuCmd,
ConParm_t  parm[],
U16  nParms 
)

Connects to a BSSID.

This function tries to connect to a BSSID, based on the configured parameters.

Parameters:
[in] hCuCmd Handle for the command module
[in] parm parm[0] 32 characters that represent the applicable SSID (the default is 1..32)
parm[1] 6 bytes that represent the applicable BSSID (the default is broadcast MAC)
[in] nParms Number of parameters, which can be one of the following:
0 - Neither the SSID or BSSID are given. The station attempts to connect to the best BSSID it finds
1 - Only the SSID is given. The station attempts to connect to the best BSSID it finds that supports the given SSID as its network name
2 - Both the SSID and BSSID are given. The station attempts to connect to the given BSSID that supports the given SSID as its network name.
Returns:
None
See also:
CuCmd_Disassociate()
Note:
Warning:

VOID CuCmd_Disassociate ( THandle  hCuCmd,
ConParm_t  parm[],
U16  nParms 
)

Disconnects from the BSSID.

This function disconnects a station from the BSSID to which it is associated.

Parameters:
[in] hCuCmd Handle for the command module
[in] parm Not used; should be 0
[in] nParms Not used; should be 0
Returns:
None
See also:
CuCmd_Connect()
Note:
This function resets the applicable SSID configured using the function 'CuCmd_Connect()'.
Warning:

VOID CuCmd_ModifyChannel ( THandle  hCuCmd,
ConParm_t  parm[],
U16  nParms 
)

Modifies the applicable channel.

This function configures the applicable channel on the driver.

Parameters:
[in] hCuCmd Handle for the command module
[in] parm parm[0] The applicable channel (1 - 201; default = 11)
[in] nParms The number of parameters, which can be one of the following:
0 - No channel is given. The function prints the current channel and the BSSID's channel to which the station is associated.
1 - The given channel is configured on the driver.
Returns:
None
See also:
Note:
The driver prefers associating to a BSSID that transmits on the applicable channel.
Please note that this is only one criterion for the connection.
There are other criteria as well, some of which are more critical, such as the BSSID, applicable SSID and so on.
Warning:

VOID CuCmd_ModifyConnectMode ( THandle  hCuCmd,
ConParm_t  parm[],
U16  nParms 
)

Modifies the applicable connection mode.

This function configures the connection mode to the driver.

Parameters:
[in] hCuCmd Handle for the command module
[in] parm The applicable connection mode (0 - auto, 1 - manual, default = 0)
[in] nParms The number of parameters, which can be one of the following:
0 - No connection mode is given. The function prints the current connection mode and the connection mode's available values.
1 - The given connection mode be configured on the driver.
Returns:
None
See also:
Note:
In auto-connection mode, if an SSID is configured, the driver automatically scans and attempts to connect.
If it does not find a proper candidate, it scans endlessly.
In manual connection mode, the driver does not automatically scan and does not attempt to connect.
Instead, the scan and connection attempts are triggered from the application.
The user can trigger a scan from the application using one of the following functions:
CuCmd_StartScan(), CuCmd_WextStartScan() and CuCmd_StartPeriodicScan().
If, as a result of the scan, there is a BSSID that matches, the user can trigger a connection by calling the function CuCmd_Connect().
Warning:


Generated on Sun Dec 6 12:34:02 2009 for WLAN DRIVER API REFERENCE MANUAL by  doxygen 1.5.9