GAIA Control Demo Application For iOS: User Guide

Qualcomm Technologies, Inc.
GAIA Control Demo Application for iOS

User Guide
80-CT528-1 Rev AC
August 24, 2018
For additional information or to submit technical questions, go to: https://createpoint.qti.qualcomm.com
Confidential and Proprietary – Qualcomm Technologies, Inc.
NO PUBLIC DISCLOSURE PERMITTED: Please report postings of this document on public servers or websites to:
DocCtrlAgent@qualcomm.com.
Restricted Distribution: Not to be distributed to anyone who is not an employee of either Qualcomm Technologies, Inc. or its affiliated
companies without the express approval of Qualcomm Configuration Management.
Not to be used, copied, reproduced, or modified in whole or in part, nor its contents revealed in any manner to others without the express
written permission of Qualcomm Technologies, Inc.
All Qualcomm products mentioned herein are products of Qualcomm Technologies, Inc. and/or its subsidiaries.
Qualcomm is a trademark of Qualcomm Incorporated, registered in the United States and other countries. Other product and brand names
may be trademarks or registered trademarks of their respective owners.
This technical data may be subject to U.S. and international export, re-export, or transfer (“export”) laws. Diversion contrary to U.S. and
international law is strictly prohibited.
Qualcomm Technologies, Inc.

5775 Morehouse Drive
San Diego, CA 92121
U.S.A.
© 2017-2018 Qualcomm Technologies, Inc. and/or its subsidiaries. All rights reserved.
Revision history
Revision Date Description

1 May 2017 Original publication of this document. Alternative document
number to CS-00332450-UG.
AA 09 November 2017 Updated with Qualcomm branding. DCN updated to use Agile
number.
Added Heart Rate feature and some minor corrections.
AB 22 November 2017 Updated to include User EQ and Mac OSX changes (iTunes)
for version 1.4.9.
AC August 2018 Updates for Data Length Extension support, updated images.
Prepared for ADK 6.3 release.
80-CT528-1 Rev AC Confidential and Proprietary – Qualcomm Technologies, Inc. 2

MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION
Contents
1 Application overview ............................................................................................................ 4

1.1 Minimum requirements ..............................................................................................................................4
1.2 Development tools .....................................................................................................................................4
1.3 Application composition .............................................................................................................................4
2 Use the GAIA Control Demo Application ............................................................................ 5

2.1 Select a device ..........................................................................................................................................5
2.2 Over the air updates ..................................................................................................................................6
2.3 Find my phone ......................................................................................................................................... 10
2.4 Find my headset ...................................................................................................................................... 11
2.5 Proximity alerts ........................................................................................................................................ 13
2.6 Heart Rate Service................................................................................................................................... 15
2.7 GAIA features .......................................................................................................................................... 16
2.7.1 LED control ............................................................................................................................. 16
2.7.2 Remote control ....................................................................................................................... 16
2.7.3 TWS........................................................................................................................................ 17
2.7.4 Equaliser................................................................................................................................. 18
2.7.5 User EQ .................................................................................................................................. 19
Figures
Figure 2-1 Selection of a device .....................................................................................................................................5

Figure 2-6: File transfer complete during an update.......................................................................................................8
Figure 2-10 Find my phone service disabled ............................................................................................................... 10
Figure 2-11 Find my phone service enabled ................................................................................................................ 10
Figure 2-12 Set up the alert level with Light Blue software for Mac OSX ..................................................................... 11
Figure 2-13 Find my phone service alerting ................................................................................................................. 11
Figure 2-14 Find my headset ....................................................................................................................................... 12
Figure 2-15 Find my headset alert in progress ............................................................................................................. 12
Figure 2-16 Proximity alerts ......................................................................................................................................... 13
Figure 2-17 Proximity alert in progress ........................................................................................................................ 14
Figure 2-18 Heart Rate Service.................................................................................................................................... 15
Figure 2-19 LED control, LED disabled ........................................................................................................................ 16
Figure 2-20 LED control, LED enabled ........................................................................................................................ 16
Figure 2-21 Remote control ......................................................................................................................................... 16
Figure 2-22 True Wireless Stereo ................................................................................................................................ 17
Figure 2-23 Equaliser ................................................................................................................................................... 18
Figure 2-24 User EQ .................................................................................................................................................... 19
80-CT528-1 Rev AC Confidential and Proprietary – Qualcomm Technologies, Inc. 3

1 Application overview
This document describes how to use the Qualcomm GAIA (Generic Application Interface
Architecture) Control Demo Application for iOS v1.5.
This example application controls an audio device that uses the Qualcomm GAIA protocol to
communicate GAIA features and GATT attributes for other Bluetooth low energy technology
features, over BR/EDR or Bluetooth low energy.
1.1 Minimum requirements

The GAIA Control Demo Application v1.5 is compatible with iOS 8.0 and later versions.
1.2 Development tools

The GAIA Control Demo Application v1.5 is developed using Objective-C, Xcode 8.1, and iOS
frameworks.
1.3 Application composition

The GAIA Control Demo Application project comprises the following modules:
■ GaiaControl: The main application.
■ BTLibrary: A Bluetooth helper library, which accelerates the use of the Core Bluetooth
library.
■ GaiaLibrary: The library to manage operations over the GAIA protocol.
■ HealthDemo: A secondary application that implements GATT health Services which are used
in the main application.
80-CT528-1 Rev AC Confidential and Proprietary – Qualcomm Technologies International, Ltd. 4

2 Use the GAIA Control Demo Application
Once the application is launched you will presented with a list of nearby devices.
When connecting to your device for the first time, the pairing mode must be activated on the
audio device for this to succeed.
2.1 Select a device
Figure 2-1 Selection of a device

Use the GAIA Control Demo Application
2.2 Over the air updates

With the GAIA Control Demo Application installed on an iOS device.
1. Add an upgrade file to the GAIA Control Demo App using iTunes:
2. The connected device advertises available Bluetooth Smart services. Tap Update Service:

3. The upgrade file or files uploaded from iTunes are listed. Tap the upgrade file or files
required:
4. If the device supports enhanced transfer rates then these can be configured.
Pressing start will begin the over the air update.

5. Once the upgrade is started a progress and estimated time of completion will be shown.
6. When the upgrade file transfer completes, a prompt shows. Tap OK to continue or tap cancel
to abort the upgrade.
Figure 2-2: File transfer complete during an update
7. After validating the processing of the upgrade, the device reboots. The GAIA Control Demo
Application automatically reconnects with the device when it is ready.

8. Depending on the content of the upgrade file, a few dialog confirmations to continue the
process might appear. Confirm the process to continue the update.
9. The GAIA Control Demo Application confirms when the upgrade file is committed to the
device.

2.3 Find my phone

The service is used to locate a lost phone by playing a tone on it.
Once activated the peripheral service waits for the alert to be set. In the GAIA Control Demo
Application, a tone is played once.
Figure 2-3 Find my phone service disabled
Figure 2-4 Find my phone service enabled
To test the service, connect to your phone and set the alert level:
□ 0x00 = Off
□ 0x01 = Mild and high

Figure 2-5 Set up the alert level with Light Blue software for Mac OSX
Figure 2-6 Find my phone service alerting
The alert service is activated.
2.4 Find my headset

Tap the activate button and the headset starts playing a tone.

Figure 2-7 Find my headset
Figure 2-8 Find my headset alert in progress

2.5 Proximity alerts

The Proximity feature gives access to the controls and monitoring information define by the
Proximity GATT Profile. This profile defines the behavior of the connected device when one
device moves away from the second one or when they come closer. It also defines the behavior
when the connection is dropped, lost, or when the distance between both increases above a
defined level.
Figure 2-9 Proximity alerts
The Link Loss alert level defines the strength of the alert on the connected device when the
connection is dropped.
The alert levels are:
None: deactivates the alert when the connection is dropped or lost.
Mild: activates an alert when the connection is dropped or lost.
High: activates the strongest alert when the connection is dropped or lost.

Figure 2-10 Proximity alert in progress
Once the RSSI value drops below the threshold a tone will be triggered.

2.6 Heart Rate Service
Figure 2-11 Heart Rate Service
This screen shows all the information available from the audio device regarding the GATT Heart
Rate Profile:
 The heart rate measurement, in beats per minute notified by the device (if supported).
 The energy accumulated since the last reset of the device known as energy expended, in
kilojoules.
 Inform if the body sensor is in contact with the user (if known). The last RR intervals sent
by the device.
 The location of the body sensor.
When this screen is displayed, the application automatically subscribes to the notifications of the
GATT Heart Rate Profile. As per the profile specification, the device notifies this information
regularly. The application unsubscribes when the user kills the application or when the user
comes back to the main view.

2.7 GAIA features
2.7.1 LED control
Figure 2-12 LED control, LED disabled
Figure 2-13 LED control, LED enabled
2.7.2 Remote control
Figure 2-14 Remote control

2.7.3 TWS
Figure 2-15 True Wireless Stereo
Each speaker related to the connected device appears and the speaker mode can be controlled: stereo,
left channel, right channel, mix, or no mode. Also, the volume of each speaker can be controlled if
supported.
The selection of a speaker as stereo, left, right selects automatically the corresponding mode of
speakers.

2.7.4 Equaliser
Figure 2-16 Equaliser

2.7.5 User EQ
Figure 2-17 User EQ
On this screen it is possible to change the general master gain value of the bank and to
customize the different bands by selecting a filter and changing:
 The quality filter
 The frequency filter
 The gain filter values
Selecting a filter changes the range of the frequency, quality and gain as shown below.
Filter Type Frequency Gain Quality

Master Gain Unavailable -36 dB to +12 dB Unavailable
First order high pass, all pass, and low pass 0.3 Hz to 20 kHz Unavailable Unavailable
Second order high pass, all pass, and low pass 40 Hz to 20 kHz Unavailable 0.25 to 2.0
First order low shelf, high shelf and tilt 20 Hz to 20 kHz -12 dB to +12 dB Unvailable
Second order low shelf, high shelf and tilt 40 Hz to 20 kHz -12 dB to +12 dB 0.25 to 2.0
Parametric Equalizer 20 Hz to 20 kHz -36 dB to +12 dB 0.25 to 8.0

Terms and definitions
Term Definition
Bluetooth Set of technologies providing audio and data transfer over short-range radio
connections
Demo Application Example code and libraries for an application for development purposes.
NOTE: In this document “Application” does not have the meaning given in
the Apple Developer License Agreement.
GAIA Generic Application Interface Architecture

GATT Generic ATTribute protocol
LE Low Energy
LED Light Emitting Diode
TWS True Wireless Stereo


GAIA Control Demo Application For iOS: User Guide

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

GAIA Control Demo Application For iOS: User Guide

Uploaded by

Copyright:

Available Formats

Qualcomm Technologies, Inc.

GAIA Control Demo Application for iOS

For additional information or to submit technical questions, go to: https://createpoint.qti.qualcomm.com

Confidential and Proprietary – Qualcomm Technologies, Inc.

Qualcomm Technologies, Inc.

Revision Date Description

80-CT528-1 Rev AC Confidential and Proprietary – Qualcomm Technologies, Inc. 2

1 Application overview ............................................................................................................ 4

2 Use the GAIA Control Demo Application ............................................................................ 5

Figure 2-1 Selection of a device .....................................................................................................................................5

80-CT528-1 Rev AC Confidential and Proprietary – Qualcomm Technologies, Inc. 3

1.1 Minimum requirements

1.2 Development tools

1.3 Application composition

80-CT528-1 Rev AC Confidential and Proprietary – Qualcomm Technologies International, Ltd. 4

2.1 Select a device

Figure 2-1 Selection of a device

80-CT528-1 Rev AC Confidential and Proprietary – Qualcomm Technologies International, Ltd. 5

2.2 Over the air updates

80-CT528-1 Rev AC Confidential and Proprietary – Qualcomm Technologies International, Ltd. 6

80-CT528-1 Rev AC Confidential and Proprietary – Qualcomm Technologies International, Ltd. 7

Figure 2-2: File transfer complete during an update

80-CT528-1 Rev AC Confidential and Proprietary – Qualcomm Technologies International, Ltd. 8

80-CT528-1 Rev AC Confidential and Proprietary – Qualcomm Technologies International, Ltd. 9

2.3 Find my phone

Figure 2-3 Find my phone service disabled

Figure 2-4 Find my phone service enabled

80-CT528-1 Rev AC Confidential and Proprietary – Qualcomm Technologies International, Ltd. 10

Figure 2-6 Find my phone service alerting

The alert service is activated.

2.4 Find my headset

80-CT528-1 Rev AC Confidential and Proprietary – Qualcomm Technologies International, Ltd. 11

Figure 2-7 Find my headset

Figure 2-8 Find my headset alert in progress

80-CT528-1 Rev AC Confidential and Proprietary – Qualcomm Technologies International, Ltd. 12

2.5 Proximity alerts

Figure 2-9 Proximity alerts

80-CT528-1 Rev AC Confidential and Proprietary – Qualcomm Technologies International, Ltd. 13

Figure 2-10 Proximity alert in progress

80-CT528-1 Rev AC Confidential and Proprietary – Qualcomm Technologies International, Ltd. 14

2.6 Heart Rate Service

Figure 2-11 Heart Rate Service

80-CT528-1 Rev AC Confidential and Proprietary – Qualcomm Technologies International, Ltd. 15

2.7 GAIA features

2.7.1 LED control

Figure 2-12 LED control, LED disabled

Figure 2-13 LED control, LED enabled

2.7.2 Remote control

Figure 2-14 Remote control

80-CT528-1 Rev AC Confidential and Proprietary – Qualcomm Technologies International, Ltd. 16

Figure 2-15 True Wireless Stereo

80-CT528-1 Rev AC Confidential and Proprietary – Qualcomm Technologies International, Ltd. 17

Figure 2-16 Equaliser

80-CT528-1 Rev AC Confidential and Proprietary – Qualcomm Technologies International, Ltd. 18

Figure 2-17 User EQ

 The quality filter

 The frequency filter

 The gain filter values

Filter Type Frequency Gain Quality

80-CT528-1 Rev AC Confidential and Proprietary – Qualcomm Technologies International, Ltd. 19

GAIA Generic Application Interface Architecture

80-CT528-1 Rev AC Confidential and Proprietary – Qualcomm Technologies International, Ltd. 20

You might also like