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