csr harmony 2.0 software release note

of 22 Cambridge Silicon Radio Limited 2012 CS-214049-RNP10 This material is subject to CSRs non-disclosure agreement www.csr.com

CSR Harmony v2.0

Release Note Issue 10


CSR

Harm

ony v2.0 Release N

ote

Document History

Revision 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

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]


CSR

Harm

ony v2.0 Release N

ote

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 CSRs 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.


CSR

Harm

ony v2.0 Release N

ote

Contents Document History .................................................................................................................................................... 2 Contacts .................................................................................................................................................................. 2 Trademarks, Patents and Licences ......................................................................................................................... 3 Life Support Policy and Use in Safety-critical Compliance ...................................................................................... 3 Performance and Conformance .............................................................................................................................. 3 Contents .................................................................................................................................................................. 4 Tables ..................................................................................................................................................................... 5 1. Introduction ...................................................................................................................................................... 6 2. Target Platform ................................................................................................................................................ 7

2.1. Operating system ...................................................................................................................................... 7 2.2. Hardware .................................................................................................................................................. 7

3. Installing CSR Harmony ................................................................................................................................... 8 3.1. Setup ........................................................................................................................................................ 8 3.2. Silent Installation Procedure ..................................................................................................................... 9 3.3. Verifying the Files ................................................................................................................................... 10

4. Release Functionality ..................................................................................................................................... 13 4.1. Supported Profiles .................................................................................................................................. 13 4.2. Functionality Supported in this Release .................................................................................................. 14 4.3. Third Party Applications Supported ........................................................................................................ 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 Terms and Definitions ........................................................................................................................................... 21


CSR

Harm

ony v2.0 Release N

ote

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


CSR

Harm

ony v2.0 Release N

ote

1. Introduction CSR Harmony is Windows-based host software that provides support for the wireless connectivity technologies supported by CSR.

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


CSR

Harm

ony v2.0 Release N

ote

2. Target Platform 2.1. Operating system This release is supported 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

Harm

ony v2.0 Release N

ote

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. The Welcome wizard appears.

6. Click Next. A License Agreement window appears.

7. Select I accept the terms in the License Agreement and click Next. The Destination folder window appears.

8. Either: 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. The Setup Complete Success window appears.

11. Click Finish.


CSR

Harm

ony v2.0 Release N

ote

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.

Configuration 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 Administrator.

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 verify if the silent installation is in progress, open the Task Manager > Processes and verify if

the setup.exe process is running. After the installation is complete, the setup.exe process is not visible in the Task Manager.


CSR

Harm

ony v2.0 Release N

ote

3.3. Verifying the Files After installation, verify 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.

Driver 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

USB Driver csrusb.inf Not applicable 2.1.60.0

csrusb.sys 2.1.60.0 2.1.60.0

Bluetooth Audio/Video Subsystem csravrcp.inf Not applicable 2.1.51.0

csravrcp.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

Bluetooth HID Subsystem csrhidmini.inf Not applicable 2.1.60.0

csrhidmini.sys 2.1.60.0 2.1.60.0

Serial Port Subsystem csrserial.inf Not applicable 2.1.51.0

csrserial.sys 2.1.51.0 2.1.51.0

DUN Subsystem csrdunc.inf Not applicable 2.1.51.0

csrdunc.sys 2.1.51.0 2.1.51.0

HF Audio Subsystem CsrBthAudioHF.inf Not applicable 2.1.60.0

CsrBthAudioHF.sys 2.1.60.0 2.1.60.0

HF Gateway Call Control Subsystem csrhfgcc.inf Not applicable 2.1.52.0

csrhfgcc.sys 2.1.52.0 2.1.52.0

PAN User Subsystem csrpan.inf Not applicable 2.1.51.0

csrpan.sys 2.1.51.0 2.1.51.0

Table 3.2: Driver File Version Information


CSR

Harm

ony v2.0 Release N

ote

Table 3.3 lists the User Applications file names and file version.

Application File Name File Version

User 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

CsrCplHelper.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

HarmonyCpl.cpl 2.1.63.0

HarmonyHFPSkypePlugin.exe 2.1.63.0

HarmonyUserStartup.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

VDPSrcPlayer.exe 2.1.63.0

BtSwitcherService.exe 2.1.63.0


CSR

Harm

ony v2.0 Release N

ote

Application File Name File Version

CsrHCRPServer.exe 2.1.63.0

CSRBtAVRCPCtrl.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

SyncML (third-party software) deliverables

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: User 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


CSR

Harm

ony v2.0 Release N

ote

4. Release Functionality 4.1. Supported Profiles Table 4.1 lists the Bluetooth profiles supported in this release.

Bluetooth Profile Role and Function Supported Version

HID Host v1.0

DI - v1.3

A2DP Source and Sink v1.2

AVRCP 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 User 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

ScPP Client v1.0

Table 4.1: Bluetooth Profiles and Versions Supported


CSR

Harm

ony v2.0 Release N

ote

4.2. Functionality Supported in this Release The functions supported in this release are.

Support for user 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 support for Skype. Control Panel 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 supported: AVCTP,AVDTP,BNEP,L2CAP,LMP,OBEX,RFCOMM,SDP Additional profiles supported: 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 contacts, 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 support Content Protection on source SCMS-T Bluetooth high speed Bluetooth low energy: CSR Harmony supports 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


CSR

Harm

ony v2.0 Release N

ote

SyncML for backward compatibility with older mobile phones VDP source for transmitting H.263 encoded video data Bluetooth printing using HCRP Server Languages supported:

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

Notes: BLE, PAN and Bluetooth high-speed are not supported on Windows XP. Disable Secure logon to lock/unlock the screen using the security key fob. For more information, see

the Appendix A.


CSR

Harm

ony v2.0 Release N

ote

4.3. Third Party Applications Supported The third party applications supported 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 support BLE privacy using resolvable random addressing.


CSR

Harm

ony v2.0 Release N

ote

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 supported.

CSR Harmony has been tested with BLE keyboard, mouse and security key fob with CSR Energy SDK v1.4.


CSR

Harm

ony v2.0 Release N

ote

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 AVRCP

2.1.52.0 HF-Call Control

2.1.60.0 A2DP and Audio HF

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.


CSR

Harm

ony v2.0 Release N

ote

Appendix A Disabling Secure Logon To disable Secure logon:

1. Click Start > Run. 2. Enter Control Userpasswords2 and press OK. 3. Click the Advanced tab. 4. In the Secure logon section, clear the Requires users to press Ctrl+Alt+Delete check box. 5. Click OK or Apply.


CSR

Harm

ony v2.0 Release N

ote

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

Harm

ony v2.0 Release N

ote

Terms and Definitions A2DP Advanced Audio Distribution Profile

AG Audio Gateway

av/AV Audio Video

AVCTP Audio/Video Control Transport Protocol

AVDTP Audio/Video Distribution Transport Protocol

AVRCP Audio/Video Remote Control Protocol

BlueCore Group term for CSRs 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 User 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


CSR

Harm

ony v2.0 Release N

ote

HS 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 (User)

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

ScPP 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

Document HistoryContactsTrademarks, Patents and LicencesLife Support Policy and Use in Safety-critical CompliancePerformance and ConformanceContentsTables1. Introduction2. Target Platform2.1. Operating system2.2. Hardware

3. Installing CSR Harmony3.1. Setup3.2. Silent Installation Procedure3.2.1. Configuring the Default Settings through Silent Mode3.2.2. Setup

3.3. Verifying the Files

4. Release Functionality4.1. Supported Profiles4.2. Functionality Supported in this Release4.3. Third Party Applications Supported4.4. Limitations

5. Testing6. Qualification Status6.1. WHQL Qualification6.2. Bluetooth SIGAppendix A Disabling Secure LogonAppendix B Harmony Installation Size Information

Terms and Definitions

csr harmony 2.0 software release note

Documents