ATT Commands
All ATT commands have the following format:
| Name |
Size (bytes) |
Description |
| Opcode |
2 |
PDU operation code |
| Connection Handle |
2 |
Connection handle of the link |
| Command PDU |
Variable |
Command Parameters |
For the command parameters, please see the corresponding section below.
Note: The connection handle of 0xFFFE is considered as the loopback connection.
All messages sent to this connection will be loop backed to the local host.
Events Generated
For each ATT command,when it is received, the host will send the CommandStatus
Event with the Status parameter. If a command will return additional
events, it will be noted in the description below.
ATT_ErrorRsp
| Opcode: | 0xFD01 |
|---|
| Command Description: |
|---|
| | The Error Response is used to state that a given request cannot be performed and to provide the reason. |
Command Parameters
| Connection Handle: |
|---|
| | Identifies the connection.
| Size: | 2 byte(s) |
|---|
| Default: | 0x0000 |
|---|
| Range: | 0x0000 to 0xFFFD |
|---|
|
| reqOpcode: | The request that generated this error response
| Size: | 1 byte(s)
|
|---|
| Default: | 0x01
|
|---|
| Range: |
| Value |
Description |
|---|
| 0x01 |
ATT_ERROR_RSP |
| 0x02 |
ATT_EXCHANGE_MTU_REQ |
| 0x03 |
ATT_EXCHANGE_MTU_RSP |
| 0x04 |
ATT_FIND_INFO_REQ |
| 0x05 |
ATT_FIND_INFO_RSP |
| 0x06 |
ATT_FIND_BY_TYPE_VALUE_REQ |
| 0x07 |
ATT_FIND_BY_TYPE_VALUE_RSP |
| 0x08 |
ATT_READ_BY_TYPE_REQ |
| 0x09 |
ATT_READ_BY_TYPE_RSP |
| 0x0A |
ATT_READ_REQ |
| 0x0B |
ATT_READ_RSP |
| 0x0C |
ATT_READ_BLOB_REQ |
| 0x0D |
ATT_READ_BLOB_RSP |
| 0x0E |
ATT_READ_MULTI_REQ |
| 0x0F |
ATT_READ_MULTI_RSP |
| 0x10 |
ATT_READ_BY_GRP_TYPE_REQ |
| 0x11 |
ATT_READ_BY_GRP_TYPE_RSP |
| 0x12 |
ATT_WRITE_REQ |
| 0x13 |
ATT_WRITE_RSP |
| 0x16 |
ATT_PREPARE_WRITE_REQ |
| 0x17 |
ATT_PREPARE_WRITE_RSP |
| 0x18 |
ATT_EXECUTE_WRITE_REQ |
| 0x19 |
ATT_EXECUTE_WRITE_RSP |
| 0x1B |
ATT_HANDLE_VALUE_NOTI |
| 0x1D |
ATT_HANDLE_VALUE_IND |
| 0x1E |
ATT_HANDLE_VALUE_CFM |
|
|---|
|
|---|
| handle: | The attribute handle that generated this error response
| Size: | 2 byte(s) |
|---|
| Default: | 0 |
|---|
| Range: | Any 2 byte value |
|---|
|
|---|
| errorCode: | The reason why the request has generated an error response
| Size: | 1 byte(s)
|
|---|
| Default: | 0x80
|
|---|
| Range: |
| Value |
Description |
|---|
| 0x01 |
INVALID_HANDLE |
| 0x02 |
READ_NOT_PERMITTED |
| 0x03 |
WRITE_NOT_PERMITTED |
| 0x04 |
INVALID_PDU |
| 0x05 |
INSUFFICIENT_AUTHEN |
| 0x06 |
UNSUPPORTED_REQ |
| 0x07 |
INVALID_OFFSET |
| 0x08 |
INSUFFICIENT_AUTHOR |
| 0x09 |
PREPARE_QUEUE_FULL |
| 0x0a |
ATTR_NOT_FOUND |
| 0x0b |
ATTR_NOT_LONG |
| 0x0c |
INSUFFICIENT_KEY_SIZE |
| 0x0d |
INVALID_VALUE_SIZE |
| 0x0e |
UNLIKELY_ERROR |
| 0x0f |
INSUFFICIENT_ENCRYPTION |
| 0x10 |
UNSUPPORTED_GRP_TYPE |
| 0x11 |
INSUFFICIENT_RESOURCES |
| 0x80 |
INVALID_VALUE |
|
|---|
|
|---|
Events Generated
This command only returns the CommandStatus event
ATT_ExchangeMTUReq
| Opcode: | 0xFD02 |
|---|
| Command Description: |
|---|
| | The Exchange MTU Request is used by the client to inform the server of the clients maximum receive MTU size and request the server to respond with its maximum receive MTU size is used to state that a given request cannot be performed and to provide the reason. |
Command Parameters
| Connection Handle: |
|---|
| | Identifies the connection.
| Size: | 2 byte(s) |
|---|
| Default: | 0x0000 |
|---|
| Range: | 0x0000 to 0xFFFD |
|---|
|
| clientRxMTU: | Attribute client receive MTU size
| Size: | 2 byte(s) |
|---|
| Default: | 23 |
|---|
| Range: | Any 2 byte value |
|---|
|
|---|
Events Generated
The server will respond to this request with a ATT_ExchangeMTURsp.
ATT_ExchangeMTURsp
| Opcode: | 0xFD03 |
|---|
| Command Description: |
|---|
| | The Exchange MTU Response is sent in reply to a received Exchange MTU Request. |
Command Parameters
| Connection Handle: |
|---|
| | Identifies the connection.
| Size: | 2 byte(s) |
|---|
| Default: | 0x0000 |
|---|
| Range: | 0x0000 to 0xFFFD |
|---|
|
| serverRxMTU: | Attribute server receive MTU size
| Size: | 2 byte(s) |
|---|
| Default: | 23 |
|---|
| Range: | Any 2 byte value |
|---|
|
|---|
Events Generated
This command only returns the CommandStatus event
ATT_FindInfoReq
| Opcode: | 0xFD04 |
|---|
| Command Description: |
|---|
| | The Find Information Request is used to obtain the mapping of attribute handles with their associated types. This allows a client to discover the list of attributes and their types on a server. |
Command Parameters
| Connection Handle: |
|---|
| | Identifies the connection.
| Size: | 2 byte(s) |
|---|
| Default: | 0x0000 |
|---|
| Range: | 0x0000 to 0xFFFD |
|---|
|
| startHandle: | First requested handle number
| Size: | 2 byte(s) |
|---|
| Default: | 0x0001 |
|---|
| Range: | Any 2 byte value |
|---|
|
|---|
| endHandle: | Last requested handle number
| Size: | 2 byte(s) |
|---|
| Default: | 0xFFFF |
|---|
| Range: | Any 2 byte value |
|---|
|
|---|
Events Generated
When this request is received, the server will send the ATT_FindInfoRsp. The client will forward all the Find Information Responses to the calling application. The response with the status of bleProcedureComplete will indicate the end of the sub-procedure. If no attributes will be returned or any of the requested parameters is invalid, the server will send an ATT_ErrorRsp.
ATT_FindInfoRsp
| Opcode: | 0xFD05 |
|---|
| Command Description: |
|---|
| | The Find Information Response is sent in reply to a received Find Information Request and contains information about the server. |
Command Parameters
| Connection Handle: |
|---|
| | Identifies the connection.
| Size: | 2 byte(s) |
|---|
| Default: | 0x0000 |
|---|
| Range: | 0x0000 to 0xFFFD |
|---|
|
| format: | The format of the information data
| Size: | 1 byte(s)
|
|---|
| Default: | 0x01
|
|---|
| Range: |
| Value |
Description |
|---|
| 0x01 |
HANDLE_BT_UUID_TYPE - handle(s) and 16-bit Bluetooth UUID(s) |
| 0x02 |
HANDLE_UUID_TYPE - handle(s) and 128-bit UUID(s) |
|
|---|
|
|---|
| info: | The information data whose format is determined by the format field
| Size: | input byte(s) |
|---|
| Default: | “” |
|---|
| Range: | 4 to (ATT_MTU - 2) octets |
|---|
|
|---|
Events Generated
This command only returns the CommandStatus event
ATT_FindByTypeValueReq
| Opcode: | 0xFD06 |
|---|
| Command Description: |
|---|
| | The Find By Type Value Request is used to obtain the handles of attributes that have a 16-bit UUID attribute type and attribute value. This allows the range of handles associated with a given attribute to be discovered when the attribute type determines the grouping of a set of attributes. |
Command Parameters
| Connection Handle: |
|---|
| | Identifies the connection.
| Size: | 2 byte(s) |
|---|
| Default: | 0x0000 |
|---|
| Range: | 0x0000 to 0xFFFD |
|---|
|
| startHandle: | First requested handle number
| Size: | 2 byte(s) |
|---|
| Default: | 0x0001 |
|---|
| Range: | Any 2 byte value |
|---|
|
|---|
| endHandle: | Last requested handle number
| Size: | 2 byte(s) |
|---|
| Default: | 0xFFFF |
|---|
| Range: | Any 2 byte value |
|---|
|
|---|
| type: | 2-octet UUID to find
| Size: | 2 byte(s) |
|---|
| Default: | “00:00” |
|---|
| Range: | Any 2 byte value |
|---|
|
|---|
| value: | Attribute value to find
| Size: | input byte(s) |
|---|
| Default: | “” |
|---|
| Range: | 0 to (ATT_MTU - 7) octets |
|---|
|
|---|
Events Generated
When this request is received, the server will send the ATT_FindByTypeValueRsp. The client will forward all the ATT_FindByTypeValueRsp events to the calling application. The response with the status of bleProcedureComplete will indicate the end of the sub-procedure. If no attributes will be returned or any of the requested parameters is invalid, the server will send an ATT_ErrorRsp.
ATT_FindByTypeValueRsp
| Opcode: | 0xFD07 |
|---|
| Command Description: |
|---|
| | The Find By Type Value Response is sent in reply to a received Find By Type Value Request and contains information about this server. |
Command Parameters
| Connection Handle: |
|---|
| | Identifies the connection.
| Size: | 2 byte(s) |
|---|
| Default: | 0x0000 |
|---|
| Range: | 0x0000 to 0xFFFD |
|---|
|
| handlesInfo: | The Handles Information List field is a list of one or more Handle Information groups where the first 2 bytes are the attribute handle and the next two bytes are the handle end group handle.
| Size: | input byte(s) |
|---|
| Default: | “” |
|---|
| Range: | Any 2-byte value for each element. |
|---|
|
|---|
Events Generated
This command only returns the CommandStatus event
ATT_ReadByTypeReq
| Opcode: | 0xFD08 |
|---|
| Command Description: |
|---|
| | The Read By Type Request is used to obtain the values of attributes where the attribute type is known but the handle is not known. |
Command Parameters
| Connection Handle: |
|---|
| | Identifies the connection.
| Size: | 2 byte(s) |
|---|
| Default: | 0x0000 |
|---|
| Range: | 0x0000 to 0xFFFD |
|---|
|
| startHandle: | First requested handle number
| Size: | 2 byte(s) |
|---|
| Default: | 0x0001 |
|---|
| Range: | Any 2 byte value |
|---|
|
|---|
| endHandle: | Last requested handle number
| Size: | 2 byte(s) |
|---|
| Default: | 0xFFFF |
|---|
| Range: | Any 2 byte value |
|---|
|
|---|
| type: | 2 or 16 octet UUID
| Size: | input byte(s) |
|---|
| Default: | “00:00” |
|---|
| Range: | Any 2 or 16 byte value |
|---|
|
|---|
Events Generated
When this request is received, the server will send the ATT_ReadByTypeRsp. The client will forward all the ATT_ReadByTypeRsp events to the calling application. The response with the status of bleProcedureComplete will indicate the end of the sub-procedure. If no attribute with the given type exists within the handle range or the attribute value cannot be read, the server will send an ATT_ErrorRsp.
ATT_ReadByTypeRsp
| Opcode: | 0xFD09 |
|---|
| Command Description: |
|---|
| | The Read By Type Response is sent in reply to a received Read By Type Request and contains the handles and values of the attributes that have been read. |
Command Parameters
| Connection Handle: |
|---|
| | Identifies the connection.
| Size: | 2 byte(s) |
|---|
| Default: | 0x0000 |
|---|
| Range: | 0x0000 to 0xFFFD |
|---|
|
| length: | The size of each attribute handle-value pair.
| Size: | 1 byte(s) |
|---|
| Default: | 0 |
|---|
| Range: | Any 1 byte value |
|---|
|
|---|
| dataList: | A list of Attribute Data (handle-value pairs) where the first two bytes are the attribute handle and the next two bytes are the attribute value.
| Size: | input byte(s) |
|---|
| Default: | “” |
|---|
| Range: | Any 2 byte value for each attribute handle and any (length -2) bytes for each attribute value. |
|---|
|
|---|
Events Generated
This command only returns the CommandStatus event
ATT_ReadReq
| Opcode: | 0xFD0A |
|---|
| Command Description: |
|---|
| | The Read Request is used request the server to read the value of an attribute and return its value in a Read Response. |
Command Parameters
| Connection Handle: |
|---|
| | Identifies the connection.
| Size: | 2 byte(s) |
|---|
| Default: | 0x0000 |
|---|
| Range: | 0x0000 to 0xFFFD |
|---|
|
| handle: | The handle of the attribute to be read
| Size: | 2 byte(s) |
|---|
| Default: | 0 |
|---|
| Range: | Any 2 byte value. |
|---|
|
|---|
Events Generated
When this request is received, the server will send the ATT_ReadRsp. If the attribute handle is invalid or the attribute value cannot be read, the server will send an ATT_ErrorRsp.
ATT_ReadRsp
| Opcode: | 0xFD0B |
|---|
| Command Description: |
|---|
| | The Read Response is sent in reply to a received Read Request and contains the value of the attribute that has been read. |
Command Parameters
| Connection Handle: |
|---|
| | Identifies the connection.
| Size: | 2 byte(s) |
|---|
| Default: | 0x0000 |
|---|
| Range: | 0x0000 to 0xFFFD |
|---|
|
| value: | The value of the attribute with the handle given
| Size: | input byte(s) |
|---|
| Default: | “” |
|---|
| Range: | Any (0 to (ATT_MTU - 1) byte) value |
|---|
|
|---|
Events Generated
This command only returns the CommandStatus event
ATT_ReadBlobReq
| Opcode: | 0xFD0C |
|---|
| Command Description: |
|---|
| | The Read Blob Request is used request the server to read part of the value of an attribute at a given offset and return a specific part of the value in a ATT_ReadBlobRsp. |
Command Parameters
| Connection Handle: |
|---|
| | Identifies the connection.
| Size: | 2 byte(s) |
|---|
| Default: | 0x0000 |
|---|
| Range: | 0x0000 to 0xFFFD |
|---|
|
| handle: | The handle of the attribute to be read
| Size: | 2 byte(s) |
|---|
| Default: | 0 |
|---|
| Range: | Any 2 byte value |
|---|
|
|---|
| offset: | The offset of the first octet to be read
| Size: | 2 byte(s) |
|---|
| Default: | 0 |
|---|
| Range: | Any 2 byte value |
|---|
|
|---|
Events Generated
When this request is received, the server will send the ReadBlobRsp. The client will forward all the ReadBlobRsp events to the calling application. The response with the status of bleProcedureComplete will indicate the end of the sub-procedure. If the attribute handle or offset is invalid, or the attribute value cannot be read, the server will send an ATT_ErrorRsp.
ATT_ReadBlobRsp
| Opcode: | 0xFD0D |
|---|
| Command Description: |
|---|
| | The Read Blob Response is sent in reply to a received Read Blob Request and contains part of the value of the attribute that has been read. |
Command Parameters
| Connection Handle: |
|---|
| | Identifies the connection.
| Size: | 2 byte(s) |
|---|
| Default: | 0x0000 |
|---|
| Range: | 0x0000 to 0xFFFD |
|---|
|
| value: | Part of the value of the attribute with the handle given
| Size: | input byte(s) |
|---|
| Default: | “” |
|---|
| Range: | Any (0 to (ATT_MTU - 1) octets) value. |
|---|
|
|---|
Events Generated
This command only returns the CommandStatus event
ATT_ReadMultiReq
| Opcode: | 0xFD0E |
|---|
| Command Description: |
|---|
| | The Read Multiple Request is used to request the server to read two or more values of a set of attributes and return their values in a ATT_ReadMultiRsp. Only values that have a known fixed size can be read, with the exception of the last value that can have a variable length. |
Command Parameters
| Connection Handle: |
|---|
| | Identifies the connection.
| Size: | 2 byte(s) |
|---|
| Default: | 0x0000 |
|---|
| Range: | 0x0000 to 0xFFFD |
|---|
|
| handles: | A set of two or more two-byte attribute handles
| Size: | input byte(s) |
|---|
| Default: | “” |
|---|
| Range: | Any (4 to (ATT_MTU-1) byte) value |
|---|
|
|---|
Events Generated
When this request is received, the server will send the ATT_ReadMultiRsp. If any of the attribute handles are invalid or any of the attribute values cannot be read, the server will send an ATT_ErrorRsp.
ATT_ReadMultiRsp
| Opcode: | 0xFD0F |
|---|
| Command Description: |
|---|
| | The Read Multiple Response is sent in reply to a received ATT_ReadMultiReq and contains the values of the attributes that have been read. |
Command Parameters
| Connection Handle: |
|---|
| | Identifies the connection.
| Size: | 2 byte(s) |
|---|
| Default: | 0x0000 |
|---|
| Range: | 0x0000 to 0xFFFD |
|---|
|
| values: | A set of two or more values
| Size: | input byte(s) |
|---|
| Default: | “” |
|---|
| Range: | Any (0 to (ATT_MTU - 1) byte) value. |
|---|
|
|---|
Events Generated
This command only returns the CommandStatus event
ATT_ReadByGrpTypeReq
| Opcode: | 0xFD10 |
|---|
| Command Description: |
|---|
| | The Read By Group Type Request is used to obtain the values of attributes where the attribute type is known, the type of a grouping attribute as defined by a higher layer specification, but the handle is not known. |
Command Parameters
| Connection Handle: |
|---|
| | Identifies the connection.
| Size: | 2 byte(s) |
|---|
| Default: | 0x0000 |
|---|
| Range: | 0x0000 to 0xFFFD |
|---|
|
| startHandle: | First requested handle number
| Size: | 2 byte(s) |
|---|
| Default: | 0x0001 |
|---|
| Range: | Any 2 byte value |
|---|
|
|---|
| endHandle: | Last requested handle number
| Size: | 2 byte(s) |
|---|
| Default: | 0xFFFF |
|---|
| Range: | Any 2 byte value |
|---|
|
|---|
| groupType: | 2 or 16 octet UUID
| Size: | input byte(s) |
|---|
| Default: | “00:00” |
|---|
| Range: | Any 2 or 16 byte value |
|---|
|
|---|
Events Generated
When this request is received, the server will send the ATT_ReadByGrpTypeRsp. The client will forward all the ATT_ReadByGrpTypeRsp Events to the calling application. The response with the status of bleProcedureComplete will indicate the end of the sub-procedure. If no attributes with the given type exists within the handle ranges or the Attribute Group Type is not a supported grouping attribute, the server will send an ATT_ErrorRsp
ATT_ReadByGrpTypeRsp
| Opcode: | 0xFD11 |
|---|
| Command Description: |
|---|
| | The Read By Group Type Response is sent in reply to a received ATT_ReadByGrpTypeReq and contains the handles and values of the attributes that have been read. |
Command Parameters
| Connection Handle: |
|---|
| | Identifies the connection.
| Size: | 2 byte(s) |
|---|
| Default: | 0x0000 |
|---|
| Range: | 0x0000 to 0xFFFD |
|---|
|
| length: | The size of each Attribute Data (attribute handle, end group handle and attribute value set)
| Size: | 1 byte(s) |
|---|
| Default: | 0 |
|---|
| Range: | Any 1 byte value. |
|---|
|
|---|
| dataList: | The Attribute Data field is comprised of a list of attribute handle and value pairs where the first two bytes are the attribute handle, the next two bytes are the end group handle, and the next (length - 4) bytes are the attribute value.
| Size: | input byte(s) |
|---|
| Default: | “” |
|---|
| Range: | Any value formatted as described above. |
|---|
|
|---|
Events Generated
This command only returns the CommandStatus event
ATT_WriteReq
| Opcode: | 0xFD12 |
|---|
| Command Description: |
|---|
| | The Write Request is used to request the server to write the value of an attribute and acknowledge that this has been achieved in a ATT_WriteRsp. The command field is set for the Write Command. The signature and command fields are set for the Signed Write Command. |
Command Parameters
| Connection Handle: |
|---|
| | Identifies the connection.
| Size: | 2 byte(s) |
|---|
| Default: | 0x0000 |
|---|
| Range: | 0x0000 to 0xFFFD |
|---|
|
| signature: | Whether to include the Authentication Signature with the Write PDU
| Size: | 1 byte(s)
|
|---|
| Default: | 0x00
|
|---|
| Range: |
| Value |
Description |
|---|
| 0x00 |
No |
| 0x01 |
Yes |
|
|---|
|
|---|
| command: | Whether this is the Write Command
| Size: | 1 byte(s)
|
|---|
| Default: | 0x00
|
|---|
| Range: |
| Value |
Description |
|---|
| 0x00 |
No |
| 0x01 |
Yes |
|
|---|
|
|---|
| handle: | The handle of the attribute to be set
| Size: | 2 byte(s) |
|---|
| Default: | 0 |
|---|
| Range: | Any 2 byte value |
|---|
|
|---|
| value: | The value to be written to the attribute
| Size: | input byte(s) |
|---|
| Default: | “” |
|---|
| Range: | Any (0 to (ATT_MTU - 3) byte) value |
|---|
|
|---|
Events Generated
This command only returns the CommandStatus event
ATT_WriteRsp
| Opcode: | 0xFD13 |
|---|
| Command Description: |
|---|
| | The Write Response is sent in reply to a valid Write Request and acknowledges that the attribute has been successfully written. |
Command Parameters
| Connection Handle: |
|---|
| | Identifies the connection.
| Size: | 2 byte(s) |
|---|
| Default: | 0x0000 |
|---|
| Range: | 0x0000 to 0xFFFD |
|---|
|
Events Generated
This command only returns the CommandStatus event
ATT_PrepareWriteReq
| Opcode: | 0xFD16 |
|---|
| Command Description: |
|---|
| | The Prepare Write Request is used to request the server to prepare to write the value of an attribute. The server will respond to this request with a ATT_PrepareWriteRsp, so that the client can verify that the value was received correctly. A client may send more than one ATT_PrepareWriteReq to a server, which will queue and send a response for each handle value pair. |
Command Parameters
| Connection Handle: |
|---|
| | Identifies the connection.
| Size: | 2 byte(s) |
|---|
| Default: | 0x0000 |
|---|
| Range: | 0x0000 to 0xFFFD |
|---|
|
| handle: | The handle of the attribute to be written
| Size: | 2 byte(s) |
|---|
| Default: | 0 |
|---|
| Range: | Any 2 byte value |
|---|
|
|---|
| offset: | The offset of the first octet to be written
| Size: | 2 byte(s) |
|---|
| Default: | 0 |
|---|
| Range: | Any 2 byte value |
|---|
|
|---|
| value: | Part of the value of the attribute to be written
| Size: | input byte(s) |
|---|
| Default: | “” |
|---|
| Range: | (0 to (ATT_MTU - 5) octets) |
|---|
|
|---|
Events Generated
When this request is received, the server will send the ATT_PrepareWriteRsp. If the attribute handle is invalid or the attribute value cannot be written, the server will send an ATT_ErrorRsp.
ATT_PrepareWriteRsp
| Opcode: | 0xFD17 |
|---|
| Command Description: |
|---|
| | The Prepare Write Response is sent in response to a received Prepare Write Request and acknowledges that the value has been successfully received and placed in the prepare write queue. |
Command Parameters
| Connection Handle: |
|---|
| | Identifies the connection.
| Size: | 2 byte(s) |
|---|
| Default: | 0x0000 |
|---|
| Range: | 0x0000 to 0xFFFD |
|---|
|
| handle: | The handle of the attribute to be written
| Size: | 2 byte(s) |
|---|
| Default: | 0 |
|---|
| Range: | Any 2 byte value |
|---|
|
|---|
| offset: | The offset of the first octet to be written
| Size: | 2 byte(s) |
|---|
| Default: | 0 |
|---|
| Range: | Any 2 byte value |
|---|
|
|---|
| value: | Part of the value of the attribute to be written
| Size: | input byte(s) |
|---|
| Default: | “” |
|---|
| Range: | Any (0 to (ATT_MTU - 5) byte) value. |
|---|
|
|---|
Events Generated
This command only returns the CommandStatus event
ATT_ExecuteWriteReq
| Opcode: | 0xFD18 |
|---|
| Command Description: |
|---|
| | The Execute Write Request is used to request the server to write or cancel the write of all the prepared values currently held in the prepare queue from this client. This request shall be handled by the server as an atomic operation. |
Command Parameters
| Connection Handle: |
|---|
| | Identifies the connection.
| Size: | 2 byte(s) |
|---|
| Default: | 0x0000 |
|---|
| Range: | 0x0000 to 0xFFFD |
|---|
|
| flags: | Whether to cancel or write.
| Size: | 1 byte(s)
|
|---|
| Default: | 0x01
|
|---|
| Range: |
| Value |
Description |
|---|
| 0x00 |
CANCEL_WRITES |
| 0x01 |
WRITE_VALUES |
|
|---|
|
|---|
Events Generated
When this request is received, the server will send the ATT_ExecuteWriteRsp. If the attribute value cannot be written, the server will send an ATT_ErrorRsp.
ATT_ExecuteWriteRsp
| Opcode: | 0xFD19 |
|---|
| Command Description: |
|---|
| | The Execute Write Response is sent in response to a received Execute Write Request. |
Command Parameters
| Connection Handle: |
|---|
| | Identifies the connection.
| Size: | 2 byte(s) |
|---|
| Default: | 0x0000 |
|---|
| Range: | 0x0000 to 0xFFFD |
|---|
|
Events Generated
This command only returns the CommandStatus event
ATT_HandleValueNoti
| Opcode: | 0xFD1B |
|---|
| Command Description: |
|---|
| | A server can send a notification of an attributes value at any time. |
Command Parameters
| Connection Handle: |
|---|
| | Identifies the connection.
| Size: | 2 byte(s) |
|---|
| Default: | 0x0000 |
|---|
| Range: | 0x0000 to 0xFFFD |
|---|
|
| authenticated: | Whether or not an authenticated link is required
| Size: | 1 byte(s)
|
|---|
| Default: | 0x00
|
|---|
| Range: |
| Value |
Description |
|---|
| 0x00 |
No |
| 0x01 |
Yes |
|
|---|
|
|---|
| handle: | The handle of the attribute
| Size: | 2 byte(s) |
|---|
| Default: | 0 |
|---|
| Range: | Any 2 byte value |
|---|
|
|---|
| value: | The current value of the attribute
| Size: | input byte(s) |
|---|
| Default: | “” |
|---|
| Range: | Any (0 to (ATT_MTU - 3) byte) value |
|---|
|
|---|
Events Generated
This command only returns the CommandStatus event
ATT_HandleValueInd
| Opcode: | 0xFD1D |
|---|
| Command Description: |
|---|
| | A server can send an indication of an attributes value at any time. |
Command Parameters
| Connection Handle: |
|---|
| | Identifies the connection.
| Size: | 2 byte(s) |
|---|
| Default: | 0x0000 |
|---|
| Range: | 0x0000 to 0xFFFD |
|---|
|
| authenticated: | Whether or not an authenticated link is required
| Size: | 1 byte(s)
|
|---|
| Default: | 0x00
|
|---|
| Range: |
| Value |
Description |
|---|
| 0x00 |
No |
| 0x01 |
Yes |
|
|---|
|
|---|
| handle: | The handle of the attribute
| Size: | 2 byte(s) |
|---|
| Default: | 0 |
|---|
| Range: | Any 2 byte value |
|---|
|
|---|
| value: | The current value of the attribute
| Size: | input byte(s) |
|---|
| Default: | “” |
|---|
| Range: | Any (0 to (ATT_MTU - 3) byte) value. |
|---|
|
|---|
Events Generated
The client shall send a ATT_HandleValueCfm in response to a Handle Value Indication. No further indications to this client shall occur until the confirmation has been received by the server.
ATT_HandleValueCfm
| Opcode: | 0xFD1E |
|---|
| Command Description: |
|---|
| | The Handle Value Confirmation is sent in response to a received ATT_HandleValueInd and confirms that the client has received an indication of the given attribute. |
Command Parameters
| Connection Handle: |
|---|
| | Identifies the connection.
| Size: | 2 byte(s) |
|---|
| Default: | 0x0000 |
|---|
| Range: | 0x0000 to 0xFFFD |
|---|
|
Events Generated
This command only returns the CommandStatus event
ATT Events
All ATT events have the following format:
| Name |
Size (bytes) |
Description |
| Opcode |
2 |
PDU operation code |
| Status |
1 |
Event status |
| Connection Handle |
2 |
Connection handle of the link |
| PDU length |
1 |
Length of event PDU |
| Event PDU |
Variable |
Event parameters |
For the event parameters, please see the corresponding section below.
Note: The connection handle of 0xFFFE is considered as the loopback connection.
All messages sent to this connection will be loop backed to the local host.
ATT_ErrorRsp
| Opcode: | 0x0501 |
|---|
| Event Description: |
|---|
| | ATT Error Response. |
Event Parameters
| Status: |
| Size: | 1 byte(s)
|
|---|
| Range: |
| Value |
Description |
|---|
| 0x00 |
SUCCESS |
| 0x12 |
bleIncorrectMode |
| 0x02 |
INVALIDPARAMETER |
|
|---|
|
|---|
| connectionHandle: |
|---|
| | Connection handle of the link
| Size: | 2 byte(s) |
|---|
| Range: | Any 2 byte value |
|---|
|
| pduLen: | PDU length
| Size: | 1 byte(s) |
|---|
| Range: | Any 1 byte value |
|---|
|
|---|
| reqOpcode: | Request that generated this error response
| Size: | 1 byte(s)
|
|---|
| Range: |
| Value |
Description |
|---|
| 0x01 |
ATT_ERROR_RSP |
| 0x02 |
ATT_EXCHANGE_MTU_REQ |
| 0x03 |
ATT_EXCHANGE_MTU_RSP |
| 0x04 |
ATT_FIND_INFO_REQ |
| 0x05 |
ATT_FIND_INFO_RSP |
| 0x06 |
ATT_FIND_BY_TYPE_VALUE_REQ |
| 0x07 |
ATT_FIND_BY_TYPE_VALUE_RSP |
| 0x08 |
ATT_READ_BY_TYPE_REQ |
| 0x09 |
ATT_READ_BY_TYPE_RSP |
| 0x0A |
ATT_READ_REQ |
| 0x0B |
ATT_READ_RSP |
| 0x0C |
ATT_READ_BLOB_REQ |
| 0x0D |
ATT_READ_BLOB_RSP |
| 0x0E |
ATT_READ_MULTI_REQ |
| 0x0F |
ATT_READ_MULTI_RSP |
| 0x10 |
ATT_READ_BY_GRP_TYPE_REQ |
| 0x11 |
ATT_READ_BY_GRP_TYPE_RSP |
| 0x12 |
ATT_WRITE_REQ |
| 0x13 |
ATT_WRITE_RSP |
| 0x16 |
ATT_PREPARE_WRITE_REQ |
| 0x17 |
ATT_PREPARE_WRITE_RSP |
| 0x18 |
ATT_EXECUTE_WRITE_REQ |
| 0x19 |
ATT_EXECUTE_WRITE_RSP |
| 0x1B |
ATT_HANDLE_VALUE_NOTI |
| 0x1D |
ATT_HANDLE_VALUE_IND |
| 0x1E |
ATT_HANDLE_VALUE_CFM |
|
|---|
|
|---|
| handle: | Attribute handle that generated error response
|
|---|
| errorCode: | Reason why the request has generated error response
| Size: | 1 byte(s)
|
|---|
| Range: |
| Value |
Description |
|---|
| 0x01 |
INVALID_HANDLE |
| 0x02 |
READ_NOT_PERMITTED |
| 0x03 |
WRITE_NOT_PERMITTED |
| 0x04 |
INVALID_PDU |
| 0x05 |
INSUFFICIENT_AUTHEN |
| 0x06 |
UNSUPPORTED_REQ |
| 0x07 |
INVALID_OFFSET |
| 0x08 |
INSUFFICIENT_AUTHOR |
| 0x09 |
PREPARE_QUEUE_FULL |
| 0x0a |
ATTR_NOT_FOUND |
| 0x0b |
ATTR_NOT_LONG |
| 0x0c |
INSUFFICIENT_KEY_SIZE |
| 0x0d |
INVALID_VALUE_SIZE |
| 0x0e |
UNLIKELY_ERROR |
| 0x0f |
INSUFFICIENT_ENCRYPTION |
| 0x10 |
UNSUPPORTED_GRP_TYPE |
| 0x11 |
INSUFFICIENT_RESOURCES |
| 0x80 |
INVALID_VALUE |
|
|---|
|
|---|
ATT_ExchangeMTUReq
| Opcode: | 0x0502 |
|---|
| Event Description: |
|---|
| | ATT Exchange MTU Request. |
Event Parameters
| Status: |
| Size: | 1 byte(s)
|
|---|
| Range: |
| Value |
Description |
|---|
| 0x00 |
SUCCESS |
| 0x12 |
bleIncorrectMode |
| 0x02 |
INVALIDPARAMETER |
|
|---|
|
|---|
| connectionHandle: |
|---|
| | Connection handle of the link
| Size: | 2 byte(s) |
|---|
| Range: | Any 2 byte value |
|---|
|
| pduLen: | PDU length
| Size: | 1 byte(s) |
|---|
| Range: | Any 1 byte value |
|---|
|
|---|
| clientRxMTU: | Server receive MTU size
|
|---|
ATT_ExchangeMTURsp
| Opcode: | 0x0503 |
|---|
| Event Description: |
|---|
| | ATT Exchange MTU Response. |
Event Parameters
| Status: |
| Size: | 1 byte(s)
|
|---|
| Range: |
| Value |
Description |
|---|
| 0x00 |
SUCCESS |
| 0x12 |
bleIncorrectMode |
| 0x02 |
INVALIDPARAMETER |
|
|---|
|
|---|
| connectionHandle: |
|---|
| | Connection handle of the link
| Size: | 2 byte(s) |
|---|
| Range: | Any 2 byte value |
|---|
|
| pduLen: | PDU length
| Size: | 1 byte(s) |
|---|
| Range: | Any 1 byte value |
|---|
|
|---|
| serverRxMTU: | Server receive MTU size
| Condition: | ( bStatus==0x00 || bStatus==0x16) |
|---|
| Size: | 2 byte(s) |
|---|
| Range: | |
|---|
|
|---|
ATT_FindInfoReq
| Opcode: | 0x0504 |
|---|
| Event Description: |
|---|
| | ATT Find Information Request. |
Event Parameters
| Status: |
| Size: | 1 byte(s)
|
|---|
| Range: |
| Value |
Description |
|---|
| 0x00 |
SUCCESS |
| 0x12 |
bleIncorrectMode |
| 0x02 |
INVALIDPARAMETER |
|
|---|
|
|---|
| connectionHandle: |
|---|
| | Connection handle of the link
| Size: | 2 byte(s) |
|---|
| Range: | Any 2 byte value |
|---|
|
| pduLen: | PDU length
| Size: | 1 byte(s) |
|---|
| Range: | Any 1 byte value |
|---|
|
|---|
| startHandle: | First requested handle number
| Size: | 2 byte(s) |
|---|
| Range: | Any 2 byte value |
|---|
|
|---|
| endHandle: | Last requested handle number
| Size: | 2 byte(s) |
|---|
| Range: | Any 2 byte value |
|---|
|
|---|
ATT_FindInfoRsp
| Opcode: | 0x0505 |
|---|
| Event Description: |
|---|
| | ATT Find Information Response. |
Event Parameters
| Status: |
| Size: | 1 byte(s)
|
|---|
| Range: |
| Value |
Description |
|---|
| 0x00 |
SUCCESS |
| 0x12 |
bleIncorrectMode |
| 0x02 |
INVALIDPARAMETER |
|
|---|
|
|---|
| connectionHandle: |
|---|
| | Connection handle of the link
| Size: | 2 byte(s) |
|---|
| Range: | Any 2 byte value |
|---|
|
| pduLen: | PDU length
| Size: | 1 byte(s) |
|---|
| Range: | Any 1 byte value |
|---|
|
|---|
| format: | Format of information data
| Condition: | ( bStatus==0x00 || bStatus==0x16)
|
|---|
| Size: | 1 byte(s)
|
|---|
| Range: |
| Value |
Description |
|---|
| 0x01 |
HANDLE_BT_UUID_TYPE - handle(s) and 16-bit Bluetooth UUID(s) |
| 0x02 |
HANDLE_UUID_TYPE - handle(s) and 128-bit UUID(s) |
|
|---|
|
|---|
An array of size “(pduLen-1)/(format==0x01 ? 4 : 18)” will be returned containing the parameters starting here:
| handle: | Attribute handle
| Condition: | ( bStatus==0x00 || bStatus==0x16) |
|---|
| Size: | 2 byte(s) |
|---|
| Range: | |
|---|
|
|---|
| uuid: | Characteristic UUID
| Condition: | ( bStatus==0x00 || bStatus==0x16 format==0x01) |
|---|
| Size: | 2 byte(s) |
|---|
| Range: | |
|---|
|
|---|
| uuid: | Characteristic UUID
| Condition: | ( bStatus==0x00 || bStatus==0x16 format==0x02) |
|---|
| Size: | 16 byte(s) |
|---|
| Range: | |
|---|
|
|---|
The array of parameters ends here.
ATT_FindByTypeValueReq
| Opcode: | 0x0506 |
|---|
| Event Description: |
|---|
| | ATT Find By Type Value Request. |
Event Parameters
| Status: |
| Size: | 1 byte(s)
|
|---|
| Range: |
| Value |
Description |
|---|
| 0x00 |
SUCCESS |
| 0x12 |
bleIncorrectMode |
| 0x02 |
INVALIDPARAMETER |
|
|---|
|
|---|
| connectionHandle: |
|---|
| | Connection handle of the link
| Size: | 2 byte(s) |
|---|
| Range: | Any 2 byte value |
|---|
|
| pduLen: | PDU length
| Size: | 1 byte(s) |
|---|
| Range: | Any 1 byte value |
|---|
|
|---|
| startHandle: | First requested handle number
| Size: | 2 byte(s) |
|---|
| Range: | Any 2 byte value |
|---|
|
|---|
| endHandle: | Last requested handle number
| Size: | 2 byte(s) |
|---|
| Range: | Any 2 byte value |
|---|
|
|---|
| type: | 2-octet UUID to find
| Size: | 2 byte(s) |
|---|
| Range: | Any 2 byte value |
|---|
|
|---|
| value: | Attribute value to find
| Condition: | ( pduLen.gt.6) |
|---|
| Size: | pduLen-6 byte(s) |
|---|
| Range: | Any (0 to ATT_MTU_SIZE-7) byte value |
|---|
|
|---|
ATT_FindByTypeValueRsp
| Opcode: | 0x0507 |
|---|
| Event Description: |
|---|
| | ATT Find By Type Value Response |
Event Parameters
| Status: |
| Size: | 1 byte(s)
|
|---|
| Range: |
| Value |
Description |
|---|
| 0x00 |
SUCCESS |
| 0x12 |
bleIncorrectMode |
| 0x02 |
INVALIDPARAMETER |
|
|---|
|
|---|
| connectionHandle: |
|---|
| | Connection handle of the link
| Size: | 2 byte(s) |
|---|
| Range: | Any 2 byte value |
|---|
|
| pduLen: | PDU length
| Size: | 1 byte(s) |
|---|
| Range: | Any 1 byte value |
|---|
|
|---|
An array of size “pduLen/4” will be returned containing the parameters starting here:
| handle: | Found Attribute Handle
| Condition: | ( bStatus==0x00 || bStatus==0x16) |
|---|
| Size: | 2 byte(s) |
|---|
| Range: | |
|---|
|
|---|
| grpEndHandle: | Group End Handle
| Condition: | ( bStatus==0x00 || bStatus==0x16) |
|---|
| Size: | 2 byte(s) |
|---|
| Range: | |
|---|
|
|---|
The array of parameters ends here.
ATT_ReadByTypeReq
| Opcode: | 0x0508 |
|---|
| Event Description: |
|---|
| | ATT Read By Type Request |
Event Parameters
| Status: |
| Size: | 1 byte(s)
|
|---|
| Range: |
| Value |
Description |
|---|
| 0x00 |
SUCCESS |
| 0x12 |
bleIncorrectMode |
| 0x02 |
INVALIDPARAMETER |
|
|---|
|
|---|
| connectionHandle: |
|---|
| | Connection handle of the link
| Size: | 2 byte(s) |
|---|
| Range: | Any 2 byte value |
|---|
|
| pduLen: | PDU length
| Size: | 1 byte(s) |
|---|
| Range: | Any 1 byte value |
|---|
|
|---|
| startHandle: | First requested handle number
| Size: | 2 byte(s) |
|---|
| Range: | Any 2 byte value |
|---|
|
|---|
| endHandle: | Last requested handle number
| Size: | 2 byte(s) |
|---|
| Range: | Any 2 byte value |
|---|
|
|---|
| type: | 2-octet UUID to find
| Condition: | ( pduLen.gt.4) |
|---|
| Size: | pduLen-4 byte(s) |
|---|
| Range: | |
|---|
|
|---|
ATT_ReadByTypeRsp
| Opcode: | 0x0509 |
|---|
| Event Description: |
|---|
| | ATT Read By Type Response. |
Event Parameters
| Status: |
| Size: | 1 byte(s)
|
|---|
| Range: |
| Value |
Description |
|---|
| 0x00 |
SUCCESS |
| 0x12 |
bleIncorrectMode |
| 0x02 |
INVALIDPARAMETER |
|
|---|
|
|---|
| connectionHandle: |
|---|
| | Connection handle of the link
| Size: | 2 byte(s) |
|---|
| Range: | Any 2 byte value |
|---|
|
| pduLen: | PDU length
| Size: | 1 byte(s) |
|---|
| Range: | Any 1 byte value |
|---|
|
|---|
| length: | The size of each attribute handle-value pair
| Condition: | ( bStatus==0x00 || bStatus==0x16) |
|---|
| Size: | 1 byte(s) |
|---|
| Range: | |
|---|
|
|---|
An array of size “(pduLen-1)/length” will be returned containing the parameters starting here:
| handle: | Attribute handle
| Condition: | ( bStatus==0x00 || bStatus==0x16) |
|---|
| Size: | 2 byte(s) |
|---|
| Range: | |
|---|
|
|---|
| value: | Attribute value
| Condition: | ( bStatus==0x00 || bStatus==0x16 length.gt.2) |
|---|
| Size: | length-2 byte(s) |
|---|
| Range: | |
|---|
|
|---|
The array of parameters ends here.
ATT_ReadReq
| Opcode: | 0x050A |
|---|
| Event Description: |
|---|
| | ATT Read Request. |
Event Parameters
| Status: |
| Size: | 1 byte(s)
|
|---|
| Range: |
| Value |
Description |
|---|
| 0x00 |
SUCCESS |
| 0x12 |
bleIncorrectMode |
| 0x02 |
INVALIDPARAMETER |
|
|---|
|
|---|
| connectionHandle: |
|---|
| | Connection handle of the link
| Size: | 2 byte(s) |
|---|
| Range: | Any 2 byte value |
|---|
|
| pduLen: | PDU length
| Size: | 1 byte(s) |
|---|
| Range: | Any 1 byte value |
|---|
|
|---|
| handle: | The handle of the attribute that was read
|
|---|
ATT_ReadRsp
| Opcode: | 0x050B |
|---|
| Event Description: |
|---|
| | ATT Read Response. |
Event Parameters
| Status: |
| Size: | 1 byte(s)
|
|---|
| Range: |
| Value |
Description |
|---|
| 0x00 |
SUCCESS |
| 0x12 |
bleIncorrectMode |
| 0x02 |
INVALIDPARAMETER |
|
|---|
|
|---|
| connectionHandle: |
|---|
| | Connection handle of the link
| Size: | 2 byte(s) |
|---|
| Range: | Any 2 byte value |
|---|
|
| pduLen: | PDU length
| Size: | 1 byte(s) |
|---|
| Range: | Any 1 byte value |
|---|
|
|---|
| value: | The value of the attribute that was read
| Condition: | ( bStatus==0x00 || bStatus==0x16) |
|---|
| Size: | pduLen byte(s) |
|---|
| Range: | |
|---|
|
|---|
ATT_ReadBlobReq
| Opcode: | 0x050C |
|---|
| Event Description: |
|---|
| | ATT Read Blob Request. |
Event Parameters
| Status: |
| Size: | 1 byte(s)
|
|---|
| Range: |
| Value |
Description |
|---|
| 0x00 |
SUCCESS |
| 0x12 |
bleIncorrectMode |
| 0x02 |
INVALIDPARAMETER |
|
|---|
|
|---|
| connectionHandle: |
|---|
| | Connection handle of the link
| Size: | 2 byte(s) |
|---|
| Range: | Any 2 byte value |
|---|
|
| pduLen: | PDU length
| Size: | 1 byte(s) |
|---|
| Range: | Any 1 byte value |
|---|
|
|---|
| handle: | The handle of the attribute that was read
|
|---|
| offset: | The offset of the first byte that was read
|
|---|
ATT_ReadBlobRsp
| Opcode: | 0x050D |
|---|
| Event Description: |
|---|
| | ATT Read Blob Response. |
Event Parameters
| Status: |
| Size: | 1 byte(s)
|
|---|
| Range: |
| Value |
Description |
|---|
| 0x00 |
SUCCESS |
| 0x12 |
bleIncorrectMode |
| 0x02 |
INVALIDPARAMETER |
|
|---|
|
|---|
| connectionHandle: |
|---|
| | Connection handle of the link
| Size: | 2 byte(s) |
|---|
| Range: | Any 2 byte value |
|---|
|
| pduLen: | PDU length
| Size: | 1 byte(s) |
|---|
| Range: | Any 1 byte value |
|---|
|
|---|
| value: | The value of the attribute that was read
| Condition: | ( bStatus==0x00 || bStatus==0x16) |
|---|
| Size: | pduLen byte(s) |
|---|
| Range: | |
|---|
|
|---|
ATT_ReadMultiReq
| Opcode: | 0x050E |
|---|
| Event Description: |
|---|
| | ATT Read Multiple Request. |
Event Parameters
| Status: |
| Size: | 1 byte(s)
|
|---|
| Range: |
| Value |
Description |
|---|
| 0x00 |
SUCCESS |
| 0x12 |
bleIncorrectMode |
| 0x02 |
INVALIDPARAMETER |
|
|---|
|
|---|
| connectionHandle: |
|---|
| | Connection handle of the link
| Size: | 2 byte(s) |
|---|
| Range: | Any 2 byte value |
|---|
|
| pduLen: | PDU length
| Size: | 1 byte(s) |
|---|
| Range: | Any 1 byte value |
|---|
|
|---|
| handles: | A set of two or more attribute handles.
| Size: | pduLen byte(s) |
|---|
| Range: | |
|---|
|
|---|
ATT_ReadMultiRsp
| Opcode: | 0x050F |
|---|
| Event Description: |
|---|
| | ATT Read Multiple Response. |
Event Parameters
| Status: |
| Size: | 1 byte(s)
|
|---|
| Range: |
| Value |
Description |
|---|
| 0x00 |
SUCCESS |
| 0x12 |
bleIncorrectMode |
| 0x02 |
INVALIDPARAMETER |
|
|---|
|
|---|
| connectionHandle: |
|---|
| | Connection handle of the link
| Size: | 2 byte(s) |
|---|
| Range: | Any 2 byte value |
|---|
|
| pduLen: | PDU length
| Size: | 1 byte(s) |
|---|
| Range: | Any 1 byte value |
|---|
|
|---|
| values: | A set of two or more values
| Condition: | ( bStatus==0x00 || bStatus==0x16) |
|---|
| Size: | pduLen byte(s) |
|---|
| Range: | |
|---|
|
|---|
ATT_ReadByGrpTypeReq
| Opcode: | 0x0510 |
|---|
| Event Description: |
|---|
| | ATT Read By Group Type Request. |
Event Parameters
| Status: |
| Size: | 1 byte(s)
|
|---|
| Range: |
| Value |
Description |
|---|
| 0x00 |
SUCCESS |
| 0x12 |
bleIncorrectMode |
| 0x02 |
INVALIDPARAMETER |
|
|---|
|
|---|
| connectionHandle: |
|---|
| | Connection handle of the link
| Size: | 2 byte(s) |
|---|
| Range: | Any 2 byte value |
|---|
|
| pduLen: | PDU length
| Size: | 1 byte(s) |
|---|
| Range: | Any 1 byte value |
|---|
|
|---|
| startHandle: | First requested handle number
| Size: | 2 byte(s) |
|---|
| Range: | Any 2 byte value |
|---|
|
|---|
| endHandle: | Last requested handle number
| Size: | 2 byte(s) |
|---|
| Range: | Any 2 byte value |
|---|
|
|---|
| groupType: | UUID of group to read
| Condition: | ( pduLen.gt.4) |
|---|
| Size: | pduLen-4 byte(s) |
|---|
| Range: | |
|---|
|
|---|
ATT_ReadByGrpTypeRsp
| Opcode: | 0x0511 |
|---|
| Event Description: |
|---|
| | ATT Read By Group Type Response. |
Event Parameters
| Status: |
| Size: | 1 byte(s)
|
|---|
| Range: |
| Value |
Description |
|---|
| 0x00 |
SUCCESS |
| 0x12 |
bleIncorrectMode |
| 0x02 |
INVALIDPARAMETER |
|
|---|
|
|---|
| connectionHandle: |
|---|
| | Connection handle of the link
| Size: | 2 byte(s) |
|---|
| Range: | Any 2 byte value |
|---|
|
| pduLen: | PDU length
| Size: | 1 byte(s) |
|---|
| Range: | Any 1 byte value |
|---|
|
|---|
| length: | The size of each attribute handle-value pair
| Condition: | ( bStatus==0x00 || bStatus==0x16) |
|---|
| Size: | 1 byte(s) |
|---|
| Range: | |
|---|
|
|---|
An array of size “(pduLen-1)/length” will be returned containing the parameters starting here:
| handle: | Attribute Handle
| Condition: | ( bStatus==0x00 || bStatus==0x16) |
|---|
| Size: | 2 byte(s) |
|---|
| Range: | |
|---|
|
|---|
| endGrpHandle: | End Group Handle
| Condition: | ( bStatus==0x00 || bStatus==0x16) |
|---|
| Size: | 2 byte(s) |
|---|
| Range: | |
|---|
|
|---|
| value: | Attribute Value
| Condition: | ( bStatus==0x00 || bStatus==0x16 length.gt.4) |
|---|
| Size: | length-4 byte(s) |
|---|
| Range: | |
|---|
|
|---|
The array of parameters ends here.
ATT_WriteReq
| Opcode: | 0x0512 |
|---|
| Event Description: |
|---|
| | ATT Write Request. |
Event Parameters
| Status: |
| Size: | 1 byte(s)
|
|---|
| Range: |
| Value |
Description |
|---|
| 0x00 |
SUCCESS |
| 0x12 |
bleIncorrectMode |
| 0x02 |
INVALIDPARAMETER |
|
|---|
|
|---|
| connectionHandle: |
|---|
| | Connection handle of the link
| Size: | 2 byte(s) |
|---|
| Range: | Any 2 byte value |
|---|
|
| pduLen: | PDU length
| Size: | 1 byte(s) |
|---|
| Range: | Any 1 byte value |
|---|
|
|---|
| signature: | Whether to include the authentication signature.
| Condition: | ( bStatus==0x00)
|
|---|
| Size: | 1 byte(s)
|
|---|
| Range: |
| Value |
Description |
|---|
| 0x00 |
SIG_NOT_INCLUDED |
| 0x01 |
SIG_VALID |
| 0x02 |
SIG_INVALID |
|
|---|
|
|---|
| command: | Whether this is a Write Command.
| Condition: | ( bStatus==0x00)
|
|---|
| Size: | 1 byte(s)
|
|---|
| Range: |
| Value |
Description |
|---|
| 0x00 |
No |
| 0x01 |
Yes |
|
|---|
|
|---|
| handle: | The handle of the attribute to be written.
| Condition: | ( bStatus==0x00) |
|---|
| Size: | 2 byte(s) |
|---|
| Range: | |
|---|
|
|---|
| value: | The value to be written to the attribute.
| Condition: | ( bStatus==0x00 pduLen.gt.4) |
|---|
| Size: | pduLen-4 byte(s) |
|---|
| Range: | |
|---|
|
|---|
ATT_WriteRsp
| Opcode: | 0x0513 |
|---|
| Event Description: |
|---|
| | ATT Write Response. |
Event Parameters
| Status: |
| Size: | 1 byte(s)
|
|---|
| Range: |
| Value |
Description |
|---|
| 0x00 |
SUCCESS |
| 0x12 |
bleIncorrectMode |
| 0x02 |
INVALIDPARAMETER |
|
|---|
|
|---|
| connectionHandle: |
|---|
| | Connection handle of the link
| Size: | 2 byte(s) |
|---|
| Range: | Any 2 byte value |
|---|
|
| pduLen: | PDU length
| Size: | 1 byte(s) |
|---|
| Range: | Any 1 byte value |
|---|
|
|---|
ATT_PrepareWriteReq
| Opcode: | 0x0516 |
|---|
| Event Description: |
|---|
| | ATT Prepare Write Request. |
Event Parameters
| Status: |
| Size: | 1 byte(s)
|
|---|
| Range: |
| Value |
Description |
|---|
| 0x00 |
SUCCESS |
| 0x12 |
bleIncorrectMode |
| 0x02 |
INVALIDPARAMETER |
|
|---|
|
|---|
| connectionHandle: |
|---|
| | Connection handle of the link
| Size: | 2 byte(s) |
|---|
| Range: | Any 2 byte value |
|---|
|
| pduLen: | PDU length
| Size: | 1 byte(s) |
|---|
| Range: | Any 1 byte value |
|---|
|
|---|
| handle: | The handle of the attribute to be written.
|
|---|
| offset: | The offset of the first byte to be written.
|
|---|
| value: | Part of the value of the attribute to be written.
| Condition: | ( pduLen.gt.4) |
|---|
| Size: | pduLen-4 byte(s) |
|---|
| Range: | |
|---|
|
|---|
ATT_PrepareWriteRsp
| Opcode: | 0x0517 |
|---|
| Event Description: |
|---|
| | ATT Prepare Write Response. |
Event Parameters
| Status: |
| Size: | 1 byte(s)
|
|---|
| Range: |
| Value |
Description |
|---|
| 0x00 |
SUCCESS |
| 0x12 |
bleIncorrectMode |
| 0x02 |
INVALIDPARAMETER |
|
|---|
|
|---|
| connectionHandle: |
|---|
| | Connection handle of the link
| Size: | 2 byte(s) |
|---|
| Range: | Any 2 byte value |
|---|
|
| pduLen: | PDU length
| Size: | 1 byte(s) |
|---|
| Range: | Any 1 byte value |
|---|
|
|---|
| handle: | The handle of the attribute to be written.
| Condition: | ( bStatus==0x00 || bStatus==0x16) |
|---|
| Size: | 2 byte(s) |
|---|
| Range: | |
|---|
|
|---|
| offset: | The offset of the first octet to be Written.
| Condition: | ( bStatus==0x00 || bStatus==0x16) |
|---|
| Size: | 2 byte(s) |
|---|
| Range: | |
|---|
|
|---|
| value: | Part of the value of the attribute to be written.
| Condition: | ( bStatus==0x00 || bStatus==0x16 pduLen.gt.4) |
|---|
| Size: | pduLen-4 byte(s) |
|---|
| Range: | |
|---|
|
|---|
ATT_ExecuteWriteReq
| Opcode: | 0x0518 |
|---|
| Event Description: |
|---|
| | ATT Execute Write Request. |
Event Parameters
| Status: |
| Size: | 1 byte(s)
|
|---|
| Range: |
| Value |
Description |
|---|
| 0x00 |
SUCCESS |
| 0x12 |
bleIncorrectMode |
| 0x02 |
INVALIDPARAMETER |
|
|---|
|
|---|
| connectionHandle: |
|---|
| | Connection handle of the link
| Size: | 2 byte(s) |
|---|
| Range: | Any 2 byte value |
|---|
|
| pduLen: | PDU length
| Size: | 1 byte(s) |
|---|
| Range: | Any 1 byte value |
|---|
|
|---|
| flags: | What to do with pending prepared writes.
| Size: | 1 byte(s)
|
|---|
| Range: |
| Value |
Description |
|---|
| 0x00 |
CANCEL_WRITES |
| 0x01 |
WRITE_VALUES |
|
|---|
|
|---|
ATT_ExecuteWriteRsp
| Opcode: | 0x0519 |
|---|
| Event Description: |
|---|
| | ATT Execute Write Response. |
Event Parameters
| Status: |
| Size: | 1 byte(s)
|
|---|
| Range: |
| Value |
Description |
|---|
| 0x00 |
SUCCESS |
| 0x12 |
bleIncorrectMode |
| 0x02 |
INVALIDPARAMETER |
|
|---|
|
|---|
| connectionHandle: |
|---|
| | Connection handle of the link
| Size: | 2 byte(s) |
|---|
| Range: | Any 2 byte value |
|---|
|
| pduLen: | PDU length
| Size: | 1 byte(s) |
|---|
| Range: | Any 1 byte value |
|---|
|
|---|
ATT_HandleValueNoti
| Opcode: | 0x051B |
|---|
| Event Description: |
|---|
| | ATT Handle Value Notification. |
Event Parameters
| Status: |
| Size: | 1 byte(s)
|
|---|
| Range: |
| Value |
Description |
|---|
| 0x00 |
SUCCESS |
| 0x12 |
bleIncorrectMode |
| 0x02 |
INVALIDPARAMETER |
|
|---|
|
|---|
| connectionHandle: |
|---|
| | Connection handle of the link
| Size: | 2 byte(s) |
|---|
| Range: | Any 2 byte value |
|---|
|
| pduLen: | PDU length
| Size: | 1 byte(s) |
|---|
| Range: | Any 1 byte value |
|---|
|
|---|
| handle: | The handle of the attribute.
|
|---|
| The current value of the attribute.: |
|---|
| |
| Condition: | ( pduLen.gt.2) |
|---|
| Size: | pduLen-2 byte(s) |
|---|
| Range: | |
|---|
|
ATT_HandleValueInd
| Opcode: | 0x051D |
|---|
| Event Description: |
|---|
| | ATT Handle Value Indication. |
Event Parameters
| Status: |
| Size: | 1 byte(s)
|
|---|
| Range: |
| Value |
Description |
|---|
| 0x00 |
SUCCESS |
| 0x12 |
bleIncorrectMode |
| 0x02 |
INVALIDPARAMETER |
|
|---|
|
|---|
| connectionHandle: |
|---|
| | Connection handle of the link
| Size: | 2 byte(s) |
|---|
| Range: | Any 2 byte value |
|---|
|
| pduLen: | PDU length
| Size: | 1 byte(s) |
|---|
| Range: | Any 1 byte value |
|---|
|
|---|
| handle: | The handle of the attribute.
|
|---|
| value: | The current value of the attribute.
| Condition: | ( pduLen.gt.2) |
|---|
| Size: | pduLen-2 byte(s) |
|---|
| Range: | |
|---|
|
|---|
ATT_HandleValueCfm
| Opcode: | 0x051E |
|---|
| Event Description: |
|---|
| | ATT Handle Value Confirmation. |
Event Parameters
| Status: |
| Size: | 1 byte(s)
|
|---|
| Range: |
| Value |
Description |
|---|
| 0x00 |
SUCCESS |
| 0x12 |
bleIncorrectMode |
| 0x02 |
INVALIDPARAMETER |
|
|---|
|
|---|
| connectionHandle: |
|---|
| | Connection handle of the link
| Size: | 2 byte(s) |
|---|
| Range: | Any 2 byte value |
|---|
|
| pduLen: | PDU length
| Size: | 1 byte(s) |
|---|
| Range: | Any 1 byte value |
|---|
|
|---|
ATT_FlowCtrlViolatedEvt_t
| Opcode: | 0x057E |
|---|
| Event Description: |
|---|
| | Sent when ATT flow control is violated on a connection. |
Event Parameters
| Status: |
| Size: | 1 byte(s)
|
|---|
| Range: |
| Value |
Description |
|---|
| 0x00 |
SUCCESS |
| 0x12 |
bleIncorrectMode |
| 0x02 |
INVALIDPARAMETER |
|
|---|
|
|---|
| connectionHandle: |
|---|
| | Connection handle of the link
| Size: | 2 byte(s) |
|---|
| Range: | Any 2 byte value |
|---|
|
| pduLen: | PDU length
| Size: | 1 byte(s) |
|---|
| Range: | Any 1 byte value |
|---|
|
|---|
| opcode: | Opcode of message that caused flow control violation
|
|---|
| pendingOpcode: | Opcode of pending message
|
|---|
ATT_MtuUpdatedEvt
| Opcode: | 0x057F |
|---|
| Event Description: |
|---|
| | Sent when MTU is updated for a connection. |
Event Parameters
| Status: |
| Size: | 1 byte(s)
|
|---|
| Range: |
| Value |
Description |
|---|
| 0x00 |
SUCCESS |
| 0x12 |
bleIncorrectMode |
| 0x02 |
INVALIDPARAMETER |
|
|---|
|
|---|
| connectionHandle: |
|---|
| | Connection handle of the link
| Size: | 2 byte(s) |
|---|
| Range: | Any 2 byte value |
|---|
|
| pduLen: | PDU length
| Size: | 1 byte(s) |
|---|
| Range: | Any 1 byte value |
|---|
|
|---|
| MTU: | New MTU size
|
|---|
