DTL-X Driver for USB Adapters Enabled with Bluetooth® Wireless Technology

License

SOFTWARE LICENSE AGREEMENT OF CYBERABI

CYBERABI ("Licenser") is willing to license the enclosed software to you only if you accept all of the terms in this license agreement. Please read the terms carefully before you install this software, because by installing the software you are agreeing to be bound by the terms of this agreement. If you do not agree to these terms, Licenser will not license this software to you.

Terms:

  1. The enclosed Licenser software program ("Software") is owned by Licenser and is protected by United States copyright laws, by laws of other nations, and by international treaties.
  2. Licenser grants to you the right to use one copy of the Software on a single computer or appliance.
  3. You may not copy the Software, except that you may make one copy of the software solely for backup or archival purposes.
  4. You may not reverse engineer, decompile, or disassemble the Software.
  5. Licenser warrants ("Limited Warranty") that the Software will perform substantially in accordance with the embedded instructions for a period of 90 days from the date of your receipt of the software.
  6. Licenser disclaims all other warranties, either express or implied, including but not limited to implied warranties of merchantability, fitness for a particular purposes, and non-infringement, with respect to the Software.
  7. Licenser's entire liability and your exclusive remedy shall be, at Licenser's choice, either (a) return of the price paid or (b) replacement of the software that does not meet Licenser's limited warranty, each contingent upon presentation of a copy of your receipt to Licenser
  8. The Limited Warranty is void if failure of the Software has resulted from modification, accident, abuse, or misapplication.
  9. In no event will Licenser be liable to you for damages, including any loss of profits, lost savings, or other incidental or consequential damages arising out of your use or inability to use the software.
  10. This Agreement is governed by the laws of the State of Washington, United States of America.

If you have any questions concerning this Agreement or wish to contact Licenser for any reason, please e-mail: info@cyberabi.com

Requirements

Description

If you develop Bluetooth® wireless technology enabled applications for Nokia Series 60 mobiles, DTL-X from CYBERABI is an easy-to-use Windows 2000 device driver that can help with your debugging.

DTL-X allows industry standard USB adapters enabled with Bluetooth wireless technology to emulate the discontinued Nokia Connectivity Card DTL-4. Several Nokia developer kits, including the Symbian OS SDK for Series 60 Version 1.x, can use this connectivity card or an equivalent (and also discontinued) Socket Communications Revision F card to debug Bluetooth applications on a PC host.

Advantages:

DTL-X installs as a Windows COM port, just as a DTL-4 card would.

Due to fundamental technical differences between the DTL-4 compact flash card and industry standard USB devices, DTL-X emulates most, but not all, features of the DTL-4. In our side-by-side tests, DTL-X was recognized by the Series 60 SDK Emulator and performed equivalently to a Socket 8510-00159F card on Nokia's Bluetooth control panel, Notepad, Photo Album, BTP2P, BTAdvertiser, BTDiscovery, and BTOBEX applications.

Compatibility

DTL-X uses only industry standard Bluetooth HCI commands and should work with any USB adapter enabled with industry standard Bluetooth technology, regardless of chipset. Nonetheless there are exceptions.

We've verified DTL-X compatibility with the Belkin F8T003, the Amazing Technology BlueGear, and the Hawking Technology H-BT10U. All of these USB adapters use chipsets from Cambridge Silicon Radio (CSR). Our customers have had success using DTL-X with CSR-based adapters from many vendors.

Adapters based on the Broadcom BCM2033 and similar chipsets are not compatible with DTL-X. These adapters don't support industry standard Bluetooth HCI commands until a proprietary Broadcom firmware loader runs at each power-up. DTL-X does not include a firmware loader, and so cannot be used with these adapters.

Incompatible adapters include:

This list is not comprehensive. Check the specifications of your adapter to determine compatibility.

WARNING: Use DTL-X at your own risk! DTL-X is kernel-mode system software, and may cause your computer to stop responding under certain error conditions. DTL-X is not endorsed by the Bluetooth SIG, Nokia, Microsoft, Cambridge Silicon Radio, Broadcom Corporation, Socket Communications, Amazing Technology, or Hawking Technology. All of the mentioned brand and company names are trademarks or registered trademarks of their respective owners.

Advanced Compatibility

New models of Bluetooth device come onto the market and leave the market constantly. Each device is identified by a unique combination of numbers, the vendor ID (VID) and product ID (PID). The DTL-X.inf file provided with DTL-X driver tells Windows which Bluetooth adapters work with the driver by listing combinations of vendor ID and product ID.

Not all compatible devices are listed in DTL-X.inf due to rapid proliferation of USB adapter models. Although your device might meet all requirements for compatibility with DTL-X, installation will fail if the device isn't listed. In this case, an internet search using your device's model number and the words VID and PID as search terms might reveal the correct IDs for your device. You can then edit your copy of the DTL-X.inf file, adding the necessary VID and PID.

Example: Suppose your USB Bluetooth adapter from XYZ Corporation has VID=0234 and PID=E2DE. This fictional adapter is not listed in DTL-X.inf. To install it, you must add the following two lines to DTL-X.inf.

Below [DeviceList], add:
%USB\VID_0234&PID_E2DE.DeviceDesc%=DTL-X, USB\VID_0234&PID_E2De ; XYZ Corporation VID&PID

Below DTL-XClassName="CYBERABI DTL-X Bluetooth(R) HCI Bridge", add:
USB\VID_0234&PID_E2DE.DeviceDesc="CYBERABI DTL-X (XYZ Corporation USB)"

Save the modified DTL-X.inf file, then re-install the driver making certain that the modified file is used instead of any copy that Windows might have cached (for example, the system might have renamed and cached a copy in WINDOWS\INF\OEMxxx.INF).

These steps should allow you to install DTL-X when using newer USB Bluetooth adapters not listed in DTL-X.inf.

Installation (Windows 2000)

DTL-X installs like any other plug-and-play USB device that uses a custom device driver. There's no installation program, just an .INF file that tells Windows how to install the .SYS device driver. Follow these steps to install DTL-X.

  1. Unzip the archive file to a convenient folder on your hard drive.
  2. Verify that the folder contains the three files, catalog.cat, DTL-X.sys and DTL-X.inf.
  3. Uninstall all other Bluetooth drivers and software from your PC, including any drivers and software that came with your USB Bluetooth adapter.
  4. Make sure your USB Bluetooth adapter is not plugged in to a USB port, and restart your computer.
  5. Insert your USB Bluetooth adapter into a USB port, wait for the Found New Hardware Wizard to appear, and click Next.
  6. Select Search for a suitable driver for my device (recommended) and click Next.
  7. Windows will ask where you want to search. Uncheck all boxes, and then check the Specify a location box, and click Next.
  8. Windows will ask you to insert the manufacturer's installation disk. Instead, click the Browse button and navigate to the folder containing catalog.cat, DTL-X.sys and DTL-X.inf. Then click Open.
  9. The folder path will appear in the text box at the bottom of the prompt window. Click OK.
  10. Click Next to begin installation.
  11. You may receive an Update Driver Warning indicating that Windows cannot verify the source of the DTL-X driver, or that the driver has not been qualified by Microsoft. If you receive such a warning, click Yes to continue.
  12. Wait for the Start Driver Installation dialog to appear, then click Next.
  13. Once the driver is installed, click Finish to close the hardware wizard.

Congratulations! DTL-X is now installed and ready for use.

Emulator Configuration

DTL-X creates a new COM port in the Device Manager control panel of your PC, just as a DTL-4 card would. The COM port created by DTL-X is named CYBERABI DTL-X, and the COM port number is indicated after this name in the control panel (for example, CYBERABI DTL-X (CSR USB) (COM3).

You must configure your Series 60 SDK EPOC Emulator to use this port for Bluetooth functions. To do this, edit the bt.esk file provided with the Emulator.

  1. Set the port parameter in bt.esk to one less than the COM port number of DTL-X, just as you would have to do when configuring a DTL-4 card. For example, to use DTL-X on COM3, set the port parameter in bt.esk to 2.

NOTE: The Version 1.2 EPOC Emulator requires that DTL-X be installed as COM1-COM4. Refer to Nokia's Series 60 Bluetooth testing environment documentation for additional information.

NOTE: The EPOC Emulator does not provide 100% emulation of the actual Series 60 mobile phone Bluetooth environment. The Emulator and phone use different Bluetooth protocol stacks, and different operating system multitasking technologies, leading to differing behaviors and error conditions. The Emulator does not provide all of the same communication services as the phone. Always test your application with a real phone before releasing it!

NOTE: Some emulators install two copies of the bt.esk file; if you find multiple copies, edit each of them.

Device Manager Properties Page

DTL-X creates a properties page for its COM port in the Device Manager. This properties page is accessed from Windows 2000 in the usual manner:

  1. Select Start | Settings | Control Panel
  2. Double-click on System
  3. Select the Hardware tab
  4. Click the Device Manger... button
  5. Expand the Ports (COM&LPT) list if necessary, by clicking on the small + to the left
  6. Right-click on CYBERABI DTL-X, and select Properties from the pop-up menu.

The properties page includes General, Port Settings, and Driver tabs.

You can change the COM port number assigned to DTL-X using the Port Settings | Advanced window. Although the window updates immediately to show the new COM port number, you must restart your PC before the port number change takes effect.

You can change the default data rate and flow control of DTL-X using the Port Settings window. The SDK Emulator prefers a data rate of 115200 bits per second with Hardware flow control, and will set these parameters automatically when running.

NOTE: Versions of DTL-X prior to driver version 5.0.1636.3 ignore all settings made on the Port Settings tab, including the COM port number.

Device Removal

DTL-X supports "surprise removal", meaning you can unplug an adapter controlled by DTL-X at any time, even while your computer is running. However, programs that interact with the DTL-X COM port, such as the EPOC Emulator or an application under test, might respond unpredictably to sudden unplugging of the adapter.

WARNING: Unplugging an adapter with applications running may cause your computer to lock-up or restart.

WARNING: Under Windows XP, DTL-X supports surprise removal only if the Bluetooth USB adapter was plugged in after system start-up.

For best results, we recommend exiting all Bluetooth applications and the EPOC Emulator, and then using the Safely Remove Hardware desktop icon, before unplugging your Bluetooth USB adapter.

Uninstallation (Windows 2000)

You can uninstall DTL-X like any other plug-and-play device, by using the Device Manager. The USB adapter must be plugged in in order to uninstall DTL-X.

Using BH4-X and DTL-X Together

If you've licensed both BH4-X and DTL-X, you can select which protocol to use from the properties page of the Windows Device Manager.

  1. Open the DTL-X or BH4-X properties page (whichever is currently active)
  2. Select the Driver tab
  3. Click on Update Driver, to access the Upgrade Device Driver Wizard
  4. Click Next
  5. Select Search for a suitable driver for my device (recommended) and click Next
  6. If the desired driver is visible in the Select a Device Driver window, click on the desired driver and click Next to switch drivers
  7. Otherwise, click Have Disk..., navigate to the folder where you've installed the desired driver, click on the .INF file, and click Open to install the new driver; in the future, you'll be able to switch drivers as described above.
  8. Click Next, then Finish, to complete the switch or installation.
  9. Close the properties page.

The protocol change is effective immediately. There's no need to re-start the computer, or to unplug and re-insert the USB adapter.

NOTE: Please exit all Bluetooth applications and the EPOC Emulator before changing protocols.

NOTE: The Version 1.x EPOC Emulator requires that DTL-X be installed as COM1-COM4, rather than COM1-COM7. BH4-X and DTL-X use the same COM port. When installing, select a port compatible with all of the emulators you plan to use.

Release History

Version 1.03 (27 March, 2004)

Version 1.03 (29 January, 2004)

Version 1.02 (15 September, 2003)

Version 1.00 (9 September, 2003)

If you need help with installing or using DTL-X, please visit our web site at http://www.cyberabi.com, or contact us at support@cyberabi.com.

Customer Support

We dont just sell DTL-X and BH4-X, we also use then to debug and test CYBERABI's software products that communicate using Bluetooth technology. If you need help with installing or using DTL-X, please visit our website at http://www.cyberabi.com, or contact us at support@cyberabi.com.