Callback function type to be called when a new sensor is added.

Will be called when a new sensor is added with parameters: uri of a newly added sensor and user_data which is passed to sensor_add_sensor_cb().

Since :

4.0

Remarks:

uri should not be freed and can be used only in the callback. To use outside the callback, make a copy.

Parameters:

[in]	uri	The URI of the newly added sensor
[in]	user_data	The user data had passed to sensor_add_sensor_added_cb().

Precondition:

A callback function needs to be set using sensor_add_sensor_added_cb().

See also:

sensor_add_sensor_added_cb()

sensor_remove_sensor_added_cb()

     void sensor_add_callback(const char *uri, void *user_data)
     {
         ...
     }
     ...
         sensor_add_sensor_added_cb(sensor_add_callback, NULL);
     ...
         sensor_remove_sensor_added_cb(sensor_add_callback);

Sensor handle.

The handle for controlling a specific sensor can be retrieved using sensor_get_default_sensor().
The function returns the handle of the default sensor of a given type, and usually, a device has one sensor for one type. However, if the device supports multiple sensors of the same type, sensor_get_sensor_list() function can be used to get the list of all the sensors of the type.

Since :

2.3

Callback function type to be called when a sensor is removed.

Will be called when a sensor is removed with parameters: uri of a removed sensor and user_data which is passed to sensor_add_sensor_cb().

Since :

4.0

Remarks:

uri should not be freed and can be used only in the callback. To use outside the callback, make a copy.

Parameters:

[in]	uri	The URI of the removed sensor
[in]	user_data	The user data had passed to sensor_add_sensor_removed_cb()

Precondition:

A callback function needs to be set using sensor_add_sensor_removed_cb().

See also:

sensor_add_sensor_removed_cb()

sensor_remove_sensor_removed_cb()

     void sensor_removed_callback(const char *uri, void *user_data)
     {
         ...
     }
     ...
         sensor_add_sensor_removed_cb(sensor_add_callback, NULL);
     ...
         sensor_remove_sensor_removed_cb(sensor_add_callback);

Enumeration for errors.

Since :

2.3

Enumerator:

SENSOR_ERROR_NONE	Successful
SENSOR_ERROR_IO_ERROR	I/O error
SENSOR_ERROR_INVALID_PARAMETER	Invalid parameter
SENSOR_ERROR_NOT_SUPPORTED	Not supported
SENSOR_ERROR_PERMISSION_DENIED	Permission denied
SENSOR_ERROR_OUT_OF_MEMORY	Out of memory
SENSOR_ERROR_NO_DATA	No data available (Since 3.0)
SENSOR_ERROR_NOT_NEED_CALIBRATION	Sensor doesn't need calibration
SENSOR_ERROR_OPERATION_FAILED	Operation failed
SENSOR_ERROR_NOT_AVAILABLE	The sensor is supported, but currently not available (Since 3.0)

Enumeration for heart-rate monitor batch sensor state.

In its sensor_event_s, SENSOR_HRM_BATCH reports the user's heart-rate monitor state as one of the followings.

Since :

5.5

Enumerator:

SENSOR_HRM_BATCH_STATE_NODATA_FLUSH	Flush but there was no batched data
SENSOR_HRM_BATCH_STATE_VERYLOW_RELIABILITY	Very low measurement reliability
SENSOR_HRM_BATCH_STATE_LOW_RELIABILITY	Low measurement reliability
SENSOR_HRM_BATCH_STATE_DETACHED_AUTO	Device detachment was detected during auto measurement
SENSOR_HRM_BATCH_STATE_DETACHED	Device detachment was detected
SENSOR_HRM_BATCH_STATE_DETECT_MOVE	The Movement was detected during on-demand measurement
SENSOR_HRM_BATCH_STATE_ATTACHED	Device attachment was detected
SENSOR_HRM_BATCH_STATE_NONE	Initial state before measurement
SENSOR_HRM_BATCH_STATE_OK	Heart-rate was measured normally

Enumeration for pedestrian state.

In its sensor_event_s, SENSOR_HUMAN_PEDOMETER reports the user's pedestrian state as one of the followings.

Since :

3.0

Enumerator:

SENSOR_PEDOMETER_STATE_UNKNOWN	Uncertain
SENSOR_PEDOMETER_STATE_STOP	The user is not moving
SENSOR_PEDOMETER_STATE_WALK	The user is walking
SENSOR_PEDOMETER_STATE_RUN	The user is running

Enumeration for proximity sensor events.

In its sensor_event_s, SENSOR_PROXIMITY reports the existence of nearby objects in front of the sensor as one of the followings.

Since :

2.3

Enumerator:

SENSOR_PROXIMITY_NEAR	An object is placed near the proximity sensor
SENSOR_PROXIMITY_FAR	No object is placed near the proximity sensor

Enumeration for sleep state.

In its sensor_event_s, SENSOR_HUMAN_SLEEP_MONITOR reports the user's sleep state as one of the followings.

Since :

3.0

Enumerator:

SENSOR_SLEEP_STATE_UNKNOWN	Uncertain
SENSOR_SLEEP_STATE_WAKE	The user is awake
SENSOR_SLEEP_STATE_SLEEP	The user is asleep

Enumeration for sensor types.

Since :

2.3

Enumerator:

SENSOR_ALL	All sensors. This can be used to retrieve sensor_h for all available sensors.
SENSOR_ACCELEROMETER	Accelerometer
SENSOR_GRAVITY	Gravity sensor
SENSOR_LINEAR_ACCELERATION	Linear acceleration sensor
SENSOR_MAGNETIC	Magnetic sensor
SENSOR_ROTATION_VECTOR	Rotation vector sensor
SENSOR_ORIENTATION	Orientation sensor
SENSOR_GYROSCOPE	Gyroscope
SENSOR_LIGHT	Light sensor
SENSOR_PROXIMITY	Proximity sensor
SENSOR_PRESSURE	Pressure sensor
SENSOR_ULTRAVIOLET	Ultraviolet sensor
SENSOR_TEMPERATURE	Temperature sensor
SENSOR_HUMIDITY	Humidity sensor
SENSOR_HRM	Heart-rate monitor (Since 2.3.1) Privilege : http://tizen.org/privilege/healthinfo
SENSOR_HRM_LED_GREEN	Green LED sensor of HRM (Since 2.3.1) Privilege : http://tizen.org/privilege/healthinfo
SENSOR_HRM_LED_IR	Infra-Red LED sensor of HRM (Since 2.3.1) Privilege : http://tizen.org/privilege/healthinfo
SENSOR_HRM_LED_RED	Red LED sensor of HRM (Since 2.3.1) Privilege : http://tizen.org/privilege/healthinfo
SENSOR_GYROSCOPE_UNCALIBRATED	Uncalibrated Gyroscope sensor (Since 2.4)
SENSOR_GEOMAGNETIC_UNCALIBRATED	Uncalibrated Geomagnetic sensor (Since 2.4)
SENSOR_GYROSCOPE_ROTATION_VECTOR	Gyroscope-based rotation vector sensor (Since 2.4)
SENSOR_GEOMAGNETIC_ROTATION_VECTOR	Geomagnetic-based rotation vector sensor (Since 2.4)
SENSOR_GYROSCOPE_ORIENTATION	Orientation sensor based on gyroscope rotation vector Since 6.5
SENSOR_GEOMAGNETIC_ORIENTATION	Orientation sensor based on geomagnetic rotation vector Since 6.5
SENSOR_SIGNIFICANT_MOTION	Significant motion sensor (Since 4.0)
SENSOR_HRM_BATCH	Heart-rate monitor batch sensor (Since 5.5) Privilege : http://tizen.org/privilege/healthinfo
SENSOR_HRM_LED_GREEN_BATCH	Green LED of HRM batch sensor (Since 5.5) Privilege : http://tizen.org/privilege/healthinfo
SENSOR_HUMAN_PEDOMETER	Pedometer (Since 3.0) Privilege : http://tizen.org/privilege/healthinfo
SENSOR_HUMAN_SLEEP_MONITOR	Sleep monitor (Since 3.0) Privilege : http://tizen.org/privilege/healthinfo
SENSOR_HUMAN_SLEEP_DETECTOR	Sleep detector (Since 3.0) Privilege : http://tizen.org/privilege/healthinfo
SENSOR_HUMAN_STRESS_MONITOR	Stress monitor (Since 3.0) Privilege : http://tizen.org/privilege/healthinfo Deprecated: Deprecated since 5.5
SENSOR_LAST	End of sensor enum values Deprecated: Deprecated since 3.0
SENSOR_CUSTOM	Custom sensor Deprecated: Deprecated since 3.0

Adds a callback function to be invoked when a new sensor is added.

Add a given callback function callback to be invoked when a new sensor is added. user_data will be passed to the callback function when it is called.

Since :

4.0

Parameters:

[in]	callback	A callback function to be added
[in]	user_data	A user data to be passed to the callback function

Returns:

SENSOR_ERROR_NONE on success, otherwise a negative error value

Return values:

SENSOR_ERROR_NONE	Successful
SENSOR_ERROR_INVALID_PARAMETER	Invalid parameter
SENSOR_ERROR_OPERATION_FAILED	Operation failed

See also:

sensor_remove_sensor_added_cb()

     void sensor_add_callback(const char *uri, void *user_data)
     {
         ...
     }
     ...
         sensor_add_sensor_added_cb(sensor_add_callback, NULL);
     ...
         sensor_remove_sensor_added_cb(sensor_add_callback);

Adds a callback function to be invoked when a sensor is removed.

Add a given callback function callback to be invoked when a sensor is removed. user_data will be passed to the callback function when it is called.

Since :

4.0

Parameters:

[in]	callback	A callback function to be removed
[in]	user_data	A user data to be passed to the callback function

Returns:

SENSOR_ERROR_NONE on success, otherwise a negative error value

Return values:

SENSOR_ERROR_NONE	Successful
SENSOR_ERROR_INVALID_PARAMETER	Invalid parameter
SENSOR_ERROR_OPERATION_FAILED	Operation failed

See also:

sensor_remove_sensor_removed_cb()

     void sensor_removed_callback(const char *uri, void *user_data)
     {
         ...
     }
     ...
         sensor_add_sensor_removed_cb(sensor_add_callback, NULL);
     ...
         sensor_remove_sensor_removed_cb(sensor_add_callback);

Gets the handle for the default sensor of a given type.

This function returns the handle for the sensor of a given type. If the device has more than one sensor of the given type, this function returns the default sensor of the given type, which is designated by the device.

Since :

2.3

Remarks:

Some sensor types are privileged. An application should have the privilege http://tizen.org/privilege/healthinfo to get handles for the following sensors: SENSOR_HRM, SENSOR_HRM_LED_GREEN, SENSOR_HRM_LED_IR, SENSOR_HRM_LED_RED, SENSOR_HUMAN_PEDOMETER, SENSOR_HUMAN_SLEEP_MONITOR, SENSOR_HUMAN_SLEEP_DETECTOR, and SENSOR_HUMAN_STRESS_MONITOR.

The sensor should not be released.

Parameters:

[in]	type	A sensor type to get the handle of its default sensor
[out]	sensor	The sensor handle of the default sensor

Returns:

SENSOR_ERROR_NONE on success; Otherwise a negative error value

Return values:

SENSOR_ERROR_NONE	Successful
SENSOR_ERROR_INVALID_PARAMETER	Invalid parameter
SENSOR_ERROR_NOT_SUPPORTED	The sensor type is not supported in the current device
SENSOR_ERROR_PERMISSION_DENIED	Permission denied

See also:

sensor_get_default_sensor_by_uri()

sensor_get_sensor_list()

Example

 #include <sensor.h>
 ...
 int ret = 0;
 sensor_h sensor;
 ret = sensor_get_default_sensor(SENSOR_ACCELEROMETER, &sensor);
 if (ret != SENSOR_ERROR_NONE)
         return ret;
 ...

Gets the handle for the default sensor of a given sensor URI.

This function returns the handle for the sensor of a given URI. If the device has more than one sensor of the given URI, this function returns the default sensor of the URI, which is designated by the device.
See Sensor URIs for more details about the URI format.

Since :

4.0

Remarks:

Some sensor types are privileged. An application should have the privilege http://tizen.org/privilege/healthinfo to get handles for the sensor URIs of "healthinfo" category. See Sensor URIs to find the "healthinfo" category sensor URIs.

The sensor should not be released.

Parameters:

[in]	uri	A sensor or a sensor type URI to get the handle of its default sensor
[out]	sensor	The default sensor handle

Returns:

SENSOR_ERROR_NONE on success, otherwise a negative error value

Return values:

SENSOR_ERROR_NONE	Successful
SENSOR_ERROR_INVALID_PARAMETER	Invalid parameter
SENSOR_ERROR_NOT_SUPPORTED	The URI is not supported in the current device
SENSOR_ERROR_PERMISSION_DENIED	Permission denied

See also:

sensor_get_default_sensor()

sensor_get_sensor_list_by_uri()

Example

 #include <sensor.h>
 ...
 int ret = 0;
 sensor_h sensor;
 ret = sensor_get_default_sensor_by_uri("http://tizen.org/sensor/general/accelerometer", &sensor);
 if (ret != SENSOR_ERROR_NONE)
         return ret;
 ...

Gets the size of the hardware FIFO of a given sensor.

This function returns the size of the hardware FIFO that may be used by a specific sensor to support batching. However, regarding the underlying hardware configuration, the returned count may not mean the maximum number of sensor data that can be batched. See sensor_get_max_batch_count() for such purpose, finding out the possible maximum number of batched data.

Since :

2.3

Parameters:

[in]	sensor	A sensor handle
[out]	fifo_count	The FIFO count

Returns:

SENSOR_ERROR_NONE on success, otherwise a negative error value

Return values:

SENSOR_ERROR_NONE	Successful
SENSOR_ERROR_INVALID_PARAMETER	Invalid parameter
SENSOR_ERROR_OPERATION_FAILED	Operation failed ... int fifo_count; sensor_get_min_interval(sensor, &fifo_count);

Gets the maximum value of batch count of a given sensor.

This function returns the maximum number of sensor data events that can be possibly delivered when the batched data are flushed. Therefore, this count can be used to check whether the sensor supports batching or not.
If this returns a positive count, i.e., the sensor supports batching, the count also can be used to guess the possible longest batch latency of the sensor, with respect to the update interval to use.

Since :

2.3

Parameters:

[in]	sensor	A sensor handle
[out]	max_batch_count	If the sensor does not support batching, 0; Otherwise a positive integer.

Returns:

SENSOR_ERROR_NONE on success, otherwise a negative error value

Return values:

SENSOR_ERROR_NONE	Successful
SENSOR_ERROR_INVALID_PARAMETER	Invalid parameter
SENSOR_ERROR_OPERATION_FAILED	Operation failed

See also:

sensor_listener_set_max_batch_latency()

     ...
     int max_batch_count = 0;
     sensor_get_min_interval(sensor, &max_batch_count);

Gets the upper bound of the sensor readings of a sensor.

This function returns the upper bound of the range of possible sensor values, which are generated by the corresponding sensor denoted by a sensor handle.
If all sensor values are in the same unit, e.g., or degrees, the upper bound of all sensor values is returned. Otherwise, the upper bound of the representative sensor value, e.g., the step count of SENSOR_HUMAN_PEDOMETER, is returned.

Since :

2.3

Parameters:

[in]	sensor	A sensor handle
[out]	max_range	The upper bound

Returns:

SENSOR_ERROR_NONE on success, otherwise a negative error value

Return values:

SENSOR_ERROR_NONE	Successful
SENSOR_ERROR_INVALID_PARAMETER	Invalid parameter
SENSOR_ERROR_OPERATION_FAILED	Operation failed

See also:

sensor_get_min_range()

     ...
     float max_range;
     sensor_get_max_range(sensor, &max_range);

Gets the minimum update interval of a given sensor.

Get the minimum update interval and store it in min_interval.

Since :

2.3

Parameters:

[in]	sensor	A sensor handle
[out]	min_interval	The shorted interval in milliseconds

Returns:

SENSOR_ERROR_NONE on success, otherwise a negative error value

Return values:

SENSOR_ERROR_NONE	Successful
SENSOR_ERROR_INVALID_PARAMETER	Invalid parameter
SENSOR_ERROR_OPERATION_FAILED	Operation failed ... int min_interval; sensor_get_min_interval(sensor, &min_interval);

Gets the lower bound of the sensor reading of a sensor.

This function returns the lower bound of the range of possible sensor values, which are generated by the corresponding sensor denoted by a sensor handle.
If all sensor values are in the same unit, e.g., or degrees, the lower bound of all sensor values is returned. Otherwise, the lower bound of the representative sensor value, e.g., the step count of SENSOR_HUMAN_PEDOMETER, is returned.

Since :

2.3

Parameters:

[in]	sensor	A sensor handle
[out]	min_range	The lower bound

Returns:

SENSOR_ERROR_NONE on success, otherwise a negative error value

Return values:

SENSOR_ERROR_NONE	Successful
SENSOR_ERROR_INVALID_PARAMETER	Invalid parameter
SENSOR_ERROR_OPERATION_FAILED	Operation failed

See also:

sensor_get_max_range()

     ...
     float min_range;
     sensor_get_min_range(sensor, &min_range);

Gets the name of a given sensor as a newly allocated string.

Get the name of a given sensor and store it in the name.

Since :

2.3

Remarks:

The name must be released using free(), if not being used anymore.

Parameters:

[in]	sensor	A sensor handle
[out]	name	The name of the sensor

Returns:

SENSOR_ERROR_NONE on success, otherwise a negative error value

Return values:

SENSOR_ERROR_NONE	Successful
SENSOR_ERROR_INVALID_PARAMETER	Invalid parameter ... char *name = NULL; sensor_get_name(sensor, &name); ... free(name);

Gets the resolution of the sensor readings of a sensor.

This function returns the resolution of the sensor readings. The resolution denotes the smallest difference between sensor readings, each of which is in the range that can be verified by sensor_get_min_range() and sensor_get_max_range().

Since :

2.3

Parameters:

[in]	sensor	A sensor handle
[out]	resolution	The resolution

Returns:

SENSOR_ERROR_NONE on success, otherwise a negative error value

Return values:

SENSOR_ERROR_NONE	Successful
SENSOR_ERROR_INVALID_PARAMETER	Invalid parameter
SENSOR_ERROR_OPERATION_FAILED	Operation failed ... float resolution; sensor_get_resolution(sensor, &resolution);

Gets the handle list of the sensors of a given type.

A device may have more than one sensors of the given type. In such case, this function can be used to get the handles of all sensors of the type.
The first element of the list denotes the default sensor, which can be retrieved by sensor_get_default_sensor().

Since :

2.3

Remarks:

Some sensor types are privileged. An application should have the privilege http://tizen.org/privilege/healthinfo to get handles for the following sensors: SENSOR_HRM, SENSOR_HRM_LED_GREEN, SENSOR_HRM_LED_IR, SENSOR_HRM_LED_RED, SENSOR_HUMAN_PEDOMETER, SENSOR_HUMAN_SLEEP_MONITOR, SENSOR_HUMAN_SLEEP_DETECTOR, and SENSOR_HUMAN_STRESS_MONITOR.
Instead of specifying a sensor type, by using SENSOR_ALL, applications can get the list of handles for all available sensors.
The list must be released using free(), if not being used anymore.

Parameters:

[in]	type	A sensor type to get the list of sensor handles
[out]	list	An array of the sensor handles
[out]	sensor_count	The number of handles contained in list

Returns:

SENSOR_ERROR_NONE on success; Otherwise a negative error value

Return values:

SENSOR_ERROR_NONE	Successful
SENSOR_ERROR_INVALID_PARAMETER	Invalid parameter
SENSOR_ERROR_NOT_SUPPORTED	The sensor type is not supported in the current device
SENSOR_ERROR_PERMISSION_DENIED	Permission denied
SENSOR_ERROR_OUT_OF_MEMORY	Out of memory

     sensor_h *sensor_list = NULL;
     int sensor_list_len = 0;
     sensor_get_sensor_list(SENSOR_ACCELEROMETER, &sensor_list, &sensor_list_len);

Gets the handle list of the sensors of a given URI.

A device may have more than one sensor of the given URI. In such case, this function can be used to get the handles of all sensors of the given URI.
See Sensor URIs for more details about the URI format.

Since :

4.0

Remarks:

Some sensors require one or more privileges. An application should have the corresponding privilege to get handles for such sensors. See sensor_get_default_sensor_by_uri() for more details.
The list must be released using free(), if not being used anymore.

Parameters:

[in]	uri	A sensor or a sensor type URI to get the list of sensor handles
[out]	list	An array of the sensor handles
[out]	sensor_count	The number of handles contained in list

Returns:

SENSOR_ERROR_NONE on success, otherwise a negative error value

Return values:

SENSOR_ERROR_NONE	Successful
SENSOR_ERROR_INVALID_PARAMETER	Invalid parameter
SENSOR_ERROR_NOT_SUPPORTED	The URI is not supported in the current device
SENSOR_ERROR_PERMISSION_DENIED	Permission denied
SENSOR_ERROR_OUT_OF_MEMORY	Out of memory sensor_h *sensor_list = NULL; int sensor_list_len = 0; sensor_get_sensor_list("http://tizen.org/sensor/general/accelerometer", &sensor_list, &sensor_list_len);

Gets the type of a given sensor as sensor_type_e data type.

Get the type of a given sensor if it belongs to the known types defined in sensor_type_e.

Since :

2.3

Parameters:

[in]	sensor	A sensor handle
[out]	type	The type of the sensor

Returns:

SENSOR_ERROR_NONE on success, otherwise a negative error value

Return values:

SENSOR_ERROR_NONE	Successful
SENSOR_ERROR_INVALID_PARAMETER	Invalid parameter
SENSOR_ERROR_NO_DATA	No known sensor type for the given sensor
SENSOR_ERROR_OPERATION_FAILED	Operation failed ... sensor_type_e sensor_type; sensor_get_type(sensor, &sensor_type);

Gets the URI of a given sensor as a newly allocated string.

Get the URI of a given sensor and store it in the uri.

Since :

4.0

Remarks:

The uri must be released using free(), if not being used anymore.

Parameters:

[in]	sensor	A sensor handle
[out]	uri	The URI of the sensor

Returns:

SENSOR_ERROR_NONE on success, otherwise a negative error value

Return values:

SENSOR_ERROR_NONE	Successful
SENSOR_ERROR_INVALID_PARAMETER	Invalid parameter ... char *uri = NULL; sensor_get_uri(sensor, &uri); ... free(uri);

Gets the vandor name of a given sensor as a newly allocated string.

Get the vendor name of a given sensor and store it in the vendor.

Since :

2.3

Remarks:

The vendor must be released using free(), if not being used anymore.

Parameters:

[in]	sensor	A sensor handle
[out]	vendor	The vendor of the sensor

Returns:

SENSOR_ERROR_NONE on success, otherwise a negative error value

Return values:

SENSOR_ERROR_NONE	Successful
SENSOR_ERROR_INVALID_PARAMETER	Invalid parameter ... char *vendor_name = NULL; sensor_get_vendor(sensor, &vendor_name); ... free(vendor_name);

Checks whether a given sensor type is supported in the current device.

If sensor type is supported, supported will be true. Otherwise, it will be false and the return value will be an error.

Since :

2.3

Remarks:

If the given sensor type is not supported, sensor_get_default_sensor() will return an error. It is thus recommended to check the availability of the sensor before actually acquiring sensor_h.

Parameters:

[in]	type	A sensor type to check
[out]	supported	If supported, true; Otherwise false

Returns:

SENSOR_ERROR_NONE on success; Otherwise a negative error value

Return values:

SENSOR_ERROR_NONE	Successful
SENSOR_ERROR_INVALID_PARAMETER	Invalid parameter

See also:

sensor_is_supported_by_uri()

     ...
     sensor_type_e type;
     bool supported;
     ...
     sensor_is_supported(type, &supported);
     if (!supported)
         return -1;

Checks whether a sensor corresponding to a given URI is supported in the current device.

supported is set as true if the sensor is available; otherwise, it is set as false. It is recommended to check the availability of the sensors corresponding to the URI before actually acquiring sensor_h.

Since :

4.0

Remarks:

uri should be valid and not null to correctly check the availability of a sensor. The valid form of URIs is explained in Sensor URIs.
If a URI with the sensor's name is given, for example, http://tizen.org/sensor/general/light/front, the availability of the "front" light sensor is checked. Otherwise, if a URI without the name, http://tizen.org/sensor/general/light, is given, this function checks the availability of any light sensor in the device.

Parameters:

[in]	uri	A sensor or a sensor type URI to check
[out]	supported	If supported, true, otherwise false

Returns:

SENSOR_ERROR_NONE on success, otherwise a negative error value

Return values:

SENSOR_ERROR_NONE	Successful
SENSOR_ERROR_INVALID_PARAMETER	Invalid parameter

See also:

sensor_is_supported()

     bool supported;
     sensor_is_supported_by_uri("http://tizen.org/sensor/general/light/front", &supported);
     if (!supported) {
         return -1;
     }

Checks whether a given sensor is a wake-up sensor or not.

If a sensor is a wake-up sensor, the sensor is able to wake-up the system to report its sensor data even if the system is in sleep mode.

Since :

3.0

Parameters:

[in]	sensor	A sensor handle to check
[out]	wakeup	If the sensor is a wake-up sensor, true; Otherwise false

Returns:

SENSOR_ERROR_NONE on success, otherwise a negative error value

Return values:

SENSOR_ERROR_NONE	Successful
SENSOR_ERROR_INVALID_PARAMETER	Invalid parameter

Precondition:

The handle sensor needs to be initialized using sensor_get_default_sensor() or sensor_get_sensor_list() in advance.

     bool is_wakeup_sensor = false;
     sensor_is_wake_up(sensor, &is_wakeup_sensor);
     is (!is_wakeup_sensor)
         return -1;

Removes a callback added by sensor_add_sensor_added_cb().

Remove a given callback function which is added by sensor_add_sensor_added_cb() before.

Since :

4.0

Parameters:

[in]

callback

A callback function to be removed

Returns:

SENSOR_ERROR_NONE on success, otherwise a negative error value

Return values:

SENSOR_ERROR_NONE	Successful
SENSOR_ERROR_INVALID_PARAMETER	Invalid parameter
SENSOR_ERROR_OPERATION_FAILED	Operation failed

See also:

sensor_add_sensor_added_cb()

     void sensor_add_callback(const char *uri, void *user_data)
     {
         ...
     }
     ...
         sensor_add_sensor_added_cb(sensor_add_callback, NULL);
     ...
         sensor_remove_sensor_added_cb(sensor_add_callback);

Removes a callback function added using sensor_add_sensor_removed_cb().

Remove a given callback function which is added by sensor_add_sensor_removed_cb() before.

Since :

4.0

Parameters:

[in]

callback

A callback function to be removed

Returns:

SENSOR_ERROR_NONE on success, otherwise a negative error value

Return values:

SENSOR_ERROR_NONE	Successful
SENSOR_ERROR_INVALID_PARAMETER	Invalid parameter
SENSOR_ERROR_OPERATION_FAILED	Operation failed

See also:

sensor_add_sensor_removed_cb()

     void sensor_removed_callback(const char *uri, void *user_data)
     {
         ...
     }
     ...
         sensor_add_sensor_removed_cb(sensor_add_callback, NULL);
     ...
         sensor_remove_sensor_removed_cb(sensor_add_callback);