_äìÉ`çêÉ∆ _äìÉpìáíÉ» User Guide Issue 3 CSR Cambridge Science Park Milton Road Cambridge CB4 0WH United Kingdom Registered in England 3665875 Tel.: +44 (0)1223 692000 Fax.: +44 (0)1223 692001 www.csr.
Document History Document History Revision Date Change Reason 2 12 MAR 08 Original publication of this document. 3 13 NOV 08 Section on Command Line Tools transport options added. Minor text corrections.
Trademarks, Patents and Licences Trademarks, Patents and Licences Unless otherwise stated, words and logos marked with ™ or ® are trademarks registered or owned by CSR plc 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.
Contents Contents 1 2 CS-118613-UGP3 © Cambridge Silicon Radio Limited 2000-2008 This material is subject to CSR’s non-disclosure agreement Page 4 of 27 _äìÉ`çêÉ∆=_äìÉpìáíÉ» User Guide Introduction ..................................................................................................................................................... 6 System Requirements ....................................................................................................................................
Contents List of Figures Figure 3.1 Figure 3.2 Figure 4.1 Figure 7.1 Figure 7.2 Full Installation of BlueSuite .............................................................................................................. 8 Additional Tasks Dialogue ................................................................................................................. 9 Changing the Driver ........................................................................................................................
Introduction 1 Introduction _äìÉpìáíÉ» is a _äìÉ`çêÉ∆ development suite designed to help with your _äìÉíççíÜ∆ wireless technology development program. 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. ■ Documentation to help development.
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ìáíÉ» User Guide Figure 3.
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. 4.
Install a USB Driver USB\VID_10ab&PID_1006 ; MOTION BC04 Device VID&PID DFU %GENERIC.DeviceDesc%=CSRBC.Inst.NTx86.5.1, USB\VID_1234&PID_5678 ; Generic Device VID&PID 5. You can add the device to the 64-bit Windows XP and Vista section of the file, but CSR does not support 64-bit platforms: ; ; 64-bit Windows XP and later ; [CSR.NTamd64...1] ... %MOTION2DFU.DeviceDesc%=CSRBC.Inst.NTamd64...1, USB\VID_10ab&PID_1006 ; MOTION BC04 Device VID&PID DFU %GENERIC.DeviceDesc%=CSRBC.Inst.NTamd64...1, USB\VID_1234&P
Install a USB Driver Figure 4.1: Changing the Driver Complete the Hardware Update Wizard : For Vista: 5.1 Browse my computer 5.2 Let me pick from a list of devices to install 5.3 Have disk 5.4 Browse and navigate to the Drivers folder installed as part of BlueSuite and select CSRBlueCoreUSB. Click Next 6. For XP: 5.1 No, not this time 5.2 Install from a list or specified location (Advanced) 5.
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. Opens a hexadecimal editing window. CSR recommends that you do not edit the .xpv file in any way.
BlueSuite Programs 7.2.2 Troubleshooting BlueFlash Potential problems: ■ If BlueFlash cannot identify the current build of firmware on BlueCore, check your firmware version. BlueFlash does not identify pre-Beta 10 firmware releases. ■ 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 regist
BlueSuite Programs 7.3 PSTool PSTool is an editing suite that allows you to read and modify the Persistent Store. The Persistent Store consists of configuration keys that modify the operation of the firmware. BlueCore is a very flexible device with many setup options. PS Keys must be set correctly for BlueCore to work in a particular design. Some PS Keys must be calibrated for each module. 7.3.1 PsCli PsCli is a command-line interface for reading and modifying the Persistent Store. Type pscli.
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). A basic user guide for BTCli is provided as a text file (btcliug.txt) in the BlueSuite directory.
BlueSuite Programs 7.7 BCFMRadio Important Note: Read the document referenced below before running this program, as you must configure your BlueCore device before this program will connect to it. BCFMRadio is a graphical tool for exercising the FM receiver on Bluecore5-FM. It is able to communicate with the Bluecore using I2C or BCCMDs using BCSP, H4, H4 Deep Sleep, H5, USB and SPI. BCFMRadio provides a userfriendly interface allowing configuration of the BlueCore5-FM radio.
BlueSuite Programs 7.11 DFU Wizard The DFU Wizard is a program for end users to upgrade the firmware on their BlueCore devices. The upgrade process is documented in the BlueCore Device Firmware Upgrade (DFU) Overview. 7.12 DFU Babel The USB to SPI Converter (or Babel) contains a BlueCore3-Multimedia chip with special firmware that transforms the USB packets from the host computer to SPI signals sent out over Category 5 cable.
BlueSuite Programs 7.13 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.
Regulatory Notes & Information This device complies with Part 15 of the FCC Rules. Operation is subject to the two following conditions :(1) This device may not cause harmful interference, and (2) 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.
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.
Terms and Definitions Terms and Definitions Definition API Application Programming Interface 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 HCI Host Controller Interface IC Integrated Circuit i.e.