WF_ScanGetResult Function

Microchip TCP/IP Stack

Microchip TCP/IP Stack Help
WF_ScanGetResult Function
C
void WF_ScanGetResult(
    UINT8 listIndex, 
    tWFScanResult * p_scanResult
);
Description

After a scan has completed this function is used to read one or more of the scan results from the MRF24W. The scan results will be written contiguously starting at p_scanResult (see tWFScanResult structure for format of scan result). MRF24WB0M & MRF24WG0M support up to max of 60 scan results (SSIDs).

Preconditions

MACInit must be called first. WF_EVENT_SCAN_RESULTS_READY event must have already occurrerd.

Parameters
Parameters 
Description 
listIndex 
Index (0-based list) of the scan entry to retrieve. 
p_scanResult 
Pointer to location to store the scan result structure 
Returns

None.

Remarks

RSSI can only be obtained from the scan results p_scanResult->rssi. MRF24W checks out the signal strength from the preamble of the incoming packets. The higher the values, the stronger is the received signal strength. 

p_scanResult->rssi contains received signal strength indicator (RSSI).

  • MRF24WB : RSSI_MAX (200) , RSSI_MIN (106).
  • MRF24WG : RSSI_MAX (128) , RSSI_MIN (43).

 

The RSSI value is not directly translated to dbm because this is not calibrated number. However, as a guideline, MAX(200) corresponds to 0 dbm, MIN (106) corresponds to -94 dbm.

Microchip TCP/IP Stack 5.42.08 - June 15, 2013
Copyright © 2012 Microchip Technology, Inc.  All rights reserved.