Network Profiles#

Functions#

sl_status_t
sl_net_set_profile(sl_net_interface_t interface, sl_net_profile_id_t id, const sl_net_profile_t *profile)

Store a network profile for a given interface.

sl_status_t
sl_net_get_profile(sl_net_interface_t interface, sl_net_profile_id_t id, sl_net_profile_t *profile)

Retrieve a stored network profile for a given interface.

sl_status_t
sl_net_delete_profile(sl_net_interface_t interface, sl_net_profile_id_t id)

Delete a stored network profile for a given interface.

Function Documentation#

sl_net_set_profile#

sl_status_t sl_net_set_profile (sl_net_interface_t interface, sl_net_profile_id_t id, const sl_net_profile_t * profile)

Store a network profile for a given interface.

Parameters
[in]interface

Interface identified by sl_net_interface_t.

[in]id

Profile storage index / identifier of type sl_net_profile_id_t.

[in]profile

Pointer to profile data of type sl_net_profile_t.

This function stores the network profile data such as WIFI Credentials and Network Credentials for the specified interface. The profile can be used later to bring the interface up with the stored settings.

The user can use the id to store multiple profiles for the same interface and pass the id to different APIs.

  • Pre-conditions:

Returns


Definition at line 192 of file components/service/network_manager/inc/sl_net.h

sl_net_get_profile#

sl_status_t sl_net_get_profile (sl_net_interface_t interface, sl_net_profile_id_t id, sl_net_profile_t * profile)

Retrieve a stored network profile for a given interface.

Parameters
[in]interface

Interface identified by sl_net_interface_t.

[in]id

Profile storage index / identifier of type sl_net_profile_id_t.

[out]profile

Pointer to sl_net_profile_t object that will store the retrieved profile data.

This function retrieves the network profile data for the specified interface and profile ID. The retrieved profile data is stored in the provided profile object.

  • Pre-conditions:

Returns


Definition at line 218 of file components/service/network_manager/inc/sl_net.h

sl_net_delete_profile#

sl_status_t sl_net_delete_profile (sl_net_interface_t interface, sl_net_profile_id_t id)

Delete a stored network profile for a given interface.

Parameters
[in]interface

Interface identified by sl_net_interface_t.

[in]id

Profile storage index / identifier of type sl_net_profile_id_t.

This function deletes the network profile data for the specified interface and profile ID. Once deleted, the profile cannot be used to bring the interface up.

  • Pre-conditions:

Returns


Definition at line 240 of file components/service/network_manager/inc/sl_net.h