TI BLE-Stack for Bluetooth 4.2 API Documentation  3.01.00.07
Functions
ATT API Functions

Functions

bStatus_t ATT_ErrorRsp (uint16 connHandle, attErrorRsp_t *pRsp)
 Send Error Response. More...
 
bStatus_t ATT_ExchangeMTUReq (uint16 connHandle, attExchangeMTUReq_t *pReq)
 Send Exchange MTU Request. More...
 
bStatus_t ATT_ExchangeMTURsp (uint16 connHandle, attExchangeMTURsp_t *pRsp)
 Send Exchange MTU Response. More...
 
bStatus_t ATT_ExecuteWriteReq (uint16 connHandle, attExecuteWriteReq_t *pReq)
 Send Execute Write Request. More...
 
bStatus_t ATT_ExecuteWriteRsp (uint16 connHandle)
 Send Execute Write Response. More...
 
bStatus_t ATT_FindByTypeValueReq (uint16 connHandle, attFindByTypeValueReq_t *pReq)
 Send Find By Type Value Request. More...
 
bStatus_t ATT_FindByTypeValueRsp (uint16 connHandle, attFindByTypeValueRsp_t *pRsp)
 Send Find By Type Value Response. More...
 
bStatus_t ATT_FindInfoReq (uint16 connHandle, attFindInfoReq_t *pReq)
 Send Find Information Request. More...
 
bStatus_t ATT_FindInfoRsp (uint16 connHandle, attFindInfoRsp_t *pRsp)
 Send Find Information Response. More...
 
uint16 ATT_GetMTU (uint16 connHandle)
 This function is used to get the MTU size of a connection. More...
 
uint16 ATT_GetParamValue (void)
 Get a ATT Parameter value. More...
 
bStatus_t ATT_HandleValueCfm (uint16 connHandle)
 Send Handle Value Confirmation. More...
 
bStatus_t ATT_HandleValueInd (uint16 connHandle, attHandleValueInd_t *pInd)
 Send Handle Value Indication. More...
 
bStatus_t ATT_HandleValueNoti (uint16 connHandle, attHandleValueNoti_t *pNoti)
 Send Handle Value Notification. More...
 
bStatus_t ATT_PrepareWriteReq (uint16 connHandle, attPrepareWriteReq_t *pReq)
 Send Prepare Write Request. More...
 
bStatus_t ATT_PrepareWriteRsp (uint16 connHandle, attPrepareWriteRsp_t *pRsp)
 Send Prepare Write Response. More...
 
bStatus_t ATT_ReadBlobReq (uint16 connHandle, attReadBlobReq_t *pReq)
 Send Read Blob Request. More...
 
bStatus_t ATT_ReadBlobRsp (uint16 connHandle, attReadBlobRsp_t *pRsp)
 Send Read Blob Response. More...
 
bStatus_t ATT_ReadByGrpTypeReq (uint16 connHandle, attReadByGrpTypeReq_t *pReq)
 Send Read By Group Type Request. More...
 
bStatus_t ATT_ReadByGrpTypeRsp (uint16 connHandle, attReadByGrpTypeRsp_t *pRsp)
 Send Read By Group Type Respond. More...
 
bStatus_t ATT_ReadByTypeReq (uint16 connHandle, attReadByTypeReq_t *pReq)
 Send Read By Type Request. More...
 
bStatus_t ATT_ReadByTypeRsp (uint16 connHandle, attReadByTypeRsp_t *pRsp)
 Send Read By Type Respond. More...
 
bStatus_t ATT_ReadMultiReq (uint16 connHandle, attReadMultiReq_t *pReq)
 Send Read Multiple Request. More...
 
bStatus_t ATT_ReadMultiRsp (uint16 connHandle, attReadMultiRsp_t *pRsp)
 Send Read Multiple Response. More...
 
bStatus_t ATT_ReadReq (uint16 connHandle, attReadReq_t *pReq)
 Send Read Request. More...
 
bStatus_t ATT_ReadRsp (uint16 connHandle, attReadRsp_t *pRsp)
 Send Read Response. More...
 
void ATT_RegisterClient (attNotifyTxCB_t pfnNotifyTx)
 Register the client's notify Tx function with the ATT layer. More...
 
void ATT_RegisterServer (attNotifyTxCB_t pfnNotifyTx)
 Register the server's notify Tx function with the ATT layer. More...
 
void ATT_SetParamValue (uint16 value)
 Set a ATT Parameter value. Use this function to change the default ATT parameter values. More...
 
uint8 ATT_UpdateMTU (uint16 connHandle, uint16 MTU)
 This function is used to update the MTU size of a connection. More...
 
bStatus_t ATT_WriteReq (uint16 connHandle, attWriteReq_t *pReq)
 Send Write Request. More...
 
bStatus_t ATT_WriteRsp (uint16 connHandle)
 Send Write Response. More...
 

Detailed Description

Function Documentation

§ ATT_ErrorRsp()

bStatus_t ATT_ErrorRsp ( uint16  connHandle,
attErrorRsp_t pRsp 
)

Send Error Response.

Parameters
connHandle- connection to use
pRsp- pointer to error response to be sent
Returns
SUCCESS : Response was sent successfully.
INVALIDPARAMETER : Invalid response field.
MSG_BUFFER_NOT_AVAIL
bleNotConnected
bleMemAllocError

§ ATT_ExchangeMTUReq()

bStatus_t ATT_ExchangeMTUReq ( uint16  connHandle,
attExchangeMTUReq_t pReq 
)

Send Exchange MTU Request.

Parameters
connHandle- connection to use
pReq- pointer to request to be sent
Returns
SUCCESS : Request was sent successfully.
INVALIDPARAMETER : Invalid request field.
MSG_BUFFER_NOT_AVAIL
bleNotConnected
bleMemAllocError

§ ATT_ExchangeMTURsp()

bStatus_t ATT_ExchangeMTURsp ( uint16  connHandle,
attExchangeMTURsp_t pRsp 
)

Send Exchange MTU Response.

Parameters
connHandle- connection to use
pRsp- pointer to request to be sent
Returns
SUCCESS : Response was sent successfully.
INVALIDPARAMETER : Invalid response field.
MSG_BUFFER_NOT_AVAIL
bleNotConnected
bleMemAllocError

§ ATT_ExecuteWriteReq()

bStatus_t ATT_ExecuteWriteReq ( uint16  connHandle,
attExecuteWriteReq_t pReq 
)

Send Execute Write Request.

Parameters
connHandle- connection to use
pReq- pointer to request to be sent
Returns
SUCCESS : Request was sent successfully.
INVALIDPARAMETER : Invalid request field.
MSG_BUFFER_NOT_AVAIL
bleNotConnected
bleMemAllocError

§ ATT_ExecuteWriteRsp()

bStatus_t ATT_ExecuteWriteRsp ( uint16  connHandle)

Send Execute Write Response.

Parameters
connHandle- connection to use
Returns
SUCCESS : Response was sent successfully.
INVALIDPARAMETER : Invalid response field.
MSG_BUFFER_NOT_AVAIL
bleNotConnected
bleMemAllocError

§ ATT_FindByTypeValueReq()

bStatus_t ATT_FindByTypeValueReq ( uint16  connHandle,
attFindByTypeValueReq_t pReq 
)

Send Find By Type Value Request.

Parameters
connHandle- connection to use
pReq- pointer to request to be sent
Returns
SUCCESS : Request was sent successfully. INVALIDPARAMETER : Invalid request field. MSG_BUFFER_NOT_AVAIL bleNotConnected bleMemAllocError

§ ATT_FindByTypeValueRsp()

bStatus_t ATT_FindByTypeValueRsp ( uint16  connHandle,
attFindByTypeValueRsp_t pRsp 
)

Send Find By Type Value Response.

Parameters
connHandle- connection to use
pRsp- pointer to response to be sent
Returns
SUCCESS : Response was sent successfully.
INVALIDPARAMETER : Invalid response field.
MSG_BUFFER_NOT_AVAIL
bleNotConnected
bleMemAllocError

§ ATT_FindInfoReq()

bStatus_t ATT_FindInfoReq ( uint16  connHandle,
attFindInfoReq_t pReq 
)

Send Find Information Request.

Parameters
connHandle- connection to use
pReq- pointer to request to be sent
Returns
SUCCESS : Request was sent successfully.
INVALIDPARAMETER : Invalid request field.
MSG_BUFFER_NOT_AVAIL
bleNotConnected
bleMemAllocError

§ ATT_FindInfoRsp()

bStatus_t ATT_FindInfoRsp ( uint16  connHandle,
attFindInfoRsp_t pRsp 
)

Send Find Information Response.

Parameters
connHandle- connection to use
pRsp- pointer to response to be sent
Returns
SUCCESS : Response was sent successfully.
INVALIDPARAMETER : Invalid response field.
MSG_BUFFER_NOT_AVAIL
bleNotConnected
bleMemAllocError

§ ATT_GetMTU()

uint16 ATT_GetMTU ( uint16  connHandle)

This function is used to get the MTU size of a connection.

Parameters
connHandle- connection handle.
Returns
connection MTU size.

§ ATT_GetParamValue()

uint16 ATT_GetParamValue ( void  )

Get a ATT Parameter value.

Returns
ATT Parameter value

§ ATT_HandleValueCfm()

bStatus_t ATT_HandleValueCfm ( uint16  connHandle)

Send Handle Value Confirmation.

Parameters
connHandle- connection to use
Returns
SUCCESS : Confirmation was sent successfully.
INVALIDPARAMETER : Invalid confirmation field.
MSG_BUFFER_NOT_AVAIL
bleNotConnected
bleMemAllocError

§ ATT_HandleValueInd()

bStatus_t ATT_HandleValueInd ( uint16  connHandle,
attHandleValueInd_t pInd 
)

Send Handle Value Indication.

Parameters
connHandle- connection to use
pInd- pointer to indication to be sent
Returns
SUCCESS : Indication was sent successfully.
INVALIDPARAMETER : Invalid indication field.
MSG_BUFFER_NOT_AVAIL
bleNotConnected
bleMemAllocError

§ ATT_HandleValueNoti()

bStatus_t ATT_HandleValueNoti ( uint16  connHandle,
attHandleValueNoti_t pNoti 
)

Send Handle Value Notification.

Parameters
connHandle- connection to use
pNoti- pointer to notification to be sent
Returns
SUCCESS : Notification was sent successfully.
INVALIDPARAMETER : Invalid notification field.
MSG_BUFFER_NOT_AVAIL
bleNotConnected
bleMemAllocError

§ ATT_PrepareWriteReq()

bStatus_t ATT_PrepareWriteReq ( uint16  connHandle,
attPrepareWriteReq_t pReq 
)

Send Prepare Write Request.

Parameters
connHandle- connection to use
pReq- pointer to request to be sent
Returns
SUCCESS : Request was sent successfully.
INVALIDPARAMETER : Invalid request field.
MSG_BUFFER_NOT_AVAIL
bleNotConnected
bleMemAllocError

§ ATT_PrepareWriteRsp()

bStatus_t ATT_PrepareWriteRsp ( uint16  connHandle,
attPrepareWriteRsp_t pRsp 
)

Send Prepare Write Response.

Parameters
connHandle- connection to use
pRsp- pointer to response to be sent
Returns
SUCCESS : Response was sent successfully.
INVALIDPARAMETER : Invalid response field.
MSG_BUFFER_NOT_AVAIL
bleNotConnected
bleMemAllocError

§ ATT_ReadBlobReq()

bStatus_t ATT_ReadBlobReq ( uint16  connHandle,
attReadBlobReq_t pReq 
)

Send Read Blob Request.

Parameters
connHandle- connection to use
pReq- pointer to request to be sent
Returns
SUCCESS : Request was sent successfully.
INVALIDPARAMETER : Invalid request field.
MSG_BUFFER_NOT_AVAIL
bleNotConnected
bleMemAllocError

§ ATT_ReadBlobRsp()

bStatus_t ATT_ReadBlobRsp ( uint16  connHandle,
attReadBlobRsp_t pRsp 
)

Send Read Blob Response.

Parameters
connHandle- connection to use
pRsp- pointer to response to be sent
Returns
SUCCESS : Response was sent successfully.
INVALIDPARAMETER : Invalid response field.
MSG_BUFFER_NOT_AVAIL
bleNotConnected
bleMemAllocError

§ ATT_ReadByGrpTypeReq()

bStatus_t ATT_ReadByGrpTypeReq ( uint16  connHandle,
attReadByGrpTypeReq_t pReq 
)

Send Read By Group Type Request.

Parameters
connHandle- connection to use
pReq- pointer to request to be sent
Returns
SUCCESS : Request was sent successfully.
INVALIDPARAMETER : Invalid request field.
MSG_BUFFER_NOT_AVAIL
bleNotConnected
bleMemAllocError

§ ATT_ReadByGrpTypeRsp()

bStatus_t ATT_ReadByGrpTypeRsp ( uint16  connHandle,
attReadByGrpTypeRsp_t pRsp 
)

Send Read By Group Type Respond.

Parameters
connHandle- connection to use
pRsp- pointer to response to be sent
Returns
SUCCESS : Response was sent successfully.
INVALIDPARAMETER : Invalid response field.
MSG_BUFFER_NOT_AVAIL
bleNotConnected
bleMemAllocError

§ ATT_ReadByTypeReq()

bStatus_t ATT_ReadByTypeReq ( uint16  connHandle,
attReadByTypeReq_t pReq 
)

Send Read By Type Request.

Parameters
connHandle- connection to use
pReq- pointer to request to be sent
Returns
SUCCESS : Request was sent successfully.
INVALIDPARAMETER : Invalid request field.
MSG_BUFFER_NOT_AVAIL
bleNotConnected
bleMemAllocError

§ ATT_ReadByTypeRsp()

bStatus_t ATT_ReadByTypeRsp ( uint16  connHandle,
attReadByTypeRsp_t pRsp 
)

Send Read By Type Respond.

Parameters
connHandle- connection to use
pRsp- pointer to response to be sent
Returns
SUCCESS : Response was sent successfully.
INVALIDPARAMETER : Invalid response field.
MSG_BUFFER_NOT_AVAIL
bleNotConnected
bleMemAllocError

§ ATT_ReadMultiReq()

bStatus_t ATT_ReadMultiReq ( uint16  connHandle,
attReadMultiReq_t pReq 
)

Send Read Multiple Request.

Parameters
connHandle- connection to use
pReq- pointer to request to be sent
Returns
SUCCESS : Request was sent successfully.
INVALIDPARAMETER : Invalid request field.
MSG_BUFFER_NOT_AVAIL
bleNotConnected
bleMemAllocError

§ ATT_ReadMultiRsp()

bStatus_t ATT_ReadMultiRsp ( uint16  connHandle,
attReadMultiRsp_t pRsp 
)

Send Read Multiple Response.

Parameters
connHandle- connection to use
pRsp- pointer to response to be sent
Returns
SUCCESS : Response was sent successfully.
INVALIDPARAMETER : Invalid response field.
MSG_BUFFER_NOT_AVAIL
bleNotConnected
bleMemAllocError

§ ATT_ReadReq()

bStatus_t ATT_ReadReq ( uint16  connHandle,
attReadReq_t pReq 
)

Send Read Request.

Parameters
connHandle- connection to use
pReq- pointer to request to be sent
Returns
SUCCESS : Request was sent successfully.
INVALIDPARAMETER : Invalid request field.
MSG_BUFFER_NOT_AVAIL
bleNotConnected
bleMemAllocError

§ ATT_ReadRsp()

bStatus_t ATT_ReadRsp ( uint16  connHandle,
attReadRsp_t pRsp 
)

Send Read Response.

Parameters
connHandle- connection to use
pRsp- pointer to response to be sent
Returns
SUCCESS : Response was sent successfully.
INVALIDPARAMETER : Invalid response field.
MSG_BUFFER_NOT_AVAIL
bleNotConnected
bleMemAllocError

§ ATT_RegisterClient()

void ATT_RegisterClient ( attNotifyTxCB_t  pfnNotifyTx)

Register the client's notify Tx function with the ATT layer.

Parameters
pfnNotifyTx- pointer to notify Tx function

§ ATT_RegisterServer()

void ATT_RegisterServer ( attNotifyTxCB_t  pfnNotifyTx)

Register the server's notify Tx function with the ATT layer.

Parameters
pfnNotifyTx- pointer to notify Tx function

§ ATT_SetParamValue()

void ATT_SetParamValue ( uint16  value)

Set a ATT Parameter value. Use this function to change the default ATT parameter values.

Parameters
value- new param value

§ ATT_UpdateMTU()

uint8 ATT_UpdateMTU ( uint16  connHandle,
uint16  MTU 
)

This function is used to update the MTU size of a connection.

Parameters
connHandle- connection handle.
MTU- new MTU.
Returns
SUCCESS : MTU was updated successfully.
FAILURE : MTU wasn't updated.

§ ATT_WriteReq()

bStatus_t ATT_WriteReq ( uint16  connHandle,
attWriteReq_t pReq 
)

Send Write Request.

Parameters
connHandle- connection to use
pReq- pointer to request to be sent
Returns
SUCCESS : Request was sent successfully.
INVALIDPARAMETER : Invalid request field.
MSG_BUFFER_NOT_AVAIL
bleNotConnected
bleMemAllocError
bleLinkEncrypted: Connection is already encrypted.

§ ATT_WriteRsp()

bStatus_t ATT_WriteRsp ( uint16  connHandle)

Send Write Response.

Parameters
connHandle- connection to use
Returns
SUCCESS : Response was sent successfully.
INVALIDPARAMETER : Invalid response field.
MSG_BUFFER_NOT_AVAIL
bleNotConnected
bleMemAllocError
Copyright 2017, Texas Instruments Incorporated