www.ti.com
Client Commands
125
SWRU271H–October 2010–Revised April 2019
Submit Documentation Feedback
Copyright © 2010–2019, Texas Instruments Incorporated
GATT/ATT API
bStatus_t GATT_FindIncludedServices( uint16 connHandle, uint16 startHandle, uint16
endHandle, uint8 taskId )
Used by a client to find included services with a primary service definition on a
server.
Parameters connHandle: connection to use
startHandle: start handle of primary service to search
endHandle: end handle of primary service 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 subprocedure is complete
when either ATT_READ_BY_TYPE_RSP (with bleProcedureComplete or bleTimeout
status) or ATT_ERROR_RSP (with SUCCESS status) is received by the calling
application task. If the return status is SUCCESS, the calling application task receives
multiple GATT_MSG_EVENT messages with type ATT_FIND_BY_TYPE_VALUE_RSP
or ATT_ERROR_RSP (if an error occurred on the server). This sub-procedure is
complete when either ATT_FIND_BY_TYPE_VALUE_RSP (with bleProcedureComplete
or bleTimeout status) or the calling application task recieves the ATT_ERROR_RSP
(with SUCCESS status).
bStatus_t GAPRole_GetParameter(uint16 param, void *pValue)
Get a GAP Role parameter.
Parameters param – Profile parameter ID (See Section F.3)
pValue – pointer to a location to get the value. This pointer depends on the param ID
and is cast to the appropriate data type.
Returns SUCCESS
INVALIDPARAMETER: param was not valid
bStatus_t GATT_DiscAllChars( uint16 connHandle, uint16 startHandle, uint16 endHandle, uint8
taskId )
Used by a client to find all the characteristic declarations within a service when
the handle range of the service is known.
Parameters connHandle: connection to use
startHandle: start handle of service to search
endHandle: end handle of service 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) or the calling application task receives the ATT_ERROR_RSP (with SUCCESS
status).