Wi-Fi Direct MAC Address length.

Since :

5.0

Wi-Fi Direct Device Name maximum length.

Since :

5.0

Called when IP address of client is assigned when your device is the group owner.

The following error codes can be delivered WIFI_DIRECT_ERROR_NONE WIFI_DIRECT_ERROR_OPERATION_FAILED WIFI_DIRECT_ERROR_NOT_PERMITTED

Since :

2.3

Remarks:

The mac_address can be used only in the callback. To use outside, make a copy. The ip_address can be used only in the callback. To use outside, make a copy. The interface_address can be used only in the callback. To use outside, make a copy.

Parameters:

[in]	mac_address	The MAC address of connection peer
[in]	ip_address	The IP address of connection peer
[in]	interface_address	The interface address of connection peer
[in]	user_data	The user data passed from the callback registration function

Precondition:

This callback will be invoked in the thread-default main context of the thread from which you registered this callback using wifi_direct_set_client_ip_address_assigned_cb().

See also:

wifi_direct_set_client_ip_address_assigned_cb()

wifi_direct_unset_client_ip_address_assigned_cb()

Called repeatedly when you get the information of connected peers.

Since :

2.3

Remarks:

peer is valid only in this function.

Parameters:

[in]	peer	The information of discovered peer
[in]	user_data	The user data passed from foreach function

Returns:

true to continue with the next iteration of the loop, false to break out of the loop

See also:

wifi_direct_foreach_connected_peers()

Called when the state of connection is changed.

The following error codes can be delivered WIFI_DIRECT_ERROR_NONE WIFI_DIRECT_ERROR_OPERATION_FAILED WIFI_DIRECT_ERROR_NOT_PERMITTED WIFI_DIRECT_ERROR_CONNECTION_FAILED

Since :

2.3

Remarks:

The mac_address can be used only in the callback. To use outside, make a copy.

Parameters:

[in]	error_code	The error code
[in]	connection_state	The connection state
[in]	mac_address	The MAC address of the connection peer
[in]	user_data	The user data passed from the callback registration function

Precondition:

wifi_direct_create_group(), wifi_direct_destroy_group(), wifi_direct_connect(), wifi_direct_disconnect() or wifi_direct_disconnect_all() will invoke this callback in the thread-default main context of the thread from which you registered this callback using using wifi_direct_set_connection_state_changed_cb().

See also:

wifi_direct_connect()

wifi_direct_disconnect()

wifi_direct_disconnect_all()

wifi_direct_set_connection_state_changed_cb()

wifi_direct_unset_connection_state_changed_cb()

Called when the state of device is changed.

The following error codes can be delivered WIFI_DIRECT_ERROR_NONE WIFI_DIRECT_ERROR_OPERATION_FAILED WIFI_DIRECT_ERROR_NOT_PERMITTED

Since :

2.3

Parameters:

[in]	error_code	The error code
[in]	device_state	The device state
[in]	user_data	The user data passed from the callback registration function

Precondition:

Either wifi_direct_activate() or wifi_direct_deactivate() will invoke this callback in the thread-default main context of the thread from which you registered this callback using wifi_direct_set_device_state_changed_cb().

See also:

wifi_direct_activate()

wifi_direct_deactivate()

wifi_direct_set_device_state_changed_cb()

wifi_direct_unset_device_state_changed_cb()

Called repeatedly when you get the information of discovered peers.

Since :

2.3

Remarks:

peer is valid only in this function.

Parameters:

[in]	peer	The information of the discovered peer
[in]	user_data	The user data passed from foreach function

Returns:

true to continue with the next iteration of the loop, false to break out of the loop

See also:

wifi_direct_foreach_discovered_peers()

Called when the state of discovery is changed.

The following error codes can be delivered WIFI_DIRECT_ERROR_NONE WIFI_DIRECT_ERROR_OPERATION_FAILED WIFI_DIRECT_ERROR_NOT_PERMITTED

Since :

2.3

Parameters:

[in]	error_code	The error code
[in]	discovery_state	The discovery state
[in]	user_data	The user data passed from the callback registration function

Precondition:

Either wifi_direct_start_discovery() or wifi_direct_cancel_discovery() will invoke this callback in the thread-default main context of the thread from which you registered this callback using wifi_direct_set_discovery_state_changed_cb().

See also:

wifi_direct_start_discovery()

wifi_direct_cancel_discovery()

wifi_direct_set_discovery_state_changed_cb()

wifi_direct_unset_discovery_state_changed_cb()

Called when the peer is found.

The following error codes can be delivered WIFI_DIRECT_ERROR_NONE WIFI_DIRECT_ERROR_OPERATION_FAILED WIFI_DIRECT_ERROR_NOT_PERMITTED

Since :

2.3

Remarks:

The mac_address can be used only in the callback. To use outside, make a copy.

Parameters:

[in]	error_code	The error code
[in]	discovery_state	The discovery state
[in]	mac_address	The MAC address of found peer
[in]	user_data	The user data passed from the callback registration function

Precondition:

Either wifi_direct_start_discovery() or wifi_direct_cancel_discovery() will invoke this callback in the thread-default main context of the thread from which you registered this callback using wifi_direct_set_peer_found_cb().

See also:

wifi_direct_start_discovery()

wifi_direct_cancel_discovery()

wifi_direct_set_peer_found_cb()

wifi_direct_unset_peer_found_cb()

Called when the state of connection is changed.

The following error codes can be delivered:
WIFI_DIRECT_ERROR_NONE
WIFI_DIRECT_ERROR_OPERATION_FAILED
WIFI_DIRECT_ERROR_NOT_PERMITTED

Since :

5.0

Parameters:

[in]	error_code	The error code
[in]	connection_state	The connection state
[in]	data_s	The structure for peer data
[in]	user_data	The user data passed from the callback registration function

Precondition:

wifi_direct_create_group(), wifi_direct_destroy_group(), wifi_direct_connect(), wifi_direct_disconnect() or wifi_direct_disconnect_all() will invoke this callback if you register this callback using wifi_direct_set_peer_info_connection_state_changed_cb().

See also:

wifi_direct_connect()

wifi_direct_disconnect()

wifi_direct_disconnect_all()

wifi_direct_set_peer_info_connection_state_changed_cb()

wifi_direct_unset_peer_info_connection_state_changed_cb()

Called when you get the persistent groups repeatedly.

Since :

2.3

Remarks:

The mac_address can be used only in the callback. To use outside, make a copy. The ssid can be used only in the callback. To use outside, make a copy.

Parameters:

[in]	mac_address	The MAC address of the persistent group owner
[in]	ssid	The SSID (Service Set Identifier) of the persistent group owner
[in]	user_data	The user data passed from the request function

Returns:

true to continue with the next iteration of the loop,
false to break out of the loop

Precondition:

wifi_direct_foreach_persistent_groups() will invoke this callback.

See also:

wifi_direct_foreach_persistent_groups()

Called when the state of Service discovery is changed.

The following error codes can be delivered WIFI_DIRECT_ERROR_NONE WIFI_DIRECT_ERROR_OPERATION_FAILED WIFI_DIRECT_ERROR_NOT_PERMITTED

Since :

2.3

Remarks:

The mac_address can be used only in the callback. To use outside, make a copy.

Parameters:

[in]	error_code	The error code
[in]	service_state	The service discovery state
[in]	service_type	Specifies the types of service
[in]	response_data	Received response
[in]	mac_address	The MAC address of the connection peer
[in]	user_data	User can transfer the user specific data in callback

Precondition:

Either wifi_direct_start_service_discovery() or wifi_direct_cancel_service_discovery() will invoke this callback in the thread-default main context of the thread from which you registered this callback using wifi_direct_set_service_state_changed_cb().

See also:

wifi_direct_start_discovery()

wifi_direct_cancel_discovery()

wifi_direct_set_discovery_state_changed_cb()

wifi_direct_unset_discovery_state_changed_cb()

Called when the state of Wi-FI Direct is changed.

Since :

3.0

Parameters:

[in]	state	The Wi-Fi Direct state
[in]	user_data	The user data passed from the callback registration function

Precondition:

Changes in Wi-Fi Direct state will invoke this callback if you register this callback using wifi_direct_set_state_changed_cb().

See also:

wifi_direct_set_state_changed_cb()

wifi_direct_unset_state_changed_cb()

Called when you get the supported WPS (Wi-Fi Protected Setup) type repeatedly.

Since :

2.3

Parameters:

[in]	type	The type of WPS
[in]	user_data	The user data passed from the request function

Returns:

true to continue with the next iteration of the loop,
false to break out of the loop

Precondition:

wifi_direct_foreach_supported_wps_types() will invoke this callback.

See also:

wifi_direct_foreach_supported_wps_types()

Enumeration for WPS Config Method type.

Since :

5.0

Enumerator:

WIFI_DIRECT_CONFIG_METHOD_DEFAULT	Use default config method
WIFI_DIRECT_CONFIG_METHOD_PBC	Push Button Configuration
WIFI_DIRECT_CONFIG_METHOD_PIN_DISPLAY	Display PIN code
WIFI_DIRECT_CONFIG_METHOD_PIN_KEYPAD	Provide the keypad to input the PIN

Enumeration for Wi-Fi Direct connection state.

Since :

2.3

See also:

wifi_direct_connection_state_changed_cb()

Enumerator:

WIFI_DIRECT_CONNECTION_REQ	Connection is requested
WIFI_DIRECT_CONNECTION_WPS_REQ	WPS is requested
WIFI_DIRECT_CONNECTION_IN_PROGRESS	Connection in progress
WIFI_DIRECT_CONNECTION_RSP	Connection response
WIFI_DIRECT_DISASSOCIATION_IND	Disconnected by remote Group Client
WIFI_DIRECT_DISCONNECTION_RSP	Disconnected by local device
WIFI_DIRECT_DISCONNECTION_IND	Disconnected by remote Group Owner
WIFI_DIRECT_GROUP_CREATED	Group is created
WIFI_DIRECT_GROUP_DESTROYED	Group is destroyed

Enumeration for Wi-Fi Direct device state.

Since :

2.3

See also:

wifi_direct_device_state_changed_cb()

Enumerator:

WIFI_DIRECT_DEVICE_STATE_ACTIVATED	Activated
WIFI_DIRECT_DEVICE_STATE_DEACTIVATED	Deactivated

Enumeration for Wi-Fi Direct Discovery Channel.

Since :

2.3

See also:

wifi_direct_start_discovery_specific_channel()

Enumerator:

WIFI_DIRECT_DISCOVERY_FULL_SCAN	Scan full channel
WIFI_DIRECT_DISCOVERY_SOCIAL_CHANNEL	Scan social channel
WIFI_DIRECT_DISCOVERY_CHANNEL1	Scan channel 1
WIFI_DIRECT_DISCOVERY_CHANNEL6	Scan channel 6
WIFI_DIRECT_DISCOVERY_CHANNEL11	Scan channel 11

Enumeration for Wi-Fi Direct discovery state.

Since :

2.3

See also:

wifi_direct_discovery_state_changed_cb()

wifi_direct_peer_found_cb()

Enumerator:

WIFI_DIRECT_ONLY_LISTEN_STARTED	Only listen started
WIFI_DIRECT_DISCOVERY_STARTED	Discovery started
WIFI_DIRECT_DISCOVERY_FOUND	A remote peer is found
WIFI_DIRECT_DISCOVERY_FINISHED	Discovery finished
WIFI_DIRECT_DISCOVERY_LOST	A remote peer is lost (Since 3.0)

Enumeration for Wi-Fi Display device type.

Since :

2.4

See also:

wifi_direct_set_display()

wifi_direct_get_peer_display_type()

Enumerator:

WIFI_DIRECT_DISPLAY_TYPE_SOURCE	Configure as WFD Source
WIFI_DIRECT_DISPLAY_TYPE_PRISINK	Configure as WFD Primary Sink
WIFI_DIRECT_DISPLAY_TYPE_SECSINK	Configure as WFD Secondary Sink
WIFI_DIRECT_DISPLAY_TYPE_DUAL	Configure as WFD Dual Role
WIFI_DIRECT_DISPLAY_TYPE_MAX	Not configured

Enumeration for Wi-Fi Direct error code.

Since :

2.3

Enumerator:

WIFI_DIRECT_ERROR_NONE	Successful
WIFI_DIRECT_ERROR_NOT_PERMITTED	Operation not permitted(1)
WIFI_DIRECT_ERROR_OUT_OF_MEMORY	Out of memory(12)
WIFI_DIRECT_ERROR_PERMISSION_DENIED	Permission denied(13)
WIFI_DIRECT_ERROR_RESOURCE_BUSY	Device or resource busy(16)
WIFI_DIRECT_ERROR_INVALID_PARAMETER	Invalid function parameter(22)
WIFI_DIRECT_ERROR_CONNECTION_TIME_OUT	Connection timed out(110)
WIFI_DIRECT_ERROR_NOT_SUPPORTED	Not supported
WIFI_DIRECT_ERROR_NOT_INITIALIZED	Not initialized
WIFI_DIRECT_ERROR_COMMUNICATION_FAILED	I/O error
WIFI_DIRECT_ERROR_WIFI_USED	WiFi is being used
WIFI_DIRECT_ERROR_MOBILE_AP_USED	Mobile AP is being used
WIFI_DIRECT_ERROR_CONNECTION_FAILED	Connection failed
WIFI_DIRECT_ERROR_AUTH_FAILED	Authentication failed
WIFI_DIRECT_ERROR_OPERATION_FAILED	Operation failed
WIFI_DIRECT_ERROR_TOO_MANY_CLIENT	Too many client
WIFI_DIRECT_ERROR_ALREADY_INITIALIZED	Already initialized client
WIFI_DIRECT_ERROR_CONNECTION_CANCELED	Connection canceled by local device

Enumeration for Wi-Fi Direct primary device type.

Since :

2.3

See also:

wifi_direct_get_primary_device_type()

Enumerator:

WIFI_DIRECT_PRIMARY_DEVICE_TYPE_COMPUTER	Computer
WIFI_DIRECT_PRIMARY_DEVICE_TYPE_INPUT_DEVICE	Input device
WIFI_DIRECT_PRIMARY_DEVICE_TYPE_PRINTER	Printer
WIFI_DIRECT_PRIMARY_DEVICE_TYPE_CAMERA	Camera
WIFI_DIRECT_PRIMARY_DEVICE_TYPE_STORAGE	Storage
WIFI_DIRECT_PRIMARY_DEVICE_TYPE_NETWORK_INFRA	Network Infrastructure
WIFI_DIRECT_PRIMARY_DEVICE_TYPE_DISPLAY	Display
WIFI_DIRECT_PRIMARY_DEVICE_TYPE_MULTIMEDIA_DEVICE	Multimedia device
WIFI_DIRECT_PRIMARY_DEVICE_TYPE_GAME_DEVICE	Game device
WIFI_DIRECT_PRIMARY_DEVICE_TYPE_TELEPHONE	Telephone
WIFI_DIRECT_PRIMARY_DEVICE_TYPE_AUDIO	Audio
WIFI_DIRECT_PRIMARY_DEVICE_TYPE_OTHER	Others

Enumeration for Wi-Fi Direct secondary device type.

Since :

2.3

See also:

wifi_direct_get_secondary_device_type()

Enumerator:

WIFI_DIRECT_SECONDARY_DEVICE_TYPE_COMPUTER_PC	PC
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_COMPUTER_SERVER	Server
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_COMPUTER_MEDIA_CENTER	Media Center
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_COMPUTER_UMPC	UMPC
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_COMPUTER_NOTEBOOK	Notebook
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_COMPUTER_DESKTOP	Desktop
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_COMPUTER_MID	MID
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_COMPUTER_NETBOOK	Netbook
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_INPUT_KEYBOARD	Keyboard
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_INPUT_MOUSE	Mouse
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_INPUT_JOYSTICK	Joystick
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_INPUT_TRACKBALL	Trackball
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_INPUT_CONTROLLER	Controller
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_INPUT_REMOTE	Remote
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_INPUT_TOUCHSCREEN	Touchscreen
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_INPUT_BIOMETRIC_READER	Biometric reader
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_INPUT_BARCODE_READER	Barcode reader
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_PRINTER_PRINTER	Printer
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_PRINTER_SCANNER	Scanner
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_PRINTER_FAX	Fax
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_PRINTER_COPIER	Copier
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_PRINTER_ALL_IN_ONE	All-in-one
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_CAMERA_DIGITAL_STILL	Digital still camera
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_CAMERA_VIDEO	Video camera
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_CAMERA_WEBCAM	Webcam
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_CAMERA_SECURITY	Security camera
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_STORAGE_NAS	NAS
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_NETWORK_INFRA_AP	AP
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_NETWORK_INFRA_ROUTER	Router
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_NETWORK_INFRA_SWITCH	Switch
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_NETWORK_INFRA_GATEWAY	Gateway
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_DISPLAY_TV	TV
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_DISPLAY_PIC_FRAME	Picture frame
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_DISPLAY_PROJECTOR	Projector
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_DISPLAY_MONITOR	Monitor
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_MULTIMEDIA_DAR	DAR
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_MULTIMEDIA_PVR	PVR
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_MULTIMEDIA_MCX	MCX
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_MULTIMEDIA_STB	Set-top box
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_MULTIMEDIA_MS_MA_ME	Media Server / Media Adapter / Media Extender
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_MULTIMEDIA_PVP	Portable video player
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_GAME_XBOX	Xbox
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_GAME_XBOX_360	Xbox 360
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_GAME_PS	Playstation
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_GAME_CONSOLE	Console
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_GAME_PORTABLE	Portable
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_TELEPHONE_WINDOWS_MOBILE	Windows Mobile
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_TELEPHONE_PHONE_SINGLE	Phone - single mode
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_TELEPHONE_PHONE_DUAL	Phone - dual mode
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_TELEPHONE_SMARTPHONE_SINGLE	Smart Phone - single mode
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_TELEPHONE_SMARTPHONE_DUAL	Smart Phone - dual mode
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_AUDIO_TUNER	Tuner
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_AUDIO_SPEAKER	Speaker
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_AUDIO_PMP	Portable Music Player
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_AUDIO_HEADSET	Headset
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_AUDIO_HEADPHONE	Headphone
WIFI_DIRECT_SECONDARY_DEVICE_TYPE_AUDIO_MIC	Microphone

Enumeration for Wi-Fi Direct service Discovery state.

Since :

2.3

See also:

wifi_direct_service_state_changed_cb()

Enumerator:

WIFI_DIRECT_SERVICE_DISCOVERY_STARTED	Service discovery started
WIFI_DIRECT_SERVICE_DISCOVERY_FOUND	Service discovery found
WIFI_DIRECT_SERVICE_DISCOVERY_FINISHED	Service discovery finished

Enumeration for Service Discovery type.

Since :

2.3

See also:

wifi_direct_service_state_changed_cb()

wifi_direct_start_service_discovery()

wifi_direct_cancel_service_discovery()

wifi_direct_register_service()

Enumerator:

WIFI_DIRECT_SERVICE_TYPE_ALL	Service discovery type all
WIFI_DIRECT_SERVICE_TYPE_BONJOUR	Service discovery type bonjour
WIFI_DIRECT_SERVICE_TYPE_UPNP	Service discovery type UPNP
WIFI_DIRECT_SERVICE_TYPE_WS_DISCOVERY	Service discovery type ws discovery
WIFI_DIRECT_SERVICE_TYPE_WIFI_DISPLAY	Service discovery type wifi-display
WIFI_DIRECT_SERVICE_TYPE_BT_ADDR	Service discovery type bt address
WIFI_DIRECT_SERVICE_TYPE_CONTACT_INFO	Service discovery type contact info
WIFI_DIRECT_SERVICE_TYPE_VENDOR	Service discovery type vendor-specific

Enumeration for Wi-Fi Direct link status.

Since :

2.3

See also:

wifi_direct_state_changed_cb()

wifi_direct_get_state()

Enumerator:

WIFI_DIRECT_STATE_DEACTIVATED	Deactivated
WIFI_DIRECT_STATE_DEACTIVATING	Deactivating
WIFI_DIRECT_STATE_ACTIVATING	Activating
WIFI_DIRECT_STATE_ACTIVATED	Activated
WIFI_DIRECT_STATE_DISCOVERING	Discovering
WIFI_DIRECT_STATE_CONNECTING	Connecting
WIFI_DIRECT_STATE_DISCONNECTING	Disconnecting
WIFI_DIRECT_STATE_CONNECTED	Connected
WIFI_DIRECT_STATE_GROUP_OWNER	Group owner

Enumeration for Wi-Fi Frame type.

Since :

4.0

See also:

wifi_direct_add_vsie()

wifi_direct_remove_vsie()

wifi_direct_get_vsie()

Enumerator:

WIFI_DIRECT_VSIE_FRAME_P2P_PROBE_REQ	P2P probe request frame
WIFI_DIRECT_VSIE_FRAME_P2P_PROBE_RESP	P2P probe response frame
WIFI_DIRECT_VSIE_FRAME_P2P_GO_PROBE_RESP	P2P group owner probe response frame
WIFI_DIRECT_VSIE_FRAME_P2P_GO_BEACON	P2P probe request frame
WIFI_DIRECT_VSIE_FRAME_P2P_PD_REQ	P2P provision discovery request frame
WIFI_DIRECT_VSIE_FRAME_P2P_PD_RESP	P2P provision discovery response frame
WIFI_DIRECT_VSIE_FRAME_P2P_GO_NEG_REQ	P2P probe request frame
WIFI_DIRECT_VSIE_FRAME_P2P_GO_NEG_RESP	P2P group owner negotiation response frame
WIFI_DIRECT_VSIE_FRAME_P2P_GO_NEG_CONF	P2P group owner negotiation confirmation frame
WIFI_DIRECT_VSIE_FRAME_P2P_INV_REQ	P2P invitation request frame
WIFI_DIRECT_VSIE_FRAME_P2P_INV_RESP	P2P invitation response frame
WIFI_DIRECT_VSIE_FRAME_P2P_ASSOC_REQ	P2P association request frame
WIFI_DIRECT_VSIE_FRAME_P2P_ASSOC_RESP	P2P association response frame
WIFI_DIRECT_VSIE_FRAME_ASSOC_REQ	Association request frame

Enumeration for Wi-Fi WPS type.

Since :

2.3

See also:

wifi_direct_supported_wps_type_cb()

wifi_direct_get_local_wps_type()

wifi_direct_set_req_wps_type()

wifi_direct_get_req_wps_type()

Enumerator:

WIFI_DIRECT_WPS_TYPE_NONE	No WPS type
WIFI_DIRECT_WPS_TYPE_PBC	Push Button Configuration
WIFI_DIRECT_WPS_TYPE_PIN_DISPLAY	Display PIN code
WIFI_DIRECT_WPS_TYPE_PIN_KEYPAD	Provide the keypad to input the PIN

Enumeration for Wi-Fi Display device type.

Deprecated:

Deprecated since 5.0. Use wifi_direct_display_type_e instead.

Since :

2.3

Enumerator:

WIFI_DISPLAY_TYPE_NONE	Configure as WFD Source
WIFI_DISPLAY_TYPE_SINK	Configure as WFD Primary Sink
WIFI_DISPLAY_TYPE_SRC	Configure as WFD Secondary Sink
WIFI_DISPLAY_TYPE_DUAL	Configure as WFD Dual Role
WIFI_DISPLAY_TYPE_MAX	Not configured

Activates the Wi-Fi Direct service, asynchronously.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/wifidirect

Returns:

0 on success, otherwise a negative error value

Return values:

WIFI_DIRECT_ERROR_NONE	Successful
WIFI_DIRECT_ERROR_OPERATION_FAILED	Operation failed
WIFI_DIRECT_ERROR_COMMUNICATION_FAILED	Communication failed
WIFI_DIRECT_ERROR_PERMISSION_DENIED	Permission denied
WIFI_DIRECT_ERROR_NOT_PERMITTED	Operation not permitted
WIFI_DIRECT_ERROR_NOT_SUPPORTED	Not supported
WIFI_DIRECT_ERROR_NOT_INITIALIZED	Not initialized
WIFI_DIRECT_ERROR_RESOURCE_BUSY	Device or resource busy
WIFI_DIRECT_ERROR_WIFI_USED	Wi-Fi is being used
WIFI_DIRECT_ERROR_MOBILE_AP_USED	Mobile AP is being used

Precondition:

Wi-Fi Direct service must be initialized by wifi_direct_initialize().

Postcondition:

wifi_direct_device_state_changed_cb() will be invoked.

See also:

wifi_direct_initialize()

wifi_direct_deactivate()

wifi_direct_device_state_changed_cb()

Here is an example of the usage:

 #include <stdio.h>
 #include <wifi_direct.h>


 int function(void)
 {
    int ret;

    ret = wifi_direct_activate(); // Activate Wi-Fi Direct

    if (ret != WIFI_DIRECT_ERROR_NONE) {
        printf("Failed to activate Wi-Fi Direct\n");
        return -1;
    }

    printf("Wi-Fi Direct Activated\n");
    return 0;
 }

 int main()
 {
    wifi_direct_initialize(); // Initialize Wi-Fi Direct
    function();
    wifi_direct_deactivate(); // deactivate Wi-Fi Direct
    wifi_direct_deinitialize(); // Deinitialize Wi-Fi Direct
    return 0;
 }

Sets the WPS config PBC as preferred method for connection.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/wifidirect

Returns:

0 on success, otherwise a negative error value

Return values:

WIFI_DIRECT_ERROR_NONE	Successful
WIFI_DIRECT_ERROR_OPERATION_FAILED	Operation failed
WIFI_DIRECT_ERROR_COMMUNICATION_FAILED	Communication failed
WIFI_DIRECT_ERROR_PERMISSION_DENIED	Permission denied
WIFI_DIRECT_ERROR_NOT_PERMITTED	Operation not permitted
WIFI_DIRECT_ERROR_NOT_SUPPORTED	Not supported
WIFI_DIRECT_ERROR_NOT_INITIALIZED	Not initialized
WIFI_DIRECT_ERROR_RESOURCE_BUSY	Device or resource busy

Precondition:

Wi-Fi Direct service must be activated by wifi_direct_activate().

See also:

wifi_direct_activate()

Here is an example of the usage:

 #include <stdio.h>
 #include <wifi_direct.h>

 int function(void)
 {
    int ret;

    ret = wifi_direct_activate_pushbutton(); // Activate WPS PBC Push Button

    if (ret != WIFI_DIRECT_ERROR_NONE) {
        printf("Failed to activate push button\n");
        return -1;
    }

    printf("Push button Activated successfully\n");

    return 0;
 }

 int main()
 {
    wifi_direct_initialize(); // Initialize Wi-Fi Direct
    wifi_direct_activate(); // Activate Wi-Fi Direct

    function();

    //       APP CODE HERE

    // App must clean up Wi-Fi Direct before exiting

    wifi_direct_deactivate(); // Deactivate Wi-Fi Direct
    wifi_direct_deinitialize(); // Deinitialize Wi-Fi Direct
    return 0;
 }

Adds the Wi-Fi Vendor Specific Information Element (VSIE) to specific frame type.

Since :

4.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/wifidirect

Remarks:

vsie_str for frame_id will be in effect until Wi-Fi Direct is deactivated.

Parameters:

[in]	frame_id	frame ID for setting VSIE
[in]	vsie_str	VSIE data

Returns:

0 on success, otherwise a negative error value

Return values:

WIFI_DIRECT_ERROR_NONE	Successful
WIFI_DIRECT_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_DIRECT_ERROR_OPERATION_FAILED	Operation failed
WIFI_DIRECT_ERROR_COMMUNICATION_FAILED	Communication failed
WIFI_DIRECT_ERROR_PERMISSION_DENIED	Permission denied
WIFI_DIRECT_ERROR_NOT_PERMITTED	Operation not permitted
WIFI_DIRECT_ERROR_NOT_SUPPORTED	Not supported
WIFI_DIRECT_ERROR_NOT_INITIALIZED	Not initialized
WIFI_DIRECT_ERROR_RESOURCE_BUSY	Device or resource busy

Precondition:

Wi-Fi Direct service must be activated by wifi_direct_activate().

See also:

wifi_direct_activate()

wifi_direct_remove_vsie()

wifi_direct_get_vsie()

Here is an example of the usage:

 #include <stdio.h>
 #include <wifi_direct.h>


 int function(void)
 {
    int ret;
    char *vsie = NULL;
    unsigned int frame_id;

    printf("Input the frame id\n");
    scanf("%2u", &frame_id);

    printf("Input the vsie\n");
    scanf("%100ms", &vsie);

    ret = wifi_direct_add_vsie(frame_id, vsie); // add vsie

    if (ret != WIFI_DIRECT_ERROR_NONE) {
        printf("Failed to add vsie\n");
        return -1;
    }

    printf("vsie added success");
    free(vsie);
    return 0;
 }

 int main()
 {
    wifi_direct_initialize(); // Initialize Wi-Fi Direct
    wifi_direct_activate(); // Activate Wi-Fi Direct

    function();

    //       APP CODE HERE

    // App must clean up Wi-Fi Direct before exiting

    wifi_direct_deactivate(); // Deactivate Wi-Fi Direct
    wifi_direct_deinitialize(); // Deinitialize Wi-Fi Direct
    return 0;
 }

Cancels the connection now in progress.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/wifidirect

Parameters:

[in]

mac_address

The MAC address of rejected device

Returns:

0 on success, otherwise a negative error value

Return values:

WIFI_DIRECT_ERROR_NONE	Successful
WIFI_DIRECT_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_DIRECT_ERROR_OPERATION_FAILED	Operation failed
WIFI_DIRECT_ERROR_COMMUNICATION_FAILED	Communication failed
WIFI_DIRECT_ERROR_PERMISSION_DENIED	Permission denied
WIFI_DIRECT_ERROR_NOT_PERMITTED	Operation not permitted
WIFI_DIRECT_ERROR_NOT_SUPPORTED	Not supported
WIFI_DIRECT_ERROR_NOT_INITIALIZED	Not initialized
WIFI_DIRECT_ERROR_RESOURCE_BUSY	Device or resource busy

Here is an example of the usage:

 #include <stdio.h>
 #include <wifi_direct.h>

 bool peer_selected = false;
 int connection_timeout = 0;
 int count = 0; // counter to wait for connection

 int function(char *mac);

 gboolean connection_timeout_cb(gpointer data)
 {
    char *mac = (char *)data;

    if (count < 3) {
        count++;
        return TRUE;
    }

    function(mac); // cancel ongoing connection
    g_free(mac);
    return FALSE;
 }

 void peers_cb(wifi_direct_discovered_peer_info_s* peer,
                                           void *user_data)
 {
    char *mac;

    if (peer && !peer_selected) {
        printf("peer device=%s MAC=%s\n", peer->device_name, peer->mac_address);

        mac = g_strdup(peer->mac_address);
        peer_selected = true;

        wifi_direct_connect(mac); // Connect to the selected peer
        connection_timeout = g_timeout_add(1000,
                                         connection_timeout_cb,
                                         mac); // Add 3secs timeout
    }
 }

 int function(char *mac)
 {
    int ret;

    ret = wifi_direct_cancel_connection(mac); // cancel connection

 if (ret != WIFI_DIRECT_ERROR_NONE) {
        printf("Failed to cancel the ongoing connection\n");
        return -1;
    }

    return 0;
 }

 void callback_2(int error_code,
                 wifi_direct_connection_state_e state,
                 const char *mac, void *user_data)
 *{
    switch (state) {
    case WIFI_DIRECT_CONNECTION_IN_PROGRESS:
        printf("Connection in progress\n");
    break;

    case WIFI_DIRECT_CONNECTON_RSP:
        printf("Connected\n");
        g_source_remove(connection_timeout);
    break;

    case WIFI_DIRECT_DISCONNECTION_IND:
        printf("Disconnection IND\n");
    break;

    case WIFI_DIRECT_DISCONNECTION_RSP;
        printf("Disconnected\n");
    break;
 }
 *}

 void callback_1(int error_code,
               wifi_direct_discovery_state_e discovery_state,
               void *user_data)
 {
    switch(discovery_state) {
    case WIFI_DIRECT_DISCOVERY_STARTED:
        printf("Discovery started\n");
    break;

    case WIFI_DIRECT_ONLY_LISTEN_STARTED:
        printf("listen started\n");
    break;

    case WIFI_DIRECT_DISCOVERY_FINISHED:
        printf("Discovery finished\n");

    wifi_direct_foreach_discovered_peers(peers_cb,
                                        NULL); // Get discovered peer
    break;

    case WIFI_DIRECT_DISCOVERY_FOUND:
        printf("peer devices found\n");
    break;

    case WIFI_DIRECT_DISCOVERY_LOST:
        printf("Discovery lost\n");
    break;

    default:
    break;
    }
 }

 int main()
 {
    wifi_direct_initialize(); // Initialize Wi-Fi Direct
    wifi_direct_set_discovery_state_changed_cb(callback_1, NULL); // Register callback 1
    wifi_direct_set_connection_state_changed_cb(callback_2, NULL); // Register callback 2

    wifi_direct_activate(); // Activate Wi-Fi Direct
    wifi_direct_start_discovery(TRUE, 15); // Start discovery

    // App must clean up Wi-Fi Direct before exiting

    wifi_direct_deactivate(); // Deactivate Wi-Fi Direct
    wifi_direct_unset_connection_state_changed_cb(); // Deregister callback 2
    wifi_direct_unset_discovery_state_changed_cb(); // Deregister callback 1
    wifi_direct_deinitialize(); // Deinitialize Wi-Fi Direct
    return 0;
 }

Cancels discovery process, asynchronously.

This function stops all discovery processes started with wifi_direct_start_discovery() functions.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/wifidirect

Returns:

0 on success, otherwise a negative error value

Return values:

WIFI_DIRECT_ERROR_NONE	Successful
WIFI_DIRECT_ERROR_OPERATION_FAILED	Operation failed
WIFI_DIRECT_ERROR_COMMUNICATION_FAILED	Communication failed
WIFI_DIRECT_ERROR_PERMISSION_DENIED	Permission denied
WIFI_DIRECT_ERROR_NOT_PERMITTED	Operation not permitted
WIFI_DIRECT_ERROR_NOT_SUPPORTED	Not supported
WIFI_DIRECT_ERROR_NOT_INITIALIZED	Not initialized
WIFI_DIRECT_ERROR_RESOURCE_BUSY	Device or resource busy

Precondition:

Discovery must be started by wifi_direct_start_discovery().

Postcondition:

wifi_direct_discovery_state_changed_cb() will be invoked.

See also:

wifi_direct_start_discovery()

wifi_direct_start_discovery_specific_channel()

wifi_direct_start_discovery_specific_freq()

wifi_direct_discovery_state_changed_cb()

Here is an example of the usage:

 #include <stdio.h>
 #include <wifi_direct.h>


 void callback(int error_code,
               wifi_direct_discovery_state_e discovery_state,
               void *user_data)
 {
    switch(discovery_state) {
    case WIFI_DIRECT_DISCOVERY_STARTED:
        printf("Discovery started\n");
        break;

    case WIFI_DIRECT_ONLY_LISTEN_STARTED:
        printf("listen started\n");
        break;

    case WIFI_DIRECT_DISCOVERY_FINISHED:
        printf("Discovery finished\n");
        break;

    case WIFI_DIRECT_DISCOVERY_FOUND:
        printf("peer devices found\n");
        break;

    case WIFI_DIRECT_DISCOVERY_LOST:
        printf("Discovery lost\n");
        break;

    default:
    break;
    }
 }

 int function(void)
 {
    int ret;

    ret = wifi_direct_cancel_discovery(); // Cancel ongoing discovery

 if (ret != WIFI_DIRECT_ERROR_NONE) {
        printf("Failed to cancel discovery\n");
        return -1;
    }

    return 0;
 }

 int main()
 {
    wifi_direct_initialize(); // Initialize Wi-Fi Direct
    wifi_direct_set_discovery_state_changed_cb(callback, NULL); // Register callback
    wifi_direct_activate(); // Activate Wi-Fi Direct
    wifi_direct_start_discovery(TRUE, 15); // Start discovery

    function();

    wifi_direct_deactivate(); // Deactivate Wi-Fi Direct
    wifi_direct_unset_discovery_state_changed_cb(); // Deregister callback
    wifi_direct_deinitialize(); // Deinitialize Wi-Fi Direct
    return 0;
 }

Cancels an ongoing wifi direct service discovery.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/wifidirect

Parameters:

[in]	mac_address	The MAC address of servicing device. A broadcast will be sent when MAC is SET to ZERO
[in]	service_type	Describes the type of service

Returns:

0 on success, otherwise a negative error value

Return values:

WIFI_DIRECT_ERROR_NONE	Successful
WIFI_DIRECT_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_DIRECT_ERROR_OPERATION_FAILED	Operation failed
WIFI_DIRECT_ERROR_COMMUNICATION_FAILED	Communication failed
WIFI_DIRECT_ERROR_PERMISSION_DENIED	Permission denied
WIFI_DIRECT_ERROR_NOT_PERMITTED	Operation not permitted
WIFI_DIRECT_ERROR_NOT_SUPPORTED	Not supported
WIFI_DIRECT_ERROR_NOT_INITIALIZED	Not initialized
WIFI_DIRECT_ERROR_RESOURCE_BUSY	Device or resource busy

Precondition:

Wi-Fi Direct service must be activated by wifi_direct_activate().

See also:

wifi_direct_activate()

Here is an example of the usage:

 #include <stdio.h>
 #include <wifi_direct.h>

 void callback(int error_code,
       wifi_direct_service_discovery_state_e discovery_state,
       wifi_direct_service_type_e service_type,
       void *response_data, const char * mac_address,
       void *user_data)
 {
    switch (discovery_state) {
    case WIFI_DIRECT_SERVICE_DISCOVERY_STARTED:
        printf("Service discovery started\n");
    break;

    case WIFI_DIRECT_SERVICE_DISCOVERY_FINISHED:
        printf("Service discovery finished\n");
    break;

    case WIFI_DIRECT_SERVICE_DISCOVERY_FOUND:
        printf("Service discovery found\n");
    break;
    }
 }

 int function(void)
 {
    int ret;

    ret = wifi_direct_cancel_service_discovery(NULL,
                             WIFI_DIRECT_SERVICE_TYPE_ALL); // cancel the ongoing service discovery

    if (ret != WIFI_DIRECT_ERROR_NONE) {
        printf("Failed to cancel service discovery\n");
        return -1;
    }

    return 0;
 }

 int main()
 {
    wifi_direct_initialize(); // Initialize Wi-Fi Direct
    wifi_direct_set_service_state_changed_cb(callback, NULL);
    wifi_direct_activate(); // Activate Wi-Fi Direct

    wifi_direct_start_service_discovery(NULL,
                       WIFI_DIRECT_SERVICE_TYPE_ALL); // start broadcast service discovery

    function();

    //       APP CODE HERE

    // App must clean up Wi-Fi Direct before exiting

    wifi_direct_deactivate(); // Deactivate Wi-Fi Direct
    wifi_direct_unset_service_state_changed_cb();
    wifi_direct_deinitialize(); // Deinitialize Wi-Fi Direct
    return 0;
 }

Connects to a specified peer, asynchronously.

This function connects to specified peer by automatically determining whether to perform group formation, join an existing group, invite, re-invoke a group. The decision is based on the current state of the peers (i.e. GO, STA, not connected) and the availability of persistent data.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/wifidirect

Parameters:

[in]

mac_address

The MAC address of remote device

Returns:

0 on success, otherwise a negative error value

Return values:

WIFI_DIRECT_ERROR_NONE	Successful
WIFI_DIRECT_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_DIRECT_ERROR_OPERATION_FAILED	Operation failed
WIFI_DIRECT_ERROR_COMMUNICATION_FAILED	Communication failed
WIFI_DIRECT_ERROR_PERMISSION_DENIED	Permission denied
WIFI_DIRECT_ERROR_NOT_PERMITTED	Operation not permitted
WIFI_DIRECT_ERROR_NOT_SUPPORTED	Not supported
WIFI_DIRECT_ERROR_NOT_INITIALIZED	Not initialized
WIFI_DIRECT_ERROR_TOO_MANY_CLIENT	Too many client
WIFI_DIRECT_ERROR_CONNECTION_TIME_OUT	Connection timed out
WIFI_DIRECT_ERROR_CONNECTION_FAILED	Connection failed
WIFI_DIRECT_ERROR_AUTH_FAILED	Authentication failed

Precondition:

Wi-Fi Direct service must be activated by wifi_direct_activate().

Postcondition:

wifi_direct_connection_state_changed_cb() will be invoked.

See also:

wifi_direct_activate()

wifi_direct_disconnect()

wifi_direct_disconnect_all()

wifi_direct_connection_state_changed_cb()

Here is an example of the usage:

 #include <stdio.h>
 #include <wifi_direct.h>


 bool device_selected = false;

 void peers_cb(wifi_direct_discovered_peer_info_s* peer,
                                           void *user_data)
 {
    if (peer && !device_selected) {
        printf("peer device=%s MAC=%s\n", peer->device_name, peer->mac_address);

        device_selected = true;

        function(peer->mac_address); // Connect to the first discovered peer
    }
 }

 int function(const char *mac)
 {
    int ret;

    ret = wifi_direct_connect(mac); // connect to the peer device

 if (ret != WIFI_DIRECT_ERROR_NONE) {
        printf("Failed to connect the peer\n");
        return -1;
    }

    return 0;
 }

 void callback_2(int error_code,
                 wifi_direct_connection_state_e state,
                 const char *mac, void *user_data)
 *{
    switch (state) {
    case WIFI_DIRECT_CONNECTION_IN_PROGRESS:
        printf("Connection in progress\n");
    break;

    case WIFI_DIRECT_CONNECTION_RSP:
        printf("Connected\n");
    break;

    case WIFI_DIRECT_DISCONNECTION_IND:
        printf("Disconnection IND\n");
    break;

    case WIFI_DIRECT_DISCONNECTION_RSP;
        printf("Disconnected\n");
    break;
    }
 }

 void callback_1(int error_code,
               wifi_direct_discovery_state_e discovery_state,
               void *user_data)
 {
    switch(discovery_state) {
    case WIFI_DIRECT_DISCOVERY_STARTED:
        printf("Discovery started\n");
    break;

    case WIFI_DIRECT_ONLY_LISTEN_STARTED:
        printf("listen started\n");
    break;

    case WIFI_DIRECT_DISCOVERY_FINISHED:
        printf("Discovery finished\n");

    wifi_direct_foreach_discovered_peers(peers_cb,
                                        NULL); // Get discovered peer
    break;

    case WIFI_DIRECT_DISCOVERY_FOUND:
        printf("peer devices found\n");
        break;

    case WIFI_DIRECT_DISCOVERY_LOST:
        printf("Discovery lost\n");
    break;

    default:
    break;
    }
 }

 int main()
 {
    wifi_direct_initialize(); // Initialize Wi-Fi Direct
    wifi_direct_set_discovery_state_changed_cb(callback_1, NULL); // Register callback 1
    wifi_direct_set_connection_state_changed_cb(callback_2, NULL); // Register callback 2

    wifi_direct_activate(); // Activate Wi-Fi Direct
    wifi_direct_start_discovery(TRUE, 15); // Start discovery

    //       APP CODE HERE

    // App must clean up Wi-Fi Direct before exiting

    wifi_direct_deactivate(); // Deactivate Wi-Fi Direct
    wifi_direct_unset_discovery_state_changed_cb(); // Deregister callback
    wifi_direct_deinitialize(); // Deinitialize Wi-Fi Direct
    return 0;
 }

Creates a Wi-Fi Direct Group, asynchronously.

This function sets up device as the Group Owner and waits for clients to connect. In addition, a soft AP will be created, the WPS registrar and the DHCP server will be started.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/wifidirect

Returns:

0 on success, otherwise a negative error value

Return values:

WIFI_DIRECT_ERROR_NONE	Successful
WIFI_DIRECT_ERROR_OPERATION_FAILED	Operation failed
WIFI_DIRECT_ERROR_COMMUNICATION_FAILED	Communication failed
WIFI_DIRECT_ERROR_PERMISSION_DENIED	Permission denied
WIFI_DIRECT_ERROR_NOT_PERMITTED	Operation not permitted
WIFI_DIRECT_ERROR_NOT_SUPPORTED	Not supported
WIFI_DIRECT_ERROR_NOT_INITIALIZED	Not initialized
WIFI_DIRECT_ERROR_RESOURCE_BUSY	Device or resource busy
WIFI_DIRECT_ERROR_AUTH_FAILED	Authentication failed

Precondition:

Wi-Fi Direct service must be activated by wifi_direct_activate().

Postcondition:

wifi_direct_connection_state_changed_cb() will be invoked with WIFI_DIRECT_GROUP_CREATED.

See also:

wifi_direct_activate()

wifi_direct_destroy_group()

wifi_direct_connection_state_changed_cb()

Here is an example of the usage:

 #include <stdio.h>
 #include <wifi_direct.h>

 void callback_1(int error_code,
               wifi_direct_connection_state_e state,
               const char *mac, void *user_data)
 {
    if (state == WIFI_DIRECT_GROUP_CREATED) {
        printf("Group created\n");
    }
 }

 int function(void)
 {
    int res;

    res = wifi_direct_create_group() // create autonomous group

 if (res != WIFI_DIRECT_ERROR_NONE) {
        printf("Failed to create group\n");
        return -1;
 }

    return 0;
 }

 int main()
 {
    wifi_direct_initialize(); // Initialize Wi-Fi Direct
    wifi_direct_set_connection_state_changed_cb(callback_1, NULL); // Register callback_1
    wifi_direct_activate(); // Activate Wi-Fi Direct

    function();

    //       APP CODE HERE

    // App must clean up Wi-Fi Direct before exiting

    wifi_direct_deactivate(); // Deactivate Wi-Fi Direct
    wifi_direct_unset_connection_state_changed_cb(); // Deregister callback_1
    wifi_direct_deinitialize(); // Deinitialize Wi-Fi Direct
    return 0;
 }

Creates a Wi-Fi Direct Group, asynchronously with given SSID name.

This function sets up device as the Group Owner and waits for clients to connect. In addition, a soft AP will be created, the WPS registrar and the DHCP server will be started.

Since :

5.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/wifidirect

Parameters:

[in]

ssid

Referred to as a network name, it is a name that identifies a wireless network

Returns:

0 on success, otherwise a negative error value

Return values:

WIFI_DIRECT_ERROR_NONE	Successful
WIFI_DIRECT_ERROR_OPERATION_FAILED	Operation failed
WIFI_DIRECT_ERROR_COMMUNICATION_FAILED	Communication failed
WIFI_DIRECT_ERROR_PERMISSION_DENIED	Permission denied
WIFI_DIRECT_ERROR_INVALID_PARAMETER	Invalid parameters
WIFI_DIRECT_ERROR_NOT_SUPPORTED	Not supported
WIFI_DIRECT_ERROR_NOT_INITIALIZED	Not initialized
WIFI_DIRECT_ERROR_RESOURCE_BUSY	Device or resource busy
WIFI_DIRECT_ERROR_AUTH_FAILED	Authentication failed

Precondition:

Wi-Fi Direct service must be activated by wifi_direct_activate().

Postcondition:

wifi_direct_connection_state_changed_cb() will be invoked with WIFI_DIRECT_GROUP_CREATED.

See also:

wifi_direct_activate()

wifi_direct_destroy_group()

wifi_direct_connection_state_changed_cb()

Deactivates the Wi-Fi Direct service, asynchronously.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/wifidirect

Returns:

0 on success, otherwise a negative error value

Return values:

WIFI_DIRECT_ERROR_NONE	Successful
WIFI_DIRECT_ERROR_OPERATION_FAILED	Operation failed
WIFI_DIRECT_ERROR_COMMUNICATION_FAILED	Communication failed
WIFI_DIRECT_ERROR_PERMISSION_DENIED	Permission denied
WIFI_DIRECT_ERROR_NOT_PERMITTED	Operation not permitted
WIFI_DIRECT_ERROR_NOT_SUPPORTED	Not supported
WIFI_DIRECT_ERROR_NOT_INITIALIZED	Not initialized
WIFI_DIRECT_ERROR_RESOURCE_BUSY	Device or resource busy

Precondition:

Wi-Fi Direct service must be activated by wifi_direct_activate().

Postcondition:

wifi_direct_device_state_changed_cb() will be invoked.

See also:

wifi_direct_activate()

wifi_direct_device_state_changed_cb()

Here is an example of the usage:

 #include <stdio.h>
 #include <wifi_direct.h>


 int function(void)
 {
    int ret;

    ret = wifi_direct_deactivate(); // Deactivate Wi-Fi Direct

    if (ret != WIFI_DIRECT_ERROR_NONE) {
        printf("Failed to deactivate Wi-Fi Direct\n");
        return -1;
    }

    printf("Wi-Fi Direct Deactivated\n");
    return 0;
 }

 int main()
 {
    wifi_direct_initialize(); // Initialize Wi-Fi Direct
    wifi_direct_activate(); // Activated Wi-Fi Direct
    function();
    wifi_direct_deinitialize(); // Deinitialize Wi-Fi Direct
    return 0;
 }

Disables Wi-Fi Display functionality & disables the support of WFD Information Element (IE).

Since :

2.4

Privilege Level:

public

Privilege:

http://tizen.org/privilege/wifidirect

Returns:

0 on success, otherwise a negative error value

Return values:

WIFI_DIRECT_ERROR_NONE	Successful
WIFI_DIRECT_ERROR_OPERATION_FAILED	Operation failed
WIFI_DIRECT_ERROR_COMMUNICATION_FAILED	Communication failed
WIFI_DIRECT_ERROR_PERMISSION_DENIED	Permission denied
WIFI_DIRECT_ERROR_NOT_PERMITTED	Operation not permitted
WIFI_DIRECT_ERROR_NOT_SUPPORTED	Not supported
WIFI_DIRECT_ERROR_NOT_INITIALIZED	Not initialized
WIFI_DIRECT_ERROR_RESOURCE_BUSY	Device or resource busy

Precondition:

Wi-Fi Direct service must be activated by wifi_direct_activate() and Wi-Fi Display must be enabled by wifi_direct_init_display().

See also:

wifi_direct_activate()

wifi_direct_init_display()

wifi_direct_set_display()

Here is an example of the usage:

 #include <stdio.h>
 #include <wifi_direct.h>


 int function(void)
 {
    int ret;

    wifi_direct_init_display();

    ret = wifi_direct_deinit_display();

    if (ret != WIFI_DIRECT_ERROR_NONE) {
        printf("Failed to deinit display\n");
        return -1;
    }

    printf("deinit display success\n");
    return 0;
 }

 int main()
 {
    wifi_direct_initialize(); // Initialize Wi-Fi Direct
    wifi_direct_activate(); // Activate Wi-Fi Direct

    function();

    //       APP CODE HERE

    // App must clean up Wi-Fi Direct before exiting

    wifi_direct_deactivate(); // Deactivate Wi-Fi Direct
    wifi_direct_deinitialize(); // Deinitialize Wi-Fi Direct
    return 0;
 }

Deinitializes Wi-Fi Direct service.

Since :

2.3

Returns:

0 on success, otherwise a negative error value

Return values:

WIFI_DIRECT_ERROR_NONE	Successful
WIFI_DIRECT_ERROR_NOT_PERMITTED	Operation not permitted
WIFI_DIRECT_ERROR_NOT_INITIALIZED	Not initialized
WIFI_DIRECT_ERROR_COMMUNICATION_FAILED	Communication failed
WIFI_DIRECT_ERROR_NOT_SUPPORTED	Not supported

Precondition:

Wi-Fi Direct service must be initialized by wifi_direct_initialize().

See also:

wifi_direct_initialize()

Here is an example of the usage:

 #include <stdio.h>
 #include <wifi_direct.h>

 void function(void)
 {
    int ret;

    ret = wifi_direct_deinitialize();

    if (ret != WIFI_DIRECT_ERROR_NONE) {
        printf("Failed to deinitialize\n");
        return;
    }

    printf("Deinitialized Successfully\n");
 }

 int main()
 {
    wifi_direct_initialize(); // initialize Wi-Fi Direct
    function(); // deinitialize Wi-Fi Direct
    return 0;
 }

Deregisters for a service used for Wi-Fi Direct Service Discovery.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/wifidirect

Parameters:

[in]

service_id

A Service ID for which service has to be deregistered

Returns:

0 on success, otherwise a negative error value

Return values:

WIFI_DIRECT_ERROR_NONE	Successful
WIFI_DIRECT_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_DIRECT_ERROR_OPERATION_FAILED	Operation failed
WIFI_DIRECT_ERROR_COMMUNICATION_FAILED	Communication failed
WIFI_DIRECT_ERROR_PERMISSION_DENIED	Permission denied
WIFI_DIRECT_ERROR_NOT_PERMITTED	Operation not permitted
WIFI_DIRECT_ERROR_NOT_SUPPORTED	Not supported
WIFI_DIRECT_ERROR_NOT_INITIALIZED	Not initialized
WIFI_DIRECT_ERROR_RESOURCE_BUSY	Device or resource busy

Precondition:

Wi-Fi Direct service must be activated by wifi_direct_activate().

See also:

wifi_direct_activate()

Here is an example of the usage:

 #include <stdio.h>
 #include <wifi_direct.h>


 int function(void)
 {
    int ret;
    int input;

    printf("Enter the service id\n");
    scanf("%5d", &input);

    ret = wifi_direct_deregister_service(input);

    if (ret != WIFI_DIRECT_ERROR_NONE) {
        printf("Failed to deregister service\n");
        return -1;
    }

    return 0;
 }

 int main()
 {
    wifi_direct_initialize(); // Initialize Wi-Fi Direct
    wifi_direct_activate(); // Activate Wi-Fi Direct

    function();

    //       APP CODE HERE

    // App must clean up Wi-Fi Direct before exiting

    wifi_direct_deactivate(); // Deactivate Wi-Fi Direct
    wifi_direct_deinitialize(); // Deinitialize Wi-Fi Direct
    return 0;
 }

Destroys the Wi-Fi Direct Group, asynchronously.

This function destroys the Wi-Fi Direct Group owned by a local device. If creating a Group is in progress, this function cancels that creating.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/wifidirect

Returns:

0 on success, otherwise a negative error value

Return values:

WIFI_DIRECT_ERROR_NONE	Successful
WIFI_DIRECT_ERROR_OPERATION_FAILED	Operation failed
WIFI_DIRECT_ERROR_COMMUNICATION_FAILED	Communication failed
WIFI_DIRECT_ERROR_PERMISSION_DENIED	Permission denied
WIFI_DIRECT_ERROR_NOT_PERMITTED	Operation not permitted
WIFI_DIRECT_ERROR_NOT_SUPPORTED	Not supported
WIFI_DIRECT_ERROR_NOT_INITIALIZED	Not initialized
WIFI_DIRECT_ERROR_RESOURCE_BUSY	Device or resource busy
WIFI_DIRECT_ERROR_AUTH_FAILED	Authentication failed

Precondition:

Wi-Fi Direct service must be activated by wifi_direct_activate().

Postcondition:

wifi_direct_connection_state_changed_cb() will be invoked with WIFI_DIRECT_GROUP_DESTROYED.

See also:

wifi_direct_activate()

wifi_direct_create_group()

wifi_direct_connection_state_changed_cb()

Here is an example of the usage:

 #include <stdio.h>
 #include <wifi_direct.h>

 void callback_1(int error_code,
               wifi_direct_connection_state_e state,
               const char *mac, void *user_data)
 {
    if (state == WIFI_DIRECT_GROUP_DESTROYED) {
        printf("Group destroyed\n");
    }
 }

 int function(void)
 {
    int res;

    res = wifi_direct_destroy_group() // destroy autonomous group

 if (res != WIFI_DIRECT_ERROR_NONE) {
        printf("Failed to destroy group\n");
        return -1;
 }

    return 0;
 }

 int main()
 {
    wifi_direct_initialize(); // Initialize Wi-Fi Direct
    wifi_direct_set_connection_state_changed_cb(callback_1, NULL); // Register callback_1
    wifi_direct_activate(); // Activate Wi-Fi Direct

    function();

    //       APP CODE HERE

    // App must clean up Wi-Fi Direct before exiting

    wifi_direct_deactivate(); // Deactivate Wi-Fi Direct
    wifi_direct_unset_connection_state_changed_cb(); // Deregister callback_1
    wifi_direct_deinitialize(); // Deinitialize Wi-Fi Direct
    return 0;
 }

Disconnects the specified peer, asynchronously.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/wifidirect

Parameters:

[in]

mac_address

The MAC address of remote device

Returns:

0 on success, otherwise a negative error value

Return values:

WIFI_DIRECT_ERROR_NONE	Successful
WIFI_DIRECT_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_DIRECT_ERROR_OPERATION_FAILED	Operation failed
WIFI_DIRECT_ERROR_COMMUNICATION_FAILED	Communication failed
WIFI_DIRECT_ERROR_PERMISSION_DENIED	Permission denied
WIFI_DIRECT_ERROR_NOT_PERMITTED	Operation not permitted
WIFI_DIRECT_ERROR_NOT_SUPPORTED	Not supported
WIFI_DIRECT_ERROR_NOT_INITIALIZED	Not initialized
WIFI_DIRECT_ERROR_RESOURCE_BUSY	Device or resource busy

Precondition:

Wi-Fi Direct service must be activated by wifi_direct_activate().

Postcondition:

wifi_direct_connection_state_changed_cb() will be invoked.

See also:

wifi_direct_activate()

wifi_direct_connect()

wifi_direct_connection_state_changed_cb()

Here is an example of the usage:

 #include <stdio.h>
 #include <wifi_direct.h>

 bool callback_2(wifi_direct_connected_peer_info_s* peer,
                 void* user_data)
 {
    if (peer) {
        printf("connected device=%s mac=%s\n",
                    peer->device_name, peer->mac_address);
    }
 }

 void callback_1(int error_code,
               wifi_direct_connection_state_e state,
               const char *mac, void *user_data)
 *{
    switch (state) {
    case WIFI_DIRECT_CONNECTION_IN_PROGRESS:
        printf("Connection in progress\n");
    break;

    case WIFI_DIRECT_CONNECTON_RSP:
        printf("Connected\n");
 break;

    case WIFI_DIRECT_DISCONNECTION_IND:
        printf("Disconnection IND\n");
    break;

    case WIFI_DIRECT_DISCONNECTION_RSP;
        printf("Disconnected mac=%s\n", mac_address); // disconnect notification
    break;
 }
 *}

 int function(char *mac)
 {
    int res;

    res = wifi_direct_disconnect(mac); // disconnect the connected peer with input mac

 if (res != WIFI_DIRECT_ERROR_NONE) {
        printf("Failed to disconnect all clients\n");
        return -1;
 }

    return 0;
 }

 int main()
 {
    char mac[16] = {0,};

    wifi_direct_initialize(); // Initialize Wi-Fi Direct
    wifi_direct_set_connection_state_changed_cb(callback_1, NULL); // Register callback_1
    wifi_direct_activate(); // Activate Wi-Fi Direct *

    wifi_direct_foreach_connected_peers(callback_2, NULL); // Register callback_2

    printf("Enter the connected peer mac address\n");
    read(stdin, mac, 15);

    function(mac);

    //       APP CODE HERE

    // App must clean up Wi-Fi Direct before exiting

    wifi_direct_deactivate(); // Deactivate Wi-Fi Direct
    wifi_direct_unset_connection_state_changed_cb(); // Deregister callback
    wifi_direct_deinitialize(); // Deinitialize Wi-Fi Direct
    return 0;
 }

Disconnects all connected links to peers, asynchronously.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/wifidirect

Returns:

0 on success, otherwise a negative error value

Return values:

WIFI_DIRECT_ERROR_NONE	Successful
WIFI_DIRECT_ERROR_OPERATION_FAILED	Operation failed
WIFI_DIRECT_ERROR_COMMUNICATION_FAILED	Communication failed
WIFI_DIRECT_ERROR_PERMISSION_DENIED	Permission denied
WIFI_DIRECT_ERROR_NOT_PERMITTED	Operation not permitted
WIFI_DIRECT_ERROR_NOT_SUPPORTED	Not supported
WIFI_DIRECT_ERROR_NOT_INITIALIZED	Not initialized
WIFI_DIRECT_ERROR_RESOURCE_BUSY	Device or resource busy

Precondition:

Wi-Fi Direct service must be activated by wifi_direct_activate().

Postcondition:

wifi_direct_connection_state_changed_cb() will be invoked.

See also:

wifi_direct_activate()

wifi_direct_disconnect()

wifi_direct_connection_state_changed_cb()

Here is an example of the usage:

 #include <stdio.h>
 #include <wifi_direct.h>

 void callback(int error_code,
               wifi_direct_connection_state_e state,
               const char *mac, void *user_data)
 *{
    switch (state) {
    case WIFI_DIRECT_CONNECTION_IN_PROGRESS:
        printf("Connection in progress\n");
    break;

    case WIFI_DIRECT_CONNECTON_RSP:
        printf("Connected\n");
 break;

    case WIFI_DIRECT_DISCONNECTION_IND:
        printf("Disconnection IND\n");
    break;

    case WIFI_DIRECT_DISCONNECTION_RSP;
        printf("Disconnected\n"); // disconnect notification
    break;
 }
 *}

 int function(void)
 {
    int res;

    res = wifi_direct_disconnect_all(); // disconnect all the connected peers

 if (res != WIFI_DIRECT_ERROR_NONE) {
        printf("Failed to disconnect all clients\n");
        return -1;
 }

    return 0;
 }

 int main()
 {
    wifi_direct_initialize(); // Initialize Wi-Fi Direct
    wifi_direct_set_connection_state_changed_cb(callback, NULL); // Register callback
    wifi_direct_activate(); // Activate Wi-Fi Direct *

 function();

    //       APP CODE HERE

    // App must clean up Wi-Fi Direct before exiting

    wifi_direct_deactivate(); // Deactivate Wi-Fi Direct
    wifi_direct_unset_connection_state_changed_cb(); // Deregister callback
    wifi_direct_deinitialize(); // Deinitialize Wi-Fi Direct
    return 0;
 }

Gets the information of connected peers.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/wifidirect

Parameters:

[in]	callback	The callback function to invoke
[in]	user_data	The user data to be passed to the callback function

Returns:

0 on success, otherwise a negative error value

Return values:

WIFI_DIRECT_ERROR_NONE	Successful
WIFI_DIRECT_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_DIRECT_ERROR_OPERATION_FAILED	Operation failed
WIFI_DIRECT_ERROR_COMMUNICATION_FAILED	Communication failed
WIFI_DIRECT_ERROR_PERMISSION_DENIED	Permission denied
WIFI_DIRECT_ERROR_NOT_PERMITTED	Operation not permitted
WIFI_DIRECT_ERROR_NOT_SUPPORTED	Not supported
WIFI_DIRECT_ERROR_NOT_INITIALIZED	Not initialized
WIFI_DIRECT_ERROR_RESOURCE_BUSY	Device or resource busy

Precondition:

Wi-Fi Direct service must be activated by wifi_direct_activate().

See also:

wifi_direct_activate()

wifi_direct_discovered_peer_cb()

Here is an example of the usage:

 #include <stdio.h>
 #include <wifi_direct.h>

 bool callback_1(wifi_direct_connected_peer_info_s* peer,
                 void* user_data)
 {
    if (peer) {
        printf("connected device=%s mac=%s\n",
                    peer->device_name, peer->mac_address);
    }
 }

 int function(char *mac)
 {
    int res;

    res = wifi_direct_foreach_connected_peers(callback_1, NULL) // Get connected peers

 if (res != WIFI_DIRECT_ERROR_NONE) {
        printf("Failed to get connected peers\n");
        return -1;
 }

    return 0;
 }

 int main()
 {
    wifi_direct_initialize(); // Initialize Wi-Fi Direct
    wifi_direct_activate(); // Activate Wi-Fi Direct

    function();

    //       APP CODE HERE

    // App must clean up Wi-Fi Direct before exiting

    wifi_direct_deactivate(); // Deactivate Wi-Fi Direct
    wifi_direct_deinitialize(); // Deinitialize Wi-Fi Direct
    return 0;
 }

Gets the information of discovered peers.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/wifidirect

Parameters:

[in]	callback	The callback function to invoke
[in]	user_data	The user data to be passed to the callback function

Returns:

0 on success, otherwise a negative error value

Return values:

WIFI_DIRECT_ERROR_NONE	Successful
WIFI_DIRECT_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_DIRECT_ERROR_OPERATION_FAILED	Operation failed
WIFI_DIRECT_ERROR_COMMUNICATION_FAILED	Communication failed
WIFI_DIRECT_ERROR_PERMISSION_DENIED	Permission denied
WIFI_DIRECT_ERROR_NOT_PERMITTED	Operation not permitted
WIFI_DIRECT_ERROR_NOT_SUPPORTED	Not supported
WIFI_DIRECT_ERROR_NOT_INITIALIZED	Not initialized
WIFI_DIRECT_ERROR_RESOURCE_BUSY	Device or resource busy

Precondition:

Wi-Fi Direct service must be activated by wifi_direct_activate().

See also:

wifi_direct_activate()

wifi_direct_discovered_peer_cb()

Here is an example of the usage:

 #include <stdio.h>
 #include <wifi_direct.h>


 void function_cb(wifi_direct_discovered_peer_info_s* peer,
                                           void *user_data)
 {
    if (peer)
        printf("peer device=%s MAC=%s\n", peer->device_name, peer->mac_address);
 }

 int function(void)
 {
    int ret;

    ret = wifi_direct_foreach_discovered_peers(function_cb, NULL); // get discovered peer devices info

 if (ret != WIFI_DIRECT_ERROR_NONE) {
        printf("Failed to get discovered peers\n");
        return -1;
    }

    return 0;
 }

 void callback(int error_code,
               wifi_direct_discovery_state_e discovery_state,
               void *user_data)
 {
    switch(discovery_state) {
    case WIFI_DIRECT_DISCOVERY_STARTED:
        printf("Discovery started\n");
        break;

    case WIFI_DIRECT_ONLY_LISTEN_STARTED:
        printf("listen started\n");
        break;

    case WIFI_DIRECT_DISCOVERY_FINISHED:
        printf("Discovery finished\n");

        function();

        break;

    case WIFI_DIRECT_DISCOVERY_FOUND:
        printf("peer devices found\n");
        break;

    case WIFI_DIRECT_DISCOVERY_LOST:
        printf("Discovery lost\n");
        break;

    default:
    break;
    }
 }

 int main()
 {
    wifi_direct_initialize(); // Initialize Wi-Fi Direct
    wifi_direct_set_discovery_state_changed_cb(callback, NULL); // Register callback
    wifi_direct_activate(); // Activate Wi-Fi Direct
    wifi_direct_start_discovery(TRUE, 15); // Start discovery

    //       APP CODE HERE

    // App must clean up Wi-Fi Direct before exiting

    wifi_direct_deactivate(); // Deactivate Wi-Fi Direct
    wifi_direct_unset_discovery_state_changed_cb(); // Deregister callback
    wifi_direct_deinitialize(); // Deinitialize Wi-Fi Direct
    return 0;
 }

Gets the persistent groups.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/wifidirect

Parameters:

[in]	callback	The callback function to invoke
[in]	user_data	The user data to be passed to the callback function

Returns:

0 on success, otherwise a negative error value

Return values:

WIFI_DIRECT_ERROR_NONE	Successful
WIFI_DIRECT_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_DIRECT_ERROR_OPERATION_FAILED	Operation failed
WIFI_DIRECT_ERROR_COMMUNICATION_FAILED	Communication failed
WIFI_DIRECT_ERROR_PERMISSION_DENIED	Permission denied
WIFI_DIRECT_ERROR_NOT_PERMITTED	Operation not permitted
WIFI_DIRECT_ERROR_NOT_SUPPORTED	Not supported
WIFI_DIRECT_ERROR_NOT_INITIALIZED	Not initialized
WIFI_DIRECT_ERROR_RESOURCE_BUSY	Device or resource busy

Precondition:

Wi-Fi Direct service must be initialized by wifi_direct_initialize().

Postcondition:

wifi_direct_persistent_group_cb() will be called.

See also:

wifi_direct_initialize()

wifi_direct_persistent_group_cb()

Here is an example of the usage:

 #include <stdio.h>
 #include <wifi_direct.h>


 bool callback(const char *mac_address,
               const char *ssid,
               void *user_data)
 {
    if (mac_address)
        printf("mac = %s\n", mac_address);

    if (ssid)
        printf("ssid = %s\n", ssid);

    return true;
 }

 int function(void)
 {
    int ret;

    ret = wifi_direct_foreach_persistent_groups(callback, NULL);

    if (ret != WIFI_DIRECT_ERROR_NONE) {
        printf("Failed to set callback to get persistent groups\n");
        return -1;
    }

    return 0;
 }

 int main()
 {
    wifi_direct_initialize(); // Initialize Wi-Fi Direct
    wifi_direct_activate(); // Activate Wi-Fi Direct

    function();

    //       APP CODE HERE

    // App must clean up Wi-Fi Direct before exiting

    wifi_direct_deactivate(); // Deactivate Wi-Fi Direct
    wifi_direct_deinitialize(); // Deinitialize Wi-Fi Direct
    return 0;
 }

Gets the supported WPS (Wi-Fi Protected Setup) types.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/wifidirect

Parameters:

[in]	callback	The callback function to invoke
[in]	user_data	The user data to be passed to the callback function

Returns:

0 on success, otherwise a negative error value

Return values:

WIFI_DIRECT_ERROR_NONE	Successful
WIFI_DIRECT_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_DIRECT_ERROR_OPERATION_FAILED	Operation failed
WIFI_DIRECT_ERROR_COMMUNICATION_FAILED	Communication failed
WIFI_DIRECT_ERROR_PERMISSION_DENIED	Permission denied
WIFI_DIRECT_ERROR_NOT_PERMITTED	Operation not permitted
WIFI_DIRECT_ERROR_NOT_SUPPORTED	Not supported
WIFI_DIRECT_ERROR_NOT_INITIALIZED	Not initialized
WIFI_DIRECT_ERROR_RESOURCE_BUSY	Device or resource busy

Precondition:

Wi-Fi Direct service must be initialized by wifi_direct_initialize().

See also:

wifi_direct_initialize()

wifi_direct_supported_wps_type_cb()

Here is an example of the usage:

 #include <stdio.h>
 #include <wifi_direct.h>


 bool callback(wifi_direct_wps_types_e type, void *user_data)
 {
    switch (type) {
    case WIFI_DIRECT_WPS_TYPE_PBC:
        printf("mode is WPS PBC\n");
    break;

    case WIFI_DIRECT_WPS_TYPE_PIN_DISPLAY:
        printf("mode is WPS PIN Display\n");
    break;

    case WIFI_DIRECT_WPS_TYPE_PIN_KEYPAD:
        printf("mode is WPS PIN Keypad\n");
    break;
    }
 }

 int function(void)
 {
    int ret;

    ret = wifi_direct_foreach_supported_wps_types(callback, NULL);

    if (ret != WIFI_DIRECT_ERROR_NONE) {
        printf("Failed to get supported wps types\n");
        return -1;
    }

    return 0;
 }

 int main()
 {
    wifi_direct_initialize(); // Initialize Wi-Fi Direct
    wifi_direct_activate(); // Activate Wi-Fi Direct

    function();

    //       APP CODE HERE

    // App must clean up Wi-Fi Direct before exiting

    wifi_direct_deactivate(); // Deactivate Wi-Fi Direct
    wifi_direct_deinitialize(); // Deinitialize Wi-Fi Direct
    return 0;
 }

Gets the information of peer devices which is in the connecting state.

Since :

4.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/wifidirect

Remarks:

peer_info must be released with free().

Parameters:

[out]

peer_info

connecting peer device data

Returns:

0 on success, otherwise a negative error value

Return values:

WIFI_DIRECT_ERROR_NONE	Successful
WIFI_DIRECT_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_DIRECT_ERROR_OPERATION_FAILED	Operation failed
WIFI_DIRECT_ERROR_COMMUNICATION_FAILED	Communication failed
WIFI_DIRECT_ERROR_PERMISSION_DENIED	Permission denied
WIFI_DIRECT_ERROR_NOT_PERMITTED	Operation not permitted
WIFI_DIRECT_ERROR_NOT_SUPPORTED	Not supported
WIFI_DIRECT_ERROR_NOT_INITIALIZED	Not initialized
WIFI_DIRECT_ERROR_RESOURCE_BUSY	Device or resource busy

Precondition:

Wi-Fi Direct service must be connecting state by wifi_direct_connect() or by receiving connection request from p2p peer device.

See also:

wifi_direct_activate()

wifi_direct_connect()

Here is an example of the usage:

 #include <stdio.h>
 #include <wifi_direct.h>


 bool device_selected = false;

 void peers_cb(wifi_direct_discovered_peer_info_s* peer,
                                           void *user_data)
 {
    if (peer && !device_selected) {
        printf("peer device=%s MAC=%s\n", peer->device_name, peer->mac_address);

        device_selected = true;

        wifi_direct_connect(peer->mac_address); // Connect to the first discovered peer
    }
 }

 int function(void)
 {
    int ret;
    wifi_direct_discovered_peer_info_s *peer = NULL;

    ret = wifi_direct_get_connecting_peer_info(&peer);

    if (ret != WIFI_DIRECT_ERROR_NONE) {
        printf("Failed to get connecting peer info\n");
        return -1;
    }

    printf("peer device name (%s) mac (%s)\n", peer->device_name,
                                                 peer->mac_address);
    return 0;
 }

 void callback_2(int error_code,
                 wifi_direct_connection_state_e state,
                 const char *mac, void *user_data)
 *{
    switch (state) {
    case WIFI_DIRECT_CONNECTION_IN_PROGRESS:
        printf("Connection in progress\n");

        function(); // get the connecting peer info

    break;

    case WIFI_DIRECT_CONNECTION_RSP:
        printf("Connected\n");
 break;

    case WIFI_DIRECT_DISCONNECTION_IND:
        printf("Disconnection IND\n");
    break;

    case WIFI_DIRECT_DISCONNECTION_RSP;
        printf("Disconnected\n");
    break;
 }
 *}

 void callback_1(int error_code,
               wifi_direct_discovery_state_e discovery_state,
               void *user_data)
 {
    switch(discovery_state) {
    case WIFI_DIRECT_DISCOVERY_STARTED:
        printf("Discovery started\n");
        break;

    case WIFI_DIRECT_ONLY_LISTEN_STARTED:
        printf("listen started\n");
        break;

    case WIFI_DIRECT_DISCOVERY_FINISHED:
        printf("Discovery finished\n");

    wifi_direct_foreach_discovered_peers(peers_cb,
                                        NULL); // Get discovered peer
        break;

    case WIFI_DIRECT_DISCOVERY_FOUND:
        printf("peer devices found\n");
        break;

    case WIFI_DIRECT_DISCOVERY_LOST:
        printf("Discovery lost\n");
        break;

    default:
    break;
    }
 }

 int main()
 {
    wifi_direct_initialize(); // Initialize Wi-Fi Direct
    wifi_direct_set_discovery_state_changed_cb(callback_1, NULL); // Register callback 1
    wifi_direct_set_connection_state_changed_cb(callback_2, NULL); // Register callback 2

    wifi_direct_activate(); // Activate Wi-Fi Direct
    wifi_direct_start_discovery(TRUE, 15); // Start discovery

    //       APP CODE HERE

    // App must clean up Wi-Fi Direct before exiting

    wifi_direct_deactivate(); // Deactivate Wi-Fi Direct
    wifi_direct_unset_discovery_state_changed_cb(); // Deregister callback
    wifi_direct_deinitialize(); // Deinitialize Wi-Fi Direct
    return 0;
 }

Gets the name of a local device.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/wifidirect

Remarks:

device_name must be released with free().

Parameters:

[out]

device_name

The name of a local device

Returns:

0 on success, otherwise a negative error value

Return values:

WIFI_DIRECT_ERROR_NONE	Successful
WIFI_DIRECT_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_DIRECT_ERROR_OPERATION_FAILED	Operation failed
WIFI_DIRECT_ERROR_COMMUNICATION_FAILED	Communication failed
WIFI_DIRECT_ERROR_PERMISSION_DENIED	Permission denied
WIFI_DIRECT_ERROR_NOT_SUPPORTED	Not supported
WIFI_DIRECT_ERROR_NOT_INITIALIZED	Not initialized
WIFI_DIRECT_ERROR_RESOURCE_BUSY	Device or resource busy

Precondition:

Wi-Fi Direct service must be initialized by wifi_direct_initialize().

See also:

wifi_direct_initialize()

wifi_direct_set_device_name()

Here is an example of the usage:

 #include <stdio.h>
 #include <wifi_direct.h>

 int function(void)
 {
    int res;
    char *name;

    res = wifi_direct_get_device_name(&name); // get device name

    if (res != WIFI_DIRECT_ERROR_NONE) {
        printf("Failed to get device name\n");
        return -1;
 }

    printf("device name = %s\n", name);
    g_free(name);
    return 0;
 }

 int main()
 {
    wifi_direct_initialize(); // Initialize Wi-Fi Direct
    wifi_direct_activate(); // Activate Wi-Fi Direct

    function();

    //       APP CODE HERE

    // App must clean up Wi-Fi Direct before exiting

    wifi_direct_deactivate(); // Deactivate Wi-Fi Direct
    wifi_direct_deinitialize(); // Deinitialize Wi-Fi Direct
    return 0;
 }

Gets the Wi-Fi Display parameters for the WFD IE of local device.

Since :

5.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/wifidirect

Parameters:

[out]	type	WFD device type: role of WFD device like source or sink
[out]	port	Session management control port number, it will be of 2 bytes (0~65535)
[out]	hdcp	CP support bit: (1 = hdcp support is enabled, 0 = hdcp support is disabled)

Returns:

0 on success, otherwise a negative error value

Return values:

WIFI_DIRECT_ERROR_NONE	Successful
WIFI_DIRECT_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_DIRECT_ERROR_OPERATION_FAILED	Operation failed
WIFI_DIRECT_ERROR_COMMUNICATION_FAILED	Communication failed
WIFI_DIRECT_ERROR_PERMISSION_DENIED	Permission denied
WIFI_DIRECT_ERROR_NOT_PERMITTED	Operation not permitted
WIFI_DIRECT_ERROR_NOT_SUPPORTED	Not supported
WIFI_DIRECT_ERROR_NOT_INITIALIZED	Not initialized
WIFI_DIRECT_ERROR_RESOURCE_BUSY	Device or resource busy

Precondition:

Wi-Fi Direct service must be activated by wifi_direct_activate() and enable Wi-Fi Display by wifi_direct_init_display().

See also:

wifi_direct_activate()

wifi_direct_init_display()

wifi_direct_deinit_display()

Here is an example of the usage:

 #include <stdio.h>
 #include <wifi_direct.h>


 int function(void)
 {
    int ret;
    wifi_direct_display_type_e type;
    int port;
    int hdcp;

    ret = wifi_direct_get_display(&type, &port, &hdcp);

    if (ret != WIFI_DIRECT_ERROR_NONE) {
        printf("Failed to get display property\n");
        return -1;
    }

    printf("get display param success [type:%d], [port:%d], [hdcp:%d]\n", type, port, hdcp);
    return 0;
 }

 int main()
 {
    wifi_direct_initialize(); // Initialize Wi-Fi Direct
    wifi_direct_activate(); // Activate Wi-Fi Direct

    function();

    //       APP CODE HERE

    // App must clean up Wi-Fi Direct before exiting

    wifi_direct_deactivate(); // Deactivate Wi-Fi Direct
    wifi_direct_deinitialize(); // Deinitialize Wi-Fi Direct
    return 0;
 }

Gets the Wi-Fi Display Session Availability.

Since :

5.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/wifidirect

Parameters:

[out]

availability

Wi-Fi display session availability

Returns:

0 on success, otherwise a negative error value

Return values:

WIFI_DIRECT_ERROR_NONE	Successful
WIFI_DIRECT_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_DIRECT_ERROR_OPERATION_FAILED	Operation failed
WIFI_DIRECT_ERROR_COMMUNICATION_FAILED	Communication failed
WIFI_DIRECT_ERROR_PERMISSION_DENIED	Permission denied
WIFI_DIRECT_ERROR_NOT_PERMITTED	Operation not permitted
WIFI_DIRECT_ERROR_NOT_SUPPORTED	Not supported
WIFI_DIRECT_ERROR_NOT_INITIALIZED	Not initialized
WIFI_DIRECT_ERROR_RESOURCE_BUSY	Device or resource busy

Precondition:

Wi-Fi Direct service must be activated by wifi_direct_activate() and enable Wi-Fi Display by wifi_direct_init_display().

See also:

wifi_direct_activate()

wifi_direct_init_display()

wifi_direct_deinit_display()

Here is an example of the usage:

 #include <stdio.h>
 #include <wifi_direct.h>


 int function(void)
 {
    int ret;
    int availability;

    ret = wifi_direct_get_display_availability(&availability);

    if (ret != WIFI_DIRECT_ERROR_NONE) {
        printf("Failed to get display availability\n");
        return -1;
    }

    printf("get display availability success [%d]\n", availability);
    return 0;
 }

 int main()
 {
    wifi_direct_initialize(); // Initialize Wi-Fi Direct
    wifi_direct_activate(); // Activate Wi-Fi Direct

    function();

    //       APP CODE HERE

    // App must clean up Wi-Fi Direct before exiting

    wifi_direct_deactivate(); // Deactivate Wi-Fi Direct
    wifi_direct_deinitialize(); // Deinitialize Wi-Fi Direct
    return 0;
 }

Gets the Gateway address.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/wifidirect

Remarks:

gateway_address must be released using free().

Parameters:

[out]

gateway_address

The gateway address

Returns:

0 on success, otherwise a negative error value

Return values:

WIFI_DIRECT_ERROR_NONE	Successful
WIFI_DIRECT_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_DIRECT_ERROR_OPERATION_FAILED	Operation failed
WIFI_DIRECT_ERROR_OUT_OF_MEMORY	Out of memory
WIFI_DIRECT_ERROR_COMMUNICATION_FAILED	Communication failed
WIFI_DIRECT_ERROR_PERMISSION_DENIED	Permission denied
WIFI_DIRECT_ERROR_NOT_PERMITTED	Operation not permitted
WIFI_DIRECT_ERROR_NOT_SUPPORTED	Not supported
WIFI_DIRECT_ERROR_NOT_INITIALIZED	Not initialized
WIFI_DIRECT_ERROR_RESOURCE_BUSY	Device or resource busy

Precondition:

Wi-Fi Direct service must be activated by wifi_direct_activate().

See also:

wifi_direct_activate()

Here is an example of the usage:

 #include <stdio.h>
 #include <wifi_direct.h>

 int function(void);

 bool device_selected = false;

 void peers_cb(wifi_direct_discovered_peer_info_s* peer,
                                           void *user_data)
 {
    if (peer && !device_selected) {
        printf("peer device=%s MAC=%s\n", peer->device_name, peer->mac_address);

        device_selected = true;

        wifi_direct_connect(peer->mac_address); // Connect to the first discovered peer
    }
 }

 int function(void)
 {
    int ret;
    char *gateway;
    char *ip;

    wifi_direct_get_ip_address(&ip); // get ip address

    ret = wifi_direct_get_gateway_address(&gateway); // get gateway address

    if (ret != WIFI_DIRECT_ERROR_NONE) {
        printf("Failed to get gateway address\n");
        return -1;
    }

    printf("gateway address=%s\n", gateway);
    g_free(ip);
    g_free(gateway);
    return 0;
 }

 void callback_2(int error_code,
                 wifi_direct_connection_state_e state,
                 const char *mac, void *user_data)
 *{
    switch (state) {
    case WIFI_DIRECT_CONNECTION_IN_PROGRESS:
        printf("Connection in progress\n");
    break;

    case WIFI_DIRECT_CONNECTON_RSP:
        printf("Connected\n");

        function();
 break;

    case WIFI_DIRECT_DISCONNECTION_IND:
        printf("Disconnection IND\n");
    break;

    case WIFI_DIRECT_DISCONNECTION_RSP;
        printf("Disconnected\n");
    break;
 }
 *}

 void callback_1(int error_code,
               wifi_direct_discovery_state_e discovery_state,
               void *user_data)
 {
    switch(discovery_state) {
    case WIFI_DIRECT_DISCOVERY_STARTED:
        printf("Discovery started\n");
        break;

    case WIFI_DIRECT_ONLY_LISTEN_STARTED:
        printf("listen started\n");
        break;

    case WIFI_DIRECT_DISCOVERY_FINISHED:
        printf("Discovery finished\n");

        wifi_direct_foreach_discovered_peers(peers_cb,
                                        NULL);
        break;

    case WIFI_DIRECT_DISCOVERY_FOUND:
        printf("peer devices found\n");
        break;

    case WIFI_DIRECT_DISCOVERY_LOST:
        printf("Discovery lost\n");
        break;

    default:
    break;
    }
 }

 int main()
 {
    wifi_direct_initialize(); // Initialize Wi-Fi Direct
    wifi_direct_set_discovery_state_changed_cb(callback_1, NULL); // Register callback 1
    wifi_direct_set_connection_state_changed_cb(callback_2, NULL); // Register callback 2

    wifi_direct_activate(); // Activate Wi-Fi Direct
    wifi_direct_start_discovery(TRUE, 15); // Start discovery

    //       APP CODE HERE

    // App must clean up Wi-Fi Direct before exiting

    wifi_direct_deactivate(); // Deactivate Wi-Fi Direct
    wifi_direct_unset_connection_state_changed_cb(); // Deregister callback
    wifi_direct_unset_discovery_state_changed_cb(); // Deregister callback
    wifi_direct_deinitialize(); // Deinitialize Wi-Fi Direct
    return 0;
 }

Gets the intent of the group owner for each connection type.

Since :

5.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/wifidirect

Parameters:

[in]	type	The type of connection for a peer device
[out]	intent	The intent of the group owner

Returns:

0 on success, otherwise a negative error value

Return values:

WIFI_DIRECT_ERROR_NONE	Successful
WIFI_DIRECT_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_DIRECT_ERROR_OPERATION_FAILED	Operation failed
WIFI_DIRECT_ERROR_COMMUNICATION_FAILED	Communication failed
WIFI_DIRECT_ERROR_PERMISSION_DENIED	Permission denied
WIFI_DIRECT_ERROR_NOT_PERMITTED	Operation not permitted
WIFI_DIRECT_ERROR_NOT_SUPPORTED	Not supported
WIFI_DIRECT_ERROR_NOT_INITIALIZED	Not initialized
WIFI_DIRECT_ERROR_RESOURCE_BUSY	Device or resource busy

Precondition:

Wi-Fi Direct service must be initialized by wifi_direct_initialize().

See also:

wifi_direct_initialize()

wifi_direct_set_go_intent_per_type()

Gets the intent of the group owner.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/wifidirect

Parameters:

[out]

intent

The intent of the group owner

Returns:

0 on success, otherwise a negative error value

Return values:

WIFI_DIRECT_ERROR_NONE	Successful
WIFI_DIRECT_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_DIRECT_ERROR_OPERATION_FAILED	Operation failed
WIFI_DIRECT_ERROR_COMMUNICATION_FAILED	Communication failed
WIFI_DIRECT_ERROR_PERMISSION_DENIED	Permission denied
WIFI_DIRECT_ERROR_NOT_PERMITTED	Operation not permitted
WIFI_DIRECT_ERROR_NOT_SUPPORTED	Not supported
WIFI_DIRECT_ERROR_NOT_INITIALIZED	Not initialized
WIFI_DIRECT_ERROR_RESOURCE_BUSY	Device or resource busy

Precondition:

Wi-Fi Direct service must be initialized by wifi_direct_initialize().

See also:

wifi_direct_initialize()

wifi_direct_set_group_owner_intent()

Here is an example of the usage:

 #include <stdio.h>
 #include <wifi_direct.h>


 int function(void)
 {
    int ret;
    int go_intent;

    ret = wifi_direct_get_group_owner_intent(&go_intent);

    if (ret != WIFI_DIRECT_ERROR_NONE) {
        printf("Failed to get go intent\n");
        return -1;
    }

    printf("Current GO Intent = %d\n", go_intent);
    return 0;
 }

 int main()
 {
    wifi_direct_initialize(); // Initialize Wi-Fi Direct
    wifi_direct_activate(); // Activate Wi-Fi Direct

    function();

    //       APP CODE HERE

    // App must clean up Wi-Fi Direct before exiting

    wifi_direct_deactivate(); // Deactivate Wi-Fi Direct
    wifi_direct_deinitialize(); // Deinitialize Wi-Fi Direct
    return 0;
 }

Gets IP address of a local device.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/wifidirect

Remarks:

ip_address must be released using free().

Parameters:

[out]

ip_address

The IP address

Returns:

0 on success, otherwise a negative error value

Return values:

WIFI_DIRECT_ERROR_NONE	Successful
WIFI_DIRECT_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_DIRECT_ERROR_OPERATION_FAILED	Operation failed
WIFI_DIRECT_ERROR_OUT_OF_MEMORY	Out of memory
WIFI_DIRECT_ERROR_COMMUNICATION_FAILED	Communication failed
WIFI_DIRECT_ERROR_PERMISSION_DENIED	Permission denied
WIFI_DIRECT_ERROR_NOT_PERMITTED	Operation not permitted
WIFI_DIRECT_ERROR_NOT_SUPPORTED	Not supported
WIFI_DIRECT_ERROR_NOT_INITIALIZED	Not initialized
WIFI_DIRECT_ERROR_RESOURCE_BUSY	Device or resource busy

Precondition:

Wi-Fi Direct service must be activated by wifi_direct_activate().

See also:

wifi_direct_activate()

Here is an example of the usage:

 #include <stdio.h>
 #include <wifi_direct.h>

 int function(void);

 bool device_selected = false;

 void peers_cb(wifi_direct_discovered_peer_info_s* peer,
                                           void *user_data)
 {
    if (peer && !device_selected) {
        printf("peer device=%s MAC=%s\n", peer->device_name, peer->mac_address);

        device_selected = true;

        wifi_direct_connect(peer->mac_address); // Connect to the first discovered peer
    }
 }

 int function(void)
 {
    int ret;
    char *ip;

    ret = wifi_direct_get_ip_address(&ip); // get ip address

    if (ret != WIFI_DIRECT_ERROR_NONE) {
        printf("Failed to connect the peer\n");
        return -1;
    }

    printf("IP address=%s\n", ip);
    g_free(ip);
    return 0;
 }

 void callback_2(int error_code,
                 wifi_direct_connection_state_e state,
                 const char *mac, void *user_data)
 *{
    switch (state) {
    case WIFI_DIRECT_CONNECTION_IN_PROGRESS:
        printf("Connection in progress\n");
    break;

    case WIFI_DIRECT_CONNECTON_RSP:
        printf("Connected\n");

        function();
 break;

    case WIFI_DIRECT_DISCONNECTION_IND:
        printf("Disconnection IND\n");
    break;

    case WIFI_DIRECT_DISCONNECTION_RSP;
        printf("Disconnected\n");
    break;
 }
 *}

 void callback_1(int error_code,
               wifi_direct_discovery_state_e discovery_state,
               void *user_data)
 {
    switch(discovery_state) {
    case WIFI_DIRECT_DISCOVERY_STARTED:
        printf("Discovery started\n");
        break;

    case WIFI_DIRECT_ONLY_LISTEN_STARTED:
        printf("listen started\n");
        break;

    case WIFI_DIRECT_DISCOVERY_FINISHED:
        printf("Discovery finished\n");

        wifi_direct_foreach_discovered_peers(peers_cb,
                                        NULL);
        break;

    case WIFI_DIRECT_DISCOVERY_FOUND:
        printf("peer devices found\n");
        break;

    case WIFI_DIRECT_DISCOVERY_LOST:
        printf("Discovery lost\n");
        break;

    default:
    break;
    }
 }

 int main()
 {
    wifi_direct_initialize(); // Initialize Wi-Fi Direct
    wifi_direct_set_discovery_state_changed_cb(callback_1, NULL); // Register callback 1
    wifi_direct_set_connection_state_changed_cb(callback_2, NULL); // Register callback 2

    wifi_direct_activate(); // Activate Wi-Fi Direct
    wifi_direct_start_discovery(TRUE, 15); // Start discovery

    //       APP CODE HERE

    // App must clean up Wi-Fi Direct before exiting

    wifi_direct_deactivate(); // Deactivate Wi-Fi Direct
    wifi_direct_unset_discovery_state_changed_cb(); // Deregister callback
    wifi_direct_deinitialize(); // Deinitialize Wi-Fi Direct
    return 0;
 }

Gets the WPS (Wi-Fi Protected Setup) type.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/wifidirect

Parameters:

[out]

type

The type of WPS

Returns:

0 on success, otherwise a negative error value

Return values:

WIFI_DIRECT_ERROR_NONE	Successful
WIFI_DIRECT_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_DIRECT_ERROR_OPERATION_FAILED	Operation failed
WIFI_DIRECT_ERROR_COMMUNICATION_FAILED	Communication failed
WIFI_DIRECT_ERROR_PERMISSION_DENIED	Permission denied
WIFI_DIRECT_ERROR_NOT_PERMITTED	Operation not permitted
WIFI_DIRECT_ERROR_NOT_SUPPORTED	Not supported
WIFI_DIRECT_ERROR_NOT_INITIALIZED	Not initialized
WIFI_DIRECT_ERROR_RESOURCE_BUSY	Device or resource busy

Precondition:

Wi-Fi Direct service must be initialized by wifi_direct_initialize().

See also:

wifi_direct_initialize()

wifi_direct_foreach_supported_wps_types()

Here is an example of the usage:

 #include <stdio.h>
 #include <wifi_direct.h>


 int function(void)
 {
    int ret;
    int wps_type;

    ret = wifi_direct_get_local_wps_type(&wps_type);

    if (ret != WIFI_DIRECT_ERROR_NONE) {
        printf("Failed to get supported wps types\n");
        return -1;
    }

    switch (wps_type) {
    case WIFI_DIRECT_WPS_TYPE_PBC:
        printf("mode is WPS PBC\n");
    break;

    case WIFI_DIRECT_WPS_TYPE_PIN_DISPLAY:
        printf("mode is WPS PIN Display\n");
    break;

    case WIFI_DIRECT_WPS_TYPE_PIN_KEYPAD:
        printf("mode is WPS PIN Keypad\n");
    break;
    }
    return 0;
 }

 int main()
 {
    wifi_direct_initialize(); // Initialize Wi-Fi Direct
    wifi_direct_activate(); // Activate Wi-Fi Direct

    function();

    //       APP CODE HERE

    // App must clean up Wi-Fi Direct before exiting

    wifi_direct_deactivate(); // Deactivate Wi-Fi Direct
    wifi_direct_deinitialize(); // Deinitialize Wi-Fi Direct
    return 0;
 }

Gets MAC address of a local device.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/wifidirect

Remarks:

mac_address must be released using free().

Parameters:

[out]

mac_address

The MAC address

Returns:

0 on success, otherwise a negative error value

Return values:

WIFI_DIRECT_ERROR_NONE	Successful
WIFI_DIRECT_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_DIRECT_ERROR_OPERATION_FAILED	Operation failed
WIFI_DIRECT_ERROR_OUT_OF_MEMORY	Out of memory
WIFI_DIRECT_ERROR_COMMUNICATION_FAILED	Communication failed
WIFI_DIRECT_ERROR_PERMISSION_DENIED	Permission denied
WIFI_DIRECT_ERROR_NOT_PERMITTED	Operation not permitted
WIFI_DIRECT_ERROR_NOT_SUPPORTED	Not supported
WIFI_DIRECT_ERROR_NOT_INITIALIZED	Not initialized
WIFI_DIRECT_ERROR_RESOURCE_BUSY	Device or resource busy

Precondition:

Wi-Fi Direct service must be initialized by wifi_direct_initialize().

See also:

wifi_direct_initialize()

Here is an example of the usage:

 #include <stdio.h>
 #include <wifi_direct.h>

 int function(void);

 bool device_selected = false;

 void peers_cb(wifi_direct_discovered_peer_info_s* peer,
                                           void *user_data)
 {
    if (peer && !device_selected) {
        printf("peer device=%s MAC=%s\n", peer->device_name, peer->mac_address);

        device_selected = true;

        wifi_direct_connect(peer->mac_address); // Connect to the first discovered peer
    }
 }

 int function(void)
 {
    int ret;
    char *mac;
    char *ip;

    wifi_direct_get_ip_address(&ip); // get ip address

    ret = wifi_direct_get_mac_address(&mac); // get MAC address

    if (ret != WIFI_DIRECT_ERROR_NONE) {
        printf("Failed to get mac address\n");
        return -1;
    }

    printf("MAC address=%s\n", mac);
    g_free(ip);
    g_free(mac);
    return 0;
 }

 void callback_2(int error_code,
                 wifi_direct_connection_state_e state,
                 const char *mac, void *user_data)
 *{
    switch (state) {
    case WIFI_DIRECT_CONNECTION_IN_PROGRESS:
        printf("Connection in progress\n");
    break;

    case WIFI_DIRECT_CONNECTON_RSP:
        printf("Connected\n");

        function();
 break;

    case WIFI_DIRECT_DISCONNECTION_IND:
        printf("Disconnection IND\n");
    break;

    case WIFI_DIRECT_DISCONNECTION_RSP;
        printf("Disconnected\n");
    break;
 }
 *}

 void callback_1(int error_code,
               wifi_direct_discovery_state_e discovery_state,
               void *user_data)
 {
    switch(discovery_state) {
    case WIFI_DIRECT_DISCOVERY_STARTED:
        printf("Discovery started\n");
        break;

    case WIFI_DIRECT_ONLY_LISTEN_STARTED:
        printf("listen started\n");
        break;

    case WIFI_DIRECT_DISCOVERY_FINISHED:
        printf("Discovery finished\n");

        wifi_direct_foreach_discovered_peers(peers_cb,
                                        NULL);
        break;

    case WIFI_DIRECT_DISCOVERY_FOUND:
        printf("peer devices found\n");
        break;

    case WIFI_DIRECT_DISCOVERY_LOST:
        printf("Discovery lost\n");
        break;

    default:
    break;
    }
 }

 int main()
 {
    wifi_direct_initialize(); // Initialize Wi-Fi Direct
    wifi_direct_set_discovery_state_changed_cb(callback_1, NULL); // Register callback 1
    wifi_direct_set_connection_state_changed_cb(callback_2, NULL); // Register callback 2

    wifi_direct_activate(); // Activate Wi-Fi Direct
    wifi_direct_start_discovery(TRUE, 15); // Start discovery

    //       APP CODE HERE

    // App must clean up Wi-Fi Direct before exiting

    wifi_direct_deactivate(); // Deactivate Wi-Fi Direct
    wifi_direct_unset_connection_state_changed_cb(); // Deregister callback
    wifi_direct_unset_discovery_state_changed_cb(); // Deregister callback
    wifi_direct_deinitialize(); // Deinitialize Wi-Fi Direct
    return 0;
 }

Gets the max number of clients.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/wifidirect

Parameters:

[out]

max

The max number of clients

Returns:

0 on success, otherwise a negative error value

Return values:

WIFI_DIRECT_ERROR_NONE	Successful
WIFI_DIRECT_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_DIRECT_ERROR_OPERATION_FAILED	Operation failed
WIFI_DIRECT_ERROR_COMMUNICATION_FAILED	Communication failed
WIFI_DIRECT_ERROR_PERMISSION_DENIED	Permission denied
WIFI_DIRECT_ERROR_NOT_PERMITTED	Operation not permitted
WIFI_DIRECT_ERROR_NOT_SUPPORTED	Not supported
WIFI_DIRECT_ERROR_NOT_INITIALIZED	Not initialized
WIFI_DIRECT_ERROR_RESOURCE_BUSY	Device or resource busy

Precondition:

Wi-Fi Direct service must be initialized by wifi_direct_initialize().

See also:

wifi_direct_initialize()

wifi_direct_set_max_clients()

Here is an example of the usage:

 #include <stdio.h>
 #include <wifi_direct.h>


 int function(void)
 {
    int ret;
    int max_client;

    ret = wifi_direct_get_max_clients(&max_client);

    if (ret != WIFI_DIRECT_ERROR_NONE) {
        printf("Failed to get max clients\n");
        return -1;
    }

    printf("max client = %d\n", max_client);
    return 0;
 }

 int main()
 {
    wifi_direct_initialize(); // Initialize Wi-Fi Direct
    wifi_direct_activate(); // Activate Wi-Fi Direct

    function();

    //       APP CODE HERE

    // App must clean up Wi-Fi Direct before exiting

    wifi_direct_deactivate(); // Deactivate Wi-Fi Direct
    wifi_direct_deinitialize(); // Deinitialize Wi-Fi Direct
    return 0;
 }

Gets the name of network interface (for example: eth0, pdp0).

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/wifidirect

Remarks:

name must be released using free().

Parameters:

[out]

name

The name of the network interface

Returns:

0 on success, otherwise negative error value

Return values:

WIFI_DIRECT_ERROR_NONE	Successful
WIFI_DIRECT_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_DIRECT_ERROR_OPERATION_FAILED	Operation failed
WIFI_DIRECT_ERROR_OUT_OF_MEMORY	Out of memory
WIFI_DIRECT_ERROR_COMMUNICATION_FAILED	Communication failed
WIFI_DIRECT_ERROR_PERMISSION_DENIED	Permission denied
WIFI_DIRECT_ERROR_NOT_PERMITTED	Operation not permitted
WIFI_DIRECT_ERROR_NOT_SUPPORTED	Not supported
WIFI_DIRECT_ERROR_NOT_INITIALIZED	Not initialized
WIFI_DIRECT_ERROR_RESOURCE_BUSY	Device or resource busy

Precondition:

Wi-Fi Direct service must be activated by wifi_direct_activate().

See also:

wifi_direct_activate()

Here is an example of the usage:

 #include <stdio.h>
 #include <wifi_direct.h>

 int function(void)
 {
    int res;
    char *iface_name;

    res = wifi_direct_get_network_interface_name(&iface_name); // get interface name

    if (res != WIFI_DIRECT_ERROR_NONE) {
        printf("Failed to get interface name\n");
        return -1;
 }

    printf("interface = %s\n", iface_name);
    g_free(iface_name);
    return 0;
 }

 int main()
 {
    wifi_direct_initialize(); // Initialize Wi-Fi Direct
    wifi_direct_activate(); // Activate Wi-Fi Direct

    function();

    //       APP CODE HERE

    // App must clean up Wi-Fi Direct before exiting

    wifi_direct_deactivate(); // Deactivate Wi-Fi Direct
    wifi_direct_deinitialize(); // Deinitialize Wi-Fi Direct
    return 0;
 }