BlueCove supported stacks

On Windows WIDCOMM and BlueSoleil stacks are added in BlueCove version 2.0.0.

Support for Mac OS X added in BlueCove version 2.0.2.

Support for Linux BlueZ added in BlueCove version 2.0.3 as additional GPL licensed module.

To determine which Bluetooth stack is installed on your Windows XP see this page

Windows Mobile

If automatic Bluetooth Stack detection is not enough Java System property "bluecove.stack" can be used to force desired Stack Initialization. Values "widcomm", "bluesoleil" or "winsock". By default winsock is selected if available.

Another property "bluecove.stack.first" is used optimize stack detection. If -Dbluecove.stack.first=widcomm then widcomm (bluecove.dll) stack is loaded first and if not available then BlueCove will switch to winsock. By default intelbth.dll is loaded first.

If multiple stacks are detected they are selected in following order: "winsock", "widcomm", "bluesoleil". Since BlueCove v2.0.1 "bluecove.stack.first" will alter the order of stack selection.

If System property is not an option (e.g. when running in Webstart) create text file "bluecove.stack" or "bluecove.stack.first" containing stack name and add this file to BlueCove or Application jar. (Since v2.0.1)

Use LocalDevice.getProperty("bluecove.stack") to find out what stack is used.

On Windows XP (Not on Vista) WIDCOMM and Microsoft can run at the same time and so different instances of BlueCove can use this stacks in parallel. If you are adventures users on Vista you can use BlueCove dll build with BTW-6_1_0_1501-SDK http://snapshot.bluecove.org/special-build/ to have access to WIDCOMM stack

Broadcom (WIDCOMM)

This stack is most stable stack from one supported by BlueCove Supported RFCOMM and L2CAP (since BlueCove v2.0.1)

Requirements

• BTW Stack software version 1.4.2.10 SP5 or above on Windows32 (before Vista)
• For AMD64 systems you need to build dll yourself
• Broadcom wbtapi.dll required. It is installed with WIDCOMM drivers.
• On Windows Mobile 2003 WIDCOMM BTW-CE stack versions 1.4.1.60 or newer
• On Windows Mobile 5.0 any working Broadcom's WIDCOMM BTW-CE

JSR-82 Limitations

• LocalDevice.setDiscoverable(...) not supported.
• ServiceRecord.setDeviceServiceClasses(..) not supported.
• ServiceRecord attributes of DataElement types URL are discovered as STRING
• If remote device changed its class DiscoveryListener.deviceDiscovered may report older value when -Dbluecove.inquiry.report_asap=true
• Service search requests are executes sequentially. "bluetooth.sd.trans.max=1"
• The discovery database is cumulative. It contains the results of all previous discoveries of the application or any other applications that are running or that have run. So ServiceSearch may return service even when it is down.
• L2CAP unable to send and receive empty L2CAP packet

• ServiceRecord attributes of DataElement types U_INT_8, INT_8, INT_16 and UINT_16 are not properly discovered (fixed in BTW-6_1_0_1501-SDK and stack v 4, get dlls here http://snapshot.bluecove.org/special-build/)
• On Vista WIDCOMM stack detected as Microsoft with all the benefits of one. If you need L2CAP support on Vista and Broadcom v6 use custom bluecove.dll build

Winsock (Microsoft)

Requirements

• Microsoft Bluetooth stack (currently this means Windows XP SP2 or newer and Windows Mobile 2003 or newer)
• Broadcom stack v6 on Windows Vista
• A Bluetooth device supported by the Microsoft Bluetooth stack.
• List of Bluetooth USB dongles working with Microsoft Bluetooth stack
• Windows Mobile Devices and installation instructions

Limitations

• Microsoft Bluetooth stack only support RFCOMM connections
• L2CAP not supported
• DiscoveryListener.deviceDiscovered() would be called for devices that a paired with your Microsoft BT stack regardless if device ON or OFF
• LocalDevice.setDiscoverable(NOT_DISCOVERABLE) will not change the state if discoverable is enabled system wide in "Bluetooth Devices" "Options"
• ServiceRecord.setDeviceServiceClasses not supported on Windows Mobile

BlueSoleil (IVT Corporation)

We don't recommend the use of this stack for the begginers in JSR-82. There are too many limitations that may be very confusing. Also our experience show that you may need to frequently reboot your Windows.

Requirements

• BlueSoleil version 1.6.0, 2.3 or 3.2.2.8. BlueSoleil version 5.0.5 not supported.

JSR-82 Limitations

SDK provided by IVT is very limited. We just implemented what we can on top of it.

• BlueCove on BlueSoleil Bluetooth stack only support RFCOMM and OBEX connections
• Only RFCOMM services can be created. No OBEX services
• L2CAP not supported
• Service attributes are not supported in Service search of when creating Server, LocalDevice.getProperty("bluetooth.sd.attr.retrievable.max") == "0"
• DiscoveryAgent.searchServices() can only find 128bits-GUID service with specific UUID. You can't list all service on remote device.
• DiscoveryAgent.searchServices(.. UUID[] uuidSet, ..) only ONE UUID is used during search, the last one in array.
• You need to run DiscoveryAgent.searchServices() with UUID of your service before you can make connection to it using Connector.open(url);
• Client Connector.open() use GUID of the discovered service. Only one would be selected
• Server can't close incoming connection. It will wait until connection is closed remotely. (Our implementation should be changed to restart Service(Server) each time connection is closed to fix this)
• searchServices can't distinguish the service type (RFCOMM or OBEX). To solve this following UUIDs are always discoved as obex (btgoep://) connections
• IR_MC_SYNC (0x1104), OBEX_OBJECT_PUSH (0x1105), OBEX_FILE_TRANSFER (0x1106), IR_MC_SYNC_COMMAND (0x1107), IMG_RESPONDER (0x111B)
• ServiceRecord.setDeviceServiceClasses not supported

N.B. In our test lab when using fake ES-388 Bluetooth USB Adapter we can only make from 180 to 250 max connections in sequence. After this BlueSoleil.exe needs to restart or Windows needs to be rebooted. This does not happen when we used dongle bought from bluesoleil.com

OS X

Requirements

• PowerPC- or Intel-based Mac OS X 10.4 (Bluetooth v1.2) or late

JSR-82 Limitations

• LocalDevice.setDiscoverable(...) not supported.
• Dynamic assignment of PSM for L2CAP service does not work. 1001 is assigned all the time. Use btl2cap://localhost:uuid;name=test;bluecovepsm=1003
• ServiceRecord attributes of DataElement types U_INT_8, INT_8 are not properly publshed by service on OS X 10.4
• ServiceRecord attributes of DataElement type BOOL published as U_INT_1
• ServiceRecord attributes of DataElement type URL published as STRING
• ServiceRecord.setDeviceServiceClasses(..) will work on Mac OS X 10.5 Leo and later.

Linux BlueZ

N.B. Support for BlueZ is added in BlueCove version 2.0.3 as additional GNU General Public License module bluecove-gpl.

Requirements

• Package bluez-libs 3.7 or later installed on your system

JSR-82 Limitations

• LocalDevice.setDiscoverable(...) supported only when running with superuser privileges.
• ServiceRecord.setDeviceServiceClasses(..) not supported.
• authenticate and encrypt not implemented.