Tizen IoT Extension SDK 1.0  1.0.1
Defines | Typedefs | Enumerations | Functions
Master
SmartThings Thing

The Master API provides functions to connect to SmartThings Cloud. More...

Defines

#define SMARTTHINGS_SSID_LEN_MAX   32
 Definition for the max length of SSID for access point. 1.
#define SMARTTHINGS_CLOUD_INFO_LEN_MAX   128
 Definition for the max length of cloud information. 1.

Typedefs

typedef struct smartthings_s * smartthings_h
 The SmartThings handle. 1.
typedef struct
smartthings_ap_info_s * 		smartthings_ap_info_h
 The access point information handle. 1.
typedef struct
smartthings_device_prov_info_s * 		smartthings_device_prov_info_h
 The device provisioning information handle. 1.
typedef struct
smartthings_cloud_info_s * 		smartthings_cloud_info_h
 The cloud information handle for cloud sign-up. 1.
typedef struct
smartthings_ap_list_s * 		smartthings_ap_list_h
 The access point list handle. 1.
typedef void(* smartthings_connection_status_cb )(smartthings_h handle, smartthings_connection_status_e status, void *user_data)
 Callback for status of connection to SmartThings Thing agent. 1.
typedef void(* smartthings_status_changed_cb )(smartthings_h handle, smartthings_status_e status, void *user_data)
 Callback for SmartThings Thing status. 1.
typedef void(* smartthings_user_confirm_cb )(smartthings_h handle, void *user_data)
 Callback for getting user's input regarding mutual verification. 1.
typedef void(* smartthings_reset_confirm_cb )(smartthings_h handle, void *user_data)
 Callback for getting user's opinion regarding device reset. 1.
typedef void(* smartthings_reset_result_cb )(smartthings_h handle, bool result, void *user_data)
 Callback for result of reset operation. 1.
typedef void(* smartthings_pin_generated_cb )(smartthings_h handle, const char *pin, size_t size, void *user_data)
 Callback for carrying the randomly generated PIN information. 1.
typedef void(* smartthings_pin_display_close_cb )(smartthings_h handle, void *user_data)
 Callback for informing the application to close the PIN display. 1.
typedef void(* smartthings_wifi_ap_provisioning_cb )(smartthings_h handle, smartthings_ap_info_h ap_info_h, void *user_data)
 Callback for informing Wi-Fi AP information to connect. 1.
typedef void(* smartthings_device_provisioning_cb )(smartthings_h handle, smartthings_device_prov_info_h dev_prov_h, void *user_data)
 Callback for informing device provisioning information. 1.
typedef void(* smartthings_scan_ap_cb )(smartthings_h handle, int req_id, void *user_data)
 Callback for informing the scan AP list request. 1.
typedef void(* smartthings_stop_soft_ap_cb )(smartthings_h handle, void *user_data)
 Callback for informing the stop soft AP request. 1.

Enumerations

enum  smartthings_error_e {
  SMARTTHINGS_ERROR_NONE = TIZEN_ERROR_NONE, SMARTTHINGS_ERROR_INVALID_PARAMETER = TIZEN_ERROR_INVALID_PARAMETER, SMARTTHINGS_ERROR_OUT_OF_MEMORY = TIZEN_ERROR_OUT_OF_MEMORY, SMARTTHINGS_ERROR_PERMISSION_DENIED = TIZEN_ERROR_PERMISSION_DENIED,
  SMARTTHINGS_ERROR_NO_DATA = TIZEN_ERROR_NO_DATA, SMARTTHINGS_ERROR_NOT_SUPPORTED = TIZEN_ERROR_NOT_SUPPORTED, SMARTTHINGS_ERROR_OPERATION_FAILED = TIZEN_ERROR_UNKNOWN - 1, SMARTTHINGS_ERROR_SERVICE_UNAVAILABLE = TIZEN_ERROR_UNKNOWN -2
}
 Enumeration for the SmartThings error. 1. More...
enum  smartthings_status_e {
  SMARTTHINGS_STATUS_NOT_READY = -1, SMARTTHINGS_STATUS_INIT = 0, SMARTTHINGS_STATUS_ES_STARTED, SMARTTHINGS_STATUS_ES_DONE,
  SMARTTHINGS_STATUS_ES_FAILED_ON_OWNERSHIP_TRANSFER, SMARTTHINGS_STATUS_CONNECTING_TO_AP, SMARTTHINGS_STATUS_CONNECTED_TO_AP, SMARTTHINGS_STATUS_CONNECTING_TO_AP_FAILED,
  SMARTTHINGS_STATUS_REGISTERING_TO_CLOUD, SMARTTHINGS_STATUS_REGISTERED_TO_CLOUD, SMARTTHINGS_STATUS_REGISTERING_FAILED_ON_SIGN_IN, SMARTTHINGS_STATUS_REGISTERING_FAILED_ON_PUB_RES
}
 Enumeration for SmartThings status. 1. More...
enum  smartthings_connection_status_e { SMARTTHINGS_CONNECTION_STATUS_CONNECTED = 0, SMARTTHINGS_CONNECTION_STATUS_DISCONNECTED, SMARTTHINGS_CONNECTION_STATUS_REJECTED }
 Enumeration for RPC connection status. 1. More...
enum  smartthings_wifi_mode_e {
  SMARTTHINGS_WIFI_MODE_11A = (1 << 0), SMARTTHINGS_WIFI_MODE_11B = (1 << 1), SMARTTHINGS_WIFI_MODE_11G = (1 << 2), SMARTTHINGS_WIFI_MODE_11N = (1 << 3),
  SMARTTHINGS_WIFI_MODE_11AC = (1 << 4)
}
 The Wi-Fi mode. 1. More...
enum  smartthings_wifi_freq_e { SMARTTHINGS_WIFI_FREQ_24G = (1 << 0), SMARTTHINGS_WIFI_FREQ_5G = (1 << 1) }
 The Wi-Fi frequency band. 1. More...
enum  smartthings_wifi_authtype_e { SMARTTHINGS_WIFI_AUTHTYPE_NONE = 0, SMARTTHINGS_WIFI_AUTHTYPE_WEP, SMARTTHINGS_WIFI_AUTHTYPE_WPA_PSK, SMARTTHINGS_WIFI_AUTHTYPE_WPA2_PSK }
 The Wi-Fi authentication type of access point. 1. More...
enum  smartthings_wifi_enctype_e {
  SMARTTHINGS_WIFI_ENCTYPE_NONE = 0, SMARTTHINGS_WIFI_ENCTYPE_WEP_64, SMARTTHINGS_WIFI_ENCTYPE_WEP_128, SMARTTHINGS_WIFI_ENCTYPE_TKIP,
  SMARTTHINGS_WIFI_ENCTYPE_AES, SMARTTHINGS_WIFI_ENCTYPE_TKIP_AES
}
 The Wi-Fi encryption type of access point. 1. More...

Functions

int smartthings_initialize (smartthings_h *handle, smartthings_connection_status_cb connection_status_cb, void *user_data)
 Creates a handle and connects to agent. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.
int smartthings_deinitialize (smartthings_h handle)
 Deinitializes a handle and disconnects from the agent. 1.
int smartthings_start (smartthings_h handle)
 Starts SmartThings Thing operation. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.
int smartthings_stop (smartthings_h handle)
 Stops SmartThings Thing operation. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.
int smartthings_set_status_changed_cb (smartthings_h handle, smartthings_status_changed_cb status_cb, void *user_data)
 Sets thing status changed callback. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.
int smartthings_unset_status_changed_cb (smartthings_h handle)
 Unsets thing status changed callback. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.
int smartthings_set_certificate_file (smartthings_h handle, const char *certificate, const char *private_key)
 Sets test certificate files. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.
int smartthings_set_device_property (smartthings_h handle, const char *dev_name, int wifi_mode, int wifi_freq)
 Sets device property for Easy-setup. 1.
int smartthings_get_device_id (smartthings_h handle, char **device_id)
 Gets a device ID. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.
int smartthings_get_easysetup_status (smartthings_h handle, bool *is_completed)
 Gets a Easy-setup status. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.
int smartthings_start_easysetup (smartthings_h handle)
 Starts Easy-setup mode.
int smartthings_stop_easysetup (smartthings_h handle)
 Stops Easy-setup mode.
int smartthings_set_user_confirm_cb (smartthings_h handle, smartthings_user_confirm_cb confirm_cb, void *user_data)
 Sets callback for getting user confirmation for mutual verification based just work ownership transfer. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.
int smartthings_unset_user_confirm_cb (smartthings_h handle)
 Unsets user confirmation callback. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.
int smartthings_set_reset_confirm_cb (smartthings_h handle, smartthings_reset_confirm_cb confirm_cb, void *user_data)
 Sets reset confirmation callback. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.
int smartthings_unset_reset_confirm_cb (smartthings_h handle)
 Unsets reset confirmation callback. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.
int smartthings_set_reset_result_cb (smartthings_h handle, smartthings_reset_result_cb reset_result_cb, void *user_data)
 Sets reset result callback. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.
int smartthings_unset_reset_result_cb (smartthings_h handle)
 Unsets reset result callback. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.
int smartthings_set_pin_cb (smartthings_h handle, smartthings_pin_generated_cb generated_cb, smartthings_pin_display_close_cb close_cb, void *user_data)
 Sets callback for getting randomly generated PIN for the PIN-based ownership transfer request. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.
int smartthings_unset_pin_cb (smartthings_h handle)
 Unsets PIN callback. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.
int smartthings_set_wifi_ap_provisioning_cb (smartthings_h handle, smartthings_wifi_ap_provisioning_cb wifi_ap_cb, void *user_data)
 Sets callback for getting Wi-Fi AP information during Easy-setup. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.
int smartthings_unset_wifi_ap_provisioning_cb (smartthings_h handle)
 Unsets callback for getting Wi-Fi AP information during Easy-setup. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.
int smartthings_set_device_provisioning_cb (smartthings_h handle, smartthings_device_provisioning_cb dev_prov_cb, void *user_data)
 Sets callback for getting device provisioning information. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.
int smartthings_unset_device_provisioning_cb (smartthings_h handle)
 Unsets callback for getting device provisioning information. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.
int smartthings_set_scan_ap_cb (smartthings_h handle, smartthings_scan_ap_cb scan_ap_cb, void *user_data)
 Sets callback for informing the scan AP list request. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.
int smartthings_unset_scan_ap_cb (smartthings_h handle)
 Unsets callback for informing the scan AP list request. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.
int smartthings_set_stop_soft_ap_cb (smartthings_h handle, smartthings_stop_soft_ap_cb stop_soft_ap_cb, void *user_data)
 Sets callback for informing the stop soft AP request. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.
int smartthings_unset_stop_soft_ap_cb (smartthings_h handle)
 Unsets callback for informing the stop soft AP request. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.
int smartthings_send_user_confirm (smartthings_h handle, bool confirm)
 Sends a user confirmation for MUTUAL VERIFICATION BASED JUST WORK Ownership transfer. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing
http://tizen.org/privilege/internet.
int smartthings_send_reset_confirm (smartthings_h handle, bool confirm)
 Sends a reset confirmation. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing
http://tizen.org/privilege/internet.
int smartthings_reset (smartthings_h handle)
 Sends a reset command for resetting the device's Cloud signup and Easy-setup. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing
http://tizen.org/privilege/internet.
int smartthings_apinfo_get_ssid (smartthings_ap_info_h ap_info_h, char **ssid)
 Gets SSID of access point. 1.
int smartthings_apinfo_get_password (smartthings_ap_info_h ap_info_h, char **pwd)
 Gets password of access point. 1.
int smartthings_apinfo_get_authtype (smartthings_ap_info_h ap_info_h, smartthings_wifi_authtype_e *authtype)
 Gets authentification type of access point. 1.
int smartthings_apinfo_get_enctype (smartthings_ap_info_h ap_info_h, smartthings_wifi_enctype_e *enctype)
 Gets encryption type of access point. 1.
int smartthings_apinfo_get_channel (smartthings_ap_info_h ap_info_h, int *channel)
 Gets channel information of access point. 1.
int smartthings_devinfo_get_language (smartthings_device_prov_info_h dev_prov_h, char **language)
 Gets language of device provisioing information. 1.
int smartthings_devinfo_get_country (smartthings_device_prov_info_h dev_prov_h, char **country)
 Gets country of device provisioing information. 1.
int smartthings_devinfo_get_datetime (smartthings_device_prov_info_h dev_prov_h, char **datetime)
 Gets datetime of device provisioing information. 1.
int smartthings_aplist_create (smartthings_ap_list_h *ap_list_h, unsigned int count)
 Creates a SmartThings AP list handle. 1.
int smartthings_aplist_destroy (smartthings_ap_list_h ap_list_h)
 Destroys a SmartThings AP list handle. 1.
int smartthings_aplist_set_ssid (smartthings_ap_list_h ap_list_h, int idx, const char *ssid)
 Sets SSID at the specific index of AP list handle. 1.
int smartthings_aplist_set_bssid (smartthings_ap_list_h ap_list_h, int idx, const char *bssid)
 Sets BSSID at the specific index of AP list handle. 1.
int smartthings_aplist_set_authtype (smartthings_ap_list_h ap_list_h, int idx, smartthings_wifi_authtype_e authtype)
 Sets authentification type at the specific index of AP list handle. 1.
int smartthings_aplist_set_enctype (smartthings_ap_list_h ap_list_h, int idx, smartthings_wifi_enctype_e enctype)
 Sets encryption type at the specific index of AP list handle. 1.
int smartthings_aplist_set_channel (smartthings_ap_list_h ap_list_h, int idx, int channel)
 Sets frequency channel at the specific index of AP list handle. 1.
int smartthings_aplist_set_signal_level (smartthings_ap_list_h ap_list_h, int idx, int signal_level)
 Sets signal level at the specific index of AP list handle. 1.
int smartthings_aplist_set_max_rate (smartthings_ap_list_h ap_list_h, int idx, int max_rate)
 Sets max speed rate at the specific index of AP list handle. 1.
int smartthings_send_ap_list (smartthings_h handle, smartthings_ap_list_h ap_list_h, int req_id)
 Sends the scanned AP list. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing
http://tizen.org/privilege/internet.
int smartthings_cloudinfo_create (smartthings_cloud_info_h *cloud_info_h)
 Creates a SmartThings cloud information handle. 1.
int smartthings_cloudinfo_destroy (smartthings_cloud_info_h cloud_info_h)
 Destroys a SmartThings cloud information handle. 1.
int smartthings_cloudinfo_set_region (smartthings_cloud_info_h cloud_info_h, const char *region)
 Sets region of cloud information. 1.
int smartthings_cloudinfo_set_auth_provider (smartthings_cloud_info_h cloud_info_h, const char *auth_provider)
 Sets authentification provider of cloud information. 1.
int smartthings_cloudinfo_set_access_token (smartthings_cloud_info_h cloud_info_h, const char *access_token)
 Sets access token of cloud information. 1.
int smartthings_cloudinfo_set_refresh_token (smartthings_cloud_info_h cloud_info_h, const char *refresh_token)
 Sets refresh token of cloud information. 1.
int smartthings_cloudinfo_set_user_id (smartthings_cloud_info_h cloud_info_h, const char *user_id)
 Sets user ID of cloud information. 1.
int smartthings_cloudinfo_set_client_id (smartthings_cloud_info_h cloud_info_h, const char *client_id)
 Sets client ID of cloud information. 1.
int smartthings_sign_up_cloud (smartthings_h handle, smartthings_cloud_info_h cloud_info_h)
 Requests to sign up to cloud. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing
http://tizen.org/privilege/internet.
int smartthings_set_preconfigured_pin (smartthings_h handle, const char *pin)
 Sets preconfigured PIN. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.
int smartthings_set_mot_status (smartthings_h handle, bool enable)
 Sets MOT(multiple ownership transfer) status. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.

Detailed Description

The Master API provides functions to connect to SmartThings Cloud.

Required Header

#include <smartthings.h>

Overview

The SmartThings Thing Master API provides the following functionalities:

Typedef Documentation

typedef void(* smartthings_connection_status_cb)(smartthings_h handle, smartthings_connection_status_e status, void *user_data)

Callback for status of connection to SmartThings Thing agent. 1.

Remarks:
The handle should not be released.
The handle is the same object for which the callback was set/added.
The handle will be released when smartthings_deinitialize() is called.
When callback is called, user can see connection status as smartthings_connection_status_e enumeration value.
Parameters:
[in]resultThe result of connection operation
[in]handleThe SmartThings handle
[in]statusThe status of connection
[in]user_dataThe user data passed from the callback registration function
See also:
smartthings_initialize()
typedef void(* smartthings_device_provisioning_cb)(smartthings_h handle, smartthings_device_prov_info_h dev_prov_h, void *user_data)

Callback for informing device provisioning information. 1.

Remarks:
The handle should not be released.
The handle is the same object for which the callback was set/added.
The handle will be released when smartthings_deinitialize() is called.
The dev_prov_h should not be released.
The dev_prov_h will be released when smartthings_unset_device_provisioning_cb() is called.
When callback is called, user can get device provisioning information.
Parameters:
[in]handleThe SmartThings handle
[in]dev_prov_hThe device provisioning information handle
[in]user_dataThe user data passed from the callback registration function
See also:
smartthings_set_device_provisioning_cb()
smartthings_unset_device_provisioning_cb()
typedef void(* smartthings_pin_display_close_cb)(smartthings_h handle, void *user_data)

Callback for informing the application to close the PIN display. 1.

Remarks:
The handle should not be released.
The handle is the same object for which the callback was set/added.
The handle will be released when smartthings_deinitialize() is called.
When callback is called, user can know PIN based ownership transfer is finished.
Parameters:
[in]handleThe SmartThings handle
[in]user_dataThe user data passed from the callback registration function
See also:
smartthings_set_pin_cb()
smartthings_unset_pin_cb()
typedef void(* smartthings_pin_generated_cb)(smartthings_h handle, const char *pin, size_t size, void *user_data)

Callback for carrying the randomly generated PIN information. 1.

Remarks:
The handle should not be released.
The handle is the same object for which the callback was set/added.
The handle will be released when smartthings_deinitialize() is called.
The pin can be used only in the callback. To use outside, make a copy.
When callback is called, user can see PIN value and length.
Parameters:
[in]handleThe SmartThings handle
[in]pinThe PIN data in string format
[in]sizeThe PIN length of pin
[in]user_dataThe user data passed from the callback registration function
See also:
smartthings_set_pin_cb()
smartthings_unset_pin_cb()
typedef void(* smartthings_reset_confirm_cb)(smartthings_h handle, void *user_data)

Callback for getting user's opinion regarding device reset. 1.

Remarks:
The handle should not be released.
The handle is the same object for which the callback was set/added.
The handle will be released when smartthings_deinitialize() is called.
When callback is called, user can sends a confirmation for reset as true or false.
Parameters:
[in]handleThe SmartThings handle
[in]user_dataThe user data passed from the callback registration function
See also:
smartthings_set_reset_confirm_cb()
smartthings_unset_reset_confirm_cb()
typedef void(* smartthings_reset_result_cb)(smartthings_h handle, bool result, void *user_data)

Callback for result of reset operation. 1.

Remarks:
The handle should not be released.
The handle is the same object for which the callback was set/added.
The handle will be released when smartthings_deinitialize() is called.
When callback is called, user can check reset operation succeeds or fails.
Parameters:
[in]handleThe SmartThings handle
[in]resultThe result of reset
[in]user_dataThe user data passed from the callback registration function
See also:
smartthings_set_reset_result_cb()
smartthings_unset_reset_result_cb()
typedef void(* smartthings_scan_ap_cb)(smartthings_h handle, int req_id, void *user_data)

Callback for informing the scan AP list request. 1.

Remarks:
The handle should not be released.
The handle is the same object for which the callback was set/added.
The handle will be released when smartthings_deinitialize() is called.
When callback is called, user scans access points, sets AP list and sends it to agent.
Parameters:
[in]handleThe SmartThings handle
[in]req_idThe request ID
[in]user_dataThe user data passed from the callback registration function
See also:
smartthings_set_scan_ap_cb()
smartthings_unset_scan_ap_cb()
typedef void(* smartthings_status_changed_cb)(smartthings_h handle, smartthings_status_e status, void *user_data)

Callback for SmartThings Thing status. 1.

Remarks:
The handle should not be released.
The handle is the same object for which the callback was set/added.
The handle will be released when smartthings_deinitialize() is called.
When callback is called, user can see SmartThings status as smartthings_status_e enumeration value.
Parameters:
[in]handleThe SmartThings handle
[in]statusThe status of SmartThings
[in]user_dataThe user data passed from the callback registration function
See also:
smartthings_set_status_changed_cb()
smartthings_unset_status_changed_cb()
typedef void(* smartthings_stop_soft_ap_cb)(smartthings_h handle, void *user_data)

Callback for informing the stop soft AP request. 1.

Remarks:
The handle should not be released.
The handle is the same object for which the callback was set/added.
The handle will be released when smartthings_deinitialize() is called.
When callback is called, user stops soft AP.
Parameters:
[in]handleThe SmartThings handle
[in]user_dataThe user data passed from the callback registration function
See also:
smartthings_set_stop_soft_ap_cb()
smartthings_unset_stop_soft_ap_cb()
typedef void(* smartthings_user_confirm_cb)(smartthings_h handle, void *user_data)

Callback for getting user's input regarding mutual verification. 1.

Remarks:
The handle should not be released.
The handle is the same object for which the callback was set/added.
The handle will be released when smartthings_deinitialize() is called.
When callback is called, user can send a confirmation for mutual verification as true or false.
Parameters:
[in]handleThe SmartThings handle
[in]user_dataThe user data passed from the callback registration function
See also:
smartthings_set_user_confirm_cb()
smartthings_unset_user_confirm_cb()
typedef void(* smartthings_wifi_ap_provisioning_cb)(smartthings_h handle, smartthings_ap_info_h ap_info_h, void *user_data)

Callback for informing Wi-Fi AP information to connect. 1.

Remarks:
The handle should not be released.
The handle is the same object for which the callback was set/added.
The handle will be released when smartthings_deinitialize() is called.
The ap_info_h should not be released.
The ap_info_h will be released when smartthings_unset_wifi_ap_provisioning_cb() is called.
When callback is called, user can get Wi-Fi provisioning information.
Parameters:
[in]handleThe SmartThings handle
[in]ap_info_hThe AP information handle
[in]user_dataThe user data passed from the callback registration function
See also:
smartthings_set_wifi_ap_provisioning_cb()
smartthings_unset_wifi_ap_provisioning_cb()

Enumeration Type Documentation

enum smartthings_connection_status_e

Enumeration for RPC connection status. 1.

Enumerator:
SMARTTHINGS_CONNECTION_STATUS_CONNECTED 

Connection is connected

SMARTTHINGS_CONNECTION_STATUS_DISCONNECTED 

Connection is disconnected

SMARTTHINGS_CONNECTION_STATUS_REJECTED 

Connection is rejected

enum smartthings_error_e

Enumeration for the SmartThings error. 1.

Enumerator:
SMARTTHINGS_ERROR_NONE 

Successful

SMARTTHINGS_ERROR_INVALID_PARAMETER 

Invalid parameter

SMARTTHINGS_ERROR_OUT_OF_MEMORY 

Out of memory

SMARTTHINGS_ERROR_PERMISSION_DENIED 

Permission denied

SMARTTHINGS_ERROR_NO_DATA 

No data

SMARTTHINGS_ERROR_NOT_SUPPORTED 

Not supported

SMARTTHINGS_ERROR_OPERATION_FAILED 

Operation failed

SMARTTHINGS_ERROR_SERVICE_UNAVAILABLE 

Service unavailable

enum smartthings_status_e

Enumeration for SmartThings status. 1.

Enumerator:
SMARTTHINGS_STATUS_NOT_READY 

Service agent is not ready

SMARTTHINGS_STATUS_INIT 

Initial state of SmartThings Thing

SMARTTHINGS_STATUS_ES_STARTED 

Easy-setup is started

SMARTTHINGS_STATUS_ES_DONE 

Easy-setup is done

SMARTTHINGS_STATUS_ES_FAILED_ON_OWNERSHIP_TRANSFER 

Easy-setup failed due to Ownership-Transfer failure

SMARTTHINGS_STATUS_CONNECTING_TO_AP 

Connecting to target Wi-Fi access point

SMARTTHINGS_STATUS_CONNECTED_TO_AP 

Connected to target Wi-Fi access point

SMARTTHINGS_STATUS_CONNECTING_TO_AP_FAILED 

Failed to connect to target Wi-Fi access point

SMARTTHINGS_STATUS_REGISTERING_TO_CLOUD 

Trying to sign up, sign in and publish resources to cloud

SMARTTHINGS_STATUS_REGISTERED_TO_CLOUD 

Publish resources to cloud is complete. Now the thing is ready to be controlled via cloud

SMARTTHINGS_STATUS_REGISTERING_FAILED_ON_SIGN_IN 

Failed to sign in to cloud

SMARTTHINGS_STATUS_REGISTERING_FAILED_ON_PUB_RES 

Failed to publish resources to cloud

enum smartthings_wifi_authtype_e

The Wi-Fi authentication type of access point. 1.

Enumerator:
SMARTTHINGS_WIFI_AUTHTYPE_NONE 

No authentication

SMARTTHINGS_WIFI_AUTHTYPE_WEP 

WEP

SMARTTHINGS_WIFI_AUTHTYPE_WPA_PSK 

WPA-PSK

SMARTTHINGS_WIFI_AUTHTYPE_WPA2_PSK 

WPA2-PSK

enum smartthings_wifi_enctype_e

The Wi-Fi encryption type of access point. 1.

Enumerator:
SMARTTHINGS_WIFI_ENCTYPE_NONE 

No encryption

SMARTTHINGS_WIFI_ENCTYPE_WEP_64 

WEP 64

SMARTTHINGS_WIFI_ENCTYPE_WEP_128 

WEP 128

SMARTTHINGS_WIFI_ENCTYPE_TKIP 

TKIP

SMARTTHINGS_WIFI_ENCTYPE_AES 

AES

SMARTTHINGS_WIFI_ENCTYPE_TKIP_AES 

TKIP/AES

enum smartthings_wifi_freq_e

The Wi-Fi frequency band. 1.

Enumerator:
SMARTTHINGS_WIFI_FREQ_24G 

Wi-Fi 2.4GHz

SMARTTHINGS_WIFI_FREQ_5G 

Wi-Fi 5GHz

enum smartthings_wifi_mode_e

The Wi-Fi mode. 1.

Enumerator:
SMARTTHINGS_WIFI_MODE_11A 

Wi-Fi 11A

SMARTTHINGS_WIFI_MODE_11B 

Wi-Fi 11B

SMARTTHINGS_WIFI_MODE_11G 

Wi-Fi 11G

SMARTTHINGS_WIFI_MODE_11N 

Wi-Fi 11N

SMARTTHINGS_WIFI_MODE_11AC 

Wi-Fi 11AC

Function Documentation

int smartthings_apinfo_get_authtype ( smartthings_ap_info_h  ap_info_h,
smartthings_wifi_authtype_e *  authtype 
)

Gets authentification type of access point. 1.

Parameters:
[in]ap_info_hThe SmartThings AP information handle
[out]authtypeThe authentification type
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
SMARTTHINGS_ERROR_OPERATION_FAILEDOperation failed
See also:
smartthings_set_wifi_ap_provisioning_cb()
smartthings_unset_wifi_ap_provisioning_cb()
int smartthings_apinfo_get_channel ( smartthings_ap_info_h  ap_info_h,
int *  channel 
)

Gets channel information of access point. 1.

Parameters:
[in]ap_info_hThe SmartThings AP information handle
[out]channelThe frequency channel
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
SMARTTHINGS_ERROR_OPERATION_FAILEDOperation failed
See also:
smartthings_set_wifi_ap_provisioning_cb()
smartthings_unset_wifi_ap_provisioning_cb()
int smartthings_apinfo_get_enctype ( smartthings_ap_info_h  ap_info_h,
smartthings_wifi_enctype_e *  enctype 
)

Gets encryption type of access point. 1.

Parameters:
[in]ap_info_hThe SmartThings AP information handle
[out]enctypeThe encryption type
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
SMARTTHINGS_ERROR_OPERATION_FAILEDOperation failed
See also:
smartthings_set_wifi_ap_provisioning_cb()
smartthings_unset_wifi_ap_provisioning_cb()
int smartthings_apinfo_get_password ( smartthings_ap_info_h  ap_info_h,
char **  pwd 
)

Gets password of access point. 1.

Remarks:
The pwd should be released using free().
Parameters:
[in]ap_info_hThe SmartThings AP information handle
[out]pwdThe password
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
SMARTTHINGS_ERROR_OPERATION_FAILEDOperation failed
See also:
smartthings_set_wifi_ap_provisioning_cb()
smartthings_unset_wifi_ap_provisioning_cb()
int smartthings_apinfo_get_ssid ( smartthings_ap_info_h  ap_info_h,
char **  ssid 
)

Gets SSID of access point. 1.

Remarks:
The ssid should be released using free().
Parameters:
[in]ap_info_hThe SmartThings AP information handle
[out]ssidThe SSID name
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
SMARTTHINGS_ERROR_OPERATION_FAILEDOperation failed
See also:
smartthings_set_wifi_ap_provisioning_cb()
smartthings_unset_wifi_ap_provisioning_cb()
int smartthings_aplist_create ( smartthings_ap_list_h *  ap_list_h,
unsigned int  count 
)

Creates a SmartThings AP list handle. 1.

Remarks:
The ap_list_h must be released using smartthings_aplist_destroy().
Parameters:
[out]ap_list_hThe SmartThings AP list handle to be newly created on success
[in]countThe count of AP
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
SMARTTHINGS_ERROR_OUT_OF_MEMORYOut of memory
See also:
smartthings_aplist_destroy()
int smartthings_aplist_destroy ( smartthings_ap_list_h  ap_list_h)

Destroys a SmartThings AP list handle. 1.

Parameters:
[in]ap_list_hThe SmartThings AP list handle
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
See also:
smartthings_aplist_create()
int smartthings_aplist_set_authtype ( smartthings_ap_list_h  ap_list_h,
int  idx,
smartthings_wifi_authtype_e  authtype 
)

Sets authentification type at the specific index of AP list handle. 1.

Parameters:
[in]ap_list_hThe SmartThings AP list handle
[in]idxThe index
[in]authtypeThe authentification type of AP
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
See also:
smartthings_aplist_create()
smartthings_aplist_destroy()
int smartthings_aplist_set_bssid ( smartthings_ap_list_h  ap_list_h,
int  idx,
const char *  bssid 
)

Sets BSSID at the specific index of AP list handle. 1.

Parameters:
[in]ap_list_hThe SmartThings AP list handle
[in]idxThe index
[in]bssidThe BSSID of AP
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
See also:
smartthings_aplist_create()
smartthings_aplist_destroy()
int smartthings_aplist_set_channel ( smartthings_ap_list_h  ap_list_h,
int  idx,
int  channel 
)

Sets frequency channel at the specific index of AP list handle. 1.

Parameters:
[in]ap_list_hThe SmartThings AP list handle
[in]idxThe index
[in]channelThe frequency channel of AP
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
See also:
smartthings_aplist_create()
smartthings_aplist_destroy()
int smartthings_aplist_set_enctype ( smartthings_ap_list_h  ap_list_h,
int  idx,
smartthings_wifi_enctype_e  enctype 
)

Sets encryption type at the specific index of AP list handle. 1.

Parameters:
[in]ap_list_hThe SmartThings AP list handle
[in]idxThe index
[in]enctypeThe encryption type of AP
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
See also:
smartthings_aplist_create()
smartthings_aplist_destroy()
int smartthings_aplist_set_max_rate ( smartthings_ap_list_h  ap_list_h,
int  idx,
int  max_rate 
)

Sets max speed rate at the specific index of AP list handle. 1.

Parameters:
[in]ap_list_hThe SmartThings AP list handle
[in]idxThe index
[in]max_rateThe max speed rate of AP
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
See also:
smartthings_aplist_create()
smartthings_aplist_destroy()
int smartthings_aplist_set_signal_level ( smartthings_ap_list_h  ap_list_h,
int  idx,
int  signal_level 
)

Sets signal level at the specific index of AP list handle. 1.

Parameters:
[in]ap_list_hThe SmartThings AP list handle
[in]idxThe index
[in]signal_levelThe signal level of AP
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
See also:
smartthings_aplist_create()
smartthings_aplist_destroy()
int smartthings_aplist_set_ssid ( smartthings_ap_list_h  ap_list_h,
int  idx,
const char *  ssid 
)

Sets SSID at the specific index of AP list handle. 1.

Parameters:
[in]ap_list_hThe SmartThings AP list handle
[in]idxThe index
[in]ssidThe SSID of AP
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
See also:
smartthings_aplist_create()
smartthings_aplist_destroy()
int smartthings_cloudinfo_create ( smartthings_cloud_info_h *  cloud_info_h)

Creates a SmartThings cloud information handle. 1.

Remarks:
The cloud_info_h must be released using smartthings_cloudinfo_destroy().
Parameters:
[out]cloud_info_hThe SmartThings cloud information handle to be newly created on success
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
SMARTTHINGS_ERROR_OUT_OF_MEMORYOut of memory
See also:
smartthings_cloudinfo_destroy()
int smartthings_cloudinfo_destroy ( smartthings_cloud_info_h  cloud_info_h)

Destroys a SmartThings cloud information handle. 1.

Parameters:
[in]cloud_info_hThe SmartThings cloud information handle
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
See also:
smartthings_cloudinfo_create()
int smartthings_cloudinfo_set_access_token ( smartthings_cloud_info_h  cloud_info_h,
const char *  access_token 
)

Sets access token of cloud information. 1.

Parameters:
[in]cloud_info_hThe SmartThings cloud information handle
[in]access_tokenThe access token
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
int smartthings_cloudinfo_set_auth_provider ( smartthings_cloud_info_h  cloud_info_h,
const char *  auth_provider 
)

Sets authentification provider of cloud information. 1.

Parameters:
[in]cloud_info_hThe SmartThings cloud information handle
[in]auth_providerThe authentification provider
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
int smartthings_cloudinfo_set_client_id ( smartthings_cloud_info_h  cloud_info_h,
const char *  client_id 
)

Sets client ID of cloud information. 1.

Parameters:
[in]cloud_info_hThe SmartThings cloud information handle
[in]client_idThe client ID
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
int smartthings_cloudinfo_set_refresh_token ( smartthings_cloud_info_h  cloud_info_h,
const char *  refresh_token 
)

Sets refresh token of cloud information. 1.

Parameters:
[in]cloud_info_hThe SmartThings cloud information handle
[in]refresh_tokenThe refresh token
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
int smartthings_cloudinfo_set_region ( smartthings_cloud_info_h  cloud_info_h,
const char *  region 
)

Sets region of cloud information. 1.

Remarks:
The region can be set to one of "global" or "china".
If it doesn't use this function, the region will be set to "global" internally.
Parameters:
[in]cloud_info_hThe SmartThings cloud information handle
[in]regionThe region name
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
int smartthings_cloudinfo_set_user_id ( smartthings_cloud_info_h  cloud_info_h,
const char *  user_id 
)

Sets user ID of cloud information. 1.

Parameters:
[in]cloud_info_hThe SmartThings cloud information handle
[in]user_idThe user ID
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
int smartthings_deinitialize ( smartthings_h  handle)

Deinitializes a handle and disconnects from the agent. 1.

Parameters:
[in]handleThe SmartThings handle
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
SMARTTHINGS_ERROR_OPERATION_FAILEDOperation failed
See also:
smartthings_initialize()
int smartthings_devinfo_get_country ( smartthings_device_prov_info_h  dev_prov_h,
char **  country 
)

Gets country of device provisioing information. 1.

Remarks:
The country should be released using free().
Parameters:
[in]dev_prov_hThe SmartThings device provisioning information handle
[out]countryThe ISO Country Code (ISO 3166-1 Alpha-2)
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
SMARTTHINGS_ERROR_OPERATION_FAILEDOperation failed
See also:
smartthings_set_device_provisioning_cb()
smartthings_unset_device_provisioning_cb()
int smartthings_devinfo_get_datetime ( smartthings_device_prov_info_h  dev_prov_h,
char **  datetime 
)

Gets datetime of device provisioing information. 1.

Remarks:
The datetime should be released using free().
Parameters:
[in]dev_prov_hThe SmartThings device provisioning information handle
[out]datetimeThe date and time
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
SMARTTHINGS_ERROR_OPERATION_FAILEDOperation failed
See also:
smartthings_set_device_provisioning_cb()
smartthings_unset_device_provisioning_cb()
int smartthings_devinfo_get_language ( smartthings_device_prov_info_h  dev_prov_h,
char **  language 
)

Gets language of device provisioing information. 1.

Remarks:
The language should be released using free().
Parameters:
[in]dev_prov_hThe SmartThings device provisioning information handle
[out]languageThe IETF language tag using ISO 639X
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
SMARTTHINGS_ERROR_OPERATION_FAILEDOperation failed
See also:
smartthings_set_device_provisioning_cb()
smartthings_unset_device_provisioning_cb()
int smartthings_get_device_id ( smartthings_h  handle,
char **  device_id 
)

Gets a device ID. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.

Remarks:
The device_id should be released using free().
Parameters:
[in]handleThe SmartThings handle
[out]device_idThe device ID
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
SMARTTHINGS_ERROR_PERMISSION_DENIEDPermission denied
SMARTTHINGS_ERROR_OPERATION_FAILEDOperation failed
SMARTTHINGS_ERROR_SERVICE_UNAVAILABLEService unavailable
int smartthings_get_easysetup_status ( smartthings_h  handle,
bool *  is_completed 
)

Gets a Easy-setup status. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.

Parameters:
[in]handleThe SmartThings handle
[out]is_completedThe status of Easy-setup whether it is completed or not
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
SMARTTHINGS_ERROR_PERMISSION_DENIEDPermission denied
SMARTTHINGS_ERROR_OPERATION_FAILEDOperation failed
SMARTTHINGS_ERROR_SERVICE_UNAVAILABLEService unavailable
int smartthings_initialize ( smartthings_h *  handle,
smartthings_connection_status_cb  connection_status_cb,
void *  user_data 
)

Creates a handle and connects to agent. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.

Remarks:
The handle must be released using smartthings_deinitialize().
Ths function returns SMARTTHINGS_ERROR_PERMISSION_DENIED
if the application has no app-defined privilege for 'http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master'.
Parameters:
[out]handleThe SmartThings handle to be newly created on success
[in]connection_status_cbThe RPC connection status callback to register
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
SMARTTHINGS_ERROR_OUT_OF_MEMORYOut of memory
SMARTTHINGS_ERROR_PERMISSION_DENIEDPermission denied
SMARTTHINGS_ERROR_OPERATION_FAILEDOperation failed
SMARTTHINGS_ERROR_NOT_SUPPORTEDNot supported
SMARTTHINGS_ERROR_SERVICE_UNAVAILABLEService unavailable
See also:
smartthings_deinitialize()
int smartthings_reset ( smartthings_h  handle)

Sends a reset command for resetting the device's Cloud signup and Easy-setup. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing
http://tizen.org/privilege/internet.

Parameters:
[in]handleThe SmartThings handle
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
SMARTTHINGS_ERROR_PERMISSION_DENIEDPermission denied
SMARTTHINGS_ERROR_OPERATION_FAILEDOperation failed
SMARTTHINGS_ERROR_SERVICE_UNAVAILABLEService unavailable
See also:
smartthings_set_reset_result_cb()
smartthings_unset_reset_result_cb()
int smartthings_send_ap_list ( smartthings_h  handle,
smartthings_ap_list_h  ap_list_h,
int  req_id 
)

Sends the scanned AP list. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing
http://tizen.org/privilege/internet.

Parameters:
[in]handleThe SmartThings handle
[in]ap_list_hThe SmartThings AP list handle
[in]req_idThe request ID
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
SMARTTHINGS_ERROR_OUT_OF_MEMORYOut of memory
SMARTTHINGS_ERROR_PERMISSION_DENIEDPermission denied
SMARTTHINGS_ERROR_OPERATION_FAILEDOperation failed
SMARTTHINGS_ERROR_SERVICE_UNAVAILABLEService unavailable
See also:
smartthings_aplist_create()
smartthings_aplist_destroy()
smartthings_set_scan_ap_cb()
int smartthings_send_reset_confirm ( smartthings_h  handle,
bool  confirm 
)

Sends a reset confirmation. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing
http://tizen.org/privilege/internet.

Parameters:
[in]handleThe SmartThings handle
[in]confirmThe reset confirmation
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
SMARTTHINGS_ERROR_PERMISSION_DENIEDPermission denied
SMARTTHINGS_ERROR_OPERATION_FAILEDOperation failed
SMARTTHINGS_ERROR_SERVICE_UNAVAILABLEService unavailable
See also:
smartthings_set_reset_confirm_cb()
smartthings_unset_reset_confirm_cb()
int smartthings_send_user_confirm ( smartthings_h  handle,
bool  confirm 
)

Sends a user confirmation for MUTUAL VERIFICATION BASED JUST WORK Ownership transfer. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing
http://tizen.org/privilege/internet.

Parameters:
[in]handleThe SmartThings handle
[in]confirmThe user confirmation for OTM(ownership transfer method)
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
SMARTTHINGS_ERROR_PERMISSION_DENIEDPermission denied
SMARTTHINGS_ERROR_OPERATION_FAILEDOperation failed
SMARTTHINGS_ERROR_SERVICE_UNAVAILABLEService unavailable
See also:
smartthings_set_user_confirm_cb()
smartthings_unset_user_confirm_cb()
int smartthings_set_certificate_file ( smartthings_h  handle,
const char *  certificate,
const char *  private_key 
)

Sets test certificate files. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.

Remarks:
These files should be placed in 'res' directory of application.
This function is needed only for using test certificate.
This function can be used before smartthings_start()
Parameters:
[in]handleThe SmartThings handle
[in]certificateThe certificate file
[in]private_keyThe private key file
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
SMARTTHINGS_ERROR_PERMISSION_DENIEDPermission denied
SMARTTHINGS_ERROR_OPERATION_FAILEDOperation failed
SMARTTHINGS_ERROR_SERVICE_UNAVAILABLEService unavailable
int smartthings_set_device_property ( smartthings_h  handle,
const char *  dev_name,
int  wifi_mode,
int  wifi_freq 
)

Sets device property for Easy-setup. 1.

Remarks:
This function can be used before smartthings_start()
Parameters:
[in]handleThe SmartThings handle
[in]dev_nameThe device name
[in]wifi_modeThe supported Wi-Fi mode (bit masked value for smartthings_wifi_mode_e)
[in]wifi_freqThe supported Wi-Fi frequency (bit masked value for smartthings_wifi_freq_e)
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
int smartthings_set_device_provisioning_cb ( smartthings_h  handle,
smartthings_device_provisioning_cb  dev_prov_cb,
void *  user_data 
)

Sets callback for getting device provisioning information. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.

Remarks:
Only one callback function can be set with this function.
If multiple callbacks are set, the last one is registered only.
Callback is called when device provisioning event occurs.
When callback is called, user can get device provisioning information.
Parameters:
[in]handleThe SmartThings handle
[in]dev_prov_cbThe device provisioning callback to register
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
SMARTTHINGS_ERROR_PERMISSION_DENIEDPermission denied
SMARTTHINGS_ERROR_OPERATION_FAILEDOperation failed
SMARTTHINGS_ERROR_SERVICE_UNAVAILABLEService unavailable
See also:
smartthings_unset_device_provisioning_cb()
int smartthings_set_mot_status ( smartthings_h  handle,
bool  enable 
)

Sets MOT(multiple ownership transfer) status. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.

Parameters:
[in]handleThe SmartThings handle
[in]enableThe MOT(multiple ownership transfer) status
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
SMARTTHINGS_ERROR_PERMISSION_DENIEDPermission denied
SMARTTHINGS_ERROR_OPERATION_FAILEDOperation failed
SMARTTHINGS_ERROR_SERVICE_UNAVAILABLEService unavailable
int smartthings_set_pin_cb ( smartthings_h  handle,
smartthings_pin_generated_cb  generated_cb,
smartthings_pin_display_close_cb  close_cb,
void *  user_data 
)

Sets callback for getting randomly generated PIN for the PIN-based ownership transfer request. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.

Remarks:
Only one callback function can be set with this function.
If multiple callbacks are set, the last one is registered only.
generated_cb callback is called when PIN is generated.
close_cb callback is called when PIN based ownership transfer is finished.
When generated_cb callback is called, user can see PIN value and length.
When close_cb callback is called, user can know PIN based ownership transfer is finished.
Parameters:
[in]handleThe SmartThings handle
[in]generated_cbThe PIN generation callback to register
[in]close_cbThe PIN display close callback to register
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
SMARTTHINGS_ERROR_PERMISSION_DENIEDPermission denied
SMARTTHINGS_ERROR_OPERATION_FAILEDOperation failed
SMARTTHINGS_ERROR_SERVICE_UNAVAILABLEService unavailable
See also:
smartthings_unset_pin_cb()
int smartthings_set_preconfigured_pin ( smartthings_h  handle,
const char *  pin 
)

Sets preconfigured PIN. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.

Parameters:
[in]handleThe SmartThings handle
[in]pinThe PIN code to preconfigure
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
SMARTTHINGS_ERROR_PERMISSION_DENIEDPermission denied
SMARTTHINGS_ERROR_OPERATION_FAILEDOperation failed
SMARTTHINGS_ERROR_SERVICE_UNAVAILABLEService unavailable
int smartthings_set_reset_confirm_cb ( smartthings_h  handle,
smartthings_reset_confirm_cb  confirm_cb,
void *  user_data 
)

Sets reset confirmation callback. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.

Remarks:
Only one callback function can be set with this function.
If multiple callbacks are set, the last one is registered only.
Callback is called when it needs user's confirm for reset.
When callback is called, user can send a confirmation for reset as true or false.
Parameters:
[in]handleThe SmartThings handle
[in]confirm_cbThe reset confirm callback to register
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
SMARTTHINGS_ERROR_PERMISSION_DENIEDPermission denied
SMARTTHINGS_ERROR_OPERATION_FAILEDOperation failed
SMARTTHINGS_ERROR_SERVICE_UNAVAILABLEService unavailable
See also:
smartthings_unset_reset_confirm_cb()
int smartthings_set_reset_result_cb ( smartthings_h  handle,
smartthings_reset_result_cb  reset_result_cb,
void *  user_data 
)

Sets reset result callback. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.

Remarks:
Only one callback function can be set with this function.
If multiple callbacks are set, the last one is registered only.
Callback is called when reset operation returns its result.
When callback is called, user can check reset operation succeeds or fails.
Parameters:
[in]handleThe SmartThings handle
[in]reset_result_cbThe reset result callback to register
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
SMARTTHINGS_ERROR_PERMISSION_DENIEDPermission denied
SMARTTHINGS_ERROR_OPERATION_FAILEDOperation failed
SMARTTHINGS_ERROR_SERVICE_UNAVAILABLEService unavailable
See also:
smartthings_unset_reset_result_cb()
int smartthings_set_scan_ap_cb ( smartthings_h  handle,
smartthings_scan_ap_cb  scan_ap_cb,
void *  user_data 
)

Sets callback for informing the scan AP list request. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.

Remarks:
Only one callback function can be set with this function.
If multiple callbacks are set, the last one is registered only.
Callback is called when GET request for access point list.
When callback is called, user scans access points, sets AP list and sends it to agent.
Parameters:
[in]handleThe SmartThings handle
[in]scan_ap_cbThe callback to register
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
SMARTTHINGS_ERROR_PERMISSION_DENIEDPermission denied
SMARTTHINGS_ERROR_OPERATION_FAILEDOperation failed
SMARTTHINGS_ERROR_SERVICE_UNAVAILABLEService unavailable
See also:
smartthings_unset_scan_ap_cb()
smartthings_send_ap_list()
int smartthings_set_status_changed_cb ( smartthings_h  handle,
smartthings_status_changed_cb  status_cb,
void *  user_data 
)

Sets thing status changed callback. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.

Remarks:
Only one callback function can be set with this function.
If multiple callbacks are set, the last one is registered only.
Callback is called when SmartThings status is changed.
When callback is called, user can get SmartThings status as smartthings_status_e enumeration value.
Parameters:
[in]handleThe SmartThings handle
[in]status_cbThe status changed callback to register
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
SMARTTHINGS_ERROR_PERMISSION_DENIEDPermission denied
SMARTTHINGS_ERROR_OPERATION_FAILEDOperation failed
SMARTTHINGS_ERROR_SERVICE_UNAVAILABLEService unavailable
See also:
smartthings_unset_status_changed_cb()
int smartthings_set_stop_soft_ap_cb ( smartthings_h  handle,
smartthings_stop_soft_ap_cb  stop_soft_ap_cb,
void *  user_data 
)

Sets callback for informing the stop soft AP request. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.

Remarks:
Only one callback function can be set with this function.
If multiple callbacks are set, the last one is registered only.
Callback is called when POST request for stopping soft AP.
When callback is called, user stops soft AP.
Parameters:
[in]handleThe SmartThings handle
[in]stop_soft_ap_cbThe callback to register
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
SMARTTHINGS_ERROR_PERMISSION_DENIEDPermission denied
SMARTTHINGS_ERROR_OPERATION_FAILEDOperation failed
SMARTTHINGS_ERROR_SERVICE_UNAVAILABLEService unavailable
See also:
smartthings_unset_stop_soft_ap_cb()
int smartthings_set_user_confirm_cb ( smartthings_h  handle,
smartthings_user_confirm_cb  confirm_cb,
void *  user_data 
)

Sets callback for getting user confirmation for mutual verification based just work ownership transfer. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.

Remarks:
Only one callback function can be set with this function.
If multiple callbacks are set, the last one is registered only.
Callback is called when it needs user's confirm for mutual verification based just work ownership transfer.
When callback is called, user can send a confirmation for mutual verification based just work ownership transfer as true or false.
Parameters:
[in]handleThe SmartThings handle
[in]confirm_cbThe user confirm callback to register
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
SMARTTHINGS_ERROR_PERMISSION_DENIEDPermission denied
SMARTTHINGS_ERROR_OPERATION_FAILEDOperation failed
SMARTTHINGS_ERROR_SERVICE_UNAVAILABLEService unavailable
See also:
smartthings_unset_user_confirm_cb()
int smartthings_set_wifi_ap_provisioning_cb ( smartthings_h  handle,
smartthings_wifi_ap_provisioning_cb  wifi_ap_cb,
void *  user_data 
)

Sets callback for getting Wi-Fi AP information during Easy-setup. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.

Remarks:
Only one callback function can be set with this function.
If multiple callbacks are set, the last one is registered only.
Callback is called when Wi-Fi provisioning event occurs.
When callback is called, user can get Wi-Fi provisioning information.
Parameters:
[in]handleThe SmartThings handle
[in]wifi_ap_cbThe Wi-Fi AP callback to register
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
SMARTTHINGS_ERROR_PERMISSION_DENIEDPermission denied
SMARTTHINGS_ERROR_OPERATION_FAILEDOperation failed
SMARTTHINGS_ERROR_SERVICE_UNAVAILABLEService unavailable
See also:
smartthings_unset_wifi_ap_provisioning_cb()
int smartthings_sign_up_cloud ( smartthings_h  handle,
smartthings_cloud_info_h  cloud_info_h 
)

Requests to sign up to cloud. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing
http://tizen.org/privilege/internet.

Parameters:
[in]handleThe SmartThings handle
[in]cloud_info_hThe handle for cloud signup
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
SMARTTHINGS_ERROR_PERMISSION_DENIEDPermission denied
SMARTTHINGS_ERROR_OPERATION_FAILEDOperation failed
SMARTTHINGS_ERROR_SERVICE_UNAVAILABLEService unavailable
int smartthings_start ( smartthings_h  handle)

Starts SmartThings Thing operation. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.

Parameters:
[in]handleThe SmartThings handle
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
SMARTTHINGS_ERROR_PERMISSION_DENIEDPermission denied
SMARTTHINGS_ERROR_OPERATION_FAILEDOperation failed
SMARTTHINGS_ERROR_SERVICE_UNAVAILABLEService unavailable
See also:
smartthings_stop()
int smartthings_start_easysetup ( smartthings_h  handle)

Starts Easy-setup mode.

This function requests for turning on soft AP to SmartThings Thing agent. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing
http://tizen.org/privilege/softap

Parameters:
[in]handleThe SmartThings handle
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
SMARTTHINGS_ERROR_PERMISSION_DENIEDPermission denied
SMARTTHINGS_ERROR_OPERATION_FAILEDOperation failed
SMARTTHINGS_ERROR_SERVICE_UNAVAILABLEService unavailable
See also:
smartthings_stop_easysetup()
int smartthings_stop ( smartthings_h  handle)

Stops SmartThings Thing operation. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.

Parameters:
[in]handleThe SmartThings handle
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
SMARTTHINGS_ERROR_PERMISSION_DENIEDPermission denied
SMARTTHINGS_ERROR_OPERATION_FAILEDOperation failed
SMARTTHINGS_ERROR_SERVICE_UNAVAILABLEService unavailable
See also:
smartthings_start()
int smartthings_stop_easysetup ( smartthings_h  handle)

Stops Easy-setup mode.

This function requests for turning off soft AP to SmartThings Thing agent. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing
http://tizen.org/privilege/softap

Parameters:
[in]handleThe SmartThings handle
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
SMARTTHINGS_ERROR_PERMISSION_DENIEDPermission denied
SMARTTHINGS_ERROR_OPERATION_FAILEDOperation failed
SMARTTHINGS_ERROR_SERVICE_UNAVAILABLEService unavailable
See also:
smartthings_start_easysetup()
int smartthings_unset_device_provisioning_cb ( smartthings_h  handle)

Unsets callback for getting device provisioning information. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.

Parameters:
[in]handleThe SmartThings handle
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
SMARTTHINGS_ERROR_PERMISSION_DENIEDPermission denied
SMARTTHINGS_ERROR_OPERATION_FAILEDOperation failed
SMARTTHINGS_ERROR_SERVICE_UNAVAILABLEService unavailable
See also:
smartthings_set_device_provisioning_cb()
int smartthings_unset_pin_cb ( smartthings_h  handle)

Unsets PIN callback. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.

Parameters:
[in]handleThe SmartThings handle
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
SMARTTHINGS_ERROR_PERMISSION_DENIEDPermission denied
SMARTTHINGS_ERROR_OPERATION_FAILEDOperation failed
SMARTTHINGS_ERROR_SERVICE_UNAVAILABLEService unavailable
See also:
smartthings_set_pin_cb()
int smartthings_unset_reset_confirm_cb ( smartthings_h  handle)

Unsets reset confirmation callback. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.

Parameters:
[in]handleThe SmartThings handle
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
SMARTTHINGS_ERROR_PERMISSION_DENIEDPermission denied
SMARTTHINGS_ERROR_OPERATION_FAILEDOperation failed
SMARTTHINGS_ERROR_SERVICE_UNAVAILABLEService unavailable
See also:
smartthings_set_reset_confirm_cb()
int smartthings_unset_reset_result_cb ( smartthings_h  handle)

Unsets reset result callback. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.

Parameters:
[in]handleThe SmartThings handle
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
SMARTTHINGS_ERROR_PERMISSION_DENIEDPermission denied
SMARTTHINGS_ERROR_OPERATION_FAILEDOperation failed
SMARTTHINGS_ERROR_SERVICE_UNAVAILABLEService unavailable
See also:
smartthings_set_reset_result_cb()
int smartthings_unset_scan_ap_cb ( smartthings_h  handle)

Unsets callback for informing the scan AP list request. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.

Parameters:
[in]handleThe SmartThings handle
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
SMARTTHINGS_ERROR_PERMISSION_DENIEDPermission denied
SMARTTHINGS_ERROR_OPERATION_FAILEDOperation failed
SMARTTHINGS_ERROR_SERVICE_UNAVAILABLEService unavailable
See also:
smartthings_set_scan_ap_cb()
int smartthings_unset_status_changed_cb ( smartthings_h  handle)

Unsets thing status changed callback. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.

Parameters:
[in]handleThe SmartThings handle
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
SMARTTHINGS_ERROR_PERMISSION_DENIEDPermission denied
SMARTTHINGS_ERROR_OPERATION_FAILEDOperation failed
SMARTTHINGS_ERROR_SERVICE_UNAVAILABLEService unavailable
See also:
smartthings_set_status_changed_cb()
int smartthings_unset_stop_soft_ap_cb ( smartthings_h  handle)

Unsets callback for informing the stop soft AP request. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.

Parameters:
[in]handleThe SmartThings handle
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
SMARTTHINGS_ERROR_PERMISSION_DENIEDPermission denied
SMARTTHINGS_ERROR_OPERATION_FAILEDOperation failed
SMARTTHINGS_ERROR_SERVICE_UNAVAILABLEService unavailable
See also:
smartthings_set_stop_soft_ap_cb()
int smartthings_unset_user_confirm_cb ( smartthings_h  handle)

Unsets user confirmation callback. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.

Parameters:
[in]handleThe SmartThings handle
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
SMARTTHINGS_ERROR_PERMISSION_DENIEDPermission denied
SMARTTHINGS_ERROR_OPERATION_FAILEDOperation failed
SMARTTHINGS_ERROR_SERVICE_UNAVAILABLEService unavailable
See also:
smartthings_set_user_confirm_cb()
int smartthings_unset_wifi_ap_provisioning_cb ( smartthings_h  handle)

Unsets callback for getting Wi-Fi AP information during Easy-setup. 1 http://com.samsung.tizen.smartthings-thing/appdefined/smartthings-thing.master
http://tizen.org/privilege/appmanager.launch
http://tizen.org/privilege/datasharing.

Parameters:
[in]handleThe SmartThings handle
Returns:
0 on success, otherwise a negative error value
Return values:
SMARTTHINGS_ERROR_NONESuccessful
SMARTTHINGS_ERROR_INVALID_PARAMETERInvalid parameter
SMARTTHINGS_ERROR_PERMISSION_DENIEDPermission denied
SMARTTHINGS_ERROR_OPERATION_FAILEDOperation failed
SMARTTHINGS_ERROR_SERVICE_UNAVAILABLEService unavailable
See also:
smartthings_set_wifi_ap_provisioning_cb()
 All Files Functions Typedefs Enumerations Enumerator