Tizen Native API  4.0
Wi-Fi Monitor

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:

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