Tizen RT Public API  v1.1 D4
Wi-Fi_Manager

Provides APIs for Wi-Fi Manager. More...

Files

file  wifi_manager.h
 Provides APIs for Wi-Fi Manager.
 

Data Structures

struct  wifi_manager_scan_info_s
 Keep information of nearby access points as scan results. More...
 
struct  wifi_manager_cb_s
 Include callback functions which are asynchronously called after Wi-Fi Manager APIs are called. More...
 
struct  wifi_manager_info_s
 Keep Wi-Fi Manager information including ip/mac address, ssid, rssi, etc. More...
 
struct  wifi_manager_softap_config_s
 Specify information of soft access point (softAP) such as ssid and channel number. More...
 
struct  wifi_manager_ap_config_s
 Specify which access point (AP) a client connects to. More...
 

Enumerations

enum  connect_status_e
 Status of Wi-Fi interface such as connected or disconnected. More...
 
enum  wifi_manager_result_e
 Result types of Wi-Fi Manager APIs such as FAIL, SUCCESS, or INVALID ARGS. More...
 
enum  wifi_manager_mode_e
 Mode of Wi-Fi interface such as station mode or ap mode. More...
 
enum  wifi_manager_scan_result_e
 Result types of nearby access point scanning. More...
 
enum  wifi_manager_ap_auth_type_e {
  WIFI_MANAGER_AUTH_OPEN, WIFI_MANAGER_AUTH_WEP_SHARED, WIFI_MANAGER_AUTH_WPA_PSK, WIFI_MANAGER_AUTH_WPA2_PSK,
  WIFI_MANAGER_AUTH_WPA_AND_WPA2_PSK, WIFI_MANAGER_AUTH_UNKNOWN
}
 Wi-Fi authentication type such as WPA, WPA2, or WPS. More...
 
enum  wifi_manager_ap_crypto_type_e {
  WIFI_MANAGER_CRYPTO_NONE, WIFI_MANAGER_CRYPTO_WEP_64, WIFI_MANAGER_CRYPTO_WEP_128, WIFI_MANAGER_CRYPTO_AES,
  WIFI_MANAGER_CRYPTO_TKIP, WIFI_MANAGER_CRYPTO_TKIP_AND_AES, WIFI_MANAGER_CRYPTO_UNKNOWN
}
 Wi-Fi encryption type such as WEP, AES, or TKIP. More...
 

Functions

wifi_manager_result_e wifi_manager_init (wifi_manager_cb_s *wmcb)
 Initialize Wi-Fi Manager including starting Wi-Fi interface. More...
 
wifi_manager_result_e wifi_manager_deinit (void)
 Deinitialize Wi-Fi Manager including stoping Wi-Fi interface. More...
 
wifi_manager_result_e wifi_manager_set_mode (wifi_manager_mode_e mode, wifi_manager_softap_config_s *config)
 Change the Wi-Fi mode to station or AP. More...
 
wifi_manager_result_e wifi_manager_get_info (wifi_manager_info_s *info)
 Retrieve current status of Wi-Fi interface including mode, connection status, ssid, received signal strengh indication, and ip address. More...
 
wifi_manager_result_e wifi_manager_connect_ap (wifi_manager_ap_config_s *config)
 Connect to an access point. More...
 
wifi_manager_result_e wifi_manager_disconnect_ap (void)
 Disconnect from the connected access point. More...
 
wifi_manager_result_e wifi_manager_scan_ap (void)
 Scan nearby access points. More...
 

Detailed Description

Provides APIs for Wi-Fi Manager.

Enumeration Type Documentation

◆ connect_status_e

Status of Wi-Fi interface such as connected or disconnected.

Definition at line 37 of file wifi_manager.h.

◆ wifi_manager_ap_auth_type_e

Wi-Fi authentication type such as WPA, WPA2, or WPS.

Enumerator
WIFI_MANAGER_AUTH_OPEN 

open mode

WIFI_MANAGER_AUTH_WEP_SHARED 

use shared key (wep key)

WIFI_MANAGER_AUTH_WPA_PSK 

WPA_PSK mode

WIFI_MANAGER_AUTH_WPA2_PSK 

WPA2_PSK mode

WIFI_MANAGER_AUTH_WPA_AND_WPA2_PSK 

WPA_PSK and WPA_PSK mixed mode

WIFI_MANAGER_AUTH_UNKNOWN 

unknown type

Definition at line 135 of file wifi_manager.h.

◆ wifi_manager_ap_crypto_type_e

Wi-Fi encryption type such as WEP, AES, or TKIP.

Enumerator
WIFI_MANAGER_CRYPTO_NONE 

none encryption

WIFI_MANAGER_CRYPTO_WEP_64 

WEP encryption wep-40

WIFI_MANAGER_CRYPTO_WEP_128 

WEP encryption wep-104

WIFI_MANAGER_CRYPTO_AES 

AES encryption

WIFI_MANAGER_CRYPTO_TKIP 

TKIP encryption

WIFI_MANAGER_CRYPTO_TKIP_AND_AES 

TKIP and AES mixed encryption

WIFI_MANAGER_CRYPTO_UNKNOWN 

unknown encryption

Definition at line 147 of file wifi_manager.h.

◆ wifi_manager_mode_e

Mode of Wi-Fi interface such as station mode or ap mode.

Definition at line 66 of file wifi_manager.h.

◆ wifi_manager_result_e

Result types of Wi-Fi Manager APIs such as FAIL, SUCCESS, or INVALID ARGS.

Definition at line 53 of file wifi_manager.h.

◆ wifi_manager_scan_result_e

Result types of nearby access point scanning.

Definition at line 79 of file wifi_manager.h.

Function Documentation

◆ wifi_manager_connect_ap()

wifi_manager_result_e wifi_manager_connect_ap ( wifi_manager_ap_config_s config)

Connect to an access point.

#include <wifi_manager/wifi_manager.h>

Parameters
[in]ssid,passphrase,authenticationtype, and cryto type of the access point which the wi-fi interface connect to.
Returns
On success, WIFI_MANAGER_SUCCESS (i.e., 0) is returned. On failure, non-zero value is returned.
Since
Tizen RT v1.1

◆ wifi_manager_deinit()

wifi_manager_result_e wifi_manager_deinit ( void  )

Deinitialize Wi-Fi Manager including stoping Wi-Fi interface.

#include <wifi_manager/wifi_manager.h>

Parameters
[in]none
Returns
On success, WIFI_MANAGER_SUCCESS (i.e., 0) is returned. On failure, non-zero value is returned.
Since
Tizen RT v1.1

◆ wifi_manager_disconnect_ap()

wifi_manager_result_e wifi_manager_disconnect_ap ( void  )

Disconnect from the connected access point.

#include <wifi_manager/wifi_manager.h>

Parameters
[in]none
Returns
On success, WIFI_MANAGER_SUCCESS (i.e., 0) is returned. On failure, non-zero value is returned.
Since
Tizen RT v1.1

◆ wifi_manager_get_info()

wifi_manager_result_e wifi_manager_get_info ( wifi_manager_info_s info)

Retrieve current status of Wi-Fi interface including mode, connection status, ssid, received signal strengh indication, and ip address.

#include <wifi_manager/wifi_manager.h>

Parameters
[out]retrievedinformation including mode, connection status, ssid, received signal strengh indication, and ip address.
Returns
On success, WIFI_MANAGER_SUCCESS (i.e., 0) is returned. On failure, non-zero value is returned.
Since
Tizen RT v1.1

◆ wifi_manager_init()

wifi_manager_result_e wifi_manager_init ( wifi_manager_cb_s wmcb)

Initialize Wi-Fi Manager including starting Wi-Fi interface.

#include <wifi_manager/wifi_manager.h>

Parameters
[in]callbackfunctions called when wi-fi events happen
Returns
On success, WIFI_MANAGER_SUCCESS (i.e., 0) is returned. On failure, non-zero value is returned.
Since
Tizen RT v1.1

◆ wifi_manager_scan_ap()

wifi_manager_result_e wifi_manager_scan_ap ( void  )

Scan nearby access points.

#include <wifi_manager/wifi_manager.h>

Parameters
[in]none
Returns
On success, WIFI_MANAGER_SUCCESS (i.e., 0) is returned. On failure, non-zero value is returned.
Since
Tizen RT v1.1

◆ wifi_manager_set_mode()

wifi_manager_result_e wifi_manager_set_mode ( wifi_manager_mode_e  mode,
wifi_manager_softap_config_s config 
)

Change the Wi-Fi mode to station or AP.

#include <wifi_manager/wifi_manager.h>

Parameters
[in]Wi-Fimode (station or AP)
[in]Incase of AP mode, AP configuration infomation should be given including ssid, channel, and passphrase.
Returns
On success, WIFI_MANAGER_SUCCESS (i.e., 0) is returned. On failure, non-zero value is returned.
Since
Tizen RT v1.1