User Manual

AdafruitFeather: Profiles

The WICED Feather API allows you to store 'profiles', which contain all of the settings about a specific AP (access

point).

This means that you only need to enter your AP details once, and once connected you can store them in non-volatile

config memory for later use, simplifying project management and speeding up connection time in certain instances.

This is useful in situations where your project might move from one physical location to another, and the AP will change

between locations (for example at home and at the office).

Connecting via Profiles

To connect to an AP using the stored profile data, simply call the bare Feather.connect() function with no parameters.

This will attempt to connect to the profiles stored in non-volatile memory from the first entry to the last, and will return

false is we were unable to connect to any of the stored APs.

Profiles API

The profile management API includes the following functions (defined as part of the AdafruitFeather class which is

normally available as Feather.*):

bool saveConnectedProfile (void)

Saves the currently connected access point details as a Profile. You must be connected when calling this functions.

Parameters: None

Returns: 'true' (1) if the profile was successfully added, otherwise 'false' (0).

bool addProfile (char* ssid)

Saves the specified open SSID to the profile list. This function should only be used with open access points that have

no security/encoding enabled.

Parameters:

ssid: A string containing the access point's SSID/name.

Returns: 'true' (1) if the profile was successfully added, otherwise 'false' (0).

Up to FIVE profiles can be stored at a time in non-volatile memory.

bool saveConnectedProfile ( void ); // Save currently connected AP

bool addProfile ( char* ssid ); // Open

bool addProfile ( char* ssid, char* key, wl_enc_type_t enc_type);

bool removeProfile ( char* ssid );

bool checkProfile ( char* ssid ); // Check if profile exists

void clearProfiles ( void );

char* profileSSID ( uint8_t pos);

int32_t profileEncryptionType ( uint8_t pos);