45 #define GATT_PERMIT_READ 0x01 46 #define GATT_PERMIT_WRITE 0x02 47 #define GATT_PERMIT_AUTHEN_READ 0x04 48 #define GATT_PERMIT_AUTHEN_WRITE 0x08 49 #define GATT_PERMIT_AUTHOR_READ 0x10 50 #define GATT_PERMIT_AUTHOR_WRITE 0x20 51 #define GATT_PERMIT_ENCRYPT_READ 0x40 52 #define GATT_PERMIT_ENCRYPT_WRITE 0x80 55 #if !defined( GATT_MAX_NUM_PREPARE_WRITES ) 56 #define GATT_MAX_NUM_PREPARE_WRITES 5 63 #define GATT_MIN_ENCRYPT_KEY_SIZE 7 64 #define GATT_MAX_ENCRYPT_KEY_SIZE 16 67 #define GATT_MAX_ATTR_SIZE 512 69 #define GATT_BASE_METHOD 0x40 71 #define GATT_INVALID_HANDLE 0x0000 72 #define GATT_MIN_HANDLE 0x0001 73 #define GATT_MAX_HANDLE 0xFFFF 75 #define GATT_ATTR_HANDLE_SIZE 0x02 77 #define GATT_MAX_MTU 0xFFFF 78 // end of ATT_GATT_Constants 91 #define gattPermitRead( a ) ( (a) & GATT_PERMIT_READ ) 92 #define gattPermitWrite( a ) ( (a) & GATT_PERMIT_WRITE ) 93 #define gattPermitEncryptRead( a ) ( (a) & GATT_PERMIT_ENCRYPT_READ ) 94 #define gattPermitEncryptWrite( a ) ( (a) & GATT_PERMIT_ENCRYPT_WRITE ) 95 #define gattPermitAuthorRead( a ) ( (a) & GATT_PERMIT_AUTHOR_READ ) 96 #define gattPermitAuthorWrite( a ) ( (a) & GATT_PERMIT_AUTHOR_WRITE ) 97 #define gattPermitAuthenRead( a ) ( (a) & GATT_PERMIT_AUTHEN_READ ) 98 #define gattPermitAuthenWrite( a ) ( (a) & GATT_PERMIT_AUTHEN_WRITE ) 101 #define gattPrimaryServiceType( t ) ( MAP_ATT_CompareUUID( primaryServiceUUID, ATT_BT_UUID_SIZE, \ 102 (t).uuid, (t).len ) ) 103 #define gattSecondaryServiceType( t ) ( MAP_ATT_CompareUUID( secondaryServiceUUID, ATT_BT_UUID_SIZE, \ 104 (t).uuid, (t).len ) ) 105 #define gattCharacterType( t ) ( MAP_ATT_CompareUUID( characterUUID, ATT_BT_UUID_SIZE, \ 106 (t).uuid, (t).len ) ) 107 #define gattIncludeType( t ) ( MAP_ATT_CompareUUID( includeUUID, ATT_BT_UUID_SIZE, \ 108 (t).uuid, (t).len ) ) 109 #define gattServiceType( t ) ( gattPrimaryServiceType( (t) ) || \ 110 gattSecondaryServiceType( (t) ) ) 275 typedef bStatus_t (*pfnGATTBondInfoCB_t)(uint16_t connHandle, uint8_t *pMitmReq, uint8_t *pKeySize);
289 typedef bStatus_t (*pfnGATTStartEncCB_t)(uint16_t connHandle);
298 pfnGATTBondInfoCB_t pfnBondInfoCB;
299 pfnGATTStartEncCB_t pfnStartEncCB;
309 extern uint8 gattNumConns;
521 uint16 len, uint16 *pHandle );
545 uint16 service, uint16 *pLastHandle );
633 uint8 authenticated, uint8 taskId );
675 uint8 authenticated );
789 uint8 len, uint8 taskId );
826 uint16 endHandle, uint8 taskId );
865 uint16 endHandle, uint8 taskId );
943 uint16 endHandle, uint8 taskId );
1324 uint8 numReqs, uint8 flags, uint8 taskId );
1555 extern void *
GATT_bm_alloc( uint16 connHandle, uint8 opcode, uint16 size, uint16 *pSizeAlloc );
1584 extern void GATT_SetHostToAppFlowCtrl( uint16 heapSize, uint8 flowCtrlMode );
1607 extern void GATT_SetNextHandle( uint16
handle );
1616 extern uint16 GATT_GetNextHandle(
void );
1640 extern bStatus_t GATT_RequestNextTransaction( uint16 connHandle, uint8 taskId );
1655 extern void GATT_Init( uint8 taskId );
1667 extern uint16 GATT_ProcessEvent( uint8 taskId, uint16 events );
GATT Read By Type Request format.
Definition: gatt.h:134
bStatus_t GATT_UpdateMTU(uint16 connHandle, uint16 mtuSize)
This API allows the software components in the Z-Stack to be written independently of the specifics o...
attReadByGrpTypeReq_t readByGrpTypeReq
ATT Read By Group Type Request.
Definition: gatt.h:176
gattAttrType_t type
Attribute type (2 or 16 octet UUIDs)
Definition: gatt.h:243
Exchange MTU Response format.
Definition: att.h:348
uint8 index
Index of last Prepare Write Request sent.
Definition: gatt.h:154
Read Request.
Definition: att.h:452
attHandleValueNoti_t handleValueNoti
ATT Handle Value Notification.
Definition: gatt.h:198
Find Information Response format.
Definition: att.h:383
bStatus_t GATT_NotifyEvent(uint16 connHandle, uint8 status, uint8 method, gattMsg_t *pMsg)
Send an event to upper layer application/protocol.
attExchangeMTURsp_t exchangeMTURsp
ATT Exchange MTU Response.
Definition: gatt.h:187
attFindByTypeValueReq_t findByTypeValueReq
ATT Find By Type Value Request.
Definition: gatt.h:171
uint16 GATT_ServiceNumAttrs(uint16 handle)
Get the number of attributes for a given service.
attPrepareWriteReq_t * pReqs
Array of Prepare Write Requests (must be allocated)
Definition: gatt.h:152
struct attAttribute_t gattAttribute_t
GATT Attribute format.
uint8 GATT_ServiceEncKeySize(uint16 handle)
Get the minimum encryption key size required by a given service.
GATT Reliable Writes Request format. Do not change the order of the members.
Definition: gatt.h:149
Find Information Request format.
Definition: att.h:358
Read Response.
Definition: att.h:462
uint8 encKeySize
Minimum encryption key size required by service (7-16 bytes)
Definition: gatt.h:255
GATT Attribute Type format.
Definition: gatt.h:228
GATT Write Long Request format. Do not change the order of the members.
Definition: gatt.h:141
bStatus_t GATT_VerifyWritePermissions(uint16 connHandle, gattAttribute_t *pAttr, uint16 service, attWriteReq_t *pReq)
Verify the permissions of an attribute for writing.
void GATT_RegisterForReq(uint8 taskId)
Register to receive incoming ATT Requests.
uint16 handle
Attribute handle - assigned internally by attribute server.
Definition: gatt.h:245
bStatus_t GATT_DiscAllPrimaryServices(uint16 connHandle, uint8 taskId)
Discovery All Primary Services.
Error Response format.
Definition: att.h:326
attPrepareWriteReq_t prepareWriteReq
ATT Prepare Write Request.
Definition: gatt.h:178
bStatus_t GATT_ReliableWrites(uint16 connHandle, attPrepareWriteReq_t *pReqs, uint8 numReqs, uint8 flags, uint8 taskId)
Do a Reliable Write.
attReadMultiRsp_t readMultiRsp
ATT Read Multiple Response.
Definition: gatt.h:193
attReadBlobRsp_t readBlobRsp
ATT Read Blob Response.
Definition: gatt.h:192
bStatus_t GATT_Indication(uint16 connHandle, attHandleValueInd_t *pInd, uint8 authenticated, uint8 taskId)
Send a GATT Indication.
attPrepareWriteRsp_t prepareWriteRsp
ATT Prepare Write Response.
Definition: gatt.h:195
Find By Type Value Request format.
Definition: att.h:395
const uint8 * uuid
Pointer to UUID.
Definition: gatt.h:231
bStatus_t GATT_ReadUsingCharUUID(uint16 connHandle, attReadByTypeReq_t *pReq, uint8 taskId)
Read Using Characteristic UUID.
bStatus_t GATT_WriteLongCharValue(uint16 connHandle, attPrepareWriteReq_t *pReq, uint8 taskId)
Write Long Characteristic Value.
attFindInfoRsp_t findInfoRsp
ATT Find Information Response.
Definition: gatt.h:188
uint16 endHandle
Last requested handle number.
Definition: gatt.h:129
gattReadByTypeReq_t gattReadByTypeReq
GATT Read By Type Request.
Definition: gatt.h:181
Write Request format.
Definition: att.h:541
uint16 lastOffset
Offset of last Prepare Write Request sent.
Definition: gatt.h:145
bStatus_t GATT_ReadCharValue(uint16 connHandle, attReadReq_t *pReq, uint8 taskId)
Read Characteristic Value.
attReadBlobReq_t readBlobReq
ATT Read Blob Request.
Definition: gatt.h:174
uint8 reliable
Whether reliable writes requested (always FALSE for Write Long)
Definition: gatt.h:143
attExchangeMTUReq_t exchangeMTUReq
ATT Exchange MTU Request.
Definition: gatt.h:169
uint16 connHandle
Connection message was received on.
Definition: gatt.h:215
attReadReq_t readReq
ATT Read Request.
Definition: gatt.h:173
attReadByTypeReq_t readByTypeReq
ATT Read By Type Request.
Definition: gatt.h:172
bStatus_t GATT_ExecuteWriteReq(uint16 connHandle, attExecuteWriteReq_t *pReq, uint8 taskId)
ATT_ExecuteWriteReq
bStatus_t GATT_SignedWriteNoRsp(uint16 connHandle, attWriteReq_t *pReq)
Signed Write No Response.
bStatus_t GATT_SendRsp(uint16 connHandle, uint8 method, gattMsg_t *pRsp)
Send an ATT Response message out.
GATT Message format.
Definition: gatt.h:166
bStatus_t GATT_DiscAllCharDescs(uint16 connHandle, uint16 startHandle, uint16 endHandle, uint8 taskId)
Discovery All Characteristic Descriptors.
uint8 numReqs
Number of Prepare Write Requests.
Definition: gatt.h:153
attFindInfoReq_t findInfoReq
ATT Find Information Request.
Definition: gatt.h:170
Read By Group Type Response format.
Definition: att.h:529
attErrorRsp_t errorRsp
ATT Error Response.
Definition: gatt.h:186
ATT MTU Updated Event message format.
Definition: att.h:644
attWriteReq_t writeReq
ATT Write Request.
Definition: gatt.h:177
bStatus_t GATT_InitClient(void)
Initialize the Generic Attribute Profile Client.
uint16 startHandle
First requested handle number (must be first field)
Definition: gatt.h:128
attHandleValueInd_t handleValueInd
ATT Handle Value Indication.
Definition: gatt.h:199
gattAttribute_t * attrs
Array of attribute records;.
Definition: gatt.h:256
uint8 GATT_ServiceChangedInd(uint16 connHandle, uint8 taskId)
Send out a Service Changed Indication.
Attribute Type format (2 or 16 octet UUID).
Definition: att.h:303
Read Multiple Response format.
Definition: att.h:506
Read Blob Response format.
Definition: att.h:484
attAttrType_t value
Primary service UUID value (2 or 16 octets)
Definition: gatt.h:130
GATT Find By Type Value Request format.
Definition: gatt.h:126
uint8 discCharsByUUID
Whether this is a GATT Discover Characteristics by UUID sub-procedure.
Definition: gatt.h:136
attExecuteWriteReq_t executeWriteReq
ATT Execute Write Request.
Definition: gatt.h:179
bStatus_t GATT_VerifyReadPermissions(uint16 connHandle, gattAttribute_t *pAttr, uint16 service)
Verify the permissions of an attribute for reading.
uint8 *const pValue
Definition: gatt.h:246
bStatus_t GATT_Notification(uint16 connHandle, attHandleValueNoti_t *pNoti, uint8 authenticated)
Send a GATT Notification.
Read Blob Request format.
Definition: att.h:473
gattFindByTypeValueReq_t gattFindByTypeValueReq
GATT Find By Type Value Request.
Definition: gatt.h:180
Find By Type Value Response format.
Definition: att.h:416
ATT Flow Control Violated Event message format.
Definition: att.h:628
uint8 permissions
Attribute permissions.
Definition: gatt.h:244
Read By Type Request format.
Definition: att.h:427
Read Multiple Request format.
Definition: att.h:495
bStatus_t GATT_ReadLongCharDesc(uint16 connHandle, attReadBlobReq_t *pReq, uint8 taskId)
Read Long Characteristic Descriptor.
GATT Structure for client security callbacks.
Definition: gatt.h:296
bStatus_t GATT_ExchangeMTU(uint16 connHandle, attExchangeMTUReq_t *pReq, uint8 taskId)
Exchange MTU Request.
Handle Value Indication format.
Definition: att.h:604
bStatus_t GATT_PrepareWriteReq(uint16 connHandle, attPrepareWriteReq_t *pReq, uint8 taskId)
Request the server to prepare to write the value of an attribute.
bStatus_t GATT_WriteNoRsp(uint16 connHandle, attWriteReq_t *pReq)
Write No Response.
gattMsg_t msg
Attribute protocol/profile message.
Definition: gatt.h:217
attReadByGrpTypeRsp_t readByGrpTypeRsp
ATT Read By Group Type Response.
Definition: gatt.h:194
Type definitions and macros for BLE stack.
Handle Value Notification format.
Definition: att.h:592
bStatus_t GATT_WriteCharValue(uint16 connHandle, attWriteReq_t *pReq, uint8 taskId)
Write Characteristic Value.
attReadByTypeRsp_t readByTypeRsp
ATT Read By Type Response.
Definition: gatt.h:190
uint8 flags
Definition: gatt.h:155
bStatus_t GATT_WriteLongCharDesc(uint16 connHandle, attPrepareWriteReq_t *pReq, uint8 taskId)
Write Long Characteristic Descriptor.
bStatus_t GATT_DiscPrimaryServiceByUUID(uint16 connHandle, uint8 *pUUID, uint8 len, uint8 taskId)
Discovery Primary Service by UUID.
OSAL Event Header.
Definition: osal.h:92
attFindByTypeValueRsp_t findByTypeValueRsp
ATT Find By Type Value Response.
Definition: gatt.h:189
uint8 reliable
Whether reliable writes requested (always TRUE for Reliable Writes)
Definition: gatt.h:151
void GATT_RegisterForMsgs(uint8 taskID)
GATT Register for Messages.
attReadMultiReq_t readMultiReq
ATT Read Multiple Request.
Definition: gatt.h:175
attFlowCtrlViolatedEvt_t flowCtrlEvt
ATT Flow Control Violated Event.
Definition: gatt.h:202
Exchange MTU Request format.
Definition: att.h:338
bStatus_t GATT_ReadCharDesc(uint16 connHandle, attReadReq_t *pReq, uint8 taskId)
Read Characteristic Descriptor.
attPrepareWriteReq_t req
ATT Prepare Write Request.
Definition: gatt.h:144
bStatus_t GATT_DiscCharsByUUID(uint16 connHandle, attReadByTypeReq_t *pReq, uint8 taskId)
Discovery Characteristics by UUID.
bStatus_t GATT_FindIncludedServices(uint16 connHandle, uint16 startHandle, uint16 endHandle, uint8 taskId)
This sub-procedure is used by a client to find include service declarations within a service definiti...
GATT GATT_MSG_EVENT message format.
Definition: gatt.h:212
bStatus_t GATT_InitServer(void)
Initialize the Generic Attribute Profile Server.
bStatus_t GATT_RegisterService(gattService_t *pService)
Register a service attribute list with the GATT Server.
GATT Service format.
Definition: gatt.h:252
Read By Group Type Request format.
Definition: att.h:517
gattWriteLongReq_t gattWriteLongReq
GATT Long Write Request.
Definition: gatt.h:182
GATT Attribute format.
Definition: gatt.h:241
Status_t bStatus_t
BLE Generic Status return.
Definition: bcomdef.h:251
void GATT_bm_free(gattMsg_t *pMsg, uint8 opcode)
GATT implementation of the de-allocator functionality.
Read By Type Response format.
Definition: att.h:439
osal_event_hdr_t hdr
GATT_MSG_EVENT and status.
Definition: gatt.h:214
Prepare Write Response format.
Definition: att.h:568
Prepare Write Request format.
Definition: att.h:555
bStatus_t GATT_WriteCharDesc(uint16 connHandle, attWriteReq_t *pReq, uint8 taskId)
Write Characteristic Descriptor.
bStatus_t GATT_ReadLongCharValue(uint16 connHandle, attReadBlobReq_t *pReq, uint8 taskId)
Read Long Characteristic Value.
bStatus_t GATT_DeregisterService(uint16 handle, gattService_t *pService)
Deregister a service attribute list with the GATT Server.
gattAttribute_t * GATT_FindHandle(uint16 handle, uint16 *pHandle)
Find the attribute record for a given handle.
gattAttribute_t * GATT_FindHandleUUID(uint16 startHandle, uint16 endHandle, const uint8 *pUUID, uint16 len, uint16 *pHandle)
Find the attribute record for a given handle and UUID.
uint8 method
Type of message.
Definition: gatt.h:216
uint8 len
Length of UUID (2 or 16)
Definition: gatt.h:230
gattAttribute_t * GATT_FindNextAttr(gattAttribute_t *pAttr, uint16 endHandle, uint16 service, uint16 *pLastHandle)
Find the next attribute of the same type for a given attribute.
uint16 numAttrs
Number of attributes in attrs.
Definition: gatt.h:254
attMtuUpdatedEvt_t mtuEvt
ATT MTU Updated Event.
Definition: gatt.h:203
void * GATT_bm_alloc(uint16 connHandle, uint8 opcode, uint16 size, uint16 *pSizeAlloc)
GATT implementation of the allocator functionality.
gattReliableWritesReq_t gattReliableWritesReq
GATT Reliable Writes Request.
Definition: gatt.h:183
Execute Write Request format.
Definition: att.h:581
attReadByTypeReq_t req
Read By Type Request.
Definition: gatt.h:137
bStatus_t GATT_ReadMultiCharValues(uint16 connHandle, attReadMultiReq_t *pReq, uint8 taskId)
Read Multiple Characteristic Values.
attReadRsp_t readRsp
ATT Read Response.
Definition: gatt.h:191
bStatus_t GATT_DiscAllChars(uint16 connHandle, uint16 startHandle, uint16 endHandle, uint8 taskId)
Discover all Characteristics.
void GATT_RegisterForInd(uint8 taskId)
Register to receive incoming ATT Indications or Notifications of attribute values.