Mobile native Wearable native

Wi-Fi

Tizen allows your application to connect to a Wireless Local Area Network (WLAN) and transfer data over the network. The Wi-Fi Manager enables your application to activate and deactivate a local Wi-Fi device, and to connect to a WLAN network in the infrastructure mode.

The main features of the Wi-Fi API include:

  • Wi-Fi device and connection management using the Wi-Fi Manager
  • Access point management

    You can manage the Wi-Fi account and security information.

    The infrastructure mode is used to connect to a wireless local area network (WLAN). The infrastructure mode requires a wireless access point. To connect to a WLAN, a client must be configured to use the same service set identifier (SSID) as the access point.

  • Wi-Fi state monitoring using the Wi-Fi Monitor
Note
You can test the Wi-Fi functionality only on a target device. The Emulator does not support this feature.

Wi-Fi Manager

The Tizen Wi-Fi Manager API (in mobile and wearable applications) provides functions for managing Wi-Fi connection.

Using the Wi-Fi Manager, you can implement features that allow the users of your application to:

  • Activate and deactivate a Wi-Fi device

    You can activate and deactivate a local Wi-Fi device using the wifi_activate() and wifi_deactivate() functions. Both functions have a callback function as the first parameter. The callback function is called after the activation or deactivation is completed. You can use the NULL value, if you want no notifications.

  • Connect to an access point

    You can connect to an access point asynchronously using the wifi_connect() function.

  • Scan the access points

    To scan access points, use the wifi_scan() and wifi_foreach_found_aps() functions.

    The wifi_scan() function starts the scan asynchronously. When the scan is finished, a callback function is called. The wifi_foreach_found_aps() function allows you to get the result of the scan. It also invokes a callback function.

Access Point

The Access Point API (in mobile and wearable applications) provides functions for managing access points (AP). You need to create an AP handle (wifi_ap_h) for using the API functions.

The Access Point API supports the following main features:

  • Creating and destroying an AP handle
  • Getting the network information
  • Getting the security information

The following table lists the network information details you can access with the Network Information API (in mobile and wearable applications).

Table: Network information details
Information Description
Bssid Basic service set identifier
Connection state Connection state
DNS address DNS address
Essid Extended service set identifier
Frequency Frequency (in MHz)
IP address IP address
IP config type Net IP configuration type
Max speed Maximum speed (in Mbps)
Proxy address Proxy address
Proxy type Proxy method type
Rssi Received signal strength indication
Subnet mask Subnet mask

The following table lists the security information details you can access with the Security Information API (in mobile and wearable applications).

Table: Security information details
Information Description
Encryption type Wi-Fi encryption type, used in the infrastructure and ad-hoc mode
Security type Wi-Fi security type
Passphrase required Whether the passphrase is required
WPS supported Whether the WPS (Wi-Fi Protected Setup) is supported

You can also obtain the EAP information listed in the following table.

Table: EAP information details
Information Description
Authentication type Type of EAP phase2 authentication of Wi-Fi
CA certificate EAP CA certificate (valid only if the EAP type is TLS)
Client Certificate EAP client certificate (valid only if the EAP type is TLS)
Passphrase EAP passphrase (valid if the EAP type is PEAP or TTLS)
Private key file EAP private key file (valid only if the EAP type is TLS)
EAP type EAP type of Wi-Fi

Wi-Fi Monitor

The Wi-Fi Monitor API (in mobile and wearable applications) provides functions for monitoring the Wi-Fi connection state.

The Wi-Fi Monitor allows you to get the state of the Wi-Fi connection. The state can be:

  • WIFI_CONNECTION_STATE_FAILURE

    Connection failed.

  • WIFI_CONNECTION_STATE_DISCONNECTED

    Disconnected.

  • WIFI_CONNECTION_STATE_ASSOCIATION

    Association.

  • WIFI_CONNECTION_STATE_CONFIGURATION

    Configuration.

  • WIFI_CONNECTION_STATE_CONNECTED

    Connected.

The Wi-Fi Monitor also allows monitoring the changes in Wi-Fi. With the Wi-Fi Monitor, you can register callback functions, which notify you when Wi-Fi properties change. The property changes resulting in notifications are listed in the following table.

Table: Property changes
Change in Description
Connection state The callback is called when the connection state is changed.
Device state The callback is called when the device state changes.
RSSI level The callback is called when the RSSI of the connected Wi-Fi changes.
Go to top