Radio Debug functions


Functions

VOID CuCmd_RadioDebug_ChannelTune (THandle hCuCmd, ConParm_t parm[], U16 nParms)
 Tunes the radio.
VOID CuCmd_RadioDebug_StartTxCw (THandle hCuCmd, ConParm_t parm[], U16 nParms)
 Starts the carrier wave test.
VOID CuCmd_RadioDebug_StartContinuousTx (THandle hCuCmd, ConParm_t parm[], U16 nParms)
 FCC test.
VOID CuCmd_RadioDebug_StopTx (THandle hCuCmd, ConParm_t parm[], U16 nParms)
 Stops Tx transmission.
VOID CuCmd_RadioDebug_StartRxStatistics (THandle hCuCmd, ConParm_t parm[], U16 nParms)
 Starts Rx statistics.
VOID CuCmd_RadioDebug_StopRxStatistics (THandle hCuCmd, ConParm_t parm[], U16 nParms)
 Stops Rx statistics.
VOID CuCmd_RadioDebug_ResetRxStatistics (THandle hCuCmd, ConParm_t parm[], U16 nParms)
 Resets Rx statistics.
VOID CuCmd_RadioDebug_GetRxStatistics (THandle hCuCmd, ConParm_t parm[], U16 nParms)
 Gets Rx statistics.
VOID CuCmd_RadioDebug_GetHDKVersion (THandle hCuCmd, ConParm_t parm[], U16 nParms)
 Gets the HDK version.

Detailed Description


Function Documentation

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

Tunes the radio.

This function tunes the radio to the applicable channel. This operation is required before any Rx or Tx operation. This command informs the firmware to receive/transmit in a certain channel.

Parameters:
[in] hCuCmd Handle for the command module
[in] parm parm[0] The band (0 - 2.4GHz band, 1 - 5.0GHz band).
parm[1] The channel (1 - 161).
[in] nParms Always 2.
Returns:
None
See also:
Note:
Warning:

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

Gets the HDK version.

This function gets the hardware development kit and SW versions and prints them.
It prints the following information:

  • Product name
  • Page number
  • Software version level
  • Radio module type
  • Software version delivery
  • Number of reference designs supported

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:
Note:
Warning:

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

Gets Rx statistics.

This function gets the collected statistics of the Rx path from the firmware and prints them.
The statistics contain information, such as the number of valid frames received, the number of FCS error frames, the number of missing frames, the average RSSI and SNR of frames and so on.

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_RadioDebug_StartRxStatistics(), CuCmd_RadioDebug_StopRxStatistics(), CuCmd_RadioDebug_ResetRxStatistics()
Note:
Warning:

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

Resets Rx statistics.

This function instructs the firmware to reset the statistics being collected for the Rx path.

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_RadioDebug_StartRxStatistics(), CuCmd_RadioDebug_StopRxStatistics(), CuCmd_RadioDebug_GetRxStatistics()
Note:
Warning:

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

FCC test.

This function continuously transmits packets with the configured parameters.

Parameters:
[in] hCuCmd Handle for the command module
[in] parm parm[0] The delay between packets, in msec.
parm[1] The rate at which to transmit.
parm[2] The packet size, in bytes, to transmit.
parm[3] The number of packets to transmit, in case of multiple number of packets.
parm[4] The upper limit of the power transmission.
parm[5] The seed. The seed is the content of the packet bytes that are transmitted.
parm[6] The packet mode, which can be one of the following:
  • Single
  • Multiple
  • Infinite length
  • Continuous
  • FCC parm[7] Indicates whether or not DCF access is used (0 - Do not use DCF access, 1 - Use DCF access).
    parm[8] Guard Interval (0 - long:800ns, 1 - short:400ns).
    parm[9] Preamble type (0 - long, 1 - short, 4 - OFDM, 6 - Mixed, 7 - GF).
    parm[10] Frame type (0 - Data, 1 - Ack, 2 - Probe-request, 3 - Random, 4 - User-defined, 5 - PER).
    parm[11] Scrambler mode (0- off, 1 - on).
    parm[12] Enable CLPC (range 0 - 100):
    0 - Disable calibration.
    Range 1-99 - Enables Cal assess periodic time; every step is a 200msec period of cal assess; for example: 1.2 second enters the value 6.
    If the value is out of range, it is changed to 25.
    5 seconds of cal assess periodical.
    parm[13] 0 - Fixed sequence number, 1 - incremental (used for PER test only).
    parm[14] Destination address (BSSID) - Used for PER test only.
[in] nParms Can be one of the following:
0 - No test parameters are given. The current test parameters are printed.
15 - An FCC test command is issued to the firmware with the given parameters.
Returns:
None
See also:
CuCmd_RadioDebug_StopTx()
Note:
Warning:

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

Starts Rx statistics.

This function instructs the firmware to start collecting statistics of the Rx path.

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_RadioDebug_StopRxStatistics(), CuCmd_RadioDebug_ResetRxStatistics(), CuCmd_RadioDebug_GetRxStatistics()
Note:
Warning:

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

Starts the carrier wave test.

This function begins transmitting a carrier wave over the air without data for test purposes.

Parameters:
[in] hCuCmd Handle for the command module
[in] parm parm[0] The Tx power to transmit
parm[1] The tone type (1 - Single Tone, 2 - Carrier Feed Through)
[in] nParms Always 2
Returns:
None
See also:
Note:
Warning:

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

Stops Rx statistics.

This function instructs the firmware to stop collecting statistics of the Rx path.

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_RadioDebug_StartRxStatistics(), CuCmd_RadioDebug_ResetRxStatistics(), CuCmd_RadioDebug_GetRxStatistics()
Note:
Warning:

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

Stops Tx transmission.

This function stops Tx transmission.

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_RadioDebug_StartContinuousTx()
Note:
Warning:


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