From 63c5fe19ec6b0ca180119189c7888243e49914ba Mon Sep 17 00:00:00 2001 From: "saerome.kim" Date: Mon, 2 Apr 2018 15:07:34 +0900 Subject: [PATCH] Fix that viloates the doxygen rules. - fix doxygen rule: @remars @a - seperate wifi-son into wifi-mesh and wifi-mesh monitor Change-Id: Iab8c36471f79f1e76c8be9c746c0494ab9e0f28d Signed-off-by: saerome.kim --- doc/wifi-mesh-doc.h | 88 ++- include/wifi-mesh.h | 1266 +++++++++++++++++++++++-------------------- 2 files changed, 747 insertions(+), 607 deletions(-) diff --git a/doc/wifi-mesh-doc.h b/doc/wifi-mesh-doc.h index 6ef03f8..3a61c5d 100644 --- a/doc/wifi-mesh-doc.h +++ b/doc/wifi-mesh-doc.h @@ -17,22 +17,26 @@ #define __TIZEN_NETWORK_WIFI_MESH_DOC_H__ /** + * @defgroup CAPI_NETWORK_WIFI_SON_MODULE Wi-Fi SON + * @brief This provides APIs to manage Wi-Fi SON. * @ingroup CAPI_NETWORK_FRAMEWORK - * @defgroup CAPI_NETWORK_WIFI_MESH_MODULE Wi-Fi Mesh - * @brief This provides APIs to manage Wi-Fi Mesh. * - * @section CAPI_NETWORK_WIFI_MESH_MODULE_HEADER Header + * @section CAPI_NETWORK_WIFI_SON_MODULE_HEADER Header * \#include * - * @section CAPI_NETWORK_WIFI_MESH_MODULE_OVERVIEW Overview - * This set of functions is used to manage the settings of Wi-Fi Mesh network. - * In addition, this set provides functions to connect and disconnect remote devices using Wi-Fi Mesh. + * @section CAPI_NETWORK_WIFI_SON_MODULE_OVERVIEW Overview + * When installing new wireless device or moving the existing Wi-Fi AP from one place to + * another at home. These are quite inconvenient tasks. + * This module can remove these inconveniences. + * This module detects each other among the devices which supports Wi-Fi Mesh Network, + * and configures the optimum network among each other. Additionally, utility functions + * allow the user to monitor or control network components. * - * @subsection CAPI_NETWORK_WIFI_MESH_MODULE_REFERENCE Wi-Fi Mesh Reference + * @subsection CAPI_NETWORK_WIFI_SON_MODULE_REFERENCE Wi-Fi Mesh Reference * - https://standards.ieee.org/findstds/standard/802.11s-2011.html/ * - http://linuxwireless.org/en/developers/Documentation/ieee80211/802.11s/ * - * @section CAPI_NETWORK_WIFI_MESH_MODULE_FEATURE Related Features + * @section CAPI_NETWORK_WIFI_SON_MODULE_FEATURE Related Features * These APIs are related with the following features:\n * - http://tizen.org/feature/network.wifi.mesh\n * - http://tizen.org/feature/network.wifi.mesh.admin\n @@ -47,5 +51,73 @@ * */ +/** + * @defgroup CAPI_NETWORK_WIFI_MESH_MANAGER_MODULE Wi-Fi SON Configuration + * @brief This provides APIs to manage Wi-Fi Mesh Network. + * @ingroup CAPI_NETWORK_WIFI_SON_MODULE + * + * @section CAPI_NETWORK_WIFI_MESH_MANAGER_NODULE_HEADER Header + * \#include + * + * @section CAPI_NETWORK_WIFI_MESH_MANAGER_MODULE_OVERVIEW Overview + * This set of functions is used to manage the Wi-Fi SON. + * - Provide ways to create/destroy a Wi-Fi Mesh network. + * - Provide ways to scan Wi-Fi Mesh networks around me. + * - Provide ways to start/stop Wi-Fi Mesh networking. + * - Provide ways to extend network using SoftAp functionality. + * + * It is recommended to design applications with regard to features, for reliability.\n + * + * You can check if a device supports the related features for this API by using @ref CAPI_SYSTEM_SYSTEM_INFO_MODULE, and control your application's actions accordingly.\n + * + * To ensure your application is only running on the device with specific features, please define the features in your manifest file using the manifest editor in the SDK.\n + * + * More details on using features in your application can be found in the Feature List. + * + */ + +/** + * @defgroup CAPI_NETWORK_WIFI_MESH_AP_MODULE Wi-Fi Mesh AP + * @brief This provides APIs to manage Wi-Fi Mesh AP. + * @ingroup CAPI_NETWORK_WIFI_MESH_MANAGER_MODULE + * + * @section CAPI_NETWORK_WIFI_MESH_AP_MODULE_HEADER Header + * \#include + * + * @section CAPI_NETWORK_WIFI_MESH_AP_MODULE_OVERVIEW Overview + * These set of functions are used to manage the Wi-Fi Mesh AP profile. + * + * It is recommended to design applications with regard to features, for reliability.\n + * + * You can check if a device supports the related features for this API by using @ref CAPI_SYSTEM_SYSTEM_INFO_MODULE, and control your application's actions accordingly.\n + * + * To ensure your application is only running on the device with specific features, please define the features in your manifest file using the manifest editor in the SDK.\n + * + * More details on using features in your application can be found in the Feature List. + * + */ + +/** + * @defgroup CAPI_NETWORK_WIFI_MESH_MONITOR_MODULE Wi-Fi SON Monitor + * @brief This provides APIs to monitor Wi-Fi Mesh system. + * @ingroup CAPI_NETWORK_WIFI_SON_MODULE + * + * @section CAPI_NETWORK_WIFI_MESH_MONITOR_MODULE_HEADER Header + * \#include + * + * @section CAPI_NETWORK_WIFI_MESH_MONITOR_MODULE_OVERVIEW Overview + * These functions are used to monitor link-related parameters of nodes present on the + * Wi-Fi Mesh network and adjust routing paths. + * + * It is recommended to design applications with regard to features, for reliability.\n + * + * You can check if a device supports the related features for this API by using @ref CAPI_SYSTEM_SYSTEM_INFO_MODULE, and control your application's actions accordingly.\n + * + * To ensure your application is only running on the device with specific features, please define the features in your manifest file using the manifest editor in the SDK.\n + * + * More details on using features in your application can be found in the Feature List. + * + */ + #endif __TIZEN_NETWORK_WIFI_MESH_DOC_H__ diff --git a/include/wifi-mesh.h b/include/wifi-mesh.h index e45ca8d..ec13a3b 100644 --- a/include/wifi-mesh.h +++ b/include/wifi-mesh.h @@ -28,7 +28,7 @@ extern "C" { */ /** - * @addtogroup CAPI_NETWORK_WIFI_MESH_MODULE + * @addtogroup CAPI_NETWORK_WIFI_MESH_MANAGER_MODULE * @{ */ @@ -71,7 +71,7 @@ typedef enum { */ /** - * @addtogroup CAPI_NETWORK_WIFI_MESH_MONITOR_MODULE + * @addtogroup CAPI_NETWORK_WIFI_MESH_MANAGER_MODULE * @since_tizen 5.0 * @{ */ @@ -215,15 +215,6 @@ typedef struct { } data; } wifi_mesh_event_data_s; -/** - * @} - */ - -/** - * @addtogroup CAPI_NETWORK_WIFI_MESH_MODULE - * @{ - */ - /** * @brief The Wi-Fi mesh network profile handle. * @since_tizen 5.0 @@ -237,1088 +228,1116 @@ typedef void* wifi_mesh_network_h; typedef void* wifi_mesh_peer_h; /** - * @brief Creates a network handle. - * @details This function is to allocate new mesh network information - * + * @brief Initializes a Wi-Fi Mesh network. * @since_tizen 5.0 * - * @param[out] network The mesh network information handle, we will allocate mesh - * network information structure internally. + * @privilege %http://tizen.org/privilege/wifi.admin * - * @return 0 on success, otherwise a negative error value. - * @retval #WIFI_MESH_ERROR_NONE Successful - * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #WIFI_MESH_ERROR_OUT_OF_MEMORY Memory error + * @remarks You must release @a handle using wifi_mesh_deinitialize(). * - * @see wifi_mesh_network_clone() - * @see wifi_mesh_network_new_with() - * @see wifi_mesh_network_destroy() + * @param[out] handle The Wi-Fi mesh handle * + * @return @c 0 on success, otherwise negative error value + * @retval #WIFI_MESH_ERROR_NONE Successful + * @retval #WIFI_MESH_ERROR_ALREADY_INITIALIZED Already initialized + * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #WIFI_MESH_ERROR_INVALID_OPERATION Invalid operation + * @retval #WIFI_MESH_ERROR_OPERATION_FAILED Operation failed + * @retval #WIFI_MESH_ERROR_PERMISSION_DENIED Permission Denied + * @retval #WIFI_MESH_ERROR_OUT_OF_MEMORY Out of memory + * @retval #WIFI_MESH_ERROR_NOT_SUPPORTED Not supported */ -int wifi_mesh_network_new(wifi_mesh_network_h* network); +int wifi_mesh_initialize(wifi_mesh_h *handle); /** - * @brief Clones a network handle. - * @details This function is to clone mesh network information - * + * @brief Deinitializes the Wi-Fi Mesh network. * @since_tizen 5.0 * - * @param[out] dst The target Wi-Fi mesh network information handle, we will allocate mesh - * network information structure internally. - * @param[in] src The source mesh network information handle. + * @param[in] handle The Wi-Fi mesh handle * - * @return 0 on success, otherwise a negative error value. + * @return 0 on success, otherwise negative error value * @retval #WIFI_MESH_ERROR_NONE Successful * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #WIFI_MESH_ERROR_OUT_OF_MEMORY Memory error - * - * @see wifi_mesh_network_new() - * @see wifi_mesh_network_new_with() - * @see wifi_mesh_network_destroy() - * + * @retval #WIFI_MESH_ERROR_INVALID_OPERATION Invalid operation + * @retval #WIFI_MESH_ERROR_OPERATION_FAILED Operation failed + * @retval #WIFI_MESH_ERROR_NOT_SUPPORTED Not supported */ -int wifi_mesh_network_clone(wifi_mesh_network_h* dst, wifi_mesh_network_h src); +int wifi_mesh_deinitialize(wifi_mesh_h handle); /** - * @brief Creates network handle with parameters. - * @details This function is to allocate new mesh network information + * @brief Specifies the type of function passed to wifi_mesh_enable(). + * @details This function can receive events from the Wi-Fi mesh network. + * ex) enabled state, scan result * * @since_tizen 5.0 * - * @param[out] network The mesh network information handle, we will allocate mesh - * network information structure internally. - * @param[in] meshid The Mesh Network ID - * @param[in] bssid The Basic Service Set ID - * @param[in] channel The operating channel number - * @param[in] rssi The Received Signal Strength Indicator - * @param[in] security The security type for network - * @param[in] passphrase The passphrase for network connection + * @remarks The @a event should not be released. + * @remarks The @a event can be used only in the callback. * - * @return 0 on success, otherwise a negative error value. - * @retval #WIFI_MESH_ERROR_NONE Successful - * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #WIFI_MESH_ERROR_OUT_OF_MEMORY Memory error + * @param[out] event_type The event identification + * @param[out] event parameter data pointer + * @param[out] user_data The user data passed from callback registration function * - * @see wifi_mesh_network_clone() - * @see wifi_mesh_network_new_with() - * @see wifi_mesh_network_destroy() + * @pre The callback must be registered using wifi_mesh_enable(). * + * @see wifi_mesh_set_event_cb() + * @see #WIFI_MESH_EVENT_ENABLED + * @see #WIFI_MESH_EVENT_SCAN_DONE + * @see #WIFI_MESH_EVENT_STATION_JOIN + * @see #WIFI_MESH_EVENT_STATION_LEFT */ -int wifi_mesh_network_new_with(wifi_mesh_network_h* network, const char *meshid, - const char *bssid, int channel, int rssi, wifi_mesh_security_type_e security, - const char *passphrase); +typedef void (*wifi_mesh_event_cb)(wifi_mesh_event_e event_type, + wifi_mesh_event_data_s* event, void *user_data); /** - * @brief Destroys network handle. - * @details This function is to destroy mesh network information + * @brief Sets event handler for the Wi-Fi mesh network service. + * @details Sets event handler to get events from the Wi-Fi mesh network service. * * @since_tizen 5.0 * - * @param[in] network The target Wi-Fi mesh network information handle. + * @param[in] handle The Wi-Fi mesh handle + * @param[in] event_handler The event handler + * @param[in] user_data The user data to be paased to event handler * * @return 0 on success, otherwise a negative error value. * @retval #WIFI_MESH_ERROR_NONE Successful * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #WIFI_MESH_ERROR_OUT_OF_MEMORY Memory error + * @retval #WIFI_MESH_ERROR_IO_ERROR Unexpected d-bus error + * @retval #WIFI_MESH_ERROR_NOT_SUPPORTED Not supported * - * @see wifi_mesh_network_new() - * @see wifi_mesh_network_new_with() - * @see wifi_mesh_network_clone() - * @see wifi_mesh_network_destroy() + * @see wifi_mesh_initialize() + * @see wifi_mesh_deinitialize() * */ -int wifi_mesh_network_destroy(wifi_mesh_network_h network); +int wifi_mesh_set_event_cb(wifi_mesh_h handle, + wifi_mesh_event_cb event_handler, void *user_data); /** - * @brief Gets a Wi-Fi mesh network id. - * @details This function is to return mesh network id + * @brief Makes the Wi-Fi mesh service enable. + * @details All this function to start Wi-Fi mesh service * * @since_tizen 5.0 * - * @remarks The @meshid should be released using free(). + * @remarks You must free all resources of the mesh by calling wifi_mesh_deinitialize() + * if mesh service is no longer needed. * - * @param[in] network The Wi-Fi mesh network information handle. - * @param[out] meshid The mesh network id. + * @param[in] handle The Wi-Fi mesh handle * * @return 0 on success, otherwise a negative error value. * @retval #WIFI_MESH_ERROR_NONE Successful * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #WIFI_MESH_ERROR_IO_ERROR Unexpected d-bus error * - * @see wifi_mesh_network_set_meshid() + * @see wifi_mesh_initialize() + * @see wifi_mesh_deinitialize() + * @see wifi_mesh_event_cb() + * @see wifi_mesh_disable() * */ -int wifi_mesh_network_get_meshid(wifi_mesh_network_h network, char **meshid); +int wifi_mesh_enable(wifi_mesh_h handle); /** - * @brief Sets a Wi-Fi mesh network id. - * @details This function is to set Wi-Fi mesh network id + * @brief Makes the Wi-Fi mesh service disable. + * @details all this function to stop Wi-Fi mesh service * * @since_tizen 5.0 * - * @param[in] network The Wi-Fi mesh network information handle. - * @param[in] meshid The mesh network id. + * @remarks You must free all resources of the mesh by calling wifi_mesh_deinitialize() + * if mesh service is no longer needed. + * + * @param[in] handle The Wi-Fi mesh handle * * @return 0 on success, otherwise a negative error value. * @retval #WIFI_MESH_ERROR_NONE Successful * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #WIFI_MESH_ERROR_IO_ERROR Unexpected d-bus error * - * @see wifi_mesh_network_get_meshid() + * @see wifi_mesh_initialize() + * @see wifi_mesh_deinitialize() + * @see wifi_mesh_enable() * */ -int wifi_mesh_network_set_meshid(wifi_mesh_network_h network, const char *meshid); +int wifi_mesh_disable(wifi_mesh_h handle); /** - * @brief Gets BSSID. - * @details This function is to get basic service set id + * @brief Scans Wi-Fi mesh networks. + * @details Scan all Wi-Fi mesh network to get network state. * * @since_tizen 5.0 * - * @remarks The @bssid should be released using free(). - * - * @param[in] network The Wi-Fi mesh network information handle. - * @param[out] bssid The basic service set id. + * @param[in] handle The Wi-Fi mesh handle * * @return 0 on success, otherwise a negative error value. * @retval #WIFI_MESH_ERROR_NONE Successful * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #WIFI_MESH_ERROR_IO_ERROR Unexpected d-bus error * - * @see wifi_mesh_network_set_bssid() + * @see wifi_mesh_specific_scan() + * @see wifi_mesh_cancel_scan() * */ -int wifi_mesh_network_get_bssid(wifi_mesh_network_h network, char **bssid); +int wifi_mesh_scan(wifi_mesh_h handle); /** - * @brief Sets BSSID. - * @details This function is to set basic service set id + * @brief Scans for the specific mesh network. + * @details Scan specific SSID and channel to get specific Wi-Fi mesh networks. * * @since_tizen 5.0 * - * @param[in] network The Wi-Fi mesh network information handle. - * @param[in] bssid The basic service set id. + * @param[in] handle The Wi-Fi mesh handle + * @param[in] ssid Specific SSID to scan + * @param[in] channel The channel number to scan * * @return 0 on success, otherwise a negative error value. * @retval #WIFI_MESH_ERROR_NONE Successful * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #WIFI_MESH_ERROR_IO_ERROR Unexpected d-bus error * - * @see wifi_mesh_network_get_bssid() + * @see wifi_mesh_scan() + * @see wifi_mesh_cancel_scan() * */ -int wifi_mesh_network_set_bssid(wifi_mesh_network_h network, const char *bssid); +int wifi_mesh_specific_scan(wifi_mesh_h handle, const char* ssid, int channel); /** - * @brief Gets channel. - * @details This function is to get channel + * @brief Cancels scanning for the mesh network. + * @details Stops scanning process of mesh network. * * @since_tizen 5.0 * - * @param[in] network The Wi-Fi mesh network information handle. - * @param[out] channel The operating channel number. + * @param[in] handle The Wi-Fi mesh handle + * * * @return 0 on success, otherwise a negative error value. * @retval #WIFI_MESH_ERROR_NONE Successful * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #WIFI_MESH_ERROR_IO_ERROR Unexpected d-bus error * - * @see wifi_mesh_network_set_channel() + * @see wifi_mesh_scan() + * @see wifi_mesh_specific_scan() + * @see wifi_mesh_scan() * */ -int wifi_mesh_network_get_channel(wifi_mesh_network_h network, int *channel); +int wifi_mesh_cancel_scan(wifi_mesh_h handle); /** - * @brief Sets channel. - * @details This function is to get channel + * @brief Called after wifi_mesh_foreach_found_network(). + * @details This function can receive scan results from Wi-Fi mesh networks. * * @since_tizen 5.0 * - * @param[in] network The Wi-Fi mesh network information handle. - * @param[in] channel The operating channel number. + * @remarks The @a network should not be released. + * @remarks The @a network can be used only in the callback. To use outside, make a copy. * - * @return 0 on success, otherwise a negative error value. - * @retval #WIFI_MESH_ERROR_NONE Successful - * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter + * @param[out] network mesh bss information handle + * @param[out] user_data user data pointer * - * @see wifi_mesh_network_get_channel() + * @pre The callback must be registered with wifi_mesh_foreach_found_network() * + * @see wifi_mesh_foreach_found_network() */ -int wifi_mesh_network_set_channel(wifi_mesh_network_h network, int channel); +typedef void (*wifi_mesh_found_network_cb)(wifi_mesh_network_h network, void* user_data); /** - * @brief Gets RSSI. - * @details This function is to get RSSI + * @brief Gets found Wi-Fi mesh network bss information. + * @details This function returns network information found through wifi_mesh_found_network_cb. * * @since_tizen 5.0 * - * @param[in] network The Wi-Fi mesh network information handle. - * @param[out] RSSI The received signal strength indicator. + * @param[in] handle The Wi-Fi mesh handle + * @param[in] cb callback function pointer to inform bss information + * @param[in] user_data user data pointer * * @return 0 on success, otherwise a negative error value. * @retval #WIFI_MESH_ERROR_NONE Successful * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #WIFI_MESH_ERROR_IO_ERROR Unexpected d-bus error * - * @see wifi_mesh_network_set_rssi() + * @see wifi_mesh_scan() + * @see wifi_mesh_found_network_cb() * */ -int wifi_mesh_network_get_rssi(wifi_mesh_network_h network, int *RSSI); +int wifi_mesh_foreach_found_network(wifi_mesh_h handle, + wifi_mesh_found_network_cb cb, void *user_data); /** - * @brief Sets RSSI. - * @details This function is to set RSSI + * @brief Called after wifi_mesh_foreach_connected_peers(). + * @details This function can receive connected peers on the Wi-Fi mesh network. * * @since_tizen 5.0 * - * @param[in] network The Wi-Fi mesh network information handle. - * @param[in] RSSI The received signal strength indicator. + * @remarks The @a peer should not be released. + * @remarks The @a peer can be used only in the callback. To use outside, make a copy. * - * @return 0 on success, otherwise a negative error value. - * @retval #WIFI_MESH_ERROR_NONE Successful - * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter + * @param[out] peer The mesh peer information handle + * @param[out] user_data user data pointer * - * @see wifi_mesh_network_get_rssi() + * @pre The callback must be registered with wifi_mesh_foreach_connected_peers() * + * @see wifi_mesh_foreach_connected_peers() */ -int wifi_mesh_network_set_rssi(wifi_mesh_network_h network, int RSSI); +typedef void (*wifi_mesh_connected_peer_cb)(wifi_mesh_peer_h peer, void* user_data); /** - * @brief Gets the security type. - * @details This function is to get the security type. + * @brief Gets found Wi-Fi mesh network peer information. + * @details This function returns network information found through wifi_mesh_connected_peer_cb. * * @since_tizen 5.0 * - * @param[in] network The Wi-Fi mesh network information handle. - * @param[out] security The security type for network. + * @param[in] handle The Wi-Fi mesh handle + * @param[in] cb callback function pointer to inform peer information + * @param[in] user_data user data pointer + * * * @return 0 on success, otherwise a negative error value. * @retval #WIFI_MESH_ERROR_NONE Successful * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #WIFI_MESH_ERROR_IO_ERROR Unexpected d-bus error * - * @see wifi_mesh_network_set_security() + * @see mesh_find_peers() + * @see wifi_mesh_connected_peer_cb() * */ -int wifi_mesh_network_get_security(wifi_mesh_network_h network, wifi_mesh_security_type_e *security); +int wifi_mesh_foreach_connected_peers(wifi_mesh_h handle, + wifi_mesh_connected_peer_cb cb, void *user_data); /** - * @brief Sets the security type. - * @details This function is to set the security type. - * - * @since_tizen 5.0 + * @brief Starts the Wi-Fi mesh network. + * @details This function is to create a Wi-Fi mesh network and do auto-connection + * using saved Wi-Fi mesh network configuration * - * @param[in] network The Wi-Fi mesh network information handle. - * @param[in] security The security type for network. + * @since_tizen 5.0 + * + * @param[in] handle The Wi-Fi mesh handle * * @return 0 on success, otherwise a negative error value. * @retval #WIFI_MESH_ERROR_NONE Successful * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #WIFI_MESH_ERROR_IO_ERROR Unexpected d-bus error * - * @see wifi_mesh_network_get_security() + * @see wifi_mesh_stop() * */ -int wifi_mesh_network_set_security(wifi_mesh_network_h network, wifi_mesh_security_type_e security); +int wifi_mesh_start(wifi_mesh_h handle); /** - * @brief Sets the passphrase for network connection. - * @details This function is to set the passphrase. + * @brief Stops the Wi-Fi mesh network. + * @details This function is to disconnect the current Wi-Fi mesh network and + * destroy all related to the Wi-Fi mesh network * * @since_tizen 5.0 * - * @param[in] network The Wi-Fi mesh network information handle. - * @param[in] passphrase The passphrase for network connection. + * @param[in] handle The Wi-Fi mesh handle * * @return 0 on success, otherwise a negative error value. * @retval #WIFI_MESH_ERROR_NONE Successful * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #WIFI_MESH_ERROR_IO_ERROR Unexpected d-bus error + * + * @see wifi_mesh_start() * - * @see wifi_mesh_network_get_security() - * @see wifi_mesh_network_set_security() */ -int wifi_mesh_network_set_passphrase(wifi_mesh_network_h network, const char* passphrase); +int wifi_mesh_stop(wifi_mesh_h handle); /** - * @brief Gets the connection state. - * @details This function is to get the connection state + * @brief Gets the Wi-Fi mesh enable state. + * @details Check if mesh is enabled in current device. * * @since_tizen 5.0 * - * @param[in] network The Wi-Fi mesh network information handle. - * @param[out] state The maximum data rate. + * @param[in] handle The Wi-Fi mesh handle + * @param[out] is_started The state of mesh. + * * * @return 0 on success, otherwise a negative error value. * @retval #WIFI_MESH_ERROR_NONE Successful * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #WIFI_MESH_ERROR_IO_ERROR Unexpected d-bus error + * + * @see wifi_mesh_start() + * @see wifi_mesh_stop() * */ -int wifi_mesh_network_get_connection_state(wifi_mesh_network_h network, wifi_mesh_connection_state_e *state); +int wifi_mesh_is_started(wifi_mesh_h handle, bool *is_started); /** - * @brief Gets the IP Config Type. - * @details This function is to gets the IP Config Type + * @brief Gets the Wi-Fi mesh connection state. + * @details Check if current device is joined Wi-Fi mesh network. * * @since_tizen 5.0 * - * @param[in] network The Wi-Fi mesh network information handle. - * @param[in] address_family Address Family - * @param[out] ip_type The IP Config Type + * @param[in] handle The Wi-Fi mesh handle + * @param[out] is_joined The state of mesh network connection. + * * * @return 0 on success, otherwise a negative error value. * @retval #WIFI_MESH_ERROR_NONE Successful * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #WIFI_MESH_ERROR_IO_ERROR Unexpected d-bus error + * + * @see wifi_mesh_start() + * @see wifi_mesh_found_network_cb() * */ -int wifi_mesh_network_get_ip_config_type(wifi_mesh_network_h network, - wifi_mesh_address_family_e address_family, - wifi_mesh_ip_config_type_e *ip_type); +int wifi_mesh_is_joined(wifi_mesh_h handle, bool* is_joined); /** - * @brief Gets the IP Address. - * @details This function is to gets the IP Address + * @brief Gets current joined Wi-Fi mesh network information. + * @details Return current joined Wi-Fi mesh network information.. * * @since_tizen 5.0 * - * @remarks You must release @ip_address using free(). + * @param[in] handle The Wi-Fi mesh handle + * @param[out] network Wi-Fi Mesh bss information handle * - * @param[in] network The Wi-Fi mesh network information handle. - * @param[in] address_family Address Family - * @param[out] ip_address The IP Address * * @return 0 on success, otherwise a negative error value. * @retval #WIFI_MESH_ERROR_NONE Successful * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #WIFI_MESH_ERROR_IO_ERROR Unexpected d-bus error + * + * @see wifi_mesh_start() * */ -int wifi_mesh_network_get_ip_address(wifi_mesh_network_h network, - wifi_mesh_address_family_e address_family, char **ip_address); +int wifi_mesh_get_joined_network(wifi_mesh_h handle, wifi_mesh_network_h* network); /** - * @brief Gets the Subnet Mask. - * @details This function is to gets the subnet mask + * @brief Sets softap options. + * @details This function sets softap options. * * @since_tizen 5.0 * - * @remarks You must release @subnet_mask using free(). + * @param[in] handle The Wi-Fi mesh handle + * @param[in] ssid The SSID + * @param[in] key The pre-shared key + * @param[in] channel The operating channel number + * @param[in] visibility The broadcast option (1:Broadcast SSID, 2:Hidden) + * @param[in] max_stations The maximum allowable number of stations (default:10) + * @param[in] security Security option (1:WPA1, 2:WPA2) * - * @param[in] network The Wi-Fi mesh network information handle. - * @param[in] address_family Address Family - * @param[out] subnet_mask The Subnet Mask * * @return 0 on success, otherwise a negative error value. * @retval #WIFI_MESH_ERROR_NONE Successful * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #WIFI_MESH_ERROR_IO_ERROR Unexpected d-bus error + * + * @see wifi_mesh_enable_softap() + * @see wifi_mesh_disable_softap() * */ -int wifi_mesh_network_get_subnet_mask(wifi_mesh_network_h network, - wifi_mesh_address_family_e address_family, char **subnet_mask); +int wifi_mesh_set_softap(wifi_mesh_h handle, const char* ssid, const char* key, + int channel, bool visibility, int max_stations, int security); /** - * @brief Gets address from the Wi-Fi mesh peer. - * @details This function is to return mesh network id + * @brief Gets softap options. + * @details This function gets softap options. * * @since_tizen 5.0 * - * @remarks You must release @address using free(). + * @remarks The @a ssid should be released using free(). + * @remarks The @a key should be released using free(). + * + * @param[in] handle The Wi-Fi mesh handle + * @param[out] ssid The SSID + * @param[out] channel The operating channel number + * @param[out] visibility The broadcast option (1:Broadcast SSID, 2:Hidden) + * @param[out] max_stations The maximum allowable number of stations (default:10) + * @param[out] security Security option (1:WPA1, 2:WPA2) + * @param[out] key The pre-shared key * - * @param[in] peer The mesh peer information handle. - * @param[out] address The address of mesh peer. * * @return 0 on success, otherwise a negative error value. * @retval #WIFI_MESH_ERROR_NONE Successful * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #WIFI_MESH_ERROR_IO_ERROR Unexpected d-bus error * - */ -int wifi_mesh_peer_get_address(wifi_mesh_peer_h peer, char **address); - -/** - * @brief Initializes a Wi-Fi Mesh network. - * @since_tizen 5.0 - * - * @privilege %http://tizen.org/privilege/wifi.admin - * - * @remarks You must release @handle using wifi_mesh_deinitialize(). - * - * @param[out] handle The Wi-Fi mesh handle + * @see wifi_mesh_set_softap() + * @see wifi_mesh_enable_softap() + * @see wifi_mesh_disable_softap() * - * @return @c 0 on success, otherwise negative error value - * @retval #WIFI_MESH_ERROR_NONE Successful - * @retval #WIFI_MESH_ERROR_ALREADY_INITIALIZED Already initialized - * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #WIFI_MESH_ERROR_INVALID_OPERATION Invalid operation - * @retval #WIFI_MESH_ERROR_OPERATION_FAILED Operation failed - * @retval #WIFI_MESH_ERROR_PERMISSION_DENIED Permission Denied - * @retval #WIFI_MESH_ERROR_OUT_OF_MEMORY Out of memory - * @retval #WIFI_MESH_ERROR_NOT_SUPPORTED Not supported */ -int wifi_mesh_initialize(wifi_mesh_h *handle); +int wifi_mesh_get_softap(wifi_mesh_h handle, char **ssid, int *channel, + bool *visibility, int *max_stations, + int *security, char **key); /** - * @brief Deinitializes the Wi-Fi Mesh network. + * @brief Makes softap enable. + * @details This function enables softap. + * * @since_tizen 5.0 * * @param[in] handle The Wi-Fi mesh handle * - * @return 0 on success, otherwise negative error value + * + * @return 0 on success, otherwise a negative error value. * @retval #WIFI_MESH_ERROR_NONE Successful * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #WIFI_MESH_ERROR_INVALID_OPERATION Invalid operation - * @retval #WIFI_MESH_ERROR_OPERATION_FAILED Operation failed - * @retval #WIFI_MESH_ERROR_NOT_SUPPORTED Not supported - */ -int wifi_mesh_deinitialize(wifi_mesh_h handle); - -/** - * @brief Specifies the type of function passed to wifi_mesh_enable(). - * @details This function can receive events from the Wi-Fi mesh network. - * ex) enabled state, scan result - * - * @since_tizen 5.0 - * - * @remarks The @event should not be released. - * @remarks The @event can be used only in the callback. - * - * @param[out] event_type The event identification - * @param[out] event parameter data pointer - * @param[out] user_data The user data passed from callback registration function + * @retval #WIFI_MESH_ERROR_IO_ERROR Unexpected d-bus error * - * @pre The callback must be registered using wifi_mesh_enable(). + * @see wifi_mesh_set_softap() + * @see wifi_mesh_disable_softap() * - * @see wifi_mesh_set_event_cb() - * @see #WIFI_MESH_EVENT_ENABLED - * @see #WIFI_MESH_EVENT_SCAN_DONE - * @see #WIFI_MESH_EVENT_STATION_JOIN - * @see #WIFI_MESH_EVENT_STATION_LEFT */ -typedef void (*wifi_mesh_event_cb)(wifi_mesh_event_e event_type, - wifi_mesh_event_data_s* event, void *user_data); +int wifi_mesh_enable_softap(wifi_mesh_h handle); /** - * @brief Sets event handler for the Wi-Fi mesh network service. - * @details Sets event handler to get events from the Wi-Fi mesh network service. + * @brief Makes softap disable. + * @details This function disables softap. * * @since_tizen 5.0 * * @param[in] handle The Wi-Fi mesh handle - * @param[in] event_handler The event handler - * @param[in] user_data The user data to be paased to event handler + * * * @return 0 on success, otherwise a negative error value. * @retval #WIFI_MESH_ERROR_NONE Successful * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter * @retval #WIFI_MESH_ERROR_IO_ERROR Unexpected d-bus error - * @retval #WIFI_MESH_ERROR_NOT_SUPPORTED Not supported * - * @see wifi_mesh_initialize() - * @see wifi_mesh_deinitialize() + * @see wifi_mesh_set_softap() + * @see wifi_mesh_enable_softap() + * @see wifi_mesh_is_softap_started() * */ -int wifi_mesh_set_event_cb(wifi_mesh_h handle, - wifi_mesh_event_cb event_handler, void *user_data); +int wifi_mesh_disable_softap(wifi_mesh_h handle); /** - * @brief Makes the Wi-Fi mesh service enable. - * @details All this function to start Wi-Fi mesh service + * @brief Checks softap status. + * @details This function checks softap status * * @since_tizen 5.0 * - * @remarks You must free all resources of the mesh by calling wifi_mesh_deinitialize() - * if mesh service is no longer needed. - * * @param[in] handle The Wi-Fi mesh handle + * @param[out] status Status of SoftAP + * * * @return 0 on success, otherwise a negative error value. * @retval #WIFI_MESH_ERROR_NONE Successful * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter * @retval #WIFI_MESH_ERROR_IO_ERROR Unexpected d-bus error * - * @see wifi_mesh_initialize() - * @see wifi_mesh_deinitialize() - * @see wifi_mesh_event_cb() - * @see wifi_mesh_disable() + * @see wifi_mesh_set_softap() + * @see wifi_mesh_enable_softap() * */ -int wifi_mesh_enable(wifi_mesh_h handle); +int wifi_mesh_is_softap_started(wifi_mesh_h handle, bool *status); /** - * @brief Makes the Wi-Fi mesh service disable. - * @details all this function to stop Wi-Fi mesh service + * @brief Sets gate options. + * @details This function sets mesh gate options. * * @since_tizen 5.0 * - * @remarks You must free all resources of the mesh by calling wifi_mesh_deinitialize() - * if mesh service is no longer needed. - * * @param[in] handle The Wi-Fi mesh handle + * @param[in] gate_announce Enable / Disable Gate Announce to peers + * @param[in] hwmp_root_mode HWMP (Hybrid Wireless Mesh Protocol) Root Mode \n + * #MESH_HWMP_ROOT_REACTIVE_MODE \n + * #MESH_HWMP_ROOT_SIMPLE_PROACTIVE_MODE \n + * #MESH_HWMP_ROOT_FORCED_PROACTIVE_MODE \n + * #MESH_HWMP_ROOT_PROACTIVE_WITH_RANN_MODE \n + * @param[in] stp Enable / Disable Gate Announce to peers + * * * @return 0 on success, otherwise a negative error value. * @retval #WIFI_MESH_ERROR_NONE Successful * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter * @retval #WIFI_MESH_ERROR_IO_ERROR Unexpected d-bus error * - * @see wifi_mesh_initialize() - * @see wifi_mesh_deinitialize() - * @see wifi_mesh_enable() + * @see wifi_mesh_unset_gate() * */ -int wifi_mesh_disable(wifi_mesh_h handle); +int wifi_mesh_set_gate(wifi_mesh_h handle, int gate_announce, + int hwmp_root_mode, bool stp); /** - * @brief Scans Wi-Fi mesh networks. - * @details Scan all Wi-Fi mesh network to get network state. + * @brief Unsets gate options. + * @details This function unsets mesh gate options. * * @since_tizen 5.0 * * @param[in] handle The Wi-Fi mesh handle * + * * @return 0 on success, otherwise a negative error value. * @retval #WIFI_MESH_ERROR_NONE Successful * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter * @retval #WIFI_MESH_ERROR_IO_ERROR Unexpected d-bus error * - * @see wifi_mesh_specific_scan() - * @see wifi_mesh_cancel_scan() + * @see wifi_mesh_set_gate() * */ -int wifi_mesh_scan(wifi_mesh_h handle); +int wifi_mesh_unset_gate(wifi_mesh_h handle); + /** - * @brief Scans for the specific mesh network. - * @details Scan specific SSID and channel to get specific Wi-Fi mesh networks. + * @brief Creates new Wi-Fi mesh network configuration. + * @details This function creates new mesh network. * * @since_tizen 5.0 * * @param[in] handle The Wi-Fi mesh handle - * @param[in] ssid Specific SSID to scan - * @param[in] channel The channel number to scan + * @param[in] network Wi-Fi Mesh bss information handle + * * * @return 0 on success, otherwise a negative error value. * @retval #WIFI_MESH_ERROR_NONE Successful * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter * @retval #WIFI_MESH_ERROR_IO_ERROR Unexpected d-bus error * - * @see wifi_mesh_scan() - * @see wifi_mesh_cancel_scan() + * @see wifi_mesh_connect_network() + * @see wifi_mesh_disconnect_network() + * @see wifi_mesh_forget_network() * */ -int wifi_mesh_specific_scan(wifi_mesh_h handle, const char* ssid, int channel); +int wifi_mesh_create_network(wifi_mesh_h handle, wifi_mesh_network_h network); /** - * @brief Called after wifi_mesh_foreach_found_network(). - * @details This function can receive scan results from Wi-Fi mesh networks. + * @brief Connects existing Wi-Fi mesh network. + * @details This function makes a connection to existing Wi-Fi mesh network. * * @since_tizen 5.0 * - * @remarks The @network should not be released. - * @remarks The @network can be used only in the callback. To use outside, make a copy. + * @param[in] handle The Wi-Fi mesh handle + * @param[in] network Wi-Fi Mesh bss information handle * - * @param[out] network mesh bss information handle - * @param[out] user_data user data pointer * - * @pre The callback must be registered with wifi_mesh_foreach_found_network() + * @return 0 on success, otherwise a negative error value. + * @retval #WIFI_MESH_ERROR_NONE Successful + * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #WIFI_MESH_ERROR_IO_ERROR Unexpected d-bus error + * + * @see wifi_mesh_create_network() + * @see wifi_mesh_disconnect_network() + * @see wifi_mesh_forget_network() * - * @see wifi_mesh_foreach_found_network() */ -typedef void (*wifi_mesh_found_network_cb)(wifi_mesh_network_h network, void* user_data); +int wifi_mesh_connect_network(wifi_mesh_h handle, wifi_mesh_network_h network); /** - * @brief Gets found Wi-Fi mesh network bss information. - * @details This function returns network information found through wifi_mesh_found_network_cb. + * @brief Disconnects existing Wi-Fi mesh network. + * @details This function disconnects with existing Wi-Fi mesh network. * * @since_tizen 5.0 * * @param[in] handle The Wi-Fi mesh handle - * @param[in] cb callback function pointer to inform bss information - * @param[in] user_data user data pointer + * @param[in] network Wi-Fi Mesh bss information handle + * * * @return 0 on success, otherwise a negative error value. * @retval #WIFI_MESH_ERROR_NONE Successful * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter * @retval #WIFI_MESH_ERROR_IO_ERROR Unexpected d-bus error * - * @see wifi_mesh_scan() - * @see wifi_mesh_found_network_cb() + * @see wifi_mesh_create_network() + * @see wifi_mesh_forget_network() * */ -int wifi_mesh_foreach_found_network(wifi_mesh_h handle, - wifi_mesh_found_network_cb cb, void *user_data); +int wifi_mesh_disconnect_network(wifi_mesh_h handle, wifi_mesh_network_h network); /** - * @brief Called after wifi_mesh_foreach_connected_peers(). - * @details This function can receive connected peers on the Wi-Fi mesh network. + * @brief Forgets existing Wi-Fi mesh network. + * @details This function removes the information of connected network. * * @since_tizen 5.0 * - * @remarks The @peer should not be released. - * @remarks The @peer can be used only in the callback. To use outside, make a copy. + * @param[in] handle The Wi-Fi mesh handle + * @param[in] network Wi-Fi Mesh bss information handle * - * @param[out] peer The mesh peer information handle - * @param[out] user_data user data pointer * - * @pre The callback must be registered with wifi_mesh_foreach_connected_peers() + * @return 0 on success, otherwise a negative error value. + * @retval #WIFI_MESH_ERROR_NONE Successful + * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #WIFI_MESH_ERROR_IO_ERROR Unexpected d-bus error + * + * @see wifi_mesh_create_network() + * @see wifi_mesh_connect_network() + * @see wifi_mesh_disconnect_network() * - * @see wifi_mesh_foreach_connected_peers() */ -typedef void (*wifi_mesh_connected_peer_cb)(wifi_mesh_peer_h peer, void* user_data); +int wifi_mesh_forget_network(wifi_mesh_h handle, wifi_mesh_network_h network); /** - * @brief Gets found Wi-Fi mesh network peer information. - * @details This function returns network information found through wifi_mesh_connected_peer_cb. + * @} + */ + +/** + * @addtogroup CAPI_NETWORK_WIFI_MESH_AP_MODULE + * @{ + */ + +/** + * @brief Creates a network handle. + * @details This function is to allocate new mesh network information * * @since_tizen 5.0 * - * @param[in] handle The Wi-Fi mesh handle - * @param[in] cb callback function pointer to inform peer information - * @param[in] user_data user data pointer - * + * @param[out] network The mesh network information handle, we will allocate mesh + * network information structure internally. * * @return 0 on success, otherwise a negative error value. * @retval #WIFI_MESH_ERROR_NONE Successful * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #WIFI_MESH_ERROR_IO_ERROR Unexpected d-bus error + * @retval #WIFI_MESH_ERROR_OUT_OF_MEMORY Memory error * - * @see mesh_find_peers() - * @see wifi_mesh_connected_peer_cb() + * @see wifi_mesh_network_clone() + * @see wifi_mesh_network_new_with() + * @see wifi_mesh_network_destroy() * */ -int wifi_mesh_foreach_connected_peers(wifi_mesh_h handle, - wifi_mesh_connected_peer_cb cb, void *user_data); +int wifi_mesh_network_new(wifi_mesh_network_h* network); /** - * @brief Starts the Wi-Fi mesh network. - * @details This function is to create a Wi-Fi mesh network and do auto-connection - * using saved Wi-Fi mesh network configuration + * @brief Clones a network handle. + * @details This function is to clone mesh network information * * @since_tizen 5.0 * - * @param[in] handle The Wi-Fi mesh handle + * @param[out] dst The target Wi-Fi mesh network information handle, we will allocate mesh + * network information structure internally. + * @param[in] src The source mesh network information handle. * * @return 0 on success, otherwise a negative error value. * @retval #WIFI_MESH_ERROR_NONE Successful * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #WIFI_MESH_ERROR_IO_ERROR Unexpected d-bus error + * @retval #WIFI_MESH_ERROR_OUT_OF_MEMORY Memory error * - * @see wifi_mesh_stop() + * @see wifi_mesh_network_new() + * @see wifi_mesh_network_new_with() + * @see wifi_mesh_network_destroy() * */ -int wifi_mesh_start(wifi_mesh_h handle); +int wifi_mesh_network_clone(wifi_mesh_network_h* dst, wifi_mesh_network_h src); /** - * @brief Stops the Wi-Fi mesh network. - * @details This function is to disconnect the current Wi-Fi mesh network and - * destroy all related to the Wi-Fi mesh network + * @brief Creates network handle with parameters. + * @details This function is to allocate new mesh network information * * @since_tizen 5.0 * - * @param[in] handle The Wi-Fi mesh handle + * @param[out] network The mesh network information handle, we will allocate mesh + * network information structure internally. + * @param[in] meshid The Mesh Network ID + * @param[in] bssid The Basic Service Set ID + * @param[in] channel The operating channel number + * @param[in] rssi The Received Signal Strength Indicator + * @param[in] security The security type for network + * @param[in] passphrase The passphrase for network connection * * @return 0 on success, otherwise a negative error value. * @retval #WIFI_MESH_ERROR_NONE Successful * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #WIFI_MESH_ERROR_IO_ERROR Unexpected d-bus error + * @retval #WIFI_MESH_ERROR_OUT_OF_MEMORY Memory error * - * @see wifi_mesh_start() + * @see wifi_mesh_network_clone() + * @see wifi_mesh_network_new_with() + * @see wifi_mesh_network_destroy() * */ -int wifi_mesh_stop(wifi_mesh_h handle); +int wifi_mesh_network_new_with(wifi_mesh_network_h* network, const char *meshid, + const char *bssid, int channel, int rssi, wifi_mesh_security_type_e security, + const char *passphrase); /** - * @brief Gets the Wi-Fi mesh enable state. - * @details Check if mesh is enabled in current device. + * @brief Destroys network handle. + * @details This function is to destroy mesh network information * * @since_tizen 5.0 * - * @param[in] handle The Wi-Fi mesh handle - * @param[out] is_started The state of mesh. - * + * @param[in] network The target Wi-Fi mesh network information handle. * * @return 0 on success, otherwise a negative error value. * @retval #WIFI_MESH_ERROR_NONE Successful * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #WIFI_MESH_ERROR_IO_ERROR Unexpected d-bus error + * @retval #WIFI_MESH_ERROR_OUT_OF_MEMORY Memory error * - * @see wifi_mesh_start() - * @see wifi_mesh_stop() + * @see wifi_mesh_network_new() + * @see wifi_mesh_network_new_with() + * @see wifi_mesh_network_clone() + * @see wifi_mesh_network_destroy() * */ -int wifi_mesh_is_started(wifi_mesh_h handle, bool *is_started); +int wifi_mesh_network_destroy(wifi_mesh_network_h network); /** - * @brief Gets the Wi-Fi mesh connection state. - * @details Check if current device is joined Wi-Fi mesh network. + * @brief Gets a Wi-Fi mesh network id. + * @details This function is to return mesh network id * * @since_tizen 5.0 * - * @param[in] handle The Wi-Fi mesh handle - * @param[out] is_joined The state of mesh network connection. + * @remarks The @a meshid should be released using free(). * + * @param[in] network The Wi-Fi mesh network information handle. + * @param[out] meshid The mesh network id. * * @return 0 on success, otherwise a negative error value. * @retval #WIFI_MESH_ERROR_NONE Successful * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #WIFI_MESH_ERROR_IO_ERROR Unexpected d-bus error * - * @see wifi_mesh_start() - * @see wifi_mesh_found_network_cb() + * @see wifi_mesh_network_set_meshid() * */ -int wifi_mesh_is_joined(wifi_mesh_h handle, bool* is_joined); +int wifi_mesh_network_get_meshid(wifi_mesh_network_h network, char **meshid); /** - * @brief Gets current joined Wi-Fi mesh network information. - * @details Return current joined Wi-Fi mesh network information.. + * @brief Sets a Wi-Fi mesh network id. + * @details This function is to set Wi-Fi mesh network id * * @since_tizen 5.0 * - * @param[in] handle The Wi-Fi mesh handle - * @param[out] network Wi-Fi Mesh bss information handle - * + * @param[in] network The Wi-Fi mesh network information handle. + * @param[in] meshid The mesh network id. * * @return 0 on success, otherwise a negative error value. * @retval #WIFI_MESH_ERROR_NONE Successful * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #WIFI_MESH_ERROR_IO_ERROR Unexpected d-bus error * - * @see wifi_mesh_start() + * @see wifi_mesh_network_get_meshid() * */ -int wifi_mesh_get_joined_network(wifi_mesh_h handle, wifi_mesh_network_h* network); +int wifi_mesh_network_set_meshid(wifi_mesh_network_h network, const char *meshid); /** - * @brief Sets softap options. - * @details This function sets softap options. + * @brief Gets BSSID. + * @details This function is to get basic service set id * * @since_tizen 5.0 * - * @param[in] handle The Wi-Fi mesh handle - * @param[in] ssid The SSID - * @param[in] key The pre-shared key - * @param[in] channel The operating channel number - * @param[in] visibility The broadcast option (1:Broadcast SSID, 2:Hidden) - * @param[in] max_stations The maximum allowable number of stations (default:10) - * @param[in] security Security option (1:WPA1, 2:WPA2) + * @remarks The @a bssid should be released using free(). * + * @param[in] network The Wi-Fi mesh network information handle. + * @param[out] bssid The basic service set id. * * @return 0 on success, otherwise a negative error value. * @retval #WIFI_MESH_ERROR_NONE Successful * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #WIFI_MESH_ERROR_IO_ERROR Unexpected d-bus error * - * @see wifi_mesh_enable_softap() - * @see wifi_mesh_disable_softap() + * @see wifi_mesh_network_set_bssid() * */ -int wifi_mesh_set_softap(wifi_mesh_h handle, const char* ssid, const char* key, - int channel, bool visibility, int max_stations, int security); +int wifi_mesh_network_get_bssid(wifi_mesh_network_h network, char **bssid); /** - * @brief Gets softap options. - * @details This function gets softap options. + * @brief Sets BSSID. + * @details This function is to set basic service set id * * @since_tizen 5.0 * - * @remarks The @ssid should be released using free(). - * @remarks The @key should be released using free(). - * - * @param[in] handle The Wi-Fi mesh handle - * @param[out] ssid The SSID - * @param[out] channel The operating channel number - * @param[out] visibility The broadcast option (1:Broadcast SSID, 2:Hidden) - * @param[out] max_stations The maximum allowable number of stations (default:10) - * @param[out] security Security option (1:WPA1, 2:WPA2) - * @param[out] key The pre-shared key - * + * @param[in] network The Wi-Fi mesh network information handle. + * @param[in] bssid The basic service set id. * * @return 0 on success, otherwise a negative error value. * @retval #WIFI_MESH_ERROR_NONE Successful * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #WIFI_MESH_ERROR_IO_ERROR Unexpected d-bus error * - * @see wifi_mesh_set_softap() - * @see wifi_mesh_enable_softap() - * @see wifi_mesh_disable_softap() + * @see wifi_mesh_network_get_bssid() * */ -int wifi_mesh_get_softap(wifi_mesh_h handle, char **ssid, int *channel, - bool *visibility, int *max_stations, - int *security, char **key); +int wifi_mesh_network_set_bssid(wifi_mesh_network_h network, const char *bssid); /** - * @brief Makes softap enable. - * @details This function enables softap. + * @brief Gets channel. + * @details This function is to get channel * * @since_tizen 5.0 * - * @param[in] handle The Wi-Fi mesh handle - * + * @param[in] network The Wi-Fi mesh network information handle. + * @param[out] channel The operating channel number. * * @return 0 on success, otherwise a negative error value. * @retval #WIFI_MESH_ERROR_NONE Successful * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #WIFI_MESH_ERROR_IO_ERROR Unexpected d-bus error * - * @see wifi_mesh_set_softap() - * @see wifi_mesh_disable_softap() + * @see wifi_mesh_network_set_channel() * */ -int wifi_mesh_enable_softap(wifi_mesh_h handle); +int wifi_mesh_network_get_channel(wifi_mesh_network_h network, int *channel); /** - * @brief Makes softap disable. - * @details This function disables softap. + * @brief Sets channel. + * @details This function is to get channel * * @since_tizen 5.0 * - * @param[in] handle The Wi-Fi mesh handle - * + * @param[in] network The Wi-Fi mesh network information handle. + * @param[in] channel The operating channel number. * * @return 0 on success, otherwise a negative error value. * @retval #WIFI_MESH_ERROR_NONE Successful * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #WIFI_MESH_ERROR_IO_ERROR Unexpected d-bus error * - * @see wifi_mesh_set_softap() - * @see wifi_mesh_enable_softap() - * @see wifi_mesh_is_softap_started() + * @see wifi_mesh_network_get_channel() * */ -int wifi_mesh_disable_softap(wifi_mesh_h handle); +int wifi_mesh_network_set_channel(wifi_mesh_network_h network, int channel); /** - * @brief Checks softap status. - * @details This function checks softap status + * @brief Gets RSSI. + * @details This function is to get RSSI * * @since_tizen 5.0 * - * @param[in] handle The Wi-Fi mesh handle - * @param[out] status Status of SoftAP - * + * @param[in] network The Wi-Fi mesh network information handle. + * @param[out] RSSI The received signal strength indicator. * * @return 0 on success, otherwise a negative error value. * @retval #WIFI_MESH_ERROR_NONE Successful * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #WIFI_MESH_ERROR_IO_ERROR Unexpected d-bus error * - * @see wifi_mesh_set_softap() - * @see wifi_mesh_enable_softap() + * @see wifi_mesh_network_set_rssi() * */ -int wifi_mesh_is_softap_started(wifi_mesh_h handle, bool *status); +int wifi_mesh_network_get_rssi(wifi_mesh_network_h network, int *RSSI); /** - * @brief Creates new Wi-Fi mesh network configuration. - * @details This function creates new mesh network. + * @brief Sets RSSI. + * @details This function is to set RSSI * * @since_tizen 5.0 * - * @param[in] handle The Wi-Fi mesh handle - * @param[in] network Wi-Fi Mesh bss information handle - * + * @param[in] network The Wi-Fi mesh network information handle. + * @param[in] RSSI The received signal strength indicator. * * @return 0 on success, otherwise a negative error value. * @retval #WIFI_MESH_ERROR_NONE Successful * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #WIFI_MESH_ERROR_IO_ERROR Unexpected d-bus error * - * @see wifi_mesh_connect_network() - * @see wifi_mesh_disconnect_network() - * @see wifi_mesh_forget_network() + * @see wifi_mesh_network_get_rssi() * */ -int wifi_mesh_create_network(wifi_mesh_h handle, wifi_mesh_network_h network); +int wifi_mesh_network_set_rssi(wifi_mesh_network_h network, int RSSI); /** - * @brief Connects existing Wi-Fi mesh network. - * @details This function makes a connection to existing Wi-Fi mesh network. + * @brief Gets the security type. + * @details This function is to get the security type. * * @since_tizen 5.0 * - * @param[in] handle The Wi-Fi mesh handle - * @param[in] network Wi-Fi Mesh bss information handle - * + * @param[in] network The Wi-Fi mesh network information handle. + * @param[out] security The security type for network. * * @return 0 on success, otherwise a negative error value. * @retval #WIFI_MESH_ERROR_NONE Successful * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #WIFI_MESH_ERROR_IO_ERROR Unexpected d-bus error * - * @see wifi_mesh_create_network() - * @see wifi_mesh_disconnect_network() - * @see wifi_mesh_forget_network() + * @see wifi_mesh_network_set_security() * */ -int wifi_mesh_connect_network(wifi_mesh_h handle, wifi_mesh_network_h network); +int wifi_mesh_network_get_security(wifi_mesh_network_h network, + wifi_mesh_security_type_e *security); /** - * @brief Disconnects existing Wi-Fi mesh network. - * @details This function disconnects with existing Wi-Fi mesh network. + * @brief Sets the security type. + * @details This function is to set the security type. * * @since_tizen 5.0 * - * @param[in] handle The Wi-Fi mesh handle - * @param[in] network Wi-Fi Mesh bss information handle - * + * @param[in] network The Wi-Fi mesh network information handle. + * @param[in] security The security type for network. * * @return 0 on success, otherwise a negative error value. * @retval #WIFI_MESH_ERROR_NONE Successful * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #WIFI_MESH_ERROR_IO_ERROR Unexpected d-bus error * - * @see wifi_mesh_create_network() - * @see wifi_mesh_forget_network() + * @see wifi_mesh_network_get_security() * */ -int wifi_mesh_disconnect_network(wifi_mesh_h handle, wifi_mesh_network_h network); +int wifi_mesh_network_set_security(wifi_mesh_network_h network, + wifi_mesh_security_type_e security); /** - * @brief Forgets existing Wi-Fi mesh network. - * @details This function removes the information of connected network. + * @brief Sets the passphrase for network connection. + * @details This function is to set the passphrase. * * @since_tizen 5.0 * - * @param[in] handle The Wi-Fi mesh handle - * @param[in] network Wi-Fi Mesh bss information handle - * + * @param[in] network The Wi-Fi mesh network information handle. + * @param[in] passphrase The passphrase for network connection. * * @return 0 on success, otherwise a negative error value. * @retval #WIFI_MESH_ERROR_NONE Successful * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #WIFI_MESH_ERROR_IO_ERROR Unexpected d-bus error - * - * @see wifi_mesh_create_network() - * @see wifi_mesh_connect_network() - * @see wifi_mesh_disconnect_network() * + * @see wifi_mesh_network_get_security() + * @see wifi_mesh_network_set_security() */ -int wifi_mesh_forget_network(wifi_mesh_h handle, wifi_mesh_network_h network); +int wifi_mesh_network_set_passphrase(wifi_mesh_network_h network, + const char* passphrase); /** - * @brief The HWMP (Hybrid Wireless Mesh Protocol) type for mesh_hwmp_root_mode_e. + * @brief Gets the connection state. + * @details This function is to get the connection state * * @since_tizen 5.0 + * + * @param[in] network The Wi-Fi mesh network information handle. + * @param[out] state The maximum data rate. + * + * @return 0 on success, otherwise a negative error value. + * @retval #WIFI_MESH_ERROR_NONE Successful + * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter + * */ -typedef enum { - MESH_HWMP_ROOT_REACTIVE_MODE = 0, /**< Disable Proative Mode */ - MESH_HWMP_ROOT_SIMPLE_PROACTIVE_MODE = 2, /**< Enable the Proactive PREQ with no PREP */ - MESH_HWMP_ROOT_FORCED_PROACTIVE_MODE = 3, /**< Enable the Proactive PREQ with PREP. - Once you do this, all the nodes in your mesh will proactively create paths to your gate. - Mesh nodes will send to gate(s) all traffic to those destinations that could not be resolved in the mesh. */ - MESH_HWMP_ROOT_PROACTIVE_WITH_RANN_MODE = 4, /**< If we use HWMP_ROOTMODE as 4, every 5 sec, - our DUT sends action_frame with root announce. */ -} mesh_hwmp_root_mode_e; - -/** - * @brief The mesh station information handle. - * @since_tizen 5.0 - */ -typedef void* wifi_mesh_station_info_h; - -/** - * @brief The mesh path information handle. - * @since_tizen 5.0 - */ -typedef void* wifi_mesh_mpath_info_h; +int wifi_mesh_network_get_connection_state(wifi_mesh_network_h network, + wifi_mesh_connection_state_e *state); /** - * @brief The mesh conf information handle. + * @brief Gets the IP Config Type. + * @details This function is to gets the IP Config Type + * * @since_tizen 5.0 + * + * @param[in] network The Wi-Fi mesh network information handle. + * @param[in] address_family Address Family + * @param[out] ip_type The IP Config Type + * + * @return 0 on success, otherwise a negative error value. + * @retval #WIFI_MESH_ERROR_NONE Successful + * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter + * */ -typedef void* wifi_mesh_meshconf_info_h; +int wifi_mesh_network_get_ip_config_type(wifi_mesh_network_h network, + wifi_mesh_address_family_e address_family, + wifi_mesh_ip_config_type_e *ip_type); /** - * @brief Gets the maximum data rate. - * @details This function is to get the maximum data rate + * @brief Gets the IP Address. + * @details This function is to gets the IP Address * * @since_tizen 5.0 * + * @remarks You must release @a ip_address using free(). + * * @param[in] network The Wi-Fi mesh network information handle. - * @param[out] data_rate The maximum data rate. + * @param[in] address_family Address Family + * @param[out] ip_address The IP Address * * @return 0 on success, otherwise a negative error value. * @retval #WIFI_MESH_ERROR_NONE Successful * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter * - * @see wifi_mesh_network_set_data_rate() - * */ -int wifi_mesh_network_get_data_rate(wifi_mesh_network_h network, int *data_rate); +int wifi_mesh_network_get_ip_address(wifi_mesh_network_h network, + wifi_mesh_address_family_e address_family, char **ip_address); /** - * @brief Sets the maximum data rate. - * @details This function is to set the maximum data rate + * @brief Gets the Subnet Mask. + * @details This function is to gets the subnet mask * * @since_tizen 5.0 * + * @remarks You must release @a subnet_mask using free(). + * * @param[in] network The Wi-Fi mesh network information handle. - * @param[in] data_rate The maximum data rate. + * @param[in] address_family Address Family + * @param[out] subnet_mask The Subnet Mask * * @return 0 on success, otherwise a negative error value. * @retval #WIFI_MESH_ERROR_NONE Successful * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter * - * @see wifi_mesh_network_get_data_rate() - * */ -int wifi_mesh_network_set_data_rate(wifi_mesh_network_h network, int data_rate); +int wifi_mesh_network_get_subnet_mask(wifi_mesh_network_h network, + wifi_mesh_address_family_e address_family, char **subnet_mask); /** - * @brief Cancels scanning for the mesh network. - * @details Stops scanning process of mesh network. + * @brief Gets address from the Wi-Fi mesh peer. + * @details This function is to return mesh network id * * @since_tizen 5.0 * - * @param[in] handle The Wi-Fi mesh handle + * @remarks You must release @a address using free(). * + * @param[in] peer The mesh peer information handle. + * @param[out] address The address of mesh peer. * * @return 0 on success, otherwise a negative error value. * @retval #WIFI_MESH_ERROR_NONE Successful * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #WIFI_MESH_ERROR_IO_ERROR Unexpected d-bus error - * - * @see wifi_mesh_scan() - * @see wifi_mesh_specific_scan() - * @see wifi_mesh_scan() * */ -int wifi_mesh_cancel_scan(wifi_mesh_h handle); +int wifi_mesh_peer_get_address(wifi_mesh_peer_h peer, char **address); /** - * @brief Sets gate options. - * @details This function sets mesh gate options. + * @brief Gets the maximum data rate. + * @details This function is to get the maximum data rate * * @since_tizen 5.0 * - * @param[in] handle The Wi-Fi mesh handle - * @param[in] gate_announce Enable / Disable Gate Announce to peers - * @param[in] hwmp_root_mode HWMP (Hybrid Wireless Mesh Protocol) Root Mode \n - * #MESH_HWMP_ROOT_REACTIVE_MODE \n - * #MESH_HWMP_ROOT_SIMPLE_PROACTIVE_MODE \n - * #MESH_HWMP_ROOT_FORCED_PROACTIVE_MODE \n - * #MESH_HWMP_ROOT_PROACTIVE_WITH_RANN_MODE \n - * @param[in] stp Enable / Disable Gate Announce to peers - * + * @param[in] network The Wi-Fi mesh network information handle. + * @param[out] data_rate The maximum data rate. * * @return 0 on success, otherwise a negative error value. * @retval #WIFI_MESH_ERROR_NONE Successful * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #WIFI_MESH_ERROR_IO_ERROR Unexpected d-bus error * - * @see wifi_mesh_unset_gate() + * @see wifi_mesh_network_set_data_rate() * */ -int wifi_mesh_set_gate(wifi_mesh_h handle, int gate_announce, int hwmp_root_mode, bool stp); +int wifi_mesh_network_get_data_rate(wifi_mesh_network_h network, + int *data_rate); /** - * @brief Unsets gate options. - * @details This function unsets mesh gate options. + * @brief Sets the maximum data rate. + * @details This function is to set the maximum data rate * * @since_tizen 5.0 * - * @param[in] handle The Wi-Fi mesh handle - * + * @param[in] network The Wi-Fi mesh network information handle. + * @param[in] data_rate The maximum data rate. * * @return 0 on success, otherwise a negative error value. * @retval #WIFI_MESH_ERROR_NONE Successful * @retval #WIFI_MESH_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #WIFI_MESH_ERROR_IO_ERROR Unexpected d-bus error * - * @see wifi_mesh_set_gate() + * @see wifi_mesh_network_get_data_rate() * */ -int wifi_mesh_unset_gate(wifi_mesh_h handle); +int wifi_mesh_network_set_data_rate(wifi_mesh_network_h network, + int data_rate); + +/** + * @} + */ + + +/** + * @addtogroup CAPI_NETWORK_WIFI_MESH_MONITOR_MODULE + * @{ + */ + +/** + * @brief The HWMP (Hybrid Wireless Mesh Protocol) type for mesh_hwmp_root_mode_e. + * + * @since_tizen 5.0 + */ +typedef enum { + MESH_HWMP_ROOT_REACTIVE_MODE = 0, /**< Disable Proative Mode */ + MESH_HWMP_ROOT_SIMPLE_PROACTIVE_MODE = 2, /**< Enable the Proactive PREQ with no PREP */ + MESH_HWMP_ROOT_FORCED_PROACTIVE_MODE = 3, /**< Enable the Proactive PREQ with PREP. + Once you do this, all the nodes in your mesh will proactively create paths to your gate. + Mesh nodes will send to gate(s) all traffic to those destinations that could not be resolved in the mesh. */ + MESH_HWMP_ROOT_PROACTIVE_WITH_RANN_MODE = 4, /**< If we use HWMP_ROOTMODE as 4, every 5 sec, + our DUT sends action_frame with root announce. */ +} mesh_hwmp_root_mode_e; + +/** + * @brief The mesh station information handle. + * @since_tizen 5.0 + */ +typedef void* wifi_mesh_station_info_h; + +/** + * @brief The mesh path information handle. + * @since_tizen 5.0 + */ +typedef void* wifi_mesh_mpath_info_h; + +/** + * @brief The mesh conf information handle. + * @since_tizen 5.0 + */ +typedef void* wifi_mesh_meshconf_info_h; + /** * @brief This callback function is called after wifi_mesh_get_stations_info(). @@ -1326,8 +1345,8 @@ int wifi_mesh_unset_gate(wifi_mesh_h handle); * * @since_tizen 5.0 * - * @remarks The @station should not be released. - * @remarks The @station can be used only in the callback. To use outside, make a copy. + * @remarks The @a station should not be released. + * @remarks The @a station can be used only in the callback. To use outside, make a copy. * * @param[out] station mesh station information handle * @param[out] user_data user data pointer @@ -1336,11 +1355,13 @@ int wifi_mesh_unset_gate(wifi_mesh_h handle); * * @see wifi_mesh_foreach_found_network() */ -typedef void(*wifi_mesh_found_station_cb)(wifi_mesh_station_info_h station, void* user_data); +typedef void(*wifi_mesh_found_station_cb)(wifi_mesh_station_info_h station, + void* user_data); /** * @brief Gets information of all connected stations. - * @details Gets information about all stations present in the currently connected mesh network. + * @details Gets information about all stations present in the currently connected mesh + * network. * * @since_tizen 5.0 * @@ -1368,7 +1389,7 @@ int wifi_mesh_get_stations_info(wifi_mesh_h handle, * * @since_tizen 5.0 * - * @remarks The @bssid should be released using free(). + * @remarks The @a bssid should be released using free(). * * @param[in] station The Wi-Fi mesh station handle * @param[out] bssid A pointer to get BSSID information @@ -1415,7 +1436,8 @@ int wifi_mesh_get_stations_info(wifi_mesh_h handle, * @see wifi_mesh_get_sta_connected_time() * */ -int wifi_mesh_get_sta_bssid(wifi_mesh_station_info_h station, char** bssid); +int wifi_mesh_get_sta_bssid(wifi_mesh_station_info_h station, + char** bssid); /** * @brief Gets inactive time of a connected station. @@ -1468,7 +1490,8 @@ int wifi_mesh_get_sta_bssid(wifi_mesh_station_info_h station, char** bssid); * @see wifi_mesh_get_sta_connected_time() * */ -int wifi_mesh_get_sta_inactive_time(wifi_mesh_station_info_h station, unsigned int* inactive_time); +int wifi_mesh_get_sta_inactive_time(wifi_mesh_station_info_h station, + unsigned int* inactive_time); /** * @brief Gets rx bytes of a connected station. @@ -1521,7 +1544,8 @@ int wifi_mesh_get_sta_inactive_time(wifi_mesh_station_info_h station, unsigned i * @see wifi_mesh_get_sta_connected_time() * */ -int wifi_mesh_get_sta_rx_bytes(wifi_mesh_station_info_h station, unsigned long* rx_bytes); +int wifi_mesh_get_sta_rx_bytes(wifi_mesh_station_info_h station, + unsigned long* rx_bytes); /** * @brief Gets rx packets of a connected station. @@ -1574,7 +1598,8 @@ int wifi_mesh_get_sta_rx_bytes(wifi_mesh_station_info_h station, unsigned long* * @see wifi_mesh_get_sta_connected_time() * */ -int wifi_mesh_get_sta_rx_packets(wifi_mesh_station_info_h station, unsigned int* rx_packets); +int wifi_mesh_get_sta_rx_packets(wifi_mesh_station_info_h station, + unsigned int* rx_packets); /** * @brief Gets tx packets counts of a connected station. @@ -1627,7 +1652,8 @@ int wifi_mesh_get_sta_rx_packets(wifi_mesh_station_info_h station, unsigned int* * @see wifi_mesh_get_sta_connected_time() * */ -int wifi_mesh_get_sta_tx_bytes(wifi_mesh_station_info_h station, unsigned long* tx_bytes); +int wifi_mesh_get_sta_tx_bytes(wifi_mesh_station_info_h station, + unsigned long* tx_bytes); /** * @brief Gets tx packets of a connected station. @@ -1680,7 +1706,8 @@ int wifi_mesh_get_sta_tx_bytes(wifi_mesh_station_info_h station, unsigned long* * @see wifi_mesh_get_sta_connected_time() * */ -int wifi_mesh_get_sta_tx_packets(wifi_mesh_station_info_h station, unsigned int* tx_packets); +int wifi_mesh_get_sta_tx_packets(wifi_mesh_station_info_h station, + unsigned int* tx_packets); /** * @brief Gets a re-trial number of transmits at a connected station. @@ -1733,7 +1760,8 @@ int wifi_mesh_get_sta_tx_packets(wifi_mesh_station_info_h station, unsigned int* * @see wifi_mesh_get_sta_connected_time() * */ -int wifi_mesh_get_sta_tx_retries(wifi_mesh_station_info_h station, unsigned int* tx_retries); +int wifi_mesh_get_sta_tx_retries(wifi_mesh_station_info_h station, + unsigned int* tx_retries); /** * @brief Gets tx-fail counts of a connected station. @@ -1786,7 +1814,8 @@ int wifi_mesh_get_sta_tx_retries(wifi_mesh_station_info_h station, unsigned int* * @see wifi_mesh_get_sta_connected_time() * */ -int wifi_mesh_get_sta_tx_failed(wifi_mesh_station_info_h station, unsigned int* tx_failed); +int wifi_mesh_get_sta_tx_failed(wifi_mesh_station_info_h station, + unsigned int* tx_failed); /** * @brief Gets a number of beacon loss at a connected station. @@ -1839,7 +1868,8 @@ int wifi_mesh_get_sta_tx_failed(wifi_mesh_station_info_h station, unsigned int* * @see wifi_mesh_get_sta_connected_time() * */ -int wifi_mesh_get_sta_beacon_loss(wifi_mesh_station_info_h station, unsigned int* beacon_loss); +int wifi_mesh_get_sta_beacon_loss(wifi_mesh_station_info_h station, + unsigned int* beacon_loss); /** * @brief Gets a number of received beacons at a connected station. @@ -1892,10 +1922,12 @@ int wifi_mesh_get_sta_beacon_loss(wifi_mesh_station_info_h station, unsigned int * @see wifi_mesh_get_sta_connected_time() * */ -int wifi_mesh_get_sta_beacon_rx(wifi_mesh_station_info_h station, unsigned long* beacon_rx); +int wifi_mesh_get_sta_beacon_rx(wifi_mesh_station_info_h station, + unsigned long* beacon_rx); /** - * @brief Gets a number of dropped packets number with ambiguous reason at a connected station. + * @brief Gets a number of dropped packets number with ambiguous reason at a connected + * station. * @details Gets a number of dropped packets number with ambiguous reason of a peer * * @since_tizen 5.0 @@ -1945,7 +1977,8 @@ int wifi_mesh_get_sta_beacon_rx(wifi_mesh_station_info_h station, unsigned long* * @see wifi_mesh_get_sta_connected_time() * */ -int wifi_mesh_get_sta_rx_drop_misc(wifi_mesh_station_info_h station, unsigned long* rx_drop_misc); +int wifi_mesh_get_sta_rx_drop_misc(wifi_mesh_station_info_h station, + unsigned long* rx_drop_misc); /** * @brief Gets instant received signal strength at a connected station. @@ -1998,7 +2031,8 @@ int wifi_mesh_get_sta_rx_drop_misc(wifi_mesh_station_info_h station, unsigned lo * @see wifi_mesh_get_sta_connected_time() * */ -int wifi_mesh_get_sta_signal(wifi_mesh_station_info_h station, int* signal); +int wifi_mesh_get_sta_signal(wifi_mesh_station_info_h station, + int* signal); /** * @brief Gets average received signal strength at a connected station. @@ -2051,7 +2085,8 @@ int wifi_mesh_get_sta_signal(wifi_mesh_station_info_h station, int* signal); * @see wifi_mesh_get_sta_connected_time() * */ -int wifi_mesh_get_sta_signal_avg(wifi_mesh_station_info_h station, int* signal_avg); +int wifi_mesh_get_sta_signal_avg(wifi_mesh_station_info_h station, + int* signal_avg); /** * @brief Gets transmit bit-rate at a connected station. @@ -2104,7 +2139,8 @@ int wifi_mesh_get_sta_signal_avg(wifi_mesh_station_info_h station, int* signal_a * @see wifi_mesh_get_sta_connected_time() * */ -int wifi_mesh_get_sta_tx_bitrate(wifi_mesh_station_info_h station, unsigned int* tx_bitrate); +int wifi_mesh_get_sta_tx_bitrate(wifi_mesh_station_info_h station, + unsigned int* tx_bitrate); /** * @brief Gets received bit-rate at a connected station. @@ -2157,7 +2193,8 @@ int wifi_mesh_get_sta_tx_bitrate(wifi_mesh_station_info_h station, unsigned int* * @see wifi_mesh_get_sta_connected_time() * */ -int wifi_mesh_get_sta_rx_bitrate(wifi_mesh_station_info_h station, unsigned int* rx_bitrate); +int wifi_mesh_get_sta_rx_bitrate(wifi_mesh_station_info_h station, + unsigned int* rx_bitrate); /** * @brief Gets local-link identifier at a connected station. @@ -2210,7 +2247,8 @@ int wifi_mesh_get_sta_rx_bitrate(wifi_mesh_station_info_h station, unsigned int* * @see wifi_mesh_get_sta_connected_time() * */ -int wifi_mesh_get_sta_mesh_llid(wifi_mesh_station_info_h station, unsigned short* mesh_llid); +int wifi_mesh_get_sta_mesh_llid(wifi_mesh_station_info_h station, + unsigned short* mesh_llid); /** * @brief Gets peer-link identifier at a connected station. @@ -2263,7 +2301,8 @@ int wifi_mesh_get_sta_mesh_llid(wifi_mesh_station_info_h station, unsigned short * @see wifi_mesh_get_sta_connected_time() * */ -int wifi_mesh_get_sta_mesh_plid(wifi_mesh_station_info_h station, unsigned short* mesh_plid); +int wifi_mesh_get_sta_mesh_plid(wifi_mesh_station_info_h station, + unsigned short* mesh_plid); /** * @brief Gets peer-link status at a connected station. @@ -2271,8 +2310,8 @@ int wifi_mesh_get_sta_mesh_plid(wifi_mesh_station_info_h station, unsigned short * * @since_tizen 5.0 * - * @remarks The @mesh_plink should not be released. - * @remarks The @mesh_plink is available until wifi_mesh_station_info_h is released. + * @remarks The @a mesh_plink should not be released. + * @remarks The @a mesh_plink is available until wifi_mesh_station_info_h is released. * * @param[in] station The Wi-Fi mesh station handle * @param[out] mesh_plink Peer-link status such as "ESTAB" @@ -2319,7 +2358,8 @@ int wifi_mesh_get_sta_mesh_plid(wifi_mesh_station_info_h station, unsigned short * @see wifi_mesh_get_sta_connected_time() * */ -int wifi_mesh_get_sta_mesh_plink(wifi_mesh_station_info_h station, unsigned char* mesh_plink); +int wifi_mesh_get_sta_mesh_plink(wifi_mesh_station_info_h station, + unsigned char* mesh_plink); /** * @brief Gets local-link power save mode at a connected station. @@ -2371,7 +2411,8 @@ int wifi_mesh_get_sta_mesh_plink(wifi_mesh_station_info_h station, unsigned char * @see wifi_mesh_get_sta_connected_time() * */ -int wifi_mesh_get_sta_local_ps_mode(wifi_mesh_station_info_h station, unsigned int* local_ps_mode); +int wifi_mesh_get_sta_local_ps_mode( + wifi_mesh_station_info_h station, unsigned int* local_ps_mode); /** * @brief Gets peer-link power save mode at a connected station. @@ -2475,7 +2516,8 @@ int wifi_mesh_get_sta_peer_ps_mode(wifi_mesh_station_info_h station, unsigned in * @see wifi_mesh_get_sta_connected_time() * */ -int wifi_mesh_get_sta_non_peer_ps_mode(wifi_mesh_station_info_h station, unsigned int* non_peer_ps_mode); +int wifi_mesh_get_sta_non_peer_ps_mode( + wifi_mesh_station_info_h station, unsigned int* non_peer_ps_mode); /** * @brief Gets to know whether a connected station authorized or not. @@ -2527,7 +2569,8 @@ int wifi_mesh_get_sta_non_peer_ps_mode(wifi_mesh_station_info_h station, unsigne * @see wifi_mesh_get_sta_connected_time() * */ -int wifi_mesh_get_sta_authorized(wifi_mesh_station_info_h station, bool* authorized); +int wifi_mesh_get_sta_authorized(wifi_mesh_station_info_h station, + bool* authorized); /** * @brief Gets to know whether a connected station athenticated or not. @@ -2579,7 +2622,8 @@ int wifi_mesh_get_sta_authorized(wifi_mesh_station_info_h station, bool* authori * @see wifi_mesh_get_sta_connected_time() * */ -int wifi_mesh_get_sta_authenticated(wifi_mesh_station_info_h station, bool* authenticated); +int wifi_mesh_get_sta_authenticated(wifi_mesh_station_info_h station, + bool* authenticated); /** * @brief Gets to know whether a connected station associated or not. @@ -2632,7 +2676,8 @@ int wifi_mesh_get_sta_authenticated(wifi_mesh_station_info_h station, bool* auth * @see wifi_mesh_get_sta_connected_time() * */ -int wifi_mesh_get_sta_associated(wifi_mesh_station_info_h station, bool* associated); +int wifi_mesh_get_sta_associated(wifi_mesh_station_info_h station, + bool* associated); /** * @brief Gets preamble type long or short. @@ -2685,11 +2730,13 @@ int wifi_mesh_get_sta_associated(wifi_mesh_station_info_h station, bool* associa * @see wifi_mesh_get_sta_connected_time() * */ -int wifi_mesh_get_sta_preamble(wifi_mesh_station_info_h station, bool* preamble); +int wifi_mesh_get_sta_preamble(wifi_mesh_station_info_h station, + bool* preamble); /** * @brief Gets to know a station can support Wireless Multimedia Extension. - * @details Get to know a station can support Wireless Multimedia Extension (in other word, Wi-Fi Multimedia). + * @details Get to know a station can support Wireless Multimedia Extension + * (in other word, Wi-Fi Multimedia). * * @since_tizen 5.0 * @@ -2738,7 +2785,8 @@ int wifi_mesh_get_sta_preamble(wifi_mesh_station_info_h station, bool* preamble) * @see wifi_mesh_get_sta_connected_time() * */ -int wifi_mesh_get_sta_wmm_wme(wifi_mesh_station_info_h station, bool* wmm_wme); +int wifi_mesh_get_sta_wmm_wme(wifi_mesh_station_info_h station, + bool* wmm_wme); /** * @brief Gets to know a station can support management frame protection. @@ -2844,7 +2892,8 @@ int wifi_mesh_get_sta_mfp(wifi_mesh_station_info_h station, bool* mfp); * @see wifi_mesh_get_sta_connected_time() * */ -int wifi_mesh_get_sta_tdls_peer(wifi_mesh_station_info_h station, bool* tdls_peer); +int wifi_mesh_get_sta_tdls_peer(wifi_mesh_station_info_h station, + bool* tdls_peer); /** * @brief Gets DTIM period of a connected station. @@ -2898,7 +2947,8 @@ int wifi_mesh_get_sta_tdls_peer(wifi_mesh_station_info_h station, bool* tdls_pee * @see wifi_mesh_get_sta_connected_time() * */ -int wifi_mesh_get_sta_dtim_period(wifi_mesh_station_info_h station, unsigned char* dtim_period); +int wifi_mesh_get_sta_dtim_period(wifi_mesh_station_info_h station, + unsigned char* dtim_period); /** * @brief Gets beacon interval of a connected station. @@ -2951,7 +3001,8 @@ int wifi_mesh_get_sta_dtim_period(wifi_mesh_station_info_h station, unsigned cha * @see wifi_mesh_get_sta_connected_time() * */ -int wifi_mesh_get_sta_beacon_interval(wifi_mesh_station_info_h station, unsigned short* beacon_interval); +int wifi_mesh_get_sta_beacon_interval( + wifi_mesh_station_info_h station, unsigned short* beacon_interval); /** * @brief Gets to know a station can support RTS (Request-to-Send) / CTS (Clear-to-Send). @@ -3004,7 +3055,8 @@ int wifi_mesh_get_sta_beacon_interval(wifi_mesh_station_info_h station, unsigned * @see wifi_mesh_get_sta_connected_time() * */ -int wifi_mesh_get_sta_cts_protection(wifi_mesh_station_info_h station, bool* cts_protection); +int wifi_mesh_get_sta_cts_protection( + wifi_mesh_station_info_h station, bool* cts_protection); /** * @brief Gets to know a station can support short preamble. @@ -3057,7 +3109,8 @@ int wifi_mesh_get_sta_cts_protection(wifi_mesh_station_info_h station, bool* cts * @see wifi_mesh_get_sta_connected_time() * */ -int wifi_mesh_get_sta_short_preamble(wifi_mesh_station_info_h station, bool* short_preamble); +int wifi_mesh_get_sta_short_preamble( + wifi_mesh_station_info_h station, bool* short_preamble); /** * @brief Gets to know a station can support short slot. @@ -3110,7 +3163,8 @@ int wifi_mesh_get_sta_short_preamble(wifi_mesh_station_info_h station, bool* sho * @see wifi_mesh_get_sta_connected_time() * */ -int wifi_mesh_get_sta_short_slot_time(wifi_mesh_station_info_h station, bool* short_slot_time); +int wifi_mesh_get_sta_short_slot_time( + wifi_mesh_station_info_h station, bool* short_slot_time); /** * @brief Gets to know how many time elapsed since a station joined. @@ -3163,7 +3217,8 @@ int wifi_mesh_get_sta_short_slot_time(wifi_mesh_station_info_h station, bool* sh * @see wifi_mesh_get_sta_short_slot_time() * */ -int wifi_mesh_get_sta_connected_time(wifi_mesh_station_info_h station, unsigned int* connected_time); +int wifi_mesh_get_sta_connected_time( + wifi_mesh_station_info_h station, unsigned int* connected_time); /** * @brief Called after wifi_mesh_get_stations_info(). @@ -3171,8 +3226,8 @@ int wifi_mesh_get_sta_connected_time(wifi_mesh_station_info_h station, unsigned * * @since_tizen 5.0 * - * @remarks The @path should not be released. - * @remarks The @path can be used only in the callback. To use outside, make a copy. + * @remarks The @a path should not be released. + * @remarks The @a path can be used only in the callback. To use outside, make a copy. * * @param[out] path mesh path information handle * @param[out] user_data user data pointer @@ -3185,7 +3240,8 @@ typedef void(*mesh_found_mpath_cb)(wifi_mesh_mpath_info_h path, void* user_data) /** * @brief Gets information of all mesh paths. - * @details Get information about all mesh paths present in the currently connected mesh network. + * @details Get information about all mesh paths present in the currently connected + * mesh network. * * @since_tizen 5.0 * @@ -3202,7 +3258,8 @@ typedef void(*mesh_found_mpath_cb)(wifi_mesh_mpath_info_h path, void* user_data) * @see wifi_mesh_get_stations_info() * */ -int wifi_mesh_get_mpath_info(wifi_mesh_h handle, mesh_found_mpath_cb cb, void *user_data); +int wifi_mesh_get_mpath_info(wifi_mesh_h handle, mesh_found_mpath_cb cb, + void *user_data); /** * @brief Gets a destination address. @@ -3211,8 +3268,8 @@ int wifi_mesh_get_mpath_info(wifi_mesh_h handle, mesh_found_mpath_cb cb, void *u * * @since_tizen 5.0 * - * @remarks The @dest_addr should not be released. - * @remarks The @dest_addr is available until wifi_mesh_mpath_info_h is released. + * @remarks The @a dest_addr should not be released. + * @remarks The @a dest_addr is available until wifi_mesh_mpath_info_h is released. * * @param[in] mpath The adjacent mesh path information * @param[out] dest_addr Destination MAC address @@ -3235,7 +3292,8 @@ int wifi_mesh_get_mpath_info(wifi_mesh_h handle, mesh_found_mpath_cb cb, void *u * @see wifi_mesh_get_mpath_flags() * */ -int wifi_mesh_get_mpath_dest_addr(wifi_mesh_mpath_info_h mpath, char** dest_addr); +int wifi_mesh_get_mpath_dest_addr(wifi_mesh_mpath_info_h mpath, + char** dest_addr); /** * @brief Gets a next hop address. @@ -3245,8 +3303,8 @@ int wifi_mesh_get_mpath_dest_addr(wifi_mesh_mpath_info_h mpath, char** dest_addr * * @since_tizen 5.0 * - * @remarks The @next_hop should not be released. - * @remarks The @next_hop is available until wifi_mesh_mpath_info_h is released. + * @remarks The @a next_hop should not be released. + * @remarks The @a next_hop is available until wifi_mesh_mpath_info_h is released. * * @param[in] mpath The adjacent mesh path information * @param[out] next_hop Destination MAC address @@ -3269,7 +3327,8 @@ int wifi_mesh_get_mpath_dest_addr(wifi_mesh_mpath_info_h mpath, char** dest_addr * @see wifi_mesh_get_mpath_flags() * */ -int wifi_mesh_get_mpath_next_hop(wifi_mesh_mpath_info_h mpath, char** next_hop); +int wifi_mesh_get_mpath_next_hop(wifi_mesh_mpath_info_h mpath, + char** next_hop); /** * @brief Gets a control interface. @@ -3278,8 +3337,8 @@ int wifi_mesh_get_mpath_next_hop(wifi_mesh_mpath_info_h mpath, char** next_hop); * * @since_tizen 5.0 * - * @remarks The @iface should not be released. - * @remarks The @iface is available until wifi_mesh_mpath_info_h is released. + * @remarks The @a iface should not be released. + * @remarks The @a iface is available until wifi_mesh_mpath_info_h is released. * * * @param[in] mpath The adjacent mesh path information @@ -3302,7 +3361,8 @@ int wifi_mesh_get_mpath_next_hop(wifi_mesh_mpath_info_h mpath, char** next_hop); * @see wifi_mesh_get_mpath_flags() * */ -int wifi_mesh_get_mpath_iface(wifi_mesh_mpath_info_h mpath, char** iface); +int wifi_mesh_get_mpath_iface(wifi_mesh_mpath_info_h mpath, + char** iface); /** * @brief Gets a serial number of the current control packet. @@ -3332,7 +3392,8 @@ int wifi_mesh_get_mpath_iface(wifi_mesh_mpath_info_h mpath, char** iface); * @see wifi_mesh_get_mpath_flags() * */ -int wifi_mesh_get_mpath_sn(wifi_mesh_mpath_info_h mpath, unsigned int* sn); +int wifi_mesh_get_mpath_sn(wifi_mesh_mpath_info_h mpath, + unsigned int* sn); /** * @brief Gets a metric number. @@ -3363,7 +3424,8 @@ int wifi_mesh_get_mpath_sn(wifi_mesh_mpath_info_h mpath, unsigned int* sn); * @see wifi_mesh_get_mpath_flags() * */ -int wifi_mesh_get_mpath_metric(wifi_mesh_mpath_info_h mpath, unsigned int* metric); +int wifi_mesh_get_mpath_metric(wifi_mesh_mpath_info_h mpath, + unsigned int* metric); /** * @brief Gets a queue length in the Wi-Fi driver. @@ -3392,7 +3454,8 @@ int wifi_mesh_get_mpath_metric(wifi_mesh_mpath_info_h mpath, unsigned int* metri * @see wifi_mesh_get_mpath_disc_retries() * @see wifi_mesh_get_mpath_flags() */ -int wifi_mesh_get_mpath_qlen(wifi_mesh_mpath_info_h mpath, unsigned int* qlen); +int wifi_mesh_get_mpath_qlen(wifi_mesh_mpath_info_h mpath, + unsigned int* qlen); /** * @brief Gets a time of next destination available. @@ -3422,7 +3485,8 @@ int wifi_mesh_get_mpath_qlen(wifi_mesh_mpath_info_h mpath, unsigned int* qlen); * @see wifi_mesh_get_mpath_disc_retries() * @see wifi_mesh_get_mpath_flags() */ -int wifi_mesh_get_mpath_exptime(wifi_mesh_mpath_info_h mpath, unsigned int* exptime); +int wifi_mesh_get_mpath_exptime(wifi_mesh_mpath_info_h mpath, + unsigned int* exptime); /** * @brief Gets a time of discovery timeout. @@ -3516,11 +3580,13 @@ int wifi_mesh_get_mpath_disc_retries(wifi_mesh_mpath_info_h mpath, * @see wifi_mesh_get_mpath_disc_timeout() * @see wifi_mesh_get_mpath_disc_retries() */ -int wifi_mesh_get_mpath_flags(wifi_mesh_mpath_info_h mpath, unsigned char* flags); +int wifi_mesh_get_mpath_flags(wifi_mesh_mpath_info_h mpath, + unsigned char* flags); /** * @brief Sets network device interface name. - * @details This function provides the ability to manually select interfaces for advanced users. + * @details This function provides the ability to manually select interfaces for + * advanced users. * * @since_tizen 5.0 * @@ -3546,7 +3612,7 @@ int wifi_mesh_set_interfaces(wifi_mesh_h handle, * * @since_tizen 5.0 * - * @remarks The @meshconf should be released using wifi_mesh_destroy_meshconf_info(). + * @remarks The @a meshconf should be released using wifi_mesh_destroy_meshconf_info(). * * @param[in] handle The Wi-Fi mesh handle * @param[out] meshconf The Mesh conf information handle @@ -3581,7 +3647,8 @@ int wifi_mesh_get_meshconf_info(wifi_mesh_h handle, * @see wifi_mesh_get_meshconf_info() * */ -int wifi_mesh_destroy_meshconf_info(wifi_mesh_meshconf_info_h meshconf); +int wifi_mesh_destroy_meshconf_info( + wifi_mesh_meshconf_info_h meshconf); /** * @brief Gets the retry timeout value of Mesh Configuration. @@ -3600,8 +3667,8 @@ int wifi_mesh_destroy_meshconf_info(wifi_mesh_meshconf_info_h meshconf); * @see wifi_mesh_destroy_meshconf_info() * */ -int wifi_mesh_get_meshconf_retry_timeout(wifi_mesh_meshconf_info_h meshconf, - unsigned short *retry_timeout); +int wifi_mesh_get_meshconf_retry_timeout( + wifi_mesh_meshconf_info_h meshconf, unsigned short *retry_timeout); /** * @brief Gets the HWMP (Hybrid Wireless Mesh Protocol) Max PREQ Retries. @@ -3621,8 +3688,8 @@ int wifi_mesh_get_meshconf_retry_timeout(wifi_mesh_meshconf_info_h meshconf, * */ -int wifi_mesh_get_meshconf_hwmp_max_preq_retries(wifi_mesh_meshconf_info_h meshconf, - unsigned char *hwmp_max_preq_retries); +int wifi_mesh_get_meshconf_hwmp_max_preq_retries( + wifi_mesh_meshconf_info_h meshconf, unsigned char *hwmp_max_preq_retries); /** * @brief Gets the Confirm Timeout. @@ -3641,8 +3708,8 @@ int wifi_mesh_get_meshconf_hwmp_max_preq_retries(wifi_mesh_meshconf_info_h meshc * @see wifi_mesh_destroy_meshconf_info() * */ -int wifi_mesh_get_meshconf_confirm_timeout(wifi_mesh_meshconf_info_h meshconf, - unsigned short *confirm_timeout); +int wifi_mesh_get_meshconf_confirm_timeout( + wifi_mesh_meshconf_info_h meshconf, unsigned short *confirm_timeout); /** * @brief Gets the Path Refresh Time. @@ -3661,8 +3728,8 @@ int wifi_mesh_get_meshconf_confirm_timeout(wifi_mesh_meshconf_info_h meshconf, * @see wifi_mesh_destroy_meshconf_info() * */ -int wifi_mesh_get_meshconf_path_refresh_time(wifi_mesh_meshconf_info_h meshconf, - unsigned int *path_refresh_time); +int wifi_mesh_get_meshconf_path_refresh_time( + wifi_mesh_meshconf_info_h meshconf, unsigned int *path_refresh_time); /** * @brief Gets the Holding Timeout. @@ -3681,8 +3748,8 @@ int wifi_mesh_get_meshconf_path_refresh_time(wifi_mesh_meshconf_info_h meshconf, * @see wifi_mesh_destroy_meshconf_info() * */ -int wifi_mesh_get_meshconf_holding_timeout(wifi_mesh_meshconf_info_h meshconf, - unsigned short *holding_timeout); +int wifi_mesh_get_meshconf_holding_timeout( + wifi_mesh_meshconf_info_h meshconf, unsigned short *holding_timeout); /** * @brief Gets the Minimum Discovery Timeout. @@ -3701,8 +3768,8 @@ int wifi_mesh_get_meshconf_holding_timeout(wifi_mesh_meshconf_info_h meshconf, * @see wifi_mesh_destroy_meshconf_info() * */ -int wifi_mesh_get_meshconf_min_disc_timeout(wifi_mesh_meshconf_info_h meshconf, - unsigned short *min_disc_timeout); +int wifi_mesh_get_meshconf_min_disc_timeout( + wifi_mesh_meshconf_info_h meshconf, unsigned short *min_disc_timeout); /** * @brief Gets the Max Peer Links. @@ -3721,8 +3788,8 @@ int wifi_mesh_get_meshconf_min_disc_timeout(wifi_mesh_meshconf_info_h meshconf, * @see wifi_mesh_destroy_meshconf_info() * */ -int wifi_mesh_get_meshconf_max_peer_links(wifi_mesh_meshconf_info_h meshconf, - unsigned short *max_peer_links); +int wifi_mesh_get_meshconf_max_peer_links( + wifi_mesh_meshconf_info_h meshconf, unsigned short *max_peer_links); /** * @brief Gets the HWMP (Hybrid Wireless Mesh Protocol) PREQ Minimum Interval. @@ -3741,8 +3808,8 @@ int wifi_mesh_get_meshconf_max_peer_links(wifi_mesh_meshconf_info_h meshconf, * @see wifi_mesh_destroy_meshconf_info() * */ -int wifi_mesh_get_meshconf_hwmp_preq_min_interval(wifi_mesh_meshconf_info_h meshconf, - unsigned short *hwmp_preq_min_interval); +int wifi_mesh_get_meshconf_hwmp_preq_min_interval( + wifi_mesh_meshconf_info_h meshconf, unsigned short *hwmp_preq_min_interval); /** * @brief Gets the TTL (Time To Live). @@ -3761,7 +3828,8 @@ int wifi_mesh_get_meshconf_hwmp_preq_min_interval(wifi_mesh_meshconf_info_h mesh * @see wifi_mesh_destroy_meshconf_info() * */ -int wifi_mesh_get_meshconf_ttl(wifi_mesh_meshconf_info_h meshconf, unsigned char *ttl); +int wifi_mesh_get_meshconf_ttl(wifi_mesh_meshconf_info_h meshconf, + unsigned char *ttl); /** * @brief Gets the HWMP (Hybrid Wireless Mesh Protocol) Active Path Timeout. @@ -3780,8 +3848,8 @@ int wifi_mesh_get_meshconf_ttl(wifi_mesh_meshconf_info_h meshconf, unsigned char * @see wifi_mesh_destroy_meshconf_info() * */ -int wifi_mesh_get_meshconf_hwmp_active_path_timeout(wifi_mesh_meshconf_info_h meshconf, - unsigned int *hwmp_active_path_timeout); +int wifi_mesh_get_meshconf_hwmp_active_path_timeout( + wifi_mesh_meshconf_info_h meshconf, unsigned int *hwmp_active_path_timeout); /** * @brief Gets the Element TTL (Time To Live). @@ -3800,8 +3868,8 @@ int wifi_mesh_get_meshconf_hwmp_active_path_timeout(wifi_mesh_meshconf_info_h me * @see wifi_mesh_destroy_meshconf_info() * */ -int wifi_mesh_get_meshconf_element_ttl(wifi_mesh_meshconf_info_h meshconf, - unsigned char *element_ttl); +int wifi_mesh_get_meshconf_element_ttl( + wifi_mesh_meshconf_info_h meshconf, unsigned char *element_ttl); /** * @brief Gets the HWMP RANN (Root Announcement) Interval. @@ -3820,8 +3888,8 @@ int wifi_mesh_get_meshconf_element_ttl(wifi_mesh_meshconf_info_h meshconf, * @see wifi_mesh_destroy_meshconf_info() * */ -int wifi_mesh_get_meshconf_hwmp_rann_interval(wifi_mesh_meshconf_info_h meshconf, - unsigned short *hwmp_rann_interval); +int wifi_mesh_get_meshconf_hwmp_rann_interval( + wifi_mesh_meshconf_info_h meshconf, unsigned short *hwmp_rann_interval); /** * @brief Gets the Gate Announcement value. @@ -3840,8 +3908,8 @@ int wifi_mesh_get_meshconf_hwmp_rann_interval(wifi_mesh_meshconf_info_h meshconf * @see wifi_mesh_destroy_meshconf_info() * */ -int wifi_mesh_get_meshconf_gate_announcements(wifi_mesh_meshconf_info_h meshconf, - unsigned char *gate_announcements); +int wifi_mesh_get_meshconf_gate_announcements( + wifi_mesh_meshconf_info_h meshconf, unsigned char *gate_announcements); /** * @} -- 2.34.1