Viewer

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

org.bluetooth.service.automation_io
Last Modified: 2015-07-14 Approved: Yes

Name: Automation IO

Type: org.bluetooth.service.automation_ioDownload / View

Assigned Number: 0x1815


Abstract:

The Automation IO service is used to expose the analog inputs/outputs and digital input/outputs of a generic IO module (IOM).

Service Dependencies

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

GATT Requirements

Sub-Procedure Server Requirement
Write Characteristic Value C1: Mandatory if Digital or Analog with Write property is supported.
Write Without Response C2: Mandatory if the “write without response” characteristic property is supported for either the Digital or Analog characteristics (if any available).
Indications C3: Mandatory if the “indicate” or “notify” characteristic property respectively is supported for either the Digital, Analog or Aggregate characteristic.
Notifications C3:Mandatory if the “indicate” or “notify” characteristic property respectively is supported for either the Digital, Analog or Aggregate characteristic.
Write Characteristic Descriptors C4: Mandatory if indications or notification is supported or if writable characteristics descriptors are supported for at least one supported characteristics.
Read Characteristic Descriptors C5: Mandatory if a Digital characteristic is present.

Transport Dependencies

Transport Supported
Classic true
Low Energy true
High Speed

Error Codes

Name Code Description
Trigger condition value not supported 0x08 An attempt was made to configure a condition value not supported by this Automation IO Server

Service Characteristics

Overview Properties Security Descriptors
Name:
Digital
Description:
The Digital characteristic is used to expose and change the state of an IOM’s digital signals.
Type:
org.bluetooth.characteristic.digital
Requirement:
Conditional
Multiple Instances:
Yes
Conditional Description:

C1:At least one instance of either Digital or Analog characteristics shall be supported

C3:The Indicate and Notify properties are excluded for the Digital and Analog characteristics if the Aggregate characteristic is supported

C4:The Indicate and Notify properties shall not be permitted simultaneously for any supported characteristic

C5:Indicate or Notify property shall be supported only if the Read property is supported for the characteristic

Property Requirement
Read Optional
Write Optional
WriteWithoutResponse Optional
SignedWrite Excluded
Notify Optional
Indicate Optional
WritableAuxiliaries Excluded
Broadcast Excluded
ExtendedProperties Excluded
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:
Characteristic Presentation Format
Type:
org.bluetooth.descriptor.gatt.characteristic_presentation_format
Requirement:
if_multiple_instances_of_same_characteristic
Permission Requirement
Read Mandatory
Write Excluded
Name:
Characteristic User Description
Type:
org.bluetooth.descriptor.gatt.characteristic_user_description
Description:
C2: Write permitted if «writable auxiliaries» is supported in the Characteristic Extended Properties descriptor otherwise read-only.
Requirement:
Optional
Permission Requirement
Read Mandatory
Write C2
Name:
Characteristic Extended Properties
Type:
org.bluetooth.descriptor.gatt.characteristic_extended_properties
Requirement:
Optional
Permission Requirement
Read Mandatory
Write Excluded
Name:
Value Trigger Setting
Type:
org.bluetooth.descriptor.value_trigger_setting
Description:

C3: Excluded if a custom condition is available, otherwise Optional.

C5: Excluded if Indicate or Notify not is defined for the characteristic or for the Aggregate characteristic (if it is used).

Requirement:
Conditional
Permission Requirement
Read Mandatory
Write Mandatory
Name:
Time Trigger Setting
Type:
org.bluetooth.descriptor.time_trigger_setting
Description:

C3: Excluded if a custom condition is available, otherwise Optional.

C4: Excluded if a Value Trigger Descriptor not is defined for the characteristic.

C5: Excluded if Indicate or Notify not is defined for the characteristic or for the Aggregate characteristic (if it is used).

Requirement:
Conditional
Permission Requirement
Read Mandatory
Write Mandatory
Name:
Number of Digitals
Type:
org.bluetooth.descriptor.number_of_digitals
Requirement:
Mandatory
Permission Requirement
Read Mandatory
Write Excluded
Name:
Analog
Description:
The Analog characteristic is used to read or write the value of one of the IOM’s analog signals.
Type:
org.bluetooth.characteristic.analog
Requirement:
Conditional
Multiple Instances:
Yes
Conditional Description:

C1: At least one instance of either Digital or Analog characteristics shall be supported

C3: The Indicate and Notify properties are excluded for the Digital and Analog characteristics if the Aggregate characteristic is supported

C4: The Indicate and Notify properties shall not be permitted simultaneously for any supported characteristic

C5: Indicate or Notify property shall be supported only if the Read property is supported for the characteristic

Property Requirement
Read Optional
Write Optional
WriteWithoutResponse Optional
SignedWrite Excluded
Notify Optional
Indicate Optional
WritableAuxiliaries Excluded
Broadcast Excluded
ExtendedProperties Excluded
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:
Characteristic Presentation Format
Type:
org.bluetooth.descriptor.gatt.characteristic_presentation_format
Requirement:
if_multiple_instances_of_same_characteristic
Permission Requirement
Read Mandatory
Write Excluded
Name:
Characteristic User Description
Type:
org.bluetooth.descriptor.gatt.characteristic_user_description
Description:
C2: Write permitted if «writable auxiliaries» is supported in the Characteristic Extended Properties descriptor otherwise read-only.
Requirement:
Optional
Permission Requirement
Read Mandatory
Write C2
Name:
Characteristic Extended Properties
Type:
org.bluetooth.descriptor.gatt.characteristic_extended_properties
Requirement:
Optional
Permission Requirement
Read Mandatory
Write Excluded
Name:
Value Trigger Setting
Type:
org.bluetooth.descriptor.value_trigger_setting
Description:

C4: Excluded if a custom condition is available otherwise Optional.

C6: Excluded if Indicate or Notify not is defined for the characteristic or for the Aggregate characteristic (if it is used).

Requirement:
Conditional
Permission Requirement
Read Mandatory
Write Mandatory
Name:
Time Trigger Setting
Type:
org.bluetooth.descriptor.time_trigger_setting
Description:

C4: Excluded if a custom condition is available otherwise Optional.

C5: Excluded if a Value Trigger Setting descriptor not is defined for the characteristic.

C6: Excluded if Indicate or Notify not is defined for the characteristic or for the Aggregate characteristic (if it is used).

Requirement:
Conditional
Permission Requirement
Read Mandatory
Write Mandatory
Name:
Valid Range
Type:
org.bluetooth.descriptor.valid_range
Requirement:
Optional
Permission Requirement
Read Mandatory
Write Excluded
Name:
Aggregate
Type:
org.bluetooth.characteristic.aggregate
Requirement:
Conditional
Conditional Description:

C2: Only one instance of the Aggregate characteristic shall exist if the Aggregate characteristic is supported.

C4: The Indicate and Notify properties shall not be permitted simultaneously for any supported characteristic

C5: Indicate or Notify property shall be supported only if the Read property is supported for the characteristic

Property Requirement
Read Optional
Write Excluded
WriteWithoutResponse Excluded
SignedWrite Excluded
Notify Optional
Indicate Optional
WritableAuxiliaries Excluded
Broadcast Excluded
ExtendedProperties Excluded
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