GATTC Application event decoders

nRF5 SDK v10.0.0

nRF51 SDK v10.0.0

GATTC Application event decoders. More...

Functions

uint32_t ble_gattc_evt_char_disc_rsp_dec (uint8_t const *const p_buf, uint32_t packet_len, ble_evt_t *const p_event, uint32_t *const p_event_len)
Decodes ble_gattc_evt_char_disc_rsp event. More...
uint32_t ble_gattc_evt_char_val_by_uuid_read_rsp_dec (uint8_t const *const p_buf, uint32_t packet_len, ble_evt_t *const p_event, uint32_t *const p_event_len)
Decodes ble_gattc_evt_char_val_by_uuid_read_rsp event. More...
uint32_t ble_gattc_evt_char_vals_read_rsp_dec (uint8_t const *const p_buf, uint32_t packet_len, ble_evt_t *const p_event, uint32_t *const p_event_len)
Decodes ble_gattc_evt_char_vals_read_rsp event. More...
uint32_t ble_gattc_evt_desc_disc_rsp_dec (uint8_t const *const p_buf, uint32_t packet_len, ble_evt_t *const p_event, uint32_t *const p_event_len)
Decodes ble_gattc_evt_desc_disc_rsp event. More...
uint32_t ble_gattc_evt_hvx_dec (uint8_t const *const p_buf, uint32_t packet_len, ble_evt_t *const p_event, uint32_t *const p_event_len)
Decodes ble_gattc_evt_hvx event. More...
uint32_t ble_gattc_evt_prim_srvc_disc_rsp_dec (uint8_t const *const p_buf, uint32_t packet_len, ble_evt_t *const p_event, uint32_t *const p_event_len)
Decodes ble_gattc_evt_prim_srvc_disc_rsp event. More...
uint32_t ble_gattc_evt_read_rsp_dec (uint8_t const *const p_buf, uint32_t packet_len, ble_evt_t *const p_event, uint32_t *const p_event_len)
Decodes ble_gattc_evt_read_rsp event. More...
uint32_t ble_gattc_evt_rel_disc_rsp_dec (uint8_t const *const p_buf, uint32_t packet_len, ble_evt_t *const p_event, uint32_t *const p_event_len)
Decodes ble_gattc_evt_rel_disc_rsp_dec event. More...
uint32_t ble_gattc_evt_timeout_dec (uint8_t const *const p_buf, uint32_t packet_len, ble_evt_t *const p_event, uint32_t *const p_event_len)
Decodes ble_gattc_evt_timeout event. More...
uint32_t ble_gattc_evt_write_rsp_dec (uint8_t const *const p_buf, uint32_t packet_len, ble_evt_t *const p_event, uint32_t *const p_event_len)
Decodes ble_gattc_evt_write_rsp event. More...

Detailed Description

GATTC Application event decoders.

Function Documentation

uint32_t ble_gattc_evt_char_disc_rsp_dec ( uint8_t const *const p_buf ,
uint32_t packet_len ,
ble_evt_t *const p_event ,
uint32_t *const p_event_len
)

Decodes ble_gattc_evt_char_disc_rsp event.

See Also
0x32 - BLE_GATTC_EVT_CHAR_DISC_RSP for packet format.

If p_event is null, the required length of p_event is returned in p_event_len .

Parameters
[in] p_buf Pointer to the beginning of an event packet.
[in] packet_len Length (in bytes) of the event packet.
[in,out] p_event Pointer to a ble_evt_t buffer where the decoded event will be stored. If NULL, required length will be returned in p_event_len .
[in,out] p_event_len in: Size (in bytes) of p_event buffer. out: Length of decoded contents of p_event .
Return values
NRF_SUCCESS Decoding success.
NRF_ERROR_NULL Decoding failure. NULL pointer supplied.
NRF_ERROR_INVALID_LENGTH Decoding failure. Incorrect buffer length.
NRF_ERROR_DATA_SIZE Decoding failure. Length of p_event is too small to hold decoded event.
uint32_t ble_gattc_evt_char_val_by_uuid_read_rsp_dec ( uint8_t const *const p_buf ,
uint32_t packet_len ,
ble_evt_t *const p_event ,
uint32_t *const p_event_len
)

Decodes ble_gattc_evt_char_val_by_uuid_read_rsp event.

See Also
0x34 - BLE_GATTC_EVT_CHAR_VAL_BY_UUID_READ_RSP for packet format.

If p_event is null, the required length of p_event is returned in p_event_len .

Parameters
[in] p_buf Pointer to the beginning of an event packet.
[in] packet_len Length (in bytes) of the event packet.
[in,out] p_event Pointer to a ble_evt_t buffer where the decoded event will be stored. If NULL, required length will be returned in p_event_len .
[in,out] p_event_len in: Size (in bytes) of p_event buffer. out: Length of decoded contents of p_event .
Return values
NRF_SUCCESS Decoding success.
NRF_ERROR_NULL Decoding failure. NULL pointer supplied.
NRF_ERROR_INVALID_LENGTH Decoding failure. Incorrect buffer length.
NRF_ERROR_DATA_SIZE Decoding failure. Length of p_event is too small to hold decoded event.
uint32_t ble_gattc_evt_char_vals_read_rsp_dec ( uint8_t const *const p_buf ,
uint32_t packet_len ,
ble_evt_t *const p_event ,
uint32_t *const p_event_len
)

Decodes ble_gattc_evt_char_vals_read_rsp event.

See Also
0x36 - BLE_GATTC_EVT_CHAR_VALS_READ_RSP for packet format.

If p_event is null, the required length of p_event is returned in p_event_len .

Parameters
[in] p_buf Pointer to the beginning of an event packet.
[in] packet_len Length (in bytes) of the event packet.
[in,out] p_event Pointer to a ble_evt_t buffer where the decoded event will be stored. If NULL, required length will be returned in p_event_len .
[in,out] p_event_len in: Size (in bytes) of p_event buffer. out: Length of decoded contents of p_event .
Return values
NRF_SUCCESS Decoding success.
NRF_ERROR_NULL Decoding failure. NULL pointer supplied.
NRF_ERROR_INVALID_LENGTH Decoding failure. Incorrect buffer length.
NRF_ERROR_DATA_SIZE Decoding failure. Length of p_event is too small to hold decoded event.
uint32_t ble_gattc_evt_desc_disc_rsp_dec ( uint8_t const *const p_buf ,
uint32_t packet_len ,
ble_evt_t *const p_event ,
uint32_t *const p_event_len
)

Decodes ble_gattc_evt_desc_disc_rsp event.

See Also
0x33 - BLE_GATTC_EVT_DESC_DISC_RSP for packet format.

If p_event is null, the required length of p_event is returned in p_event_len .

Parameters
[in] p_buf Pointer to the beginning of an event packet.
[in] packet_len Length (in bytes) of the event packet.
[in,out] p_event Pointer to a ble_evt_t buffer where the decoded event will be stored. If NULL, required length will be returned in p_event_len .
[in,out] p_event_len in: Size (in bytes) of p_event buffer. out: Length of decoded contents of p_event .
Return values
NRF_SUCCESS Decoding success.
NRF_ERROR_NULL Decoding failure. NULL pointer supplied.
NRF_ERROR_INVALID_LENGTH Decoding failure. Incorrect buffer length.
NRF_ERROR_DATA_SIZE Decoding failure. Length of p_event is too small to hold decoded event.
uint32_t ble_gattc_evt_hvx_dec ( uint8_t const *const p_buf ,
uint32_t packet_len ,
ble_evt_t *const p_event ,
uint32_t *const p_event_len
)

Decodes ble_gattc_evt_hvx event.

See Also
0x38 - BLE_GATTC_EVT_HVX for packet format.

If p_event is null, the required length of p_event is returned in p_event_len .

Parameters
[in] p_buf Pointer to the beginning of an event packet.
[in] packet_len Length (in bytes) of the event packet.
[in,out] p_event Pointer to a ble_evt_t buffer where the decoded event will be stored. If NULL, required length will be returned in p_event_len .
[in,out] p_event_len in: Size (in bytes) of p_event buffer. out: Length of decoded contents of p_event .
Return values
NRF_SUCCESS Decoding success.
NRF_ERROR_NULL Decoding failure. NULL pointer supplied.
NRF_ERROR_INVALID_LENGTH Decoding failure. Incorrect buffer length.
NRF_ERROR_DATA_SIZE Decoding failure. Length of p_event is too small to hold decoded event.
uint32_t ble_gattc_evt_prim_srvc_disc_rsp_dec ( uint8_t const *const p_buf ,
uint32_t packet_len ,
ble_evt_t *const p_event ,
uint32_t *const p_event_len
)

Decodes ble_gattc_evt_prim_srvc_disc_rsp event.

See Also
0x30 - BLE_GATTC_EVT_PRIM_SRVC_DISC_RSP for packet format.

If p_event is null, the required length of p_event is returned in p_event_len .

Parameters
[in] p_buf Pointer to the beginning of an event packet.
[in] packet_len Length (in bytes) of the event packet.
[in,out] p_event Pointer to a ble_evt_t buffer where the decoded event will be stored. If NULL, required length will be returned in p_event_len .
[in,out] p_event_len in: Size (in bytes) of p_event buffer. out: Length of decoded contents of p_event .
Return values
NRF_SUCCESS Decoding success.
NRF_ERROR_NULL Decoding failure. NULL pointer supplied.
NRF_ERROR_INVALID_LENGTH Decoding failure. Incorrect buffer length.
NRF_ERROR_DATA_SIZE Decoding failure. Length of p_event is too small to hold decoded event.
uint32_t ble_gattc_evt_read_rsp_dec ( uint8_t const *const p_buf ,
uint32_t packet_len ,
ble_evt_t *const p_event ,
uint32_t *const p_event_len
)

Decodes ble_gattc_evt_read_rsp event.

See Also
0x35 - BLE_GATTC_EVT_READ_RSP for packet format.

If p_event is null, the required length of p_event is returned in p_event_len .

Parameters
[in] p_buf Pointer to the beginning of an event packet.
[in] packet_len Length (in bytes) of the event packet.
[in,out] p_event Pointer to a ble_evt_t buffer where the decoded event will be stored. If NULL, required length will be returned in p_event_len .
[in,out] p_event_len in: Size (in bytes) of p_event buffer. out: Length of decoded contents of p_event .
Return values
NRF_SUCCESS Decoding success.
NRF_ERROR_NULL Decoding failure. NULL pointer supplied.
NRF_ERROR_INVALID_LENGTH Decoding failure. Incorrect buffer length.
NRF_ERROR_DATA_SIZE Decoding failure. Length of p_event is too small to hold decoded event.
uint32_t ble_gattc_evt_rel_disc_rsp_dec ( uint8_t const *const p_buf ,
uint32_t packet_len ,
ble_evt_t *const p_event ,
uint32_t *const p_event_len
)

Decodes ble_gattc_evt_rel_disc_rsp_dec event.

See Also
0x31 - BLE_GATTC_EVT_REL_DISC_RSP for packet format.

If p_event is null, the required length of p_event is returned in p_event_len .

Parameters
[in] p_buf Pointer to the beginning of an event packet.
[in] packet_len Length (in bytes) of the event packet.
[in,out] p_event Pointer to a ble_evt_t buffer where the decoded event will be stored. If NULL, required length will be returned in p_event_len .
[in,out] p_event_len in: Size (in bytes) of p_event buffer. out: Length of decoded contents of p_event .
Return values
NRF_SUCCESS Decoding success.
NRF_ERROR_NULL Decoding failure. NULL pointer supplied.
NRF_ERROR_INVALID_LENGTH Decoding failure. Incorrect buffer length.
NRF_ERROR_DATA_SIZE Decoding failure. Length of p_event is too small to hold decoded event.
uint32_t ble_gattc_evt_timeout_dec ( uint8_t const *const p_buf ,
uint32_t packet_len ,
ble_evt_t *const p_event ,
uint32_t *const p_event_len
)

Decodes ble_gattc_evt_timeout event.

See Also
0x39 - BLE_GATTC_EVT_TIMEOUT for packet format.

If p_event is null, the required length of p_event is returned in p_event_len .

Parameters
[in] p_buf Pointer to the beginning of an event packet.
[in] packet_len Length (in bytes) of the event packet.
[in,out] p_event Pointer to a ble_evt_t buffer where the decoded event will be stored. If NULL, required length will be returned in p_event_len .
[in,out] p_event_len in: Size (in bytes) of p_event buffer. out: Length of decoded contents of p_event .
Return values
NRF_SUCCESS Decoding success.
NRF_ERROR_NULL Decoding failure. NULL pointer supplied.
NRF_ERROR_INVALID_LENGTH Decoding failure. Incorrect buffer length.
NRF_ERROR_DATA_SIZE Decoding failure. Length of p_event is too small to hold decoded event.
uint32_t ble_gattc_evt_write_rsp_dec ( uint8_t const *const p_buf ,
uint32_t packet_len ,
ble_evt_t *const p_event ,
uint32_t *const p_event_len
)

Decodes ble_gattc_evt_write_rsp event.

See Also
0x37 - BLE_GATTC_EVT_WRITE_RSP for packet format.

If p_event is null, the required length of p_event is returned in p_event_len .

Parameters
[in] p_buf Pointer to the beginning of an event packet.
[in] packet_len Length (in bytes) of the event packet.
[in,out] p_event Pointer to a ble_evt_t buffer where the decoded event will be stored. If NULL, required length will be returned in p_event_len .
[in,out] p_event_len in: Size (in bytes) of p_event buffer. out: Length of decoded contents of p_event .
Return values
NRF_SUCCESS Decoding success.
NRF_ERROR_NULL Decoding failure. NULL pointer supplied.
NRF_ERROR_INVALID_LENGTH Decoding failure. Incorrect buffer length.
NRF_ERROR_DATA_SIZE Decoding failure. Length of p_event is too small to hold decoded event.

Please send us your feedback about the documentation! For technical questions, visit the Nordic Developer Zone .