You're a Java developer, and you've finally got yourself a
Bluetooth device. Maybe it's a cell phone, a PDA, or a USB dongle for
your PC. Or perhaps you've heard a lot about Bluetooth, but you aren't
sure what exactly you can do with it. In either case, you've had some
exposure to Bluetooth, and now you're ready to start flexing your programming
muscles with the technology. Great! The purpose of this article is to give you
a good introduction to the Bluetooth protocol, including an overview of its
protocol layers and profiles. We'll also cover the the classes and methods
of JSR-82, the official Java Bluetooth API. Finally, we'll wrap things
up by describing what software that you'll need in order to get started.
What is Bluetooth?
What exactly is Bluetooth? Well, simply stated, Bluetooth is a wireless communication
protocol. Since it's a communication protocol, you can use Bluetooth to communicate
to other Bluetooth-enabled devices. In this sense, Bluetooth is like any other
communication protocol that you use every day, such as HTTP, FTP, SMTP, or IMAP. Bluetooth
has a client-server architecture; the one that initiates the connection is the
client, and the one who receives the connection is the server. Bluetooth is a
great protocol for wireless communication because it's capable of transmitting
data at nearly 1MB/s, while consuming 1/100th of the power of Wi-Fi.
In order for Bluetooth devices to communicate properly, they all need to
conform to the Bluetooth specification. The Bluetooth specification, like any
other spec, defines the standard that a Bluetooth device should adhere to, as
well as rules that need to be enforced when communicating. You can download
the specification documents at the official Bluetooth
web site. The Bluetooth protocol stack and profiles together comprise the
Bluetooth specification.
The Bluetooth Protocol Stack
The Bluetooth stack is the software or firmware component that has direct access
to the Bluetooth device. It has control over things such as device settings, communication
parameters, and power levels for the Bluetooth device. The stack itself consists
of layers, and each layer of the stack has a specific task in the overall functionality
of the Bluetooth device. Since Bluetooth device manufacturers are not required to use all of the layers in the stack, we're only going to cover the main ones that are implemented in almost every Bluetooth device.
HCI is the Host Controller Interface. This layer is the interface between
the radio and the host computer.
L2CAP stands for Logical Link Controller Adaptation Protocol. This layer
is the multiplexer of all data passing through the unit. Audio signals, however,
have direct access to the HCI.
SDP is the Service Discovery Protocol. The SDP layer is used to find services
on remote Bluetooth devices.
RFCOMM is widely known as the virtual serial port protocol.
OBEX is the object exchange protocol.
Bluetooth Profiles
Bluetooth Profiles were created to allow different Bluetooth devices to interoperate.
For instance, let's say that you own a Bluetooth-enabled PDA and a Bluetooth-enabled wireless phone. Both devices have Bluetooth stacks. How can you
tell if those two devices will allow you to synchronize the phone lists between
each other? How will you know if you can send a phone number from the PDA to
the phone? And most importantly, how can you determine if these devices will
allow you to browse the Internet from the PDA, using the phone as a wireless modem?
A Bluetooth profile is a designed set of functionality for Bluetooth devices.
For instance, using the examples listed above, the phone and the PDA must both
support the Synchronization Profile in order to synchronize data between them.
In order to send object data such as a .vcf file from the PDA to the phone, then both
devices need to have the Object Push Profile implemented. Finally, the PDA
and the wireless phone must both support the Dialup Networking Profile in order
for the PDA to wirelessly browse the Internet via the phone. If you want your
Bluetooth-enabled devices to interact, having a Bluetooth stack is not good
enough -- they also need to conform to a particular profile.
A word of caution here: do not get Bluetooth profiles confused with J2ME profiles. J2ME profiles are a set of Java classes that extend the functionality of a J2ME
Configuration. For instance, the MID Profile is a set of Java classes that extend
the functionality of the Connected Limited Device Configuration. On the other
hand, a Bluetooth profile can be implemented in any language and on any platform,
because it refers to a defined set of functionality for a Bluetooth-enabled
device. So the Object Push Profile can be implemented on a Palm OS PDA in C++,
and can be implemented on a Bluetooth-enabled printer in assembly language.
For those of you who are familiar with RUP methodology, Bluetooth Profiles are
also called Bluetooth Use Cases.
Java Bluetooth Application Concepts
The basic concepts of any Bluetooth application (Java or otherwise) consist
of the following components:
Stack Initialization
Device Discovery
Device Management
Service Discovery
Communication
The Java Bluetooth Specification adds a special component to the mix called
the Bluetooth Control Center (BCC), which is outside of the scope of this article.
Stack Initialization
Before you can do anything, you need to initialize your stack. Remember,
the stack is the piece of software (or firmware) that controls your Bluetooth
device. Stack initialization can consist of a number of things, but its main
purpose is to get the Bluetooth device ready to start wireless communication.
Every vendor handles stack initialization differently, so we'll cover how to
initialize the stack using the Atinav Java Bluetooth SDK.
import javax.bluetooth.*;
import javax.microedition.io.*;
import com.atinav.BCC;
public class WirelessDevice implements DiscoveryListener {
LocalDevice localDevice = null;
public WirelessDevice (){
//setting the port number using Atinav's BCC
BCC.setPortName("COM1");
//setting the baud rate using Atinav's BCC
BCC.setBaudRate(57600);
//connectable mode using Atinav's BCC
BCC.setConnectable(true);
//Set discoverable mode using Atinav's BCC
BCC.setDiscoverable(DiscoveryAgent.GIAC);
try{
localDevice = LocalDevice.getLoaclDevice();
}
catch (BluetoothStateException exp) {
}
// implementation of methods in DiscoveryListener class
// of javax.bluetooth goes here
// now do some work
}
}
Device Management
LocalDevice and RemoteDevice are the two main classes
in the Java Bluetooth Specification that allow you to perform Device Management.
These classes give you the ability to query statistical information about
your own Bluetooth device (LocalDevice) and information
on the devices in the area (RemoteDevice). The static method LocalDevice.getLocalDevice()
returns an instantiated LocalDevice object for you to use. In order to get the
unique address of your Bluetooth radio, just call getBluetoothAddress() on your
local device object. The Bluetooth address serves the same purpose of the MAC
address on the network card of your computer; every Bluetooth device has a unique
address. If you want other Bluetooth devices in the area to find you, then call
the setDiscoverable() method in LocalDevice object.
In a nutshell, that's about all it takes to perform Device Management with the
Java Bluetooth Specification APIs. Now, let's take a look at the concept in Bluetooth
that allows you to discover other Bluetooth devices: device discovery.
Device Discovery
Your Bluetooth device has no idea of what other Bluetooth devices are in
the area. Perhaps there are laptops, desktops, printers, mobile phones, or PDAs
in the area. Who knows? The possibilities are endless. In order to find out,
your Bluetooth device will use the Device Discovery classes that are provided
into the Java Bluetooth API in order to see what's out there.
Let's take a look at the two classes needed in order for your Bluetooth
device to discover remote Bluetooth devices in the area: DiscoveryAgent and
DiscoveryListener.
After getting a LocalDevice object, just instantiate a DiscoveryAgent
by calling LocalDevice.getDiscoveryAgent().
The are multiple ways to discover remote Bluetooth devices, but to be brief,
I'll just show you one particular way. First, your object must implement the
DiscoveryListener interface. This interface works like any listener, so it'll
notify you when an event happens. In this case, you'll be notified when Bluetooth
devices are in the area. In order to start the discovery process, just call
the startInquiry() method on your DiscoveryAgent. This method is non-blocking,
so you are free to do other things while you wait for other Bluetooth devices
to be found.
When a Bluetooth device is found, the JVM will call the deviceDiscovered()
method of the class that implemented the DiscoveryListener interface.
This method will pass you a RemoteDevice object that represents the device discovered by
the inquiry.
Service Discovery
Now that you know how to find other Bluetooth devices, it would be really nice
to see what services that those devices offer. Of course, if the RemoteDevice
is a printer, then you know that it can offer a printing service. But what if
the RemoteDevice is a computer? Would it readily come to mind that you can also print to a
printer server?
That's where Service Discovery comes in. You can never be sure what services
a RemoteDevice may offer; Service Discovery allows you to find out what they are.
Service Discovery is just like Device Discovery in the sense that you use the
DiscoveryAgent to do the "discovering." The searchServices()
method of the DiscoveryAgent class allows you to search for services
on a RemoteDevice. When services are found, the servicesDiscovered()
will be called by the JVM if your object implemented the DiscoveryListener
interface. This callback method also passes in a ServiceRecordobject
that pertains to the service for which you searched. With a ServiceRecord
in hand, you can do plenty of things, but you would most likely would want to
connect to the RemoteDevice where this ServiceRecord originated:
Before a Bluetooth client device can use the Service Discovery on a Bluetooth
server device, the Bluetooth server needs to register its services internally
in the Service Discovery database (SDDB). That process is called Service Registration.
This section will discuss what's involved for Service Registration for a Bluetooth
device, and I'll also give you a rundown of the classes needed to accomplish this.
Note: In a peer-to-peer application, such as a file transfer or chat application,
be sure to remember that any device can act as the client or the server, so
you'll need to incorporate that functionality (both client and server) into
your code in order to handle both scenarios of Service Discovery (i.e., the client)
and Service Registration (i.e., the server). Here's a scenario of what's involved
to get your service registered and stored in the SDDB.
Call Connector.open() and cast the resulting Connection to a StreamConnectionNotifier.
Connector.open() creates a new ServiceRecord and sets some attributes.
Use the LocalDevice object and the StreamConnectionNotifier to obtain the ServiceRecord that was created by the system.
Add or modify the attributes in the ServiceRecord (optional).
Use the StreamConnectionNotifier and call acceptAndOpen() and wait for Bluetooth clients to discover this service and connect.
The system creates a service record in the SDDB.
Wait until a client connects.
When the server is ready to exit, call close() on the StreamConnectionNotifier.
The system removes the service record from the SDDB.
StreamConnectionNotifier and Connector both come from the javax.microedition.io
package of the J2ME platform. The code that accomplishes the above task is shown
below in the following snippet:
// lets name our variables
StreamConnectionNotifier notifier = null;
StreamConnection sconn = null;
LocalDevice localdevice = null;
ServiceRecord servicerecord = null;
// step #1
// the String url will already be defined with the
// correct url parameters
notifier = (StreamConnectionNotifier)Connector.open(url);
// step #2
// we will get the LocalDevice if not already done so
localdevice = LocalDevice.getLocalDevice();
servicerecord = localdevice.getRecord(notifier);
// step #3 is optional
// step #4
// this step will block the current thread until
// a client responds this step will also cause the
// service record to be stored in the SDDB
notifier.acceptAndOpen();
// step #5
// just wait...
// assume the client has connected and you are ready to exit
// step #6
// this causes the service record to be removed
// from the SDDB
notifier.close();
And that's all that you need to do Service Registration in Bluetooth. The next
step is Communication.
Communication
Bluetooth is a communication protocol, so how do you communicate with it?
Well, the Java Bluetooth API gives you three ways to send and receive data,
but for right now, we'll cover only one of them: RFCOMM.
Note: RFCOMM is the protocol layer that the Serial Port Profile uses in order
to communicate, but these two items are almost always used synonymously.
Server Connections with the Serial Port Profile
The code listing below demonstrates what is needed to open a connection on a Bluetooth
device that will act as a server.
// let's name our variables
StreamConnectionNotifier notifier = null;
StreamConnection con = null;
LocalDevice localdevice = null;
ServiceRecord servicerecord = null;
InputStream input;
OutputStream output;
// let's create a URL that contains a UUID that
// has a very low chance of conflicting with anything
String url =
"btspp://localhost:00112233445566778899AABBCCDDEEFF;name=serialconn";
// let's open the connection with the url and
// cast it into a StreamConnectionNotifier
notifier = (StreamConnectionNotifier)Connector.open(url);
// block the current thread until a client responds
con = notifier.acceptAndOpen();
// the client has responded, so open some streams
input = con.openInputStream();
output = con.openOutputStream();
// now that the streams are open, send and
// receive some data
For the most part, this looks like just about the same code used in Service Registration,
and in fact, it is! Service Registration and Server Communication are both accomplished
using the same lines of code. Here's a few items that I want to point out. The
String url begins with btspp://localhost:, which is
required if you're going to use the Bluetooth Serial Port Profile. Next comes
the UUID part of the URL, which is 00112233445566778899AABBCCDDEEFF.
This is simply a custom UUID that I made up for this service; I could have chosen
any string that was either 32 bits or 128 bits long. Finally, we have ;name=serialconn
in the url String. I could have left off this part, but I want my custom service
to have a name, so the actual service record in the SDDB has the following entry:
ServiceName = serialconn
The implementation has also assigned a channel identifier to this service.
The client must provide the channel number along with other parameters in order
to connect to a server.
Client Connections with the Serial Port Profile
Establishing a connection with the Serial Port Profile for a J2ME client is
simple because the paradigm hasn't changed for J2ME I/O. You simply call Connector.open().
StreamConnection con =(StreamConnection)Connector.open(url);
You obtain the url String that is needed to connect to the device from the
ServiceRecord object that you get from Service Discovery. Here's a more
complete listing of code that will show you how a Serial Port Profile client
makes a connection to a Serial Port Profile server.
String connectionURL = serviceRecord.getConnectionURL(0, false);
StreamConnection con =(StreamConnection)Connector.open(connectionURL);
What does a SPP client connection URL look like? If the address of the server
is 0001234567AB, the String that the SPP client would look something like this:
btspp://0001234567AB:3
The 3 at the end of the url String is the channel number that the server assigned
to this service when this service was added to the SDDB.
Java Bluetooth Development Kits
The most widely available development kit for Java Bluetooth applications is
the J2ME
Wireless Toolkit 2.2 from Sun. It incorporates a Bluetooth network simulator,
and has support for OBEX. And best of all, it's free! The current version of
the J2ME Wireless Toolkit is available on Windows platforms.
If you're targeting JSR-82-enabled Nokia phones, such as the 6600, then you
may also want to try out the Nokia
Developer's Suite 2.1. Much like Sun's Wireless Toolkit, the Nokia Developer's
Suite is free and it also includes a Bluetooth network simulator. The Nokia
Developer's Suite supports Windows and Linux platforms.
SonyEricsson also makes a free development kit for its P900 Java Bluetooth-enabled phone, which can be found at their developer site.
Atinav makes one of the most comprehensive JSR-82
implementations and developer kits with support for J2ME CLDC, J2ME CDC,
and J2SE devices. They support numerous RS-232, UART, USB, CF, and PCMCIA Bluetooth
devices. Their solution is based on an all-Java stack, and their SDK includes
the following profiles: GAP, SDAP, SPP, OBEX, FTP, Sync, OPP, Fax, and Printing
-- whew! They make the only JSR-82 implementation for the PocketPC platform,
and also support Windows and Linux.
Possio makes a JSR-82
development kit that complements their Java Bluetooth-enabled access point,
the PX30. The PX30 is a Linux-based access point, and is powered by an Intel XScale
processor. It includes Wi-Fi, Bluetooth, and the CDC Foundation Profile.
Rococo is famous for making the first
Java Bluetooth Simulator, although they also make a Java Bluetooth developer
kit for the Palm OS 4 platform. The simulator is currently priced at $1000, and supports the following profiles:
GAP, SDAP, SPP, and GOEP.
Avetana
is a German company that makes the only JSR-82 implementation for the Mac OS
X platform. They also provide JSR-82 implementations for Windows and Linux.
Summary
What have we learned here? Hopefully, you should have a good understanding
of what Bluetooth is and how to use it. Before you start communicating to other
Bluetooth devices, you need to discover the devices in your vicinity, and search
for their services. After all of the preliminaries are out of the way, you can
stream data back and forth to any Bluetooth-enabled device in your area, whether
it's running Java or not.
With over one million Bluetooth-enabled devices shipping per week (that's
right, one million devices per week), there's a lot of PDAs, cell phones, laptops,
desktops, access points, cameras, keyboards, mice, printers, audio players,
and vehicles out there for your mobile Java apps to play with!
Bruce Hopkins is the Chief Architect of Hopkins Technology and Research, and the author of the book, Bluetooth for Java.
Bluetooth Scatternet
2007-08-23 17:10:48 lindal22
[Reply | View]
Hi there,
I would like to get some help here with my project:
I'm going to implement a Bluetooth scatternet on real Bluetooth enabled devices for my project. According to the Bluetooth Specification, the master node can make changing on the states of slaves in a piconet, such as inquire/inquiry scan, page/page, active, sniff, park, unpark..., and a slave node can change it states itself as well, but how can I implement it in the real devices? Can I get access to the LMP to control the states of Bluetooth devices in a piconet or scatternet, from my applications ? Thank you very much.
bluetooth rfcomm communication with printer
2007-06-12 20:41:15 need_help_j2me
[Reply | View]
i need some help with programming code to interact with a bluetooth printer server, model WOOSIM SM40
any1 no of a java application that lets me listen 2 my music on my cell on my bluetooth headset?? i dont get it...u kan talk and listen the other dude, but u kant hear ur music....any1 no if its possible? my phone doesnt have that feature..its the sony ericsson z530i....thanxx
Sending files from PC to mobile
2007-04-18 07:33:11 krisp
[Reply | View]
Hi
I am trying to develop a java application that will send a file to a mobile device. Does anyone have any code or anywhere I can start from?
Sending files from PC to mobile
2008-08-18 07:31:52 twitmant
[Reply | View]
Hi,
I am trying to develope a java application that will send messages from a mobile to a PC.
Do you have any code or anywhere I can start from?
Thaks
I Witman
Alternative JSR-82 Dev Kits
2007-03-30 10:27:19 bruse
[Reply | View]
Just wanted to add there is now one more JSR-82 stack option to choose from : ElectricBlue JSR-82 Stack
Connecting Pc to Mobile using Bluetooth
2007-02-13 23:14:45 njja08
[Reply | View]
I am trying for an application that connects Pc to a mobile device using Bluetooth.
For that Do I need any tool kit.
If yes then Can anyone give me the deatails.
Thanks.
Connecting Pc to Mobile using Bluetooth
2007-03-30 10:29:31 bruse
[Reply | View]
Connecting Pc to Mobile using Bluetooth
2007-02-27 00:36:45 miaogaoshan
[Reply | View]
There two kinds of solutions for PC-Mobile Connection using Bluetooth.One is Comm-based Solution , and the other is JSR-82 Based Solution.
The latter is easer , more direct and needs less tools which , however (I think) , are more difficult to find on Web.
I suggest you use the former solution , which requirs a Bluetooth stack ( for example, example, the Bluetooth stack of Windows Service Pack 2 ,Widcomm Bluetooth stack or BlueSoleil Bluetooth stack ) and the javax.com package ( the package can be downloaded from java.sun.com website).
You can contact me if you want some more detail, my email is flyoverthesky@163.com.
Best Wishes~~
Connecting Pc to Mobile using Bluetooth
2008-06-28 07:33:00 arch_cancer
[Reply | View]
Sir, i 've build a client application using widcomm sdk on pc and the server on mobile phone using jsr82. The two can connect each other which i use RFComm protocol. But i have a problem on sending data from or to my phone. When i check on my server code, i found that the notifier work properly, but the acceptAndOpen didn't work, any advice about this ?? This is my email address "ItsLUp2U@gmail.com" thanks a lot
Connecting Pc to Mobile using Bluetooth
2007-04-05 13:23:40 nazmin
[Reply | View]
please contact me sir....my email is ajoi.21@gmail.com....i have sending u a email....i want to know how to use widcomm bluetooth stack or bluesoleil bluetooth stack...
A bluetooth example
2006-10-25 17:31:33 nikosft
[Reply | View]
Hi,
I have created a j2me example that finds bluetooth devices by their names and shows the service names each device offers. If anybody is interested in he/she can find it here
A bluetooth example
2008-05-02 21:20:36 norhan__1987
[Reply | View]
Hi,
I have download your code,it is runing but no bluetooth devices are discovered in the emulator,could u please tell me how to define bluetooth devices in this code.
Thanks in advance
A bluetooth example
2008-05-02 21:02:34 norhan__1987
[Reply | View]
Hi,
I have download your code,its runing on the emulator but no bluetooth discovered,could you please tell me how could i define a bluetooth devices to be discovered by the emulator
Thanks in advance
A bluetooth example
2007-01-12 22:19:58 sinaet
[Reply | View]
Hi,
I run you MIDlet. It just sits there in searching mode. I am running it in an XP with a USB BT device. A silly question: is it suppose to work and get information from real BT devices nearby? Do I need JSR 82 code as well? How will it talk to an off-the-shelf BT device?
Regards,
Sina
Please respond to sinaet@msn.com
Is there a free BTStack for PDA?
2006-05-15 23:50:58 pawelolejnik
[Reply | View]
Looking for a BTStack for PDA which is free.It doesnt exist such thing :(. Avetana BT Stack it's a cost of 8000$ !!! Why dont we create together a BTStack for PDA which would be free!
How about support for Bluetooth application in PC?
2005-11-07 02:36:09 neko_whisker
[Reply | View]
How about giving support for creating Bluetooth Java application in PC to communicate with BT enabled devices?
How about support for Bluetooth application in PC?
2006-04-01 18:41:17 j2me_bluetooth
[Reply | View]
I have created bluetooth apps for connecting PC and Mobile devices, PC-PC. Pls contact me at lethanhvuoss@gmail.com.
How about support for Bluetooth application in PC?
2006-07-22 00:21:26 sir_hussain
[Reply | View]
Hi,
Thank's I am finding way to connect PC & mobile devices via bluetooth,actually i want excanhe of data b/w servelet running on webserver on my pc & j2me(midlet program.) running on pc.can u provide me complete step with code to me,my email id-siraj.hb@gmail.com
How about support for Bluetooth application in PC?
2006-05-29 16:13:56 grishaklimov
[Reply | View]
Hello,
can you please send me some code snippets of your PC application that interacts with cellphone within bluetooth.
I can't execute "LocalDevice device = LocalDevice.getLocalDevice();" because of "javax.bluetooth.BluetoothStateException"
How about support for Bluetooth application in PC?
2006-02-02 17:12:29 weioscar
[Reply | View]
Can anyone help on the question above??
Resource you forgot
2004-07-27 22:09:40 shareme
[Reply | View]
Getting Started with Java and Bluetooth
java.net RSS Feeds
