Wln_wpa_mkey_get()

Top  Previous  Next

Description:

API procedure, calculates the pre-shared master key for WPA1 and WPA2 security modes.

Syntax:

function wln_wpa_mkey_get(byref password as string, byref ssid as string) as string

Returns:

Pre-shared master key string

See Also:

Step-by-step Usage Instructions, Operation Details, Trying WPA

 


Part

Description

password

The "human" password for the access point.

ssid

SSID (name) of the access point.

Details

In WPA1-PSK and WPA2-PSK security schemes, the password you set and the SSID of the access point are used to calculate a so-called pre-shared master key, which is the actual password used in communications between your device and the access point. The password and the pre-shared master key are not to be confused: the password is the string you manually enter (on the setup page) when configuring the access point. The pre-shared master key is a binary string that you never get to handle directly.

On Tibbo devices, pre-shared master key calculation takes up to 2 minutes. Fortunately, the key needs only be calculated when there is the password or SSID change.

Callback_wln_mkey_progress_update() is called periodically from within wln_wpa_mkey_get(). This enables your application to indicate the calculation progress to the user (i.e. by drawing a progress bar on the LCD screen).