nodemcu-firmware/docs/en/modules/wps.md

WPS Module

Since	Origin / Contributor	Maintainer	Source
2017-01-01	Frank Exoo	Frank Exoo	wps.c

WPS allows devices to be added to an existing network without entering the network credentials.

!!! danger

Use this with caution. There are serious security concerns about using WPS.

WPA/WPA2 networks that have the WPS feature enabled are [very easy to crack](http://www.howtogeek.com/176124/wi-fi-protected-setup-wps-is-insecure-heres-why-you-should-disable-it/). Once the WPS pin has been stolen [the router gives out the password](https://scotthelme.co.uk/wifi-insecurity-wps/) even if it has been changed.

You should use WPA/WPA2 with the WPS feature disabled.

wps.disable()

Disable WiFi WPS function.

Parameters

none

Returns

nil

wps.enable()

Enable WiFi WPS function.

Parameters

none

Returns

nil

wps.start()

Start WiFi WPS function. WPS must be enabled prior calling this function.

Syntax

wps.start([function(status)])

Parameters

• function(status) callback function for when the WPS function ends.

Returns

nil

Example

wps.enable()
wps.start(function(status)
  if status == wps.SUCCESS then
    print("SUCCESS!")
  elseif status == wps.FAILED then
    print("Failed")
  elseif status == wps.TIMEOUT then
    print("Timeout")
  elseif status == wps.WEP then
    print("WEP not supported")
  elseif status == wps.SCAN_ERR then
    print("WPS AP not found")
  else
    print(status)
  end
  wps.disable()
end)