Host library for controlling a WiConnect enabled Wi-Fi module.

Dependents:   wiconnect-ota_example wiconnect-web_setup_example wiconnect-test-console wiconnect-tcp_server_example ... more

Embed: (wiki syntax)

« Back to documentation index

Web Setup Methods

Web Setup Methods
[Network]

Methods for enabled/disabling module web setup. More...

Functions

WiconnectResult startWebSetup (const char *ssid=NULL, const char *password=NULL, const Callback &completeHandler=Callback())
 Start the WiConnect WiFi module 'web setup' feature.
WiconnectResult stopWebSetup ()
 Stop the WiConnect WiFi module 'web setup' feature.
WiconnectResult isWebSetupRunning (bool *isRunningPtr)
 Return status of WiConnect WiFi module 'web setup' feature.

Detailed Description

Methods for enabled/disabling module web setup.


Function Documentation

WiconnectResult isWebSetupRunning ( bool *  isRunningPtr ) [inherited]

Return status of WiConnect WiFi module 'web setup' feature.

This may be called at any time (whether web setpu has been stared or not).

Parameters:
[out]isRunningPtrPointer to bool to contain TRUE if web setup is running, FALSE else
Returns:
Result of method. See WiconnectResult
WiconnectResult startWebSetup ( const char *  ssid = NULL,
const char *  password = NULL,
const Callback completeHandler = Callback() 
) [inherited]

Start the WiConnect WiFi module 'web setup' feature.

This command has an optional background processing feature. Background processing is enabled if the completeHandler parameter is specified. If enabled, the library will poll the module every second for the web setup status (essentially it'll call isWebSetupRunning() every second in the background). When the web setup is no longer running the callback will be executed. The background processing is disabled when stopWebSetup() is called.

Note:
only the 'result' parameter of the callback handler is valid.

Refer to Asynchronous Processing for more info.

Parameters:
[in]ssidOptional, optionally set the SSID of module's softAp
[in]passwordOptional, optionally set the WPA2-PSK password for the module'S softap Note: make an OPEN softAp, set this parameter to a null string (i.e. "")
[in]completeHandlerOptional, callback to be executed when module web setup completes.
Returns:
Result of method. See WiconnectResult
WiconnectResult stopWebSetup (  ) [inherited]

Stop the WiConnect WiFi module 'web setup' feature.

This method should be called AFTER startWebSetup() to prematurely terminate web setup. Note that this is not needed if web setup completes by itself (i.e. if the user exits web setup from the webpage).

Returns:
Result of method. See WiconnectResult