Power Management functions


Functions

VOID CuCmd_SetPowerMode (THandle hCuCmd, ConParm_t parm[], U16 nParms)
 Sets the default power mode profile.
VOID CuCmd_SetPowerSavePowerLevel (THandle hCuCmd, ConParm_t parm[], U16 nParms)
 Sets the power-save power level.
VOID CuCmd_SetDefaultPowerLevel (THandle hCuCmd, ConParm_t parm[], U16 nParms)
 Sets the default power level.
VOID CuCmd_SetDozeModeInAutoPowerLevel (THandle hCuCmd, ConParm_t parm[], U16 nParms)
 Sets the doze mode.
VOID CuCmd_SetTrafficIntensityTh (THandle hCuCmd, ConParm_t parm[], U16 nParms)
 Configures the traffic intensity.

Detailed Description


Function Documentation

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

Sets the default power level.

This function sets the power level to be used when the station is not connected.

Parameters:
[in] hCuCmd Handle for the command module
[in] parm parm[0] The power level. Please refer to CuCmd_SetPowerSavePowerLevel() for the available values.
The default value is 0.
[in] nParms The number of parameters, which can be one of the following:
0 - No power level is given. The function prints the current default power level and the available values.
1 - The default power level is configured on the driver.
Returns:
None
See also:
CuCmd_SetPowerSavePowerLevel()
Note:
Warning:

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

Sets the doze mode.

This function sets the doze mode. If the power mode profile of the system is AUTO, the power mode toggles between ACTIVE mode and the applicable doze mode.

Parameters:
[in] hCuCmd Handle for the command module
[in] parm parm[0] The doze mode, which can be one of the following:
2 - SHORT_DOZE: When in a power save state, the system awakens every N beacons, according to the configuration.
3 - LONG_DOZE: When in a power save state, the system awakens every N DTIMs, according to the configuration.
The default value is 2.
[in] nParms The number of parameters, which can be one of the following:
0 - No doze mode is given. The function prints the current doze mode.
1 - The doze mode is configured on the driver.
Returns:
None
See also:
Note:
Warning:

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

Sets the default power mode profile.

This function sets the default power mode profile that should be used by the system.
This profile can be changed during operation if one of the following events occur:

  • Bluetooth is activated (low-priority event)
  • The reauthentication process with the RADIUS server is started (medium-priority event)
  • A PsPoll failure occurred (the AP did not receive the PsPoll frame sent from the station; high-priority event)
    For each of the events defined above, a special power-save profile is defined and activated.
    If more than two events occur at the same time, the power mode profile of the highest event is used.
    When the system returns to regular operation, the default power mode profile is loaded again.

Parameters:
[in] hCuCmd Handle for the command module
[in] parm parm[0] The power mode profile value, which can be one of the following:
0 - AUTO: The power mode toggles between ACTIVE and DOZE mode (depends on which DOZE mode is defined: SHORT_DOZE or LONG_DOZE).
Toggling is performed according to the power manager module algorithm.
1 - ACTIVE: No power save; the chip is constantly awake.
2 - SHORT_DOZE: The system is in a power-save state and awakens every N beacons, according to the configuration.
3 - LONG_DOZE: The system is in a power-save state and awakens every N DTIMs, according to the configuration.
The default value is 0.
[in] nParms The number of parameters, which can be one of the following:
0 - No power mode profile is given. The function prints the current power mode profile of the system.
1 - The power mode profile is configured on the driver to be used as default.
Returns:
None
See also:
CuCmd_SetDozeModeInAutoPowerLevel()
Note:
Warning:

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

Sets the power-save power level.

This function sets the power level to be used when the station is connected.

Parameters:
[in] hCuCmd Handle for the command module
[in] parm parm[0] The power level, which can be one of the following:
0 - ELP: When in a power save state, both the radio interface and the chip interface are closed.
1 - PD: When in a power save state, the radio interface is closed and the chip interface is open.
2 - Awake: When in a power save state, both interfaces are open.
The default value is 0.
[in] nParms The number of parameters, which can be one of the following:
0 - No power level is given. The function prints the current power-save power level and the available values.
1 - The power-save power level is configured on the driver.
Returns:
None
See also:
CuCmd_SetDefaultPowerLevel()
Note:
Warning:

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

Configures the traffic intensity.

This function configures the traffic intensity threshold for notification and the time interval.

Parameters:
[in] hCuCmd Handle for the command module
[in] parm parm[0] The traffic intensity high threshold, in packets (1 – 1,000; default = 100).
parm[1] The traffic intensity low threshold, in packets (1 – 1,000; default = 25).
parm[2] The time interval, in msecs, to measure the traffic (50 – 10,000; default = 1,000).
[in] nParms The number of parameters, which can be one of the following:
0 - No traffic thresholds and time interval are given. The function prints the current traffic thresholds and time interval.
1 - The traffic thresholds and time interval are configured on the driver.
Returns:
None
See also:
CuCmd_EnableTrafficEvents()
Note:
Warning:


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