gatt_client_write_value_of_characteristic() function

Writes the characteristic value using the characteristic's value handle. The GATT_EVENT_QUERY_COMPLETE event marks the end of write. The write is successfully performed, if the event's att_status field is set to ATT_ERROR_SUCCESS (see bluetooth.h for ATT_ERROR codes).

Syntax

Show:

Summary

Declaration

Definition

from gatt_client.h:701

uint8_t gatt_client_write_value_of_characteristic(btstack_packet_handler_t callback, hci_con_handle_t con_handle, uint16_t value_handle, uint16_t value_length, uint8_t * value);

Implemented in gatt_client.c:2549

Arguments

Argument

Description

callback

con_handle

value_handle

value_length

value

is not copied, make sure memory is accessible until write is done, i.e. GATT_EVENT_QUERY_COMPLETE is received

Return value

status ERROR_CODE_UNKNOWN_CONNECTION_IDENTIFIER if no HCI connection for con_handle is found BTSTACK_MEMORY_ALLOC_FAILED if no GATT client for con_handle could be allocated GATT_CLIENT_IN_WRONG_STATE if GATT client is not ready ERROR_CODE_SUCCESS if query is successfully registered

Examples

References

from examples

gatt_client_write_value_of_characteristic() function

Syntax

Arguments

Return value

Examples

References

Call Tree

Data Use

Class Tree

Override Tree

Implementations

Instances

Lifecycle