_äìÉpäáã=O» User Guide Issue 1 CSR Churchill House Cambridge Business Park Cowley Road Cambridge CB4 0WZ United Kingdom Registered in England 3665875 Tel.: +44 (0)1223 692000 Fax.: +44 (0)1223 692001 www.csr.com CS-212058-UGP1 © Cambridge Silicon Radio Limited 2011 This material is subject to CSR’s non-disclosure agreement.
Document History Document History Revision Date Change Reason 1 19 JAN 11 Original publication of this document. _äìÉpäáã=O= User Guide CS-212058-UGP1 © Cambridge Silicon Radio Limited 2011 This material is subject to CSR’s non-disclosure agreement.
Trademarks, Patents and Licenses Trademarks, Patents and Licenses Unless otherwise stated, words and logos marked with ™ or ® are trademarks registered or owned by CSR plc or its affiliates. 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 license is granted under any patent or other rights owned by CSR plc.
Contents Contents 1 2 List of Figures Figure 3.1 Figure 3.2 Figure 7.1 Figure 7.2 Full Installation of BlueSuite .............................................................................................................. 8 Additional Tasks Dialogue ................................................................................................................. 9 BlueFlash User Interface in Windows Vista ....................................................................................
Contents List of Tables Table 5.1 Table 7.1 Table 7.2 Firmware File Formats ..................................................................................................................... 11 Command Line Transport Options ................................................................................................... 14 Explanation of the BlueFlash User Interface ....................................................................................
Introduction 1 Introduction _äìÉpìáíÉ» is a _äìÉ`çêÉ∆ development suite designed to help with your _äìÉíççíÜ∆ wireless technology development program and with all testing requirements for the BlueSlim 2 module. BlueSuite contains: ■ Graphical and command-line applications to configure, test and program the BlueCore device in your design. ■ The qêìÉqÉëí» Toolkit, a set of libraries for developing production test applications for your BlueCore enabled devices. ■ Device drivers to communicate with BlueCore.
System Requirements 2 System Requirements Minimum system requirements for BlueSuite are: ■ Pentium processor based personal computer ■ 64MB of RAM ■ 20MB of available hard disk space 2.1 Operating System BlueSuite can be used on the following operating systems: ■ Microsoft Windows XP Service Pack 2 and later (not x64) ■ Microsoft Windows Vista (not x64) ■ Microsoft Windows 2000 Service Pack 3 and later (only for versions of BlueSuite prior to 2.
Install BlueSuite 3 Install BlueSuite Note: A bug in BlueSuite version 1.23 means that even if a later version of BlueSuite is installed, the version information for the USB driver may still indicate 1.23. If version 1.23 has previously been installed on the PC, unplug all CSR hardware, make sure you have the latest version of BlueSuite installed and run usbpurger from the BlueSuite installation directory. When a CSR BlueCore is plugged in, the Hardware Wizard prompts you for drivers.
Install BlueSuite _äìÉpäáã=O= User Guide Figure 3.2: Additional Tasks Dialogue CS-212058-UGP1 © Cambridge Silicon Radio Limited 2011 This material is subject to CSR’s non-disclosure agreement.
Install a USB Driver 4 Install a USB Driver BlueCore devices can be used with a USB host interface. The USB host interface is not a debugging interface and can be used by end users or in production modules. If you want to use the USB host interface to BlueCore, you must first configure your BlueCore for the USB host interface, and then install a USB device driver. _äìÉpäáã=O= User Guide CS-212058-UGP1 © Cambridge Silicon Radio Limited 2011 This material is subject to CSR’s non-disclosure agreement.
Firmware Overview 5 Firmware Overview CSR’s BlueCore ICs contain control software (called firmware). Firmware in BlueCores with flash can be updated using tools in BlueSuite: ■ ■ BlueFlash (see Section 7.2) is used during development to update your BlueCore's firmware using the Serial Peripheral Interface (SPI) debugging interface. TestFlash (part of TrueTest, see Section 8) can be used for the same purpose on the production line. DFUWizard (see Section 7.
Firmware Overview Note: If firmware with no PS is downloaded onto a blank flash, a new PS is created on the flash memory using default values suitable for a Casira module. However, some keys require calibration per module for optimal performance. See pskeys.html in the firmware release for details on using individual PS Keys. Some of the same information is available by clicking the Describe button in PSTool, see the PSTool User Guide. 5.
Getting Started 6 Getting Started When you have connected your BlueCore device(s) to your computer, you can use BlueSuite tools to communicate with them. To test you have connected your BlueCore device(s) succesfully, you can use: ■ The command-line tool btcli (Section 7.5). ■ One of the graphical programs PSTool (See the PSTool User Guide) or BlueTest3 (See the BlueTest User Guide). 6.
BlueSuite Programs 7 BlueSuite Programs This chapter describes the programs included in BlueSuite. The features of each program are briefly described and any relevant documentation is listed. Some programs without separate user guides are described in full detail. 7.1 Transport Options for Command Line Tools Some command line tools in BlueSuite take a -trans option, which controls the transport options. Table 7.
BlueSuite Programs 7.2 BlueFlash BlueFlash is a utility that allows you to download and upload firmware to and from the flash memory on the Casira modules or on your own BlueCore designs. As described in Section 5, there are several different firmware file formats, and firmware files may contain Persistent Store settings. Read Section 5.2 to make sure you do not accidentally change Persistent Store settings and to see which parts of BlueCore's firmware is updated by BlueFlash.
BlueSuite Programs Button or Area Explanation Choose File Opens a dialogue box for selection of the firmware file to download to the flash on the BlueCore Module. You may open a .xpv, .xuv or .xbv firmware file Note: If you open a .xpv file, the .xdv file must be present in the same folder. If pressed, a message indicates that this is no longer supported. Download Copies the selected file to the flash on the BlueCore module. This process updates each flash block as required and verifies them in turn.
BlueSuite Programs 7.2.2 Troubleshooting BlueFlash Potential problems: ■ If BlueFlash cannot identify the current build of firmware on BlueCore, check your firmware version. ■ If BlueFlash cannot identify flash type, BlueFlash fails to stop processor or BlueFlash times out trying to make a connection to BlueCore, ensure that the following actions have been completed: ■ Run InstParSpi.bat (C:\Program Files\CSR\BlueSuite\drivers) to copy and register the parspi.
BlueSuite Programs 7.5 BTCli Bluetooth Command Line Interface (BTCli) is a command-line program that lets you send Host Controller Interface (HCI) commands to your BlueCore device. Host computers use the HCI interface (part of the Bluetooth specification) to communicate with Bluetooth controllers (e.g. your BlueCore chip). See the BTCli User Guide for full details. 7.6 RFCli RFCli is a command line utility for communicating with RFCOMM firmware builds.
BlueSuite Programs 7.11 DFU ToolTips BlueSuite comes with DFU ToolTips, a shell extension that shows tool tips for DFU files in Windows. To see the tool tip, point the mouse over a DFU file, and wait for the tool tip to appear. Figure 7.2 shows a DFU tool tip. If the tool tip does not appear, you may have disabled tool tips in your version of Windows. To enable tool tips for files: 1. Go to the Control Panel 2. Open Folder Options 3. Select the View tab 4.
TrueTest Toolkit 8 TrueTest Toolkit The TrueTest toolkit consists of the necessary libraries and documentation to let you develop applications in a variety of languages for production programming and testing of BlueCore enabled devices. The toolkit is designed for use in production test systems. Instead of writing test scripts to call other BlueSuite programs, you can write a test program that accesses the test APIs (Application Programming Interface) directly. See the TrueTest Toolkit Introduction.
Document References 9 Document References Reference Specification of the Bluetooth System Version 2.1 + EDR, Core Package, 26 July 2007 www.bluetooth.com BlueCore Class 2 Example Designs www.csrsupport.com BlueCore Production Information Data Books www.csrsupport.com BlueCore Device Firmware Upgrade (DFU) Overview CS-112861-AN USB Device Firmware Upgrade Specification Part of the USB Specification http://www.usb.org/developers/devclass_docs/ DFU_1.1.
Regulatory Notes and Information Appendix A Regulatory Notes and Information This device complies with Part 15 of the FCC Rules. Operation is subject to the two following conditions: 1. 2. This device may not cause harmful interference This device must accept any interference received, including interference that may cause undesired operation. Changes or modifications to the transmitter not expressively approved by CSR could void the authority ability to operate the equipment.
Regulatory Notes and Information A.3 End Product Labelling The BlueSlim 2 Bluetooth Module is labeled with its own FCC ID and IC Certification Number. If the FCC ID and IC Certification Number are not visible when the module is installed inside another device, then the outside of the device into which the module is installed must also display a label referring to the enclosed module.
Terms and Definitions Terms and Definitions Definition API Application Programming Interface BCHS BlueCore Host Software BIST Built-In Self-Test BlueCore® Group term for CSR’s range of Bluetooth wireless technology ICs Bluetooth® Set of technologies providing audio and data transfer over short-range radio connections BTCli Bluetooth Command Line Interface CD ROM Compact Disk Read Only Memory CSR Cambridge Silicon Radio DFU Device Firmware Upgrade DLL Dynamically Linked Library e.g.
