Android bluetooth introduction part I

Here is a very detailed image from Android website and it tells us the whole architecture about bluetooth in Android. I tried to understand how bluetooth works in Android Dev phone and what BT services we can use.

I. related source code

* bluez 3.36 (both userspace & kernel)
- /mydroid/externel/bluez
- /mydroid/kernel/drivers/bluetooth
- /mydroid/kernel/net/bluetooth

* framework (java & c++)
- /mydroid/frameworks/base/core/jni/android_bluetooth_*.cpp (connect with hcid via dbus)
- /mydroid/frameworks/base/core/java/android/bluetooth/*.java
- /mydroid/frameworks/base/services/java/com/android/server/ (SystemServer)

* UI application (java)
- /mydroid/packages/apps/Phone/src/com/android/phone/ (Phone App)
- /mydroid/packages/apps/Settings/src/com/android/settings/bluetooth/ (Settings App)


II. Init bluetooth

* init script from /root/init.rc

1. create this directory '/data/misc/hcid' to store paired BT device information
2. launch dbus-daemon (deal connections between hcid and system server)
3. create hcid (Bluetooth Host Controller Interface Daemon) service, but disabled at first
4. create hfag service, it's for bluetooth Hands-Free Profile, but disabled at first, and only 'one shot' (it means not restart this service when it exits). Also it would register a SDP service and channel is 10.
5. create hsag service, it's for bluetooth Headset Profile, but disabled at first, and only 'one shot' (it means not restart this service when it exits). Also it would register a SDP service and channel is 11.
6. create dun service, it's for bluetooth Dial-up Networking Profile, but disabled at first, and only 'one shot' (it means not restart this service when it exits). Also it would register a SDP service and channel is 2.

* init script from /root/init.trout.rc

1. this script file is from /vendor/htc/dream folder and it's particular for this device.
2. create hciattach (attach serial devices via UART HCI to BlueZ stack) service, but disabled at first.
3. specify UART speed is 115200, serial device is /dev/ttyHS0, id/type is texas.

* system server: it would decide whether it should turn bluetooth ON or OFF from settings value. If the value is ON, then it would start hciattach and hcid service. That is why the init scripts set them disabled at first. We can decide BT power from UI application.


III. Connect with other BT devices

• bluez: it provides 'hcid' daemon and it's responsible for all related bluetooth services
• dbus-daemon: the bridge between hcid and system server
• D-Bus is a simple inter-process communication (IPC) system for software applications to communicate with one another.
• debug utility: d-feet (a dbus UI debugger ), dbus-monitor (debug probe to print message bus messages), dbus-send (Send a message to a message bus)
• bluez dbus API document: /mydroid/external/bluez/utils/hcid/dbus-api.txt
• one example as below

* Scan nearby BT devices in Android

In system server, it would send a method 'DiscoverDevices' to bluez via dbus-daemon. This method starts the device discovery procedure. This includes an inquiry procedure and remote device name resolving. On start up this process will generate a DiscoveryStarted signal and then return DeviceFound singals. If the procedure has been finished an DiscoveryCompleted signal will be sent.



/mydroid/frameworks/base/core/jni/android_server_BluetoothDeviceService.cpp

 
/* Compose the command */ 
msg = dbus_message_new_method_call(BLUEZ_DBUS_BASE_IFC, nat->adapter, DBUS_CLASS_NAME, "DiscoverDevices"); 
/* Send the command. */ 
reply = dbus_connection_send_with_reply_and_block(nat->conn, msg, -1, &err); 

log from ddms

 
06-18 14:42:14.567: INFO/BluetoothEventLoop.cpp(67): DiscoveryStarted signal received 
06-18 14:42:14.584: VERBOSE/BluetoothEventRedirector(361): Received android.bluetooth.intent.action.DISCOVERY_STARTED 
06-18 14:42:14.834: VERBOSE/BluetoothEventRedirector(361): Received android.bluetooth.intent.action.REMOTE_DEVICE_FOUND 
06-18 14:42:35.034: INFO/BluetoothEventLoop.cpp(67): DiscoveryCompleted signal received 

http://i-miss-erin.blogspot.com/2009/06/android-bluetooth-introduction-part-i.html

http://source.android.com/porting/bluetooth.html