Symbols ![]()
loading...
Files ![]()
loading...
esp_ble_gattc_prepare_write() function
Prepare to write a characteristic value which is longer than the MTU size to a specified characteristic handle
Syntax
esp_err_t esp_ble_gattc_prepare_write(esp_gatt_if_t gattc_if,
uint16_t conn_id,
uint16_t handle,
uint16_t offset,
uint16_t value_len,
uint8_t *value,
esp_gatt_auth_req_t auth_req);
Implemented in ![]()
esp_gattc_api.c:707
Return value
- ESP_OK: Success - ESP_ERR_INVALID_STATE: The connection has not been established. - ESP_GATT_INVALID_HANDLE：Invalid `handle` - ESP_FAIL: Failure due to other reasons
Notes
1. This function should be called only after the connection has been established. 2. After using this API, use `esp_ble_gattc_execute_write` to write. 3. This function triggers `ESP_GATTC_PREP_WRITE_EVT`. 4. If `value_len` is less than or equal to MTU size, it is recommended to `esp_ble_gattc_write_char` to write directly. 5. `handle` must be greater than 0.