Description
utils/consoleWiFiConfig.h provides the following function (from the WiFiNINA and BOOTLOADER SETTINGS – Library) to your console application:
s_console_wifi_config_cmds(): delivers the following commands- wifi scan – scans and list available WiFi networks
- wifi ssid – get/set the WiFi access SSID (stored in the user area of the bootloader settings)
- wifi pass- get/set the WiFi access passphrase(stored in the user area of the bootloader settings)
- wifi info – prints information about WiFi (IP, etc.)
- wifi connect – connects to the Wifi network (e.g. to test the settings)
- wifi ping IP/URL – pings a peer to check the network connection is working
Use the WiFiConfig function/commands to give the users of your application the opportunity to configure the WiFi settings of a dice-WiFi. The code uses the “user-values area” of the non-volatile memory that is protected by the bootloader. This means the WiFi settings (ssid/passwd) will still be available after flashing a new application. Please use the code as examples a/o adapt it to your needs. The source code can be found at the path see below.
Parameters
String s_console_string – String that holds the user command. Normally returned by s_console_routine() or a previous console function.
Returns
String : the user command or an empty String “” if the user command was recognised and processed by this function. (see of commands above)
Example Code:
#include "consoleLogin.h"
#include "utils/consoleWiFiConfig.h"
void setup() {
console_init(&Serial);
}
void loop() {
String s_console_string = s_console_routine();
s_console_wifi_config_cmds( s_console_string );
}Notes and Warnings
This console-function and its commands are helpful to test and learn to work with the WiFiNINA and BOOTLOADER SETTINGS – Library. See the source code as example code for your own application:
C:\Users\yourName\AppData\Local\Arduino15\packages\dice\hardware\samc\1.0.0\libraries\Console\src\...
In a ‘real world’ application, these commands might not be required but during development it could be helpful to test the Update library.
Please keep in mind that each included file and its used function increase the size of the resulting application. So in order to keep the application binaries as small as possible, include only functions that are really necessary for the final application.
An example can be found in the Arduino IDE menu:
File -> Examples -> Consoles -> Dev_Console