Viewer

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

org.bluetooth.service.human_interface_device
Last Modified: 2011-11-23 Approved: Yes

Name: Human Interface Device

Type: org.bluetooth.service.human_interface_deviceDownload / View

Assigned Number: 0x1812


Abstract:

This service exposes the HID reports and other HID data intended for HID Hosts and HID Devices.

Summary:

The HID Service exposes characteristics required for a HID Device to transfer HID report descriptors and reports to a HID Host. This also exposes the characteristics for a HID Host to write to a Device. The Human Interface Device Service is instantiated as a Primary Service.

Service Dependencies

This service has no dependencies on other GATT-based services.

GATT Requirements

Sub-Procedure Server Requirement
Read Long Characteristic Value Mandatory
Write Without Response Mandatory
Write Characteristic Value Mandatory
Notifications Mandatory
Read Characteristic Descriptors Mandatory
Write Characteristic Descriptors Mandatory

Transport Dependencies

Transport Supported
Classic false
Low Energy true
High Speed

Error Codes

This service does not define any application error codes that are used in Attribute Protocol.

Service Characteristics

Overview Properties Security Descriptors
Name:
Protocol Mode
Description:
The Protocol Mode characteristic is used to expose the current protocol mode of the HID Service with which it is associated, or to set the desired protocol mode of the HID Service

Only a single instance of this characteristic shall exist as part of the HID Service.

C4: Mandatory for HID Devices supporting Boot Protocol Mode, otherwise optional.

Type:
org.bluetooth.characteristic.protocol_mode
Requirement:
C4
Property Requirement
Read Mandatory
Write Excluded
WriteWithoutResponse Mandatory
SignedWrite Excluded
Notify Excluded
Indicate Excluded
WritableAuxiliaries Excluded
Broadcast Excluded
ExtendedProperties
None None
Name:
Report
Description:

The Report characteristic is used to exchange data between a HID Device and a HID Host.

Note: Mandatory to support at least one Report Type (Input Report, Output Report, or Feature Report) if the Report characteristic is supported.

Type:
org.bluetooth.characteristic.report
Requirement:
Optional
Conditional Description:
For Input Reports:
Property Requirement
Read Mandatory
Write Optional
WriteWithoutResponse Excluded
SignedWrite Excluded
Notify Mandatory
Indicate Excluded
WritableAuxiliaries Excluded
Broadcast Excluded
ExtendedProperties
Conditional Description:
For Output Reports:
Property Requirement
Read Mandatory
Write Mandatory
WriteWithoutResponse Mandatory
SignedWrite Excluded
Notify Excluded
Indicate Excluded
WritableAuxiliaries Excluded
Broadcast Excluded
ExtendedProperties
Conditional Description:
For Feature Reports:
Property Requirement
Read Mandatory
Write Mandatory
WriteWithoutResponse Excluded
SignedWrite Excluded
Notify Excluded
Indicate Excluded
WritableAuxiliaries Excluded
Broadcast Excluded
ExtendedProperties
None
Overview Permissions
Name:
Client Characteristic Configuration
Type:
org.bluetooth.descriptor.gatt.client_characteristic_configuration
Requirement:
if_notify_or_indicate_supported
Permission Requirement
Read Mandatory
Write Mandatory
Name:
Report Reference
Type:
org.bluetooth.descriptor.report_reference
Description:
The Report Reference characteristic descriptor is used to provide the Report ID and Report Type for the Report characteristic value.
Requirement:
if_characteristic_supported
Permission Requirement
Read Mandatory
Write Excluded
Name:
Report Map
Description:
The Report Map characteristic value contains formatting and other information for Input Report, Output Report and Feature Report data transferred between a HID Device and HID Host.
Type:
org.bluetooth.characteristic.report_map
Requirement:
Mandatory
Property Requirement
Read Mandatory
Write Excluded
WriteWithoutResponse Excluded
SignedWrite Excluded
Notify Excluded
Indicate Excluded
WritableAuxiliaries Excluded
Broadcast Excluded
ExtendedProperties
None
Overview Permissions
Name:
External Report Reference
Type:
org.bluetooth.descriptor.external_report_reference
Requirement:
Optional
Permission Requirement
Read Mandatory
Write Excluded
Name:
Boot Keyboard Input Report
Description:

The Boot Report Reference characteristic is used to provide HID Hosts operating in Boot Protocol Mode with a simplified method of discovering certain HID Service characteristics. Only a single instance of this characteristic exists as part of the HID Service.

C2: Mandatory for HID Devices operating as keyboards, else excluded.

Type:
org.bluetooth.characteristic.boot_keyboard_input_report
Requirement:
C2
Property Requirement
Read Mandatory
Write Optional
WriteWithoutResponse Excluded
SignedWrite Excluded
Notify Mandatory
Indicate Excluded
WritableAuxiliaries Excluded
Broadcast Excluded
ExtendedProperties
None
Overview Permissions
Name:
Client Characteristic Configuration
Type:
org.bluetooth.descriptor.gatt.client_characteristic_configuration
Requirement:
Mandatory
Permission Requirement
Read Mandatory
Write Mandatory
Name:
Boot Keyboard Output Report
Description:

The Boot Report Reference characteristic is used to provide HID Hosts operating in Boot Protocol Mode with a simplified method of discovering certain HID Service characteristics. Only a single instance of this characteristic exists as part of the HID Service.

C2: Mandatory for HID Devices operating as keyboards, else excluded.

Type:
org.bluetooth.characteristic.boot_keyboard_output_report
Requirement:
C2
Property Requirement
Read Mandatory
Write Mandatory
WriteWithoutResponse Mandatory
SignedWrite Excluded
Notify Excluded
Indicate Excluded
WritableAuxiliaries Excluded
Broadcast Excluded
ExtendedProperties
None None
Name:
Boot Mouse Input Report
Description:

The Boot Report Reference characteristic is used to provide HID Hosts operating in Boot Protocol Mode with a simplified method of discovering certain HID Service characteristics. Only a single instance of this characteristic exists as part of the HID Service.

C3:Mandatory for HID Devices operating as mice, else excluded.

Type:
org.bluetooth.characteristic.boot_mouse_input_report
Requirement:
C3
Property Requirement
Read Mandatory
Write Optional
WriteWithoutResponse Excluded
SignedWrite Excluded
Notify Mandatory
Indicate Excluded
WritableAuxiliaries Excluded
Broadcast Excluded
ExtendedProperties
None
Overview Permissions
Name:
Client Characteristic Configuration
Type:
org.bluetooth.descriptor.gatt.client_characteristic_configuration
Requirement:
Mandatory
Permission Requirement
Read Mandatory
Write Mandatory
Name:
HID Information
Description:
The HID Information characteristic is used to hold a set of values known as the HID Device’s HID Attributes
Type:
org.bluetooth.characteristic.hid_information
Requirement:
Mandatory
Property Requirement
Read Mandatory
Write Excluded
WriteWithoutResponse Excluded
SignedWrite Excluded
Notify Excluded
Indicate Excluded
WritableAuxiliaries Excluded
Broadcast Excluded
ExtendedProperties
None None
Name:
HID Control Point
Description:
The HID Control Point characteristic is a control-point attribute that defines the following HID Commands when written:

• Suspend ( Refer to Section 7.4.2, Bluetooth HID Profile Specification 1.0)

• Exit Suspend (Refer to Section 7.4.2, Bluetooth HID Profile Specification 1.0)

There are no response codes defined for the Suspend and Exit Suspend commands.
Type:
org.bluetooth.characteristic.hid_control_point
Requirement:
Mandatory
Property Requirement
Read Excluded
Write Excluded
WriteWithoutResponse Mandatory
SignedWrite Excluded
Notify Excluded
Indicate Excluded
WritableAuxiliaries Excluded
Broadcast Excluded
ExtendedProperties
None None