Common issues with the Serial Link Setup

It can be that BT747 does not include the serial drivers for your system. In that case, go to http://rxtx.qbang.org/ToyBox to look if there are binaries for your system. If there are, they couild be included in the BT747 distribution or made available through the web application. Contact the author of BT747 for that: through the contact form on http://www.bt747.org, through a feature request on sourceforge or through e-mail (see the application).

Linux

Apparently the Qstarz Nano 1300 requires another USB driver.
A nice 'how-to' is provided in the forum.

MacOSX

The process can be split in three big steps:

  1. Install the serial link driver
  2. Prepare to get the serial link to work (RxTx driver, only once)
  3. Install the application

In more detail, it goes like this:

  1. Usually the manufacturer did not care about MacOS, so you need to get the serial driver yourself from http://www.silabs.com (CP2102 VCP drivers).

    You do not need that driver if you are using bluetooth.

  2. The trickiest part is the serial link driver with the application (RxTx). It requires the RxTx library to be compatible with the operating system and Java itself.

    You will need to perform the following operations once. The operations make sure that a lock mechanism that is needed by RxTx can work for any user:

    1. go to Applications/Utilities
    2. run Terminal
    3. if you don't work as Admin, log in
      1. type login and press [return]
      2. type the name of the Admin and press [return], enter the password for Admin in next line and press [return]
    4. type sudo mkdir /var/lock and press [return]
    5. enter the password for Admin and press [return]
    6. type sudo chmod 777 /var/lock and press [return]
    7. type exit to log out

    Most of the time this will make things work. You may still get trouble if you have a 64 bit operating system.

    Indeed, at the time of writing, the only RxTx driver available for MacOS is a 32 bit version. You might be running a 64 bit operating system. Your 64 bit operating system can still run 32 bit programs, but when running a 64 bit program, all code it uses 'directly' must be 64 bit. As the RxTx driver does not come as a 64 bit version yet, running Java as a 64 bit version will not work. Quite franckly, there is not real reason to use the 64 bit version of Java, but you probably are if your operating system is 64 bit.
    The solution is to install the 32 bit version of Java instead. I did not look where to find it, send a note to the application author if you know where it is.

  3. Installing the application as indicated elsewhere

When using the Web Start system (running BT747 from the web) the above considerations are still valid. On top of that you also may need to give permission to the application to allow it to use the system's resources.

Windows

As on all platforms, the following steps are needed:

  1. Install the serial link driver (for USB, to be done only once on a computer)
  2. Install the application
  3. Get the serial link to work (RxTx driver)

In more detail, it goes like this:

  1. Usually the USB driver comes on a CD with your device. If not, you can probably get them from http://www.silabs.com (CP2102 VCP drivers)
  2. Installing the application as indicated elsewhere
  3. The trickiest part is the serial link driver with the application (RxTx). It requires the RxTx library to be compatible with the operating system and Java itself.
    At the time of writing, the only RxTx driver available for windows is a 32 bit version. If you have Windows Vista, you might be running a 64 bit operating system. Your 64 bit operating system can still run 32 bit programs, but when running a 64 bit program, all code it uses 'directly' must be 64 bit. As the RxTx driver does not come as a 64 bit version yet, running Java as a 64 bit version will not work. Quite franckly, there is not real reason to use the 64 bit version of Java, but you probably are if your operating system is 64 bit.
    The solution is to install the 32 bit version of Java instead. You can get it on sun's site (http://java.sun.com/javase/6/webnotes/install/system-configurations.html). You'll see that you have a choice between 32 bit and 64 bit.

When using the Web Start system (running BT747 from the web) the above considerations are still valid. On top of that you also may need to give permission to the application to allow it to use the system's resources.