Functions | |
at_ble_status_t | at_ble_characteristic_discover_all (at_ble_handle_t conn_handle, at_ble_handle_t start_handle, at_ble_handle_t end_handle) |
Discover all Characteristics declared in a connected device. More... | |
at_ble_status_t | at_ble_characteristic_discover_by_uuid (at_ble_handle_t conn_handle, at_ble_handle_t start_handle, at_ble_handle_t end_handle, at_ble_uuid_t *uuid) |
Discover all Characteristics of a given UUID declared in a connected device. More... | |
at_ble_status_t | at_ble_characteristic_read (at_ble_handle_t conn_handle, at_ble_handle_t char_handle, uint16_t offset, uint16_t length) |
Read a characteristic given its handle. More... | |
at_ble_status_t | at_ble_characteristic_read_by_uuid (at_ble_handle_t conn_handle, at_ble_handle_t start_handle, at_ble_handle_t end_handle, at_ble_uuid_t *uuid) |
Read a characteristic given its UUID. More... | |
at_ble_status_t | at_ble_characteristic_read_multible (at_ble_handle_t conn_handle, at_ble_handle_t *char_handle_list, uint16_t *char_val_length, uint8_t char_handle_count) |
Read a list of characteristics given their handles. More... | |
at_ble_status_t | at_ble_characteristic_reliable_write_cancel (at_ble_handle_t conn_handle) |
Cancels a pending prepared write operation. More... | |
at_ble_status_t | at_ble_characteristic_reliable_write_execute (at_ble_handle_t conn_handle) |
Executes a pending prepared write operation. More... | |
at_ble_status_t | at_ble_characteristic_reliable_write_prepare (at_ble_handle_t conn_handle, at_ble_handle_t char_handle, uint16_t offset, uint16_t length, uint8_t *data) |
Add a new prepared write request. More... | |
at_ble_status_t | at_ble_characteristic_write (at_ble_handle_t conn_handle, at_ble_handle_t char_handle, uint16_t offset, uint16_t length, uint8_t *data, bool signed_write, bool with_response) |
Write a characteristic. More... | |
at_ble_status_t | at_ble_descriptor_discover_all (at_ble_handle_t conn_handle, at_ble_handle_t start_handle, at_ble_handle_t end_handle) |
Discover all Descriptors declared in a connected device. More... | |
at_ble_status_t | at_ble_exchange_mtu (at_ble_handle_t conn_handle) |
This message is used by the application to initiate the MTU exchange. More... | |
at_ble_status_t | at_ble_included_service_discover_all (at_ble_handle_t conn_handle, at_ble_handle_t start_handle, at_ble_handle_t end_handle) |
Discover all included services declared in a connected device. More... | |
at_ble_status_t | at_ble_primary_service_discover_all (at_ble_handle_t conn_handle, at_ble_handle_t start_handle, at_ble_handle_t end_handle) |
Discover all Primary services declared in a connected device. More... | |
at_ble_status_t | at_ble_primary_service_discover_by_uuid (at_ble_handle_t conn_handle, at_ble_handle_t start_handle, at_ble_handle_t end_handle, at_ble_uuid_t *uuid) |
Discover all Primary services of a given UUID declared in a connected device. More... | |
at_ble_status_t at_ble_characteristic_discover_all | ( | at_ble_handle_t | conn_handle, |
at_ble_handle_t | start_handle, | ||
at_ble_handle_t | end_handle | ||
) |
Discover all Characteristics declared in a connected device.
Search will go from start_handle to end_handle, whenever a characteristic is found AT_BLE_CHARACTERISTIC_FOUND event is sent and AT_BLE_DISCOVERY_COMPLETE is sent at end of discover operation.
[in] | conn_handle | Handle of the connection |
[in] | start_handle | Start of the searched range |
[in] | end_handle | End of the searched range |
References AT_BLE_INVALID_PARAM, GATTC_DISC_ALL_CHAR, gattc_disc_cmd_handler(), and NULL.
Referenced by csc_prf_discovery_complete_handler(), and pxp_monitor_discovery_complete_handler().
at_ble_status_t at_ble_characteristic_discover_by_uuid | ( | at_ble_handle_t | conn_handle, |
at_ble_handle_t | start_handle, | ||
at_ble_handle_t | end_handle, | ||
at_ble_uuid_t * | uuid | ||
) |
Discover all Characteristics of a given UUID declared in a connected device.
Search will go from start_handle to end_handle, whenever a characteristic of matching UUID is found AT_BLE_CHARACTERISTIC_FOUND event is sent and AT_BLE_DISCOVERY_COMPLETE is sent at end of discover operation.
[in] | conn_handle | Handle of the connection |
[in] | start_handle | Start of the searched range |
[in] | end_handle | End of the searched range |
[in] | uuid | UUID of the characteristic to be found, with LSB byte First in UUID value member |
References AT_BLE_INVALID_PARAM, at_ble_uuid_type2len(), GATTC_DISC_BY_UUID_CHAR, gattc_disc_cmd_handler(), at_ble_uuid_t::type, and at_ble_uuid_t::uuid.
at_ble_status_t at_ble_characteristic_read | ( | at_ble_handle_t | conn_handle, |
at_ble_handle_t | char_handle, | ||
uint16_t | offset, | ||
uint16_t | length | ||
) |
Read a characteristic given its handle.
Read value will be reported via AT_BLE_CHARACTERISTIC_READ_RESPONSE event.
[in] | conn_handle | Handle of the connection |
[in] | char_handle | Handle of the characteristic |
[in] | offset | Offset at where to start reading |
[in] | length | Maximum length of data to read |
References gattc_read_cmd_handler_simple_read().
Referenced by lls_alert_level_read(), and txps_power_read().
at_ble_status_t at_ble_characteristic_read_by_uuid | ( | at_ble_handle_t | conn_handle, |
at_ble_handle_t | start_handle, | ||
at_ble_handle_t | end_handle, | ||
at_ble_uuid_t * | uuid | ||
) |
Read a characteristic given its UUID.
Search will go from start_handle to end_handle, whenever a descriptor with given UUID is found its value will be read and reported via AT_BLE_CHARACTERISTIC_READ_RESPONSE event.
[in] | conn_handle | Handle of the connection |
[in] | start_handle | Start of the searched range |
[in] | end_handle | End of the searched range |
[in] | uuid | UUID of the read characteristic, with LSB byte First in UUID value member |
References AT_BLE_INVALID_PARAM, at_ble_uuid_type2len(), gattc_read_cmd_handler_by_uuid(), at_ble_uuid_t::type, and at_ble_uuid_t::uuid.
at_ble_status_t at_ble_characteristic_read_multible | ( | at_ble_handle_t | conn_handle, |
at_ble_handle_t * | char_handle_list, | ||
uint16_t * | char_val_length, | ||
uint8_t | char_handle_count | ||
) |
Read a list of characteristics given their handles.
Read values will be reported via AT_BLE_CHARACTERISTIC_READ_MULTIBLE_RESPONSE event.
[in] | conn_handle | Handle of the connection |
[in] | char_handle_list | List of characteristic handles |
[in] | char_val_length | Length of characteristic handle |
[in] | char_handle_count | Number of characteristic handles |
References gattc_read_cmd_handler_multible().
at_ble_status_t at_ble_characteristic_reliable_write_cancel | ( | at_ble_handle_t | conn_handle | ) |
Cancels a pending prepared write operation.
Cancels a pending prepared write operation.
[in] | conn_handle | Handle of the connection |
References gattc_execute_write_cmd_handler().
at_ble_status_t at_ble_characteristic_reliable_write_execute | ( | at_ble_handle_t | conn_handle | ) |
Executes a pending prepared write operation.
Executes a pending prepared write operation. Write completion will be reported via AT_BLE_CHARACTERISTIC_WRITE_RESPONSE event.
[in] | conn_handle | Handle of the connection |
References gattc_execute_write_cmd_handler().
at_ble_status_t at_ble_characteristic_reliable_write_prepare | ( | at_ble_handle_t | conn_handle, |
at_ble_handle_t | char_handle, | ||
uint16_t | offset, | ||
uint16_t | length, | ||
uint8_t * | data | ||
) |
Add a new prepared write request.
Adds a new request to a pending prepared write operation, or starts a new prepared write operation if none was started before.
[in] | conn_handle | Handle of the connection |
[in] | char_handle | Handle of the characteristic |
[in] | offset | Offset at where to start write |
[in] | length | Length of data to write |
[in] | data | A buffer where write data is stored |
References GATTC_WRITE, and gattc_write_cmd_handler().
at_ble_status_t at_ble_characteristic_write | ( | at_ble_handle_t | conn_handle, |
at_ble_handle_t | char_handle, | ||
uint16_t | offset, | ||
uint16_t | length, | ||
uint8_t * | data, | ||
bool | signed_write, | ||
bool | with_response | ||
) |
Write a characteristic.
If with_response is True, write completion will be reported via AT_BLE_CHARACTERISTIC_WRITE_RESPONSE event.
[in] | conn_handle | Handle of the connection |
[in] | char_handle | Handle of the characteristic |
[in] | offset | Offset at where to start write |
[in] | length | Length of data to write |
[in] | data | A buffer where write data is stored |
[in] | signed_write | If true, perform a signed write |
[in] | with_response | If true, perform a write with response procedure, otherwise perform write with no response procedure |
References GATTC_WRITE, gattc_write_cmd_handler(), GATTC_WRITE_NO_RESPONSE, and GATTC_WRITE_SIGNED.
Referenced by csc_prf_write_notification_handler(), ias_alert_level_write(), and lls_alert_level_write().
at_ble_status_t at_ble_descriptor_discover_all | ( | at_ble_handle_t | conn_handle, |
at_ble_handle_t | start_handle, | ||
at_ble_handle_t | end_handle | ||
) |
Discover all Descriptors declared in a connected device.
Search will go from start_handle to end_handle, whenever a descriptor is found AT_BLE_DESCRIPTOR_FOUND event is sent and AT_BLE_DISCOVERY_COMPLETE is sent at end of discover operation.
[in] | conn_handle | Handle of the connection |
[in] | start_handle | Start of the searched range |
[in] | end_handle | End of the searched range |
References AT_BLE_INVALID_PARAM, gattc_disc_cmd_handler(), GATTC_DISC_DESC_CHAR, and NULL.
Referenced by csc_prf_discovery_complete_handler().
at_ble_status_t at_ble_exchange_mtu | ( | at_ble_handle_t | conn_handle | ) |
This message is used by the application to initiate the MTU exchange.
[in] | conn_handle | Handle of the connection |
References gattc_mtu_cmd_handler().
at_ble_status_t at_ble_included_service_discover_all | ( | at_ble_handle_t | conn_handle, |
at_ble_handle_t | start_handle, | ||
at_ble_handle_t | end_handle | ||
) |
Discover all included services declared in a connected device.
Search will go from start_handle to end_handle, whenever a service is found AT_BLE_INCLUDED_SERVICE_FOUND event is sent and AT_BLE_DISCOVERY_COMPLETE is sent at end of discover operation.
[in] | conn_handle | Handle of the connection |
[in] | start_handle | Start of the searched range |
[in] | end_handle | End of the searched range |
References AT_BLE_INVALID_PARAM, gattc_disc_cmd_handler(), GATTC_DISC_INCLUDED_SVC, and NULL.
at_ble_status_t at_ble_primary_service_discover_all | ( | at_ble_handle_t | conn_handle, |
at_ble_handle_t | start_handle, | ||
at_ble_handle_t | end_handle | ||
) |
Discover all Primary services declared in a connected device.
Search will go from start_handle to end_handle, whenever a service is found AT_BLE_PRIMARY_SERVICE_FOUND event is sent and AT_BLE_DISCOVERY_COMPLETE is sent at end of discover operation.
[in] | conn_handle | Handle of the connection |
[in] | start_handle | Start of the searched range |
[in] | end_handle | End of the searched range |
References AT_BLE_INVALID_PARAM, GATTC_DISC_ALL_SVC, gattc_disc_cmd_handler(), and NULL.
Referenced by pxp_monitor_service_discover().
at_ble_status_t at_ble_primary_service_discover_by_uuid | ( | at_ble_handle_t | conn_handle, |
at_ble_handle_t | start_handle, | ||
at_ble_handle_t | end_handle, | ||
at_ble_uuid_t * | uuid | ||
) |
Discover all Primary services of a given UUID declared in a connected device.
Search will go from start_handle to end_handle, whenever a service of matching UUID is found AT_BLE_PRIMARY_SERVICE_FOUND event is sent and AT_BLE_DISCOVERY_COMPLETE is sent at end of discover operation.
[in] | conn_handle | Handle of the connection |
[in] | start_handle | Start of the searched range |
[in] | end_handle | End of the searched range |
[in] | uuid | UUID of the service to be found, with LSB byte First in UUID value member |
References AT_BLE_INVALID_PARAM, at_ble_uuid_type2len(), GATTC_DISC_BY_UUID_SVC, gattc_disc_cmd_handler(), at_ble_uuid_t::type, and at_ble_uuid_t::uuid.
Referenced by csc_prf_connected_state_handler().