Enable indications for a given Generic Attribute (GATT) characteristic.
Synopsis:
#include <btapi/btgatt.h>
int bt_gatt_enable_indicate(int instance, const bt_gatt_characteristic_t *characteristic, uint8_t enable)
Arguments:
- instance
-
The identifier used to reference the connected primary service.
- characteristic
-
The GATT characteristic.
- enable
-
Enable or disable indications for the specified characteristic. Use a value of 1 to enable indications or a value of 0 to disable them.
Library:
libbtapi (For the qcc command, use the -l btapi option to link against this library)
Description:
You can also use this function to disable indications for the specified characteristic.
Returns:
EOK when indications have been successfully enabled or disabled,
-1 with the
errno set otherwise. The error codes that can be returned are as follows:
- EBUSY: The stack was busy performing another operation. You can try again later.
- EDEADLK: A potential deadlock has been avoided.
- EINVAL: The arguments passed are invalid or the connection to the remote Bluetooth-enabled device is unavailable.
- ENODEV: Unable to find the service connection defined by the instance argument.
- ENOMEM: Insufficient memory to perform the request.
- ENOSYS: The operation failed at the stack level.
- EPROTO: The operation failed because the response from remote Bluetooth-enabled device had a protocol error.
- ESRCH: The service connection was not available.
- ESRVRFAULT: An internal error has occurred.