CSR BlueCore ADK 3.0 Manuale utente

Page 1 of 28

www.csr.com

ADK 3.0 Subwoofer

User Guide

Issue 1

BlueCore®

Page 2 of 28

www.csr.com

BlueCore ADK 3.0 Subwoofer User Guide

Document History

Revision

Date

History

26 FEB 14

Original publication of this document.

Contacts

General information www.csr.com

Information on this product [email protected]

Customer support for this product www.csrsupport.com

More detail on compliance and standards [email protected]

Help with this document [email protected]

Trademarks, Patents and Licences

Unless otherwise stated, words and logos marked with ™ or ® are trademarks registered or owned by CSR plc

and/or its affiliates.

Bluetooth® and the Bluetooth logos are trademarks owned by Bluetooth SIG, Inc. and licensed to CSR.

Other products, services and names used in this document may have been trademarked by their respective owners.

The publication of this information does not imply that any licence is granted under any patent or other rights owned

by CSR plc or its affiliates.

CSR reserves the right to make technical changes to its products as part of its development programme.

While every care has been taken to ensure the accuracy of the contents of this document, CSR cannot accept

responsibility for any errors.

Life Support Policy and Use in Safety-critical Compliance

CSR’s products are not authorised for use in life-support or safety-critical applications. Use in such applications is

done at the sole discretion of the customer. CSR will not warrant the use of its devices in such applications.

Performance and Conformance

Refer to www.csrsupport.com for compliance and conformance to standards information.

Page 3 of 28

www.csr.com

BlueCore ADK 3.0 Subwoofer User Guide

Contents

Document History .........................................................................................................................................................2

Contacts........................................................................................................................................................................2

Trademarks, Patents and Licences ..............................................................................................................................2

Life Support Policy and Use in Safety-critical Compliance............................................................................................2

Performance and Conformance....................................................................................................................................2

Contents .......................................................................................................................................................................3

Tables, Figures and Equations.....................................................................................................................................3

1. Introduction ........................................................................................................................................................5

2. Hardware ...........................................................................................................................................................6

3. Getting Started...................................................................................................................................................7

3.1. Supported Development Platforms.................................................................................................................7

3.2. Building and Flashing the Subwoofer Application...........................................................................................7

3.3. Enabling Debug Output..................................................................................................................................8

3.4. Connecting to another Device via Bluetooth...................................................................................................8

3.5. Building a Soundbar with Subwoofer Support ................................................................................................9

4. Configuration....................................................................................................................................................10

4.1. Application Features (PSKEY_USR0)..........................................................................................................11

4.2. Device ID Configuration (PSKEY_USR1).....................................................................................................13

4.3. Remote Device ID Configuration (PSKEY_USR2) .......................................................................................13

4.4. LED Configuration (PSKEY_USR3) .............................................................................................................14

4.5. Button Configuration (PSKEY_USR4)..........................................................................................................17

4.6. I²S Initialisation Configuration (PSKEY_USR6)............................................................................................18

4.7. I²S Data Configuration (PSKEY_USR7).......................................................................................................20

4.8. SWAT SDP Configuration (PSKEY_USR8)..................................................................................................20

5. The ADK 3.0 Subwoofer Application................................................................................................................21

5.1. Libraries Used ..............................................................................................................................................21

5.2. Application States.........................................................................................................................................22

5.3. Pairing with a Remote Device.......................................................................................................................22

5.4. Connecting with the Paired Device...............................................................................................................23

5.5. Wired Mode..................................................................................................................................................24

5.6. Buttons .........................................................................................................................................................25

5.7. Amplifier Control...........................................................................................................................................25

Document References................................................................................................................................................28

Terms and Definitions.................................................................................................................................................28

Tables, Figures and Equations

Table 3.1: Subwoofer Project Configurations................................................................................................................7

Table 4.1: PS Keys Used by ADK 3.0 Subwoofer Application....................................................................................10

Table 4.2: Application Features PS Key Configuration...............................................................................................12

Table 4.3: Device ID PS Key Configuration................................................................................................................13

Table 4.4: Remote Device ID PS Key Configuration...................................................................................................13

Table 4.5: LED Pattern Data Structure .......................................................................................................................14

Table 4.6: Plot Point Values for the Red LED of the Example Pattern........................................................................15

Table 4.7: Plot Point Values for the Blue LED of the Example Pattern.......................................................................16

Table 4.8: Description of the Example LED Pattern with Populated Values ...............................................................16

Table 4.9: Order LED Patterns Must be Stored to the LED Configuration Data..........................................................17

Table 4.10: Structure Used for the Button Configuration Data....................................................................................17

Page 4 of 28

www.csr.com

BlueCore ADK 3.0 Subwoofer User Guide

Table 5.1: Application States Supported by the ADK 3.0 Application .........................................................................22

Figure 1.1: Example System Block Diagram.................................................................................................................5

Figure 4.1: Example LED Plot for a Pattern Using Two LEDs ....................................................................................15

Figure 5.1: ADK 3.0 Subwoofer Device Connection Establishment Procedure ..........................................................23

Figure 5.2: DAC, AMP & MUTE On/Off Control Mechanism.......................................................................................27

Page 5 of 28

www.csr.com

BlueCore ADK 3.0 Subwoofer User Guide

1. Introduction

The ADK 3.0 Subwoofer application is a single-chip Subwoofer Audio Transfer (SWAT) sink device that enables a

high-quality, robust wireless audio link from a CSR SWAT source capable device.

Configuration of the application is held in PS Keys and simplified for developers by using the ADK Configuration Tool

which allows customisation of the device to meet specific requirements, e.g to:

Assign PIO functionality

Associate device control with different button presses

Configure User and Speaker EQ setting

Configure volume control

Define unique LED patterns for user actions, system states and events

This document describes how the device can be configured and used.

Figure 1.1 shows a possible user case for a multi-channel audio Soundbar (based on a CSR device with an 8670 IC

wireless subwoofer speaker).

Figure 1.1: Example System Block Diagram

Page 6 of 28

www.csr.com

BlueCore ADK 3.0 Subwoofer User Guide

2. Hardware

This document describes the Subwoofer application in ADK 3.0. The Subwoofer application is suitable for use on

CSR8670 or BlueCore5-Multimedia devices.

These use either the CSR Bluetooth example CNS10001v4 (CSR8670) or DEV-PC-1645 (BlueCore5-Multimedia)

design boards.

Notes:

A DEV-PC-1309 interface board and suitable SPI interface, such as a CSR 132 USB-SPI converter, is required

to program and debug both BlueCore5-Multimedia and CSR8670 devices.

2.1.1. Backing Up the Development Board

Before flashing the application to the hardware CSR recommends clearing all the PS Keys from the development

board. This places the board in to a known good state.

All tools are available in the [ADK]\tools\bin sub directory. Alternatively, tools with a GUI, e.g. PSTool and BlueFlash,

can be accessed from the Windows Start menu under ADK\Tools.

Note:

Read the values in the following PS Keys using PSTool and record the values so that they can be restored later:

PSKEY_BD_ADDR

PSKEY_ANA_FTRIM (BlueCore5-Multimedia)

PSKEY_ANA_FTRIM_OFFSET (CSR8670)

PSKEY_CHARGER_CURRENT

PSKEY_CHARGER_TRIM

To clear the board’s PS Keys using BlueFlash:

1. Click Stop Processor and select Flash Erase

2. Check the Erase Persistent Store box and then select OK.

3. Exit BlueFlash.

The application is then ready to be flashed from the xIDE development environment onto the development board.

Page 7 of 28

www.csr.com

BlueCore ADK 3.0 Subwoofer User Guide

3. Getting Started

3.1. Supported Development Platforms

The Subwoofer application is designed so that it runs using default settings on either CSR8670 or BlueCore5-

Multimedia hardware.

There are four project configuration settings to choose from, depending on the hardware and debug requirements,,

the default configuration is to run on the CSR8670 hardware with debug disabled, see Table 3.1.

Table 3.1 lists the available project configurations.

Configuration

Description

Subwoofer-8670-Debug

Select this configuration when using the CSR8670 hardware and debug

output is desired

Subwoofer-8670-Release

Select this configuration when using the CSR8670 hardware and debug

output is not required

Subwoofer-BC5MM-Debug

Select this configuration when using the BlueCore5-Multimedia hardware

and debug output is desired

Subwoofer-BC5MM-Release

Select this configuration when using the BlueCore5-Multimedia hardware

and debug output is not required

Table 3.1: Subwoofer Project Configurations

Note:

When running on BlueCore5-Multimedia Hardware, the Execution mode needs to be set to Native mode, as

Assisted Native mode is not available with this platform.

Assisted Native mode should be selected when using the CSR8670.

3.2. Building and Flashing the Subwoofer Application

To download the Subwoofer application to a suitable device:

1. Connect the interface board to the development board and attach the SPI interface and USB charger.

2. Attach suitable headphones and microphone to the sockets on the development board.

3. Open the xIDE development environment from ADK 3.0.

4. Select Open Workspace from the Project menu and select the subwoofer application from the apps sub-

directory.

5. By default the application is setup to run on CSR8670 hardware, to change hardware or audio mode,

see section 4.

6. Make sure the Transport is set correctly to do this choose Debug > Transport and select the required

Debug Transport.

7. Use PSTool to merge the relevant PS Keys onto the device, for basic operation:

If using a CSR8670 device (CNS10001v4 development board), merge the

subwoofer_configuration_8670.psr file.

If using a BlueCore5-Multimedia device (DEV-PC-1645B development board), merge the

subwoofer_configuration_1645.psr file.

8. Select Build Active Project (F7) from the Build menu.

9. Select Run (F5) from the Debug menu.

10. The application is now running on the hardware.

Page 8 of 28

www.csr.com

BlueCore ADK 3.0 Subwoofer User Guide

Note:

The Subwoofer can also be run independently of the xIDE environment by selecting Stop from the Debug menu

when the application is running then resetting the hardware (as long as debug has not been enabled, see

below).

3.3. Enabling Debug Output

To enable debug output add DEBUG_PRINT_ENABLED to the Project Properties.

Note:

Debug functionality for particular files can be enabled and disabled by editing the relevant #define(s) in

subwoofer_debug.h.

When debug is enabled in the subwoofer application, the application does not run if a debugger, such as xIDE, is not

attached.

3.4. Connecting to another Device via Bluetooth

3.4.1. Pairing and Connecting the Subwoofer to a Soundbar Device

To pair the Subwoofer application to a Soundbar device:

1. Turn on the Subwoofer application by connecting the power cable to the development board:

1.1. For a non-empty paired device list:

1.1.1. The Subwoofer automatically enters connectable mode and begins making

connection requests to paired device(s).

1.1.2. To manually put the Subwoofer into pairing mode, press and hold the Multi-Function

button for 5 seconds.

1.2. With an empty paired device list:

1.2.1. The Subwoofer automatically enters pairing mode and waits for a remote device to

discover and pair to it.

With the Subwoofer in pairing mode, a Soundbar device can discover and pair to the Subwoofer, see section 3.4.2.

3.4.2. Discovering the Subwoofer Device from a Soundbar Device

When the Soundbar discovers the Subwoofer application, it automatically initiates pairing, when pairing completes,

the Subwoofer and Soundbar are connected.

3.4.3. Paired Device List Management

The Subwoofer application is designed to store one paired device.

If the Subwoofer application needs to be paired with a different host, the Subwoofer application needs to be put back

into pairing mode and an inquiry search performed.

Any new pairing procedure overwrites existing pairing information and connections.

The Subwoofer application does not support any method of clearing its paired device list.

Page 9 of 28

www.csr.com

BlueCore ADK 3.0 Subwoofer User Guide

3.5. Building a Soundbar with Subwoofer Support

To build a Soundbar device from a freshly installed ADK, open the sink project included with the ADK and select

Soundbar-8670-Release from the Build menu.

This sets all relevant build properties. However, if modifications to the sink project have been made for previous

builds, check that the following VM build options are included in the Project Properties:

SOUNDBAR

Subwoofer Link

If the Kalimba -'sbc_decoder' project has been modified in the past, check that SUB_ENABLE is included in the Project

Properties.

Note:

SUB_ENABLE and RELAY_ENABLE cannot be used at the same time. If RELAY_ENABLE is defined it needs to be

undefine when defining SUB_ENABLE.

Page 10 of 28

www.csr.com

BlueCore ADK 3.0 Subwoofer User Guide

4. Configuration

The ADK 3.0 Subwoofer application supports a number of configuration options allowing unique setups,

This section describes the configuration options available, how the subwoofer application interprets each

configuration and how to setup a valid configuration.

Table 4.1 lists the PS Keys used by the subwoofer application:

PS Key ID

Description

PSKEY_USR0

Application features configuration

PSKEY_USR1

Device ID configuration

PSKEY_USR2

Remote device ID configuration

PSKEY_USR3

LED configuration

PSKEY_USR4

Button configuration

PSKEY_USR5

Reserved

PSKEY_USR6

I²S initialisation configuration

PSKEY_USR7

I²S initialisation data

PSKEY_USR8

SWAT SDP record

PSKEY_USR9

Reserved

Table 4.1: PS Keys Used by ADK 3.0 Subwoofer Application

Indice

Manuali Subwoofer popolari di altre marche

Sony

Sony XS-AW8 Manuale utente

Sony

Sony XS-L836 Manuale utente

B&C Speakers

B&C Speakers 15 HPL 76W Manuale utente

Velodyne

Velodyne DD-18+ Manuale utente

Sonance

Sonance Cinema Series SUB 10-150 Manuale utente

Hifonics

Hifonics HW-12 Guida rapida

Magnat Audio

Magnat Audio ADR 130 BP Manuale utente

Blitz

Blitz BZP106 Manuale utente

Technics

Technics SB-AS500 Manuale utente

Lyngdorf

Lyngdorf BW-2 Manuale utente

Lyngdorf

Lyngdorf BW-3 Manuale utente

Pyle Pro

Pyle Pro PYLE PRO PDW15125 Manuale utente

REL Acoustics

REL Acoustics Q Series Manuale utente

Pioneer

Pioneer Elite S-W1EX Manuale utente

L-Acoustics

L-Acoustics KIVA SB15M Guida rapida

B&C Speakers

B&C Speakers Woofer 12 HPL 76 Manuale utente

KEF

KEF KUBE 200 Manuale utente

Yamaha

Yamaha SW500 Manuale utente