www.ti.com
Client Commands
129
SWRU271H–October 2010–Revised April 2019
Submit Documentation Feedback
Copyright © 2010–2019, Texas Instruments Incorporated
GATT/ATT API
bStatus_t GATT_ReliableWrites ( uint16 connHandle, attPrepareWriteReq_t *pReq, uint8
numReqs, uint8 flags, uint8 taskId )
Used to write a Characteristic Value to a server when the client knows the
Characteristic Value Handle, and assurance is required that the correct
Characteristic Value is going to be written by transferring the Characteristic Value
to be written in both directions before the write is performed.
Parameters connHandle: connection to use
pReq: pointer to requests to be sent (must be allocated)
numReqs - number of requests in pReq
flags - execute write request flags
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_PREPARE_WRITE_RSP,
ATT_EXECUTE_WRITE_RSP or ATT_ERROR_RSP (if an error occurred on the
server). This sub-procedure is complete when either ATT_PREPARE_WRITE_RSP (with
bleTimeout status), ATT_EXECUTE_WRITE_RSP (with SUCCESS or bleTimeout
status), or the calling application task receives the ATT_ERROR_RSP (with SUCCESS
status) .
bStatus_t GATT_ReadCharDesc ( uint16 connHandle, attReadReq_t *pReq, uint8 taskId )
Used to read a characteristic descriptor from a server when the client knows the
attribute handle of the characteristic descriptor declaration’.
Parameters connHandle: connection to use
pReq: pointer to request to be sent
taskId: task to be notified of response
Notes If the return status from this function 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 task receives the ATT_ERROR_RSP (with SUCCESS status).
bStatus_t GATT_ReadLongCharDesc ( uint16 connHandle, attReadBlobReq_t *pReq, uint8
taskId )
Used to read a characteristic descriptor from a server when the client knows the
characteristic descriptor declaration’s Attribute handle and the length of the
characteristic descriptor declaration is longer than can send in a single Read
Response attribute protocol message
Parameters connHandle: connection to use
pReq: pointer to request to be sent
taskId: task to be notified of response
Notes If the return status from this function 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 task receives the ATT_ERROR_RSP (with SUCCESS status).