Viewer

​The material contained on this page is informative only. Authoritative compliance information is contained in the applicable Bluetooth specification.

org.bluetooth.service.object_transfer
Last Modified: 2015-11-17 Approved: Yes

Name: Object Transfer Service

Type: org.bluetooth.service.object_transferDownload / View

Assigned Number: 0x1825


Abstract:

This service provides management and control features supporting bulk data transfers which occur via a separate L2CAP connection oriented channel. The Client is enabled to create and delete objects and to execute an action using the currently selected object. The selected object can be written, updated or read via an Object Transfer Channel opened by the Client. The generation of a checksum covering a part or the whole of the object contents is included as an optional feature. This service provides a general method for a Client to select and initiate the transfer of any type of object.

Summary:

.

Service Dependencies

This service is not dependent upon any other services.

GATT Requirements

Sub-Procedure Server Requirement
Write Characteristic Value Mandatory
Read Characteristic Descriptor Mandatory
Write Characteristic Descriptor Mandatory
Indication Mandatory
Read Long Characteristic Value C1
Write Long Characteristic Value C2
C1: Mandatory if the Server supports an Object Name characteristic value that may exceed (ATT_MTU-1) octets in length, where ATT_MTU is the default size for the transport being used; optional otherwise. C2: Mandatory if the Server supports an Object Name characteristic value that may exceed (ATT_MTU-3) octets in length, where ATT_MTU is the default size for the transport being used, and the characteristic is writable; optional otherwise.

Transport Dependencies

Transport Supported
Classic true
Low Energy true
High Speed true

Error Codes

Name Code Description
Write Request Rejected 0x80 An attempt was made to write a value that is invalid or not supported by this Server for a reason other than the attribute permissions.
Object Not Selected 0x81 An attempt was made to read or write to an Object Metadata characteristic while the Current Object was an Invalid Object (see Section 1.8 in the PDF sepcification).
Concurrency Limit Exceeded 0x82 The Server is unable to service the Read Request or Write Request because it exceeds the concurrency limit of the service.
Object Name Already Exists 0x83 The requested object name was rejected because the name was already in use by an existing object on the Server.

Service Characteristics

Overview Properties Security Descriptors
Name:
OTS Feature
Type:
org.bluetooth.characteristic.ots_feature
Requirement:
Mandatory
Property Requirement
Read Mandatory
Write Excluded
WriteWithoutResponse Excluded
SignedWrite Excluded
Notify Excluded
Indicate Excluded
WritableAuxiliaries Excluded
Broadcast Excluded
ExtendedProperties Excluded

Encryption is mandatory

None
Name:
Object Name
Description:
C1:Mandatory if the Server is capable of storing more than one object within the context of this instance of the service; optional otherwise. C3:Mandatory if the OACP Create op code is supported; optional otherwise.
Type:
org.bluetooth.characteristic.object_name
Requirement:
C1
Property Requirement
Read Mandatory
Write C3
WriteWithoutResponse Excluded
SignedWrite Excluded
Notify Excluded
Indicate Excluded
WritableAuxiliaries Excluded
Broadcast Excluded
ExtendedProperties Excluded

Encryption is mandatory

None
Name:
Object Type
Type:
org.bluetooth.characteristic.object_type
Requirement:
Mandatory
Property Requirement
Read Mandatory
Write Excluded
WriteWithoutResponse Excluded
SignedWrite Excluded
Notify Excluded
Indicate Excluded
WritableAuxiliaries Excluded
Broadcast Excluded
ExtendedProperties Excluded

Encryption is mandatory

None
Name:
Object Size
Type:
org.bluetooth.characteristic.object_size
Requirement:
Mandatory
Property Requirement
Read Mandatory
Write Excluded
WriteWithoutResponse Excluded
SignedWrite Excluded
Notify Excluded
Indicate Excluded
WritableAuxiliaries Excluded
Broadcast Excluded
ExtendedProperties Excluded

Encryption is mandatory

None
Name:
Object First-Created
Description:
C3: Mandatory if the OACP Create op code is supported; optional otherwise.
Type:
org.bluetooth.characteristic.object_first_created
Requirement:
Optional
Property Requirement
Read Mandatory
Write C3
WriteWithoutResponse Excluded
SignedWrite Excluded
Notify Excluded
Indicate Excluded
WritableAuxiliaries Excluded
Broadcast Excluded
ExtendedProperties Excluded

Encryption is mandatory

None
Name:
Object Last-Modified
Description:
C4: Mandatory if the Server does not have access to a real time clock; excluded otherwise.
Type:
org.bluetooth.characteristic.object_last_modified
Requirement:
Optional
Property Requirement
Read Mandatory
Write C4
WriteWithoutResponse Excluded
SignedWrite Excluded
Notify Excluded
Indicate Excluded
WritableAuxiliaries Excluded
Broadcast Excluded
ExtendedProperties Excluded

Encryption is mandatory

None
Name:
Object ID
Description:
C1: Mandatory if the Server is capable of storing more than one object; excluded otherwise.
Type:
org.bluetooth.characteristic.object_id
Requirement:
C1
Property Requirement
Read Mandatory
Write Excluded
WriteWithoutResponse Excluded
SignedWrite Excluded
Notify Excluded
Indicate Excluded
WritableAuxiliaries Excluded
Broadcast Excluded
ExtendedProperties Excluded

Encryption is mandatory

None
Name:
Object Properties
Type:
org.bluetooth.characteristic.object_properties
Requirement:
Mandatory
Property Requirement
Read Mandatory
Write Optional
WriteWithoutResponse Excluded
SignedWrite Excluded
Notify Excluded
Indicate Excluded
WritableAuxiliaries Excluded
Broadcast Excluded
ExtendedProperties Excluded

Encryption is mandatory

None
Name:
Object Action Control Point
Type:
org.bluetooth.characteristic.object_action_control_point
Requirement:
Mandatory
Property Requirement
Read Excluded
Write Mandatory
WriteWithoutResponse Excluded
SignedWrite Excluded
Notify Excluded
Indicate Mandatory
WritableAuxiliaries Excluded
Broadcast Excluded
ExtendedProperties Excluded

Encryption is mandatory

None
Name:
Object List Control Point
Description:
C1:Mandatory if the Server is capable of storing more than one object within the context of this instance of the service; optional otherwise.
Type:
org.bluetooth.characteristic.object_list_control_point
Requirement:
C1
Property Requirement
Read Excluded
Write Mandatory
WriteWithoutResponse Excluded
SignedWrite Excluded
Notify Excluded
Indicate Mandatory
WritableAuxiliaries Excluded
Broadcast Excluded
ExtendedProperties Excluded

Encryption is mandatory

None
Name:
Object List Filter
Description:
C2:Optional if the Server is capable of storing more than one object; excluded otherwise.
Type:
org.bluetooth.characteristic.object_list_filter
Requirement:
C2
Property Requirement
Read Mandatory
Write Mandatory
WriteWithoutResponse Excluded
SignedWrite Excluded
Notify Excluded
Indicate Excluded
WritableAuxiliaries Excluded
Broadcast Excluded
ExtendedProperties Excluded

Encryption is mandatory

None
Name:
Object Changed
Type:
org.bluetooth.characteristic.object_changed
Requirement:
Optional
Property Requirement
Read Excluded
Write Excluded
WriteWithoutResponse Excluded
SignedWrite Excluded
Notify Excluded
Indicate Mandatory
WritableAuxiliaries Excluded
Broadcast Excluded
ExtendedProperties Excluded

Encryption is mandatory

None