Tizen Native API  5.0

The Wi-Fi API provides functions for monitoring the state of Wi-Fi.

Required Header

#include <wifi.h>

Overview

The Wi-Fi Monitor allows monitoring the changes of Wi-Fi.

Related Features

This API is related with the following features:

  • http://tizen.org/feature/network.wifi
    It is recommended to design applications with regard to features, for reliability.
    You can check if a device supports the related features for this API by using System Information, and control your application's actions accordingly.
    To ensure your application is only running on the device with specific features, please define the features in your manifest file using the manifest editor in the SDK.
    More details on featuring your application can be found from Feature List.

Functions

int wifi_get_connection_state (wifi_connection_state_e *connection_state) TIZEN_DEPRECATED_API
 Gets the connection state.
int wifi_set_device_state_changed_cb (wifi_device_state_changed_cb callback, void *user_data) TIZEN_DEPRECATED_API
 Registers the callback called when the device state is changed.
int wifi_unset_device_state_changed_cb (void) TIZEN_DEPRECATED_API
 Unregisters the callback called when the device state is changed.
int wifi_set_background_scan_cb (wifi_scan_finished_cb callback, void *user_data) TIZEN_DEPRECATED_API
 Registers the callback called when the background scan is finished periodically.
int wifi_unset_background_scan_cb (void) TIZEN_DEPRECATED_API
 Unregisters the callback called when the scan is finished periodically.
int wifi_set_connection_state_changed_cb (wifi_connection_state_changed_cb callback, void *user_data) TIZEN_DEPRECATED_API
 Registers the callback called when the connection state is changed.
int wifi_unset_connection_state_changed_cb (void) TIZEN_DEPRECATED_API
 Unregisters the callback called when the connection state is changed.
int wifi_set_rssi_level_changed_cb (wifi_rssi_level_changed_cb callback, void *user_data) TIZEN_DEPRECATED_API
 Registers callback called when the RSSI of connected Wi-Fi is changed.
int wifi_unset_rssi_level_changed_cb (void) TIZEN_DEPRECATED_API
 Unregisters callback called when the RSSI of connected Wi-Fi is changed.

Typedefs

typedef void(* wifi_device_state_changed_cb )(wifi_device_state_e state, void *user_data)
 Called when the device state is changed.
typedef void(* wifi_connection_state_changed_cb )(wifi_connection_state_e state, wifi_ap_h ap, void *user_data)
 Called when the connection state is changed.
typedef void(* wifi_rssi_level_changed_cb )(wifi_rssi_level_e rssi_level, void *user_data)
 Called when the RSSI of connected Wi-Fi is changed.

Typedef Documentation

typedef void(* wifi_connection_state_changed_cb)(wifi_connection_state_e state, wifi_ap_h ap, void *user_data)

Called when the connection state is changed.

Deprecated:
Deprecated since 3.0. Use wifi_manager_connection_state_changed_cb instead.
Since :
2.3
Parameters:
[in]stateThe connection state
[in]apThe access point
[in]user_dataThe user data passed from the callback registration function
See also:
wifi_set_connection_state_changed_cb()
wifi_unset_connection_state_changed_cb()
typedef void(* wifi_device_state_changed_cb)(wifi_device_state_e state, void *user_data)

Called when the device state is changed.

Deprecated:
Deprecated since 3.0. Use wifi_manager_device_state_changed_cb instead.
Since :
2.3
Parameters:
[in]stateThe device state
[in]user_dataThe user data passed from the callback registration function
See also:
wifi_set_device_state_changed_cb()
wifi_unset_device_state_changed_cb()
typedef void(* wifi_rssi_level_changed_cb)(wifi_rssi_level_e rssi_level, void *user_data)

Called when the RSSI of connected Wi-Fi is changed.

Deprecated:
Deprecated since 3.0. Use wifi_manager_rssi_level_changed_cb instead.
Since :
2.3
Parameters:
[in]rssi_levelThe level of RSSI
[in]user_dataThe user data passed from the callback registration function
See also:
wifi_set_rssi_level_changed_cb()
wifi_unset_rssi_level_changed_cb()

Enumeration Type Documentation

Enumeration for the state of the Wi-Fi connection.

Deprecated:
Deprecated since 3.0. Use wifi_manager_connection_state_e instead.
Since :
2.3
Enumerator:
WIFI_CONNECTION_STATE_FAILURE 

Connection failed state

WIFI_CONNECTION_STATE_DISCONNECTED 

Disconnected state

WIFI_CONNECTION_STATE_ASSOCIATION 

Association state

WIFI_CONNECTION_STATE_CONFIGURATION 

Configuration state

WIFI_CONNECTION_STATE_CONNECTED 

Connected state

Enumeration for the state of the Wi-Fi device.

Deprecated:
Deprecated since 3.0. Use wifi_manager_device_state_e instead.
Since :
2.3
Enumerator:
WIFI_DEVICE_STATE_DEACTIVATED 

Wi-Fi is Deactivated

WIFI_DEVICE_STATE_ACTIVATED 

Wi-Fi is activated

Enumeration for the RSSI level.

Deprecated:
Deprecated since 3.0. Use wifi_manager_rssi_level_e instead.
Since :
2.3
Enumerator:
WIFI_RSSI_LEVEL_0 

level 0

WIFI_RSSI_LEVEL_1 

level 1

WIFI_RSSI_LEVEL_2 

level 2

WIFI_RSSI_LEVEL_3 

level 3

WIFI_RSSI_LEVEL_4 

level 4


Function Documentation

Gets the connection state.

Deprecated:
Deprecated since 3.0. Use wifi_manager_get_connection_state() instead.
Since :
2.3
Privilege Level:
public
Privilege:
http://tizen.org/privilege/network.get
Parameters:
[out]connection_stateThe connection state
Returns:
0 on success, otherwise negative error value
Return values:
WIFI_ERROR_NONESuccessful
WIFI_ERROR_INVALID_PARAMETERInvalid parameter
WIFI_ERROR_OPERATION_FAILEDOperation failed
WIFI_ERROR_PERMISSION_DENIEDPermission Denied
WIFI_ERROR_NOT_SUPPORTEDNot supported
int wifi_set_background_scan_cb ( wifi_scan_finished_cb  callback,
void *  user_data 
)

Registers the callback called when the background scan is finished periodically.

Deprecated:
Deprecated since 3.0. Use wifi_manager_set_background_scan_cb() instead.
Since :
2.3
Parameters:
[in]callbackThe callback function to be called
[in]user_dataThe user data passed to the callback function
Returns:
0 on success, otherwise negative error value
Return values:
WIFI_ERROR_NONESuccessful
WIFI_ERROR_INVALID_OPERATIONInvalid operation
WIFI_ERROR_INVALID_PARAMETERInvalid parameter
WIFI_ERROR_NOT_SUPPORTEDNot supported

Registers the callback called when the connection state is changed.

Deprecated:
Deprecated since 3.0. Use wifi_manager_set_connection_state_changed_cb() instead.
Since :
2.3
Parameters:
[in]callbackThe callback function to be called
[in]user_dataThe user data passed to the callback function
Returns:
0 on success, otherwise negative error value
Return values:
WIFI_ERROR_NONESuccessful
WIFI_ERROR_INVALID_OPERATIONInvalid operation
WIFI_ERROR_INVALID_PARAMETERInvalid parameter
WIFI_ERROR_NOT_SUPPORTEDNot supported
int wifi_set_device_state_changed_cb ( wifi_device_state_changed_cb  callback,
void *  user_data 
)

Registers the callback called when the device state is changed.

Deprecated:
Deprecated since 3.0. Use wifi_manager_set_device_state_changed_cb() instead.
Since :
2.3
Parameters:
[in]callbackThe callback function to be called
[in]user_dataThe user data passed to the callback function
Returns:
0 on success, otherwise negative error value
Return values:
WIFI_ERROR_NONESuccessful
WIFI_ERROR_INVALID_OPERATIONInvalid operation
WIFI_ERROR_INVALID_PARAMETERInvalid parameter
WIFI_ERROR_NOT_SUPPORTEDNot supported
int wifi_set_rssi_level_changed_cb ( wifi_rssi_level_changed_cb  callback,
void *  user_data 
)

Registers callback called when the RSSI of connected Wi-Fi is changed.

Deprecated:
Deprecated since 3.0. Use wifi_manager_set_rssi_level_changed_cb() instead.
Since :
2.3
Parameters:
[in]callbackThe callback function to be called
[in]user_dataThe user data passed to the callback function
Returns:
0 on success, otherwise negative error value
Return values:
WIFI_ERROR_NONESuccessful
WIFI_ERROR_INVALID_OPERATIONInvalid operation
WIFI_ERROR_INVALID_PARAMETERInvalid parameter
WIFI_ERROR_NOT_SUPPORTEDNot supported

Unregisters the callback called when the scan is finished periodically.

Deprecated:
Deprecated since 3.0. Use wifi_manager_unset_background_scan_cb() instead.
Since :
2.3
Returns:
0 on success, otherwise negative error value
Return values:
WIFI_ERROR_NONESuccessful
WIFI_ERROR_INVALID_OPERATIONInvalid operation
WIFI_ERROR_NOT_SUPPORTEDNot supported

Unregisters the callback called when the connection state is changed.

Deprecated:
Deprecated since 3.0. Use wifi_manager_unset_connection_state_changed_cb() instead.
Since :
2.3
Returns:
0 on success, otherwise negative error value
Return values:
WIFI_ERROR_NONESuccessful
WIFI_ERROR_INVALID_OPERATIONInvalid operation
WIFI_ERROR_NOT_SUPPORTEDNot supported

Unregisters the callback called when the device state is changed.

Deprecated:
Deprecated since 3.0. Use wifi_manager_unset_device_state_changed_cb() instead.
Since :
2.3
Returns:
0 on success, otherwise negative error value
Return values:
WIFI_ERROR_NONESuccessful
WIFI_ERROR_INVALID_OPERATIONInvalid operation
WIFI_ERROR_NOT_SUPPORTEDNot supported

Unregisters callback called when the RSSI of connected Wi-Fi is changed.

Deprecated:
Deprecated since 3.0. Use wifi_manager_unset_rssi_level_changed_cb() instead.
Since :
2.3
Returns:
0 on success, otherwise negative error value
Return values:
WIFI_ERROR_NONESuccessful
WIFI_ERROR_INVALID_OPERATIONInvalid operation
WIFI_ERROR_NOT_SUPPORTEDNot supported