Client Commands
www.ti.com
126
SWRU271H–October 2010–Revised April 2019
Submit Documentation Feedback
Copyright © 2010–2019, Texas Instruments Incorporated
GATT/ATT API
bStatus_t GATT_DiscCharsByUUID( uint16 connHandle, attReadByTypeReq_t *pReq, uint8
taskId )
Used by a client to discover service characteristics on a server when the service
handle range and characteristic UUID is known.
Parameters connHandle: connection to use
pReq: pointer to request to be sent, including start and end handles of service and UUID
of characteristic value for which to search.
taskId: task to be notified of response
Corresponding Events If the return status is SUCCESS, the calling application task receives multiple
GATT_MSG_EVENT messages with type ATT_READ_BY_TYPE_RSP or
ATT_ERROR_RSP (if an error occurred on the server). This sub-procedure is complete
when either ATT_READ_BY_TYPE_RSP (with bleProcedureComplete or bleTimeout
status) orthe calling application task recieves the ATT_ERROR_RSP (with SUCCESS
status).
bStatus_t GATT_DiscAllCharDescs ( uint16 connHandle, uint16 startHandle, uint16 endHandle,
uint8 taskId )
Used by a client to find all the characteristic descriptor’s Attribute Handles and
AttributeTypes within a characteristic definition when only the characteristic
handle range is known.
Parameters connHandle: connection to use
startHandle: start handle
endHandle: end handle
taskId: task to be notified of response
Notes If the return status is SUCCESS, the calling application task receives multiple
GATT_MSG_EVENT messages with type ATT_FIND_INFO_RSP or ATT_ERROR_RSP
(if an error occurred on the server). This sub-procedure is complete when either
ATT_FIND_INFO_RSP (with bleProcedureComplete or bleTimeout status) or the calling
application task receives the ATT_ERROR_RSP (with SUCCESS status).
bStatus_t GATT_ReadCharValue ( uint16 connHandle, attReadReq_t *pReq, uint8 taskId )
Used to read a Characteristic Value from a server when the client knows the
Characteristic Value Handle.
Parameters connHandle: connection to use
pReq: pointer to request to be sent
taskId: task to be notified of response
Notes If the return status is SUCCESS, the calling application task receives an OSAL
GATT_MSG_EVENT message with type ATT_READ_RSP or ATT_ERROR_RSP (if an
error occurred on the server). This sub- procedure is complete when either
ATT_READ_RSP (with SUCCESS or bleTimeout status) or the calling application
receives the ATT_ERROR_RSP (with SUCCESS status).