MediaTek LinkIt™ Development
Platform for RTOS Wi-Fi Developer's
Guide
© 2015 - 2017 MediaTek Inc.
Page 30 of 36
This document contains information that is proprietary to MediaTek Inc. (“MediaTek”) and/or its licensor(s).
Any unauthorized use, reproduction or disclosure of this document in whole or in part is strictly prohibited.
2.7.
WPS
Wi-Fi Protected Setup (WPS) is a network security standard to create a secure wireless home network and is used
to simplify the security setup and management of Wi-Fi networks. It includes two types of configuration, in-band
and out-of-band. The LinkIt platform uses in-band configuration that supports Push Button Connection (PBC) and
Personal Identification Number (PIN) methods.
In PBC method of WPS, the user has to push a button, either an actual or virtual one, on the access point and the
new wireless client device. On most devices, this discovery mode turns itself off as soon as a connection is
established or after a delay (typically 2 minutes or less), whichever comes first, thereby minimizing its vulnerability.
Support of this mode is mandatory for access points and optional for connecting devices. The Wi-Fi Direct
specification supersedes this requirement by stating that all devices must support the push button method.
In PIN method of the WPS, the wireless PIN can be found on the device label or display. This PIN must then be
entered at the representant (the registrar) of the network, usually the network's access point. Alternately, a PIN
provided by the access point may be entered into the new device.
A device seeking to join a wireless network is called Enrollee. A device with the authority to issue and revoke
access to a network is called Registrar.
The LinkIt SDK provides APIs to modify default device configuration before triggering the WPS and new event
handler to support credential callbacks. To set the WPS, apply the following steps.
•
Set device information.
•
Turn off WPS auto connection.
•
Register credential event handler.
•
Trigger WPS.
The device settings for WPS including Device Name, Manufacturer, Model Name, Model Number and Serial
Number can only be modified before triggering the WPS.
Once the WPS Enrollee is assigned, it’ll get new credentials from WPS Registrar. And, if the WPS auto-connection
is set on, it will use the new credentials to connect to the Wi-Fi.
The LinkIt SDK supported features for WPS:
•
STA and Enrollee PBC method.
•
STA and Enrollee PIN method.
•
AP and Registrar PBC method.
•
AP and Registrar PIN method.
•
AP and Enrollee PIN method.
Note, AP and Enrollee PIN method is only supported in MT7687 and MT7697.
The list of APIs to implement PBC and PIN methods is shown in Table 15.
