PXP: Modify APIs and Signal handle implementation

[platform/core/connectivity/bluetooth-frwk.git] / include / bluetooth-api.h

diff --git a/include/bluetooth-api.h b/include/bluetooth-api.h
index cccd59f..c06531a 100644 (file)
--- a/include/bluetooth-api.h
+++ b/include/bluetooth-api.h
@@ -6899,10 +6899,10 @@ int bluetooth_dpm_set_data_transfer_state(bt_dpm_status_t value);
 int bluetooth_dpm_get_data_transfer_state(bt_dpm_status_t *value);
 
 /**
- * @fn int bluetooth_set_proximity_property(const bluetooth_device_address_t *device_address,
+ * @fn int bluetooth_proximity_monitor_set_property(const bluetooth_device_address_t *device_address,
  *                                             bluetooth_pxp_poperty_t property, int value);
  *
- * @brief Sets the Proximity alert level/properties.
+ * @brief Sets the Proximity alert level/properties for monitor role.
  *
  * This function is a synchronous call.
  *
@@ -6919,14 +6919,14 @@ int bluetooth_dpm_get_data_transfer_state(bt_dpm_status_t *value);
  *
  * @remark     None
  */
-int bluetooth_set_proximity_property(const bluetooth_device_address_t *device_address,
+int bluetooth_proximity_monitor_set_property(const bluetooth_device_address_t *device_address,
                                                        bluetooth_pxp_poperty_t property, int value);
 
 /**
- * @fn int bluetooth_get_proximity_property(const bluetooth_device_address_t *device_address,
+ * @fn int bluetooth_proximity_monitor_get_property(const bluetooth_device_address_t *device_address,
  *                                             bluetooth_pxp_poperty_t property, int *value);
  *
- * @brief Reads the Proximity alert level/properties.
+ * @brief Reads the Proximity alert level/properties for monitor role.
  *
  * This function is a synchronous call.
  *
@@ -6942,21 +6942,21 @@ int bluetooth_set_proximity_property(const bluetooth_device_address_t *device_ad
  *
  * @remark     None
  */
-int bluetooth_get_proximity_property(const bluetooth_device_address_t *device_address,
+int bluetooth_proximity_monitor_get_property(const bluetooth_device_address_t *device_address,
                                                        bluetooth_pxp_poperty_t property, int *value);
 
 /**
- * @fn int bluetooth_get_proximity_supported_services(const bluetooth_device_address_t *device_address,
+ * @fn int bluetooth_proximity_monitor_get_supported_services(const bluetooth_device_address_t *device_address,
  *                                             int *services_supported);
  *
- * @brief Reads the Proximity profile supported properties/services.
+ * @brief Reads the Proximity Monitor profile supported properties/services.
  *
  * This function is a synchronous call.
  *
- * @return   BLUETOOTH_ERROR_NONE - Success \n
- *               BLUETOOTH_ERROR_DEVICE_NOT_ENABLED - Device is not enabled \n
- *               BLUETOOTH_ERROR_NOT_FOUND - Cannot find the proxy\n
- *               BLUETOOTH_ERROR_INVALID_PARAM - Invalid parameter \n
+ * @return      BLUETOOTH_ERROR_NONE - Success \n
+ *                              BLUETOOTH_ERROR_DEVICE_NOT_ENABLED - Device is not enabled \n
+ *                              BLUETOOTH_ERROR_NOT_FOUND - Cannot find the proxy\n
+ *                              BLUETOOTH_ERROR_INVALID_PARAM - Invalid parameter \n
  *
  * @exception  None
  * @param[in] device_address remote device address
@@ -6964,40 +6964,63 @@ int bluetooth_get_proximity_property(const bluetooth_device_address_t *device_ad
  *
  * @remark     None
  */
-int bluetooth_get_proximity_supported_services(const bluetooth_device_address_t *device_address,
+int bluetooth_proximity_monitor_get_supported_services(const bluetooth_device_address_t *device_address,
                                                        int *services_supported);
 
 /**
- * @fn int bluetooth_register__proximity_reporter();
+ * @fn int bluetooth_proximity_reporter_register();
  *
  * @brief Register all proximity related services in BlueZ.
  *
  * This function is a synchronous call.
  *
- * @return   BLUETOOTH_ERROR_NONE - Success \n
- *           BLUETOOTH_ERROR_NOT_FOUND - Cannot find the proxy\n
+ * @return      BLUETOOTH_ERROR_NONE - Success \n
+ *                      BLUETOOTH_ERROR_NOT_FOUND - Cannot find the proxy\n
  *
  * @exception  None
  *
  * @remark     None
  */
-int bluetooth_register_proximity_reporter();
+int bluetooth_proximity_reporter_register(void);
 
 /**
- * @fn int bluetooth_unregister__proximity_reporter();
+ * @fn int bluetooth_proximity_reporter_unregister();
  *
  * @brief Unregister all proximity related services in BlueZ.
  *
  * This function is a synchronous call.
  *
- * @return   BLUETOOTH_ERROR_NONE - Success \n
- *           BLUETOOTH_ERROR_NOT_FOUND - Cannot find the proxy\n
+ * @return      BLUETOOTH_ERROR_NONE - Success \n
+ *                      BLUETOOTH_ERROR_NOT_FOUND - Cannot find the proxy\n
+ *
+ * @exception  None
+ *
+ * @remark     None
+ */
+int bluetooth_proximity_reporter_unregister(void);
+
+/**
+ * @fn int bluetooth_proximity_reporter_get_property(const bluetooth_device_address_t *device_address,
+ *                                             bluetooth_pxp_poperty_t property, int *value);
+ *
+ * @brief Reads the Proximity alert level/properties for reporter role.
+ *
+ * This function is a synchronous call.
+ *
+ * @return      BLUETOOTH_ERROR_NONE - Success \n
+ *                              BLUETOOTH_ERROR_DEVICE_NOT_ENABLED - Device is not enabled \n
+ *                              BLUETOOTH_ERROR_NOT_FOUND - Cannot find the proxy\n
+ *                              BLUETOOTH_ERROR_INVALID_PARAM - Invalid parameter \n
  *
  * @exception  None
+ * @param[in] device_address remote device address
+ * @param[in] property proximity profile property
+ * @param[out] value alert level/property value
  *
  * @remark     None
  */
-int bluetooth_unregister_proximity_reporter();
+int bluetooth_proximity_reporter_get_property(const bluetooth_device_address_t *device_address,
+                                                       bluetooth_pxp_poperty_t property, int *value);
 
 /**
  * @}