Callback_wln_rescan_result()

Top  Previous  Next

Description:

Callback procedure, informs of the completion of the re-scanning initiated by wln_rescan(). Procedure body has to be created elsewhere in the project (externally with respect to the library).

Syntax:

sub callback_wln_rescan_result(current_rssi as byte, scan_rssi as byte, different_ap as no_yes)

Returns:

---

See Also:

Step-by-step Usage Instructions, Operation Details, Roaming Between Access Points

 


Part

Description

current_rssi

Signal strength for the access point your device is currently associated with. This argument will be 0 if your device is not associated with any access point.

scan_rssi

Signal strength for the access point you searched for with wln_rescan(). This argument will be 0 if the specified access point wasn't found.

different_ap

Indicates whether or not wln_rescan() has found the same access point as the one your device is currently associated with, or a different access point:

0- NO: the same access point.

1- YES: different access point.

Details

The WLN library determines whether the access point is the same or different by comparing BSSIDs ("MAC addresses") of the access point your device is currently associated with and the access point that was discovered by wln_rescan(). This comes handy for your application in case several access points in range have the same SSID (name).

If several access points with the same SSID are in range, callback_wln_rescan_result() will return the signal strength for the access point with the strongest signal.