Csr Harmony 2.0 Software Release Note 1r6bp

CSR Harmony™ v2.0 Release Note Issue 10

© Cambridge Silicon Radio Limited 2012 This material is subject to CSR’s non-disclosure agreement

Page 1 of 22 CS-214049-RNP10 www.csr.com

Document History Date

History

1

07 APR 11

Original publication of this document

2

27 MAY 11

Updated for build v2.1.14.0 release

3

17 JUN 11

Editorial updates. Incorporated latest CSR style.

4

17 JUN 11

Updated for build v2.1.16.0 release

5

09 NOV 11

Updated for build v2.1.37.0 release Internal issue only

6

09 NOV 11

Updated Known Issues section Internal issue only

7

27 DEC 11

Updated for build v2.1.51.0 release

8

12 JAN 12

Updated for build v 2.1.53.0 release

9

26 MAR 12

Updated for build 2.1.63.0 release

10

27 MAR 12

Updated Table 4.1

s General information Information on this product Customer for this product More detail on compliance and standards Help with this document

© Cambridge Silicon Radio Limited 2012 This material is subject to CSR’s non-disclosure agreement

www.csr.com [email protected]

Page 2 of 22 CS-214049-RNP10 www.csr.com

CSR Harmony v2.0 Release Note

Revision

Trademarks, Patents and Licences Unless otherwise stated, words and logos marked with ™ or ® are trademarks ed or owned by CSR plc and/or its s. 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 s. CSR reserves the right to make technical changes to its products as part of its development programme.

Life Policy and Use in Safety-critical Compliance CSR’s products are not authorised for use in life- 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.csr.com for compliance and conformance to standards information.

© Cambridge Silicon Radio Limited 2012 This material is subject to CSR’s non-disclosure agreement

Page 3 of 22 CS-214049-RNP10 www.csr.com

CSR Harmony v2.0 Release Note

While every care has been taken to ensure the accuracy of the contents of this document, CSR cannot accept responsibility for any errors.

Contents Document History.................................................................................................................................................... 2 s .................................................................................................................................................................. 2 Trademarks, Patents and Licences ......................................................................................................................... 3 Life Policy and Use in Safety-critical Compliance ...................................................................................... 3 Performance and Conformance .............................................................................................................................. 3 Contents .................................................................................................................................................................. 4 Tables ..................................................................................................................................................................... 5 1.

Introduction ...................................................................................................................................................... 6

2.

Target Platform ................................................................................................................................................ 7

4.

Operating system ...................................................................................................................................... 7

2.2.

Hardware .................................................................................................................................................. 7

Installing CSR Harmony ................................................................................................................................... 8 3.1.

Setup ........................................................................................................................................................ 8

3.2.

Silent Installation Procedure ..................................................................................................................... 9

3.3.

ing the Files ................................................................................................................................... 10

Release Functionality..................................................................................................................................... 13 4.1.

ed Profiles .................................................................................................................................. 13

4.2.

Functionality ed in this Release .................................................................................................. 14

4.3.

Third Party Applications ed ........................................................................................................ 16

4.4.

Limitations............................................................................................................................................... 16

5.

Testing ........................................................................................................................................................... 17

6.

Qualification Status ........................................................................................................................................ 18 6.1.

WHQL Qualification ................................................................................................................................ 18

6.2.

Bluetooth SIG ......................................................................................................................................... 18

Appendix A Disabling Secure Logon................................................................................................................... 19 Appendix B Harmony Installation Size Information ............................................................................................. 20 and Definitions ........................................................................................................................................... 21

© Cambridge Silicon Radio Limited 2012 This material is subject to CSR’s non-disclosure agreement

Page 4 of 22 CS-214049-RNP10 www.csr.com

CSR Harmony v2.0 Release Note

3.

2.1.

Tables Table 3.1: Silent Installation Batch File Configuration ............................................................................................. 9 Table 3.2: Driver File Version Information ............................................................................................................. 10 Table 3.3: Applications File Version Information........................................................................................... 12 Table 4.1: Bluetooth Profiles and Versions ed .......................................................................................... 13 Table 6.1: Audio Logo Category ........................................................................................................................... 18 Table 6.2: Unclassified Category .......................................................................................................................... 18

CSR Harmony v2.0 Release Note

© Cambridge Silicon Radio Limited 2012 This material is subject to CSR’s non-disclosure agreement

Page 5 of 22 CS-214049-RNP10 www.csr.com

1.

Introduction

CSR Harmony™ is Windows-based host software that provides for the wireless connectivity technologies ed by CSR. ®

This document describes the CSR Harmony Release (build 2.1.63.0).CSR Harmony complies with Bluetooth 4.0 specification.

CSR Harmony v2.0 Release Note

© Cambridge Silicon Radio Limited 2012 This material is subject to CSR’s non-disclosure agreement

Page 6 of 22 CS-214049-RNP10 www.csr.com

2.

Target Platform

2.1.

Operating system

This release is ed on the following operating systems: 

Windows 7: 32-bit and 64-bit machines



Windows XP: 32-bit and 64-bit machines



Windows Vista: 32-bit and 64-bit machines

2.2.

Hardware

CSR Harmony runs on: BlueCore4™ External



BlueCore4 PCROM (BSLIM1)



BSLIM2



BlueCore CSR8510™ A10

CSR Harmony v2.0 Release Note



®

© Cambridge Silicon Radio Limited 2012 This material is subject to CSR’s non-disclosure agreement

Page 7 of 22 CS-214049-RNP10 www.csr.com

3.

Installing CSR Harmony

3.1.

Setup

To install CSR Harmony on the target machine: 1.

Ensure the Bluetooth hardware is plugged in/enabled.

2.

Copy the setup.exe file to a folder.

3.

Double-click on setup.exe.

4.

Choose the setup language to install. If an older version of CSR Harmony is installed on the machine, the Setup wizard provides a warning. Go to step 5. If no older version of CSR Harmony exists, go to step 7.

5.

Read the warning and select OK to uninstall the earlier version. The Setup wizard returns to the Installation page.

6.

Click Next.

7.

Select I accept the in the License Agreement and click Next.

8.

Either:

A License Agreement window appears. The Destination folder window appears. 

Click Next to install in the default installation directory: C:\Program Files\CSR\CSR Harmony Wireless Software Stack



To install CSR Harmony in a different path, click Change..., choose the path for installation and click Next.

The Check Bluetooth Dongle window appears. 9.

Ensure the Bluetooth dongle is plugged in (otherwise, CSR Harmony drivers may not load properly). The Ready to Install window appears.

10.

Click Install.

11.

Click Finish.

The Setup Complete Success window appears.

© Cambridge Silicon Radio Limited 2012 This material is subject to CSR’s non-disclosure agreement

Page 8 of 22 CS-214049-RNP10 www.csr.com

CSR Harmony v2.0 Release Note

The Welcome wizard appears.

3.2.

Silent Installation Procedure

3.2.1.

Configuring the Default Settings through Silent Mode

Before continuing with silent installation procedure, edit the Silent_Install.bat file. Table 3.1 lists the entries to configure in the Silent_Install.bat file. Command

Configure the default settings:  Discovery Mode Disabled  DeviceType Laptop  Content Protection Disabled  Bluetooth Radio enabled

call setup.exe /s /v" /qn"

Disable discovery mode

call setup.exe /s /v" /qn DISC=1"

Enable discover mode

call setup.exe /s /v" /qn DISC=2"

To:    

Disable Discovery mode Set Device Type as Laptop Disable Content Protection Disable Bluetooth radio

call setup.exe /s /v" /qn DISC=1 DEVICETYPE=DeviceLaptop SCMST=ScmstDisabled BTRADIO=0"

To:    

Enable Discovery mode Set Device Type as Desktop Enable Content Protection Enable Bluetooth radio

call setup.exe /s /v" /qn DISC=2 DEVICETYPE=Desktop SCMST=ScmstEnabled BTRADIO=1"

Table 3.1: Silent Installation Batch File Configuration Note: If you do not specify a parameter, the default configuration is set.

3.2.2.

Setup

1.

Ensure the Bluetooth Hardware is plugged in/enabled.

2.

Copy the CSR Harmony Release to a local folder.

3.

Right click on the Silent_Install.bat file, and select Run as . An empty Command Prompt window and a CSR Harmony image open and close immediately. No other window or wizard is visible during silent mode installation.

4.

After the Installation is complete, the Bluetooth tray icon is visible on the task bar.

5.

To if the silent installation is in progress, open the Task Manager > Processes and if the setup.exe process is running. After the installation is complete, the setup.exe process is not visible in the Task Manager.

© Cambridge Silicon Radio Limited 2012 This material is subject to CSR’s non-disclosure agreement

Page 9 of 22 CS-214049-RNP10 www.csr.com

CSR Harmony v2.0 Release Note

Configuration

3.3.

ing the Files

After installation, the files listed in this section. They are available either in the directory path (C:\Program Files\CSR\CSR Harmony Wireless Software Stack) or in the specified path (if the default installation path was changed during installation). Notes: To view the File Version, right-click on the columns tab (where information including Name, Size, Type and Date Modified is displayed). To view the Driver Version in the Device Manager, right-click on the installed CSR driver and open the Driver Details. Table 3.2 lists the driver file names, file version and driver version. File Name

File Version

Driver Version

Bluetooth Port Driver

csrbtport.inf

Not applicable

2.1.61.0

csrbtport.sys

2.1.61.0

2.1.61.0

csrusb.inf

Not applicable

2.1.60.0

csrusb.sys

2.1.60.0

2.1.60.0

csravr.inf

Not applicable

2.1.51.0

csravr.sys

2.1.51.0

2.1.51.0

csrbthav.inf

Not applicable

2.1.60.0

csrbthav.sys

2.1.60.0

2.1.60.0

csrhidmini.inf

Not applicable

2.1.60.0

csrhidmini.sys

2.1.60.0

2.1.60.0

csrserial.inf

Not applicable

2.1.51.0

csrserial.sys

2.1.51.0

2.1.51.0

csrdunc.inf

Not applicable

2.1.51.0

csrdunc.sys

2.1.51.0

2.1.51.0

CsrBthAudioHF.inf

Not applicable

2.1.60.0

CsrBthAudioHF.sys

2.1.60.0

2.1.60.0

csrhfgcc.inf

Not applicable

2.1.52.0

csrhfgcc.sys

2.1.52.0

2.1.52.0

csrpan.inf

Not applicable

2.1.51.0

csrpan.sys

2.1.51.0

2.1.51.0

USB Driver

Bluetooth Audio/Video Subsystem

Bluetooth HID Subsystem

Serial Port Subsystem

DUN Subsystem

HF Audio Subsystem

HF Gateway Call Control Subsystem

PAN Subsystem

Table 3.2: Driver File Version Information

© Cambridge Silicon Radio Limited 2012 This material is subject to CSR’s non-disclosure agreement

Page 10 of 22 CS-214049-RNP10 www.csr.com

CSR Harmony v2.0 Release Note

Driver

Table 3.3 lists the Applications file names and file version. File Name

File Version

Applications and Libraries

CsrBtService.exe

2.1.63.0

CsrBtOBEXService.exe

2.1.63.0

CsrBtAudioService.exe

2.1.63.0

CsrAudioguiCtrl.exe

2.1.63.0

CsrlHelper.exe

2.1.63.0

CSRFileTransferWizard.exe

2.1.63.0

TrayApplication.exe

2.1.63.0

BthAddDeviceApp.dll

2.1.63.0

CsrBtProxy.dll

2.1.63.0

CsrBtOBEXProxy.dll

2.1.63.0

CsrAudioProxy.dll

2.1.63.0

CsrOBEXErrorMessages.dll

2.1.63.0

CsrUSbCustAction.dll

2.1.63.0

CsrWmpBthPlugin.dll

2.1.63.0

IconResource.dll

2.1.63.0

CSRBtShellExt.dll

2.1.63.0

CsrDevPropertyDlg.dll

2.1.63.0

Harmonyl.l

2.1.63.0

HarmonyHFPSkypePlugin.exe

2.1.63.0

HarmonyStartup.exe

2.1.63.0

ImageTranscoder.exe

2.1.63.0

CsrBtOutlookAddin.dll

2.1.63.0

CsrOfficePlugin.dll

2.1.63.0

Csrsyncdll.dll

2.1.63.0

CsrBtOutlookSyncAddin.dll

2.1.63.0

VDPSrlayer.exe

2.1.63.0

BtSwitcherService.exe

2.1.63.0

© Cambridge Silicon Radio Limited 2012 This material is subject to CSR’s non-disclosure agreement

CSR Harmony v2.0 Release Note

Application

Page 11 of 22 CS-214049-RNP10 www.csr.com

Application

File Version

CsrHCRPServer.exe

2.1.63.0

CSRBtAVRCtrl.exe

2.1.63.0

CsrSyncMLServer.exe

2.1.63.0

BLEtokenCredentialProvider.dll

2.1.63.0

csrportmon.dll

2.1.63.0

CSRBtStartApp.exe

2.1.63.0

CsrSecCoins.dll

2.1.63.0

xml2wbxml.exe

Not applicable

wbxml2xml.exe

Not applicable

libwbxml2.dll

0.9.2

libexpat.dll

1.95.6

Libexpat_license.txt

Not applicable

Table 3.3: Applications File Version Information On a 64-bit machine, the 32-bit applications are present in the C:\Program Files(X86)\CSR\CSR Harmony Wireless Software Stack directory and includes: File Name

File Version

CsrBtProxy.dll

2.1.63.0

CsrBtProxyPS.dll

2.1.63.0

HarmonyHFPSkypePlugin.exe

2.1.63.0

CsrWmpBthPlugin.dll

2.1.63.0

CsrBtOutlookAddin.dll

2.1.63.0

CsrOfficePlugin.dll

2.1.63.0

Csrsyncdll.dll

2.1.63.0

CsrBtOutlookSyncAddin.dll

2.1.63.0

Installing CSR Harmony software also installs Windows redistributable software: 

Visual C++ 9.0 ATL(x86) WinSXS MSM



Visual C++ 9.0 CRT(x86) WinSXS MSM

© Cambridge Silicon Radio Limited 2012 This material is subject to CSR’s non-disclosure agreement

Page 12 of 22 CS-214049-RNP10 www.csr.com

CSR Harmony v2.0 Release Note

SyncML (third-party software) deliverables

File Name

4.

Release Functionality

4.1.

ed Profiles

Table 4.1 lists the Bluetooth profiles ed in this release. Role and Function

ed Version

HID

Host

v1.0

DI

-

v1.3

A2DP

Source and Sink

v1.2

AVR

Target and Controller

v1.4

SPP

Initiator and Responder

v1.1

DUN

Terminal

v1.1

HF

Audio Gateway and Handsfree

v1.5

HS

Audio Gateway and Headset

v1.2

HCRP

HCRP Client and Server

v1.2

FTP

Client and Server

v1.1

OPP

Client and Server

v1.1

BPP

BPP Sender

v1.2

BIP

Initiator and Responder

v1.0

PAN



v1.0

VDP

Source

v1.0

Synchronisation

IrMC Client

v1.1

Sync ML

Server

v1.1

HOGP (Bluetooth Low Energy based HID)

Report mode host

v1.0

Proximity Profile

Monitor

v1.0

SP

Client

v1.0

CSR Harmony v2.0 Release Note

Bluetooth Profile

Table 4.1: Bluetooth Profiles and Versions ed

© Cambridge Silicon Radio Limited 2012 This material is subject to CSR’s non-disclosure agreement

Page 13 of 22 CS-214049-RNP10 www.csr.com

4.2.

Functionality ed in this Release

The functions ed in this release are. 

for interface: 

Add Bluetooth Device



Show Bluetooth Devices



Remove Device



Tray Icon



Bluetooth Discovery On/Off



Bluetooth Radio On/Off



Send To Bluetooth Device



Bluetooth Settings

Audio Streaming using SBC codec HID Device connections (Mouse and Keyboard)



Data transfer over serial interface



Hands free Gateway for Skype.



Control Application.



COD based device search



Networking access from DUN terminals



Add Bluetooth Printer



File Transfer using FTP



Basic Printing through OPP



Host Controller Interface (HCI)



Bluetooth protocols ed: AVCTP,AVDTP,BNEP,L2CAP,LMP,OBEX,RFCOMM,SDP



Additional profiles ed: GAP,GAVDP,GOEP, SDP



Mobile Device can be connected to PC; the device can accept, hang-up and reject calls on the PC



Send to Bluetooth device option from MS Outlook and MS Office applications.



SYNC of s, calendar item, notes and emails within MS Office Outlook to remote SYNC IrMC server (such as mobile phone)



PAN(U) service is used to connect to remote device with PAN(U), PAN(GN) and PAN(NAP) role. 

PAN(U)-PAN(U) connection is used to simulate a cross-over cable



PAN(U)-PAN(NAP) connection is used to access the available network



PAN(U)-PAN(GN) connection is used to form an ad-hoc network



Send and receive images between devices using BIP



Decoding and playing of received Bluetooth audio through the PC audio device



APT-X™ encoder



Content Protection on source SCMS-T



Bluetooth high speed



Bluetooth low energy: CSR Harmony s Just works and MITM BLE pairing model



Security key fob



Bluetooth low energy HID (HOGP Report Mode Host)



Switcher service: To switch BlueCore CSR8510 dongle from HID mode to HCI Mode

© Cambridge Silicon Radio Limited 2012 This material is subject to CSR’s non-disclosure agreement

Page 14 of 22 CS-214049-RNP10 www.csr.com

CSR Harmony v2.0 Release Note

 



SyncML for backward compatibility with older mobile phones



VDP source for transmitting H.263 encoded video data



Bluetooth printing using HCRP Server



Languages ed: 

Arabic



Basque



Catalan



Chinese Simplified



Chinese Traditional



Czech Danish Dutch



English



Finish



French



French(Canadian)



Galician



German



Greek



Hebrew



Hungarian



Italian



Japanese



Korean



Norwegian



Polish



Portuguese



Portuguese(Brazilian)



Russian



Slovakian



Spanish



Spanish(Latin American)



Swedish



Thai



Turkish

CSR Harmony v2.0 Release Note

 

Notes: 

BLE, PAN and Bluetooth high-speed are not ed on Windows XP.



Disable Secure logon to lock/unlock the screen using the security key fob. For more information, see the Appendix A.

© Cambridge Silicon Radio Limited 2012 This material is subject to CSR’s non-disclosure agreement

Page 15 of 22 CS-214049-RNP10 www.csr.com

4.3.

Third Party Applications ed

The third party applications ed in this release are: 

Skype v4.2.0.155



Microsoft Outlook 2007 and 2010



Microsoft Office (Word, Excel and PowerPoint) 2007 and 2010



Winamp 5.601



Windows Media Player

4.4.

Limitations

CSR Harmony does not BLE privacy using resolvable random addressing.

CSR Harmony v2.0 Release Note

© Cambridge Silicon Radio Limited 2012 This material is subject to CSR’s non-disclosure agreement

Page 16 of 22 CS-214049-RNP10 www.csr.com

5.

Testing

This software has been tested on the following operating systems: 

Windows 7 (32-bit and 64bit)



Windows XP (32-bit and 64bit)



Windows Vista (limited testing performed for both 32-bit and 64-bit)

See Table 4.1 for the profiles ed. CSR Harmony has been tested with BLE keyboard, mouse and security key fob with CSR µEnergy™ SDK v1.4.

CSR Harmony v2.0 Release Note

© Cambridge Silicon Radio Limited 2012 This material is subject to CSR’s non-disclosure agreement

Page 17 of 22 CS-214049-RNP10 www.csr.com

6.

Qualification Status

6.1.

WHQL Qualification

CSR Harmony build v2.1.63.0 includes WHQL qualified drivers (Qualification ID: 1482599, 1487690) for Windows 7 and Windows XP operating systems (32-bit and 64-bit), see Table 6.1 and Table 6.2. Driver Version

Audio Logo Category

2.1.51.0

AVR

2.1.52.0

HF-Call Control

2.1.60.0

A2DP and Audio HF

CSR Harmony v2.0 Release Note

Table 6.1: Audio Logo Category

Driver Version

Unclassified Category

2.1.60.0

HID

2.1.51.0

DUN ,SPP and PAN

2.1.60.0

USB and USBFilter Driver

2.1.61.0

CsrBTPort

Table 6.2: Unclassified Category Note: CSR Harmony drivers for Microsoft Windows Vista are test signed and not WHQL qualified.

6.2.

Bluetooth SIG

The Bluetooth SIG lists CSR Harmony. The QD ID is B017872. For more information, refer to www.bluetooth.org/tpg/QLI_editQDL.cfm?qid=17872.

© Cambridge Silicon Radio Limited 2012 This material is subject to CSR’s non-disclosure agreement

Page 18 of 22 CS-214049-RNP10 www.csr.com

Appendix A

Disabling Secure Logon

To disable Secure logon: 1.

Click Start > Run.

2.

Enter Control s2 and press OK.

3.

Click the Advanced tab.

4.

In the Secure logon section, clear the Requires s to press Ctrl+Alt+Delete check box.

5.

Click OK or Apply.

CSR Harmony v2.0 Release Note

© Cambridge Silicon Radio Limited 2012 This material is subject to CSR’s non-disclosure agreement

Page 19 of 22 CS-214049-RNP10 www.csr.com

Appendix B

Harmony Installation Size Information

The following lists the memory area occupied in the hard drive by CSR Harmony (after installation) on various operating system variants: 

Windows 7 32-bit: 157 MB



Windows 7 64-bit : 164 MB



Windows Vista 32-bit: 177 MB



Windows Vista 64-bit: 164 MB



Windows XP 32-bit: 690 MB



Windows XP 64-bit: 732 MB

CSR Harmony v2.0 Release Note

© Cambridge Silicon Radio Limited 2012 This material is subject to CSR’s non-disclosure agreement

Page 20 of 22 CS-214049-RNP10 www.csr.com

and Definitions Advanced Audio Distribution Profile

AG

Audio Gateway

av/AV

Audio Video

AVCTP

Audio/Video Control Transport Protocol

AVDTP

Audio/Video Distribution Transport Protocol

AVR

Audio/Video Remote Control Protocol

BlueCore®

Group term for CSR’s range of Bluetooth wireless technology chips

Bluetooth®

Set of technologies providing audio and data transfer over short-range radio connections

BNEP

Bluetooth Network Encapsulation Protocol

BPP

Basic Printing Profile

BT HS

Bluetooth High Speed

BLE

Bluetooth Low Energy

CSR

Cambridge Silicon Radio

COD

Class of Device

DI

Device ID Profile

DUN

Dial-Up Network

EDR

Enhanced Data Rate

GUI

Graphical Interface

GAP

Generic Access Profile

GAVDP

Generic Audio/Video Distribution Profile

GATT

Generic Attribute Profile

GOEP

Generic Object Exchange Profile

HCRP

Hardcopy Replacement Profile

HCI

Host Controller Interface

HF

Hands Free

HFP

Hands-Free Profile

HID

Human Interface Device

HOGP

HID over GATT Profile

© Cambridge Silicon Radio Limited 2012 This material is subject to CSR’s non-disclosure agreement

Page 21 of 22 CS-214049-RNP10 www.csr.com

CSR Harmony v2.0 Release Note

A2DP

Head-Set

HSP

Head Set Profile

IrMC

Infrared Mobile Communications

IOP Testing

Bluetooth Profile Inter - Operability Testing

L2CAP

Logical Link Control and Adaptation Protocol

LMP

Link Manager Protocol

MITM

Man in the middle

CSR µEnergy™

Bluetooth low energy enabled single mode chip

OBEX

Object Exchange

OPP

Object Push Profile

OS

Operating System

PAN(U)

Personal Area Network ()

PAN(GN)

Personal Area Network (Group Ad-Hoc Network)

PAN(NAP)

Personal Area Network (Network Access Point)

PC

Personal Computer

RFCOMM

Serial Port Emulation Protocol

SBC

Sub-band Codec

SP

Scan Parameters Profile

SDAP

Service Discovery Application Profile

SDK

Software Development Kit

SDP

Service Discovery protocol

SP2

Service Pack 2

SPP

Serial Port Profile

USB

Universal Serial Bus

VDP

Video Distribution Profile

© Cambridge Silicon Radio Limited 2012 This material is subject to CSR’s non-disclosure agreement

CSR Harmony v2.0 Release Note

HS

Page 22 of 22 CS-214049-RNP10 www.csr.com