一、背景及相关知识学习
1、Android Bluetooth SDK
首先,要操作蓝牙,先要在AndroidManifest.xml里加入权限
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" /> <uses-permission android:name="android.permission.BLUETOOTH" />
我们可以通过intent调用android.bluetooth.opp包下的activity也可以直接调用android.bluetooth包使用android的蓝牙功能。
方法如下:
通过android.bluetooth.opp包我们需要作的是:
打开蓝牙:
Intent enabler=new Intent(BluetoothAdapter.ACTION_REQUEST_ENABLE);
startActivityForResult(enabler,reCode);//同startActivity(enabler);
通过android.bluetooth包我们需要做的是以下几点:
(1).BluetoothAdapter
顾名思义,蓝牙适配器,直到我们建立bluetoothSocket连接之前,都要不断操作它。BluetoothAdapter里的方法很多,常用的有以下几个:
cancelDiscovery() //根据字面意思,是取消发现,也就是说当我们正在搜索设备的时候调用这个方法将不再继续搜索 disable() //关闭蓝牙 enable() //打开蓝牙 getAddress() //获取本地蓝牙地址 getDefaultAdapter() //获取默认BluetoothAdapter,实际上,也只有这一种方法获取BluetoothAdapter getName() //获取本地蓝牙名称 getRemoteDevice(String address) //根据蓝牙地址获取远程蓝牙设备 getState() //获取本地蓝牙适配器当前状态(感觉可能调试的时候更需要) isDiscovering() //判断当前是否正在查找设备,是返回true isEnabled() //判断蓝牙是否打开,已打开返回true,否则,返回false listenUsingRfcommWithServiceRecord(String name,UUID uuid) //根据名称,UUID创建并返回BluetoothServerSocket,这是创建BluetoothSocket服务器端的第一步 startDiscovery() //开始搜索,这是搜索的第一步
(2).BluetoothDevice
看名字就知道,这个类描述了一个蓝牙设备
createRfcommSocketToServiceRecord(UUID uuid) // 根据UUID创建并返回一个BluetoothSocket
这个方法也是我们获取BluetoothDevice的目的——创建BluetoothSocket
这个类其他的方法,如getAddress(),getName(),同BluetoothAdapter
(3).BluetoothServerSocket
如果去除了Bluetooth,相信大家一定再熟悉不过了,既然是Socket,方法就应该都差不多, 这个类一种只有三个方法
两个重载的accept(),accept(int timeout)两者的区别在于后面的方法指定了过时时间,需要注意的是,执行这两个方法的时候,直到接收到了客户端的请求(或是过期之后),都会阻塞线程,应该放在新线程里运行!
还有一点需要注意的是,这两个方法都返回一个BluetoothSocket,最后的连接也是服务器端与客户端的两个BluetoothSocket的连接,close()关闭!
(4).BluetoothSocket
跟BluetoothServerSocket相对,是客户端。一共5个方法,不出意外,都会用到
close() //关闭 connect() //连接 getInptuStream() //获取输入流 getOutputStream() //获取输出流 getRemoteDevice() //获取远程设备,这里指的是获取bluetoothSocket指定连接的那个远程蓝牙设备
2、Android Bluetooth 底层知识
Android蓝牙协议栈使用的是BlueZ,支持GAP, SDP, and RFCOMM规范,是一个SIG认证的蓝牙协议栈。
Bluez 是GPL许可的,因此Android的框架内与用户空间的bluez代码通过D-BUS进程通讯进行交互,以避免专有代码。
Headset和Handsfree(v1.5)规范就在Android框架中实现的,它是跟Phone App紧密耦合的。这些规范也是SIG认证的。
下面的图表提供了一个以库为导向的蓝牙栈视图。
实线框的是Android模块,红色虚线部分为合作伙伴指定模块(译者注:芯片商提供)。
下面的图表是以进程为导向视图:
移植
BlueZ是兼容蓝牙2.1的,可以工作在任何2.1芯片以及向后兼容的旧的蓝牙版本。有要有两个方面:
串口驱动 UART driver
蓝牙电源开/关 Bluetooth Power On/Off
串口驱动
BlueZ核心子系统使用hciattach守护进程添加你的指定硬件串口驱动。
例如,MSM7201A,这个文件是在drivers/serial/msm_serial.c。你还需要通过修改init.rc为hciattach来编辑命令行选项。
蓝牙电源开/关
蓝牙芯片的电源开关方法1.0和Post 1.0是不同的,具体如下:
1.0:Android框架写0或1到/sys/modules/board_[PLATFORM]/parameters/bluetooth_power_on
Post 1.0:Android框架使用linux rfkill API,参考 arch/arm/mach-msm/board-trout-rfkill.c例子。
编译
编译Android打开蓝牙支持,添加下面这行内容到BoardConfig.mk。
BOARD_HAVE_BLUETOOTH :=true
调试
调试你的蓝牙实现,可以通过读跟蓝牙相关的logs(adb logcat)和查找ERROR和警告消息。Android使用Bluez,同时会带来一些有用的调式工具。下面的片段为了提供一个建议的例子:
1 hciconfig -a # print BT chipset address and features. Useful to check if you can communicate with your BT chipset. 2 hcidump -XVt # print live HCI UART traffic. 3 hcitool scan # scan for local devices. Useful to check if RX/TX works. 4 l2ping ADDRESS # ping another BT device. Useful to check if RX/TX works. 5 sdptool records ADDRESS # request the SDP records of another BT device.
守护进程日志
hcid(STDOUT)和hciattach(STDERR)的守护进程日志缺省是被写到/dev/null。编辑init.rc和init.PLATFORM.rc在logwrapper下运行这些守护进程,把它们输出到logcat。
hciconfig -a 和 hcitool
如果你编译你自己的system.img,除了hcitool扫描不行,hciconfig -a是可以工作的,尝试安装固件到蓝牙芯片。XXX TBD
工具
BlueZ为调试和与蓝牙子系统通信提供很多设置命令行工具,包含下面这些:
Hciconfig、hcitool、hcidump、sdptool、dbus-send、dbus-monitor
二、主要类的学习
1、 BluetoothOppProvider
继承ContentProvider,所谓ContentProvider是一个提供数据的机制,当希望对其它app提供数据时需要用到。BluetoothOppProvider提供了蓝牙设置相关的数据。其中的数据表位btopp,其数据项包括BluetoothShare._ID、BluetoothShare.URI、 BluetoothShare.FILENAME_HINT、BluetoothShare._DATA、BluetoothShare.MIMETYPE 、BluetoothShare.DIRECTION、BluetoothShare.DESTINATION、BluetoothShare.VISIBILITY、BluetoothShare.USER_CONFIRMATION 、BluetoothShare.STATUS、 BluetoothShare.TOTAL_BYTES、BluetoothShare.CURRENT_BYTES、BluetoothShare.TIMESTAMP、Constants.MEDIA_SCANNED为字段名的数据项。
2、 BluetoothOppReceiver
继承BroadcastReceiver,所谓BroadcastReceiver是一个能够接受以sendBroadcast()方式发送的intent的基类。BluetoothOppReceiver处理系统消息:Intent.ACTION_BOOT_COMPLETED、BluetoothAdapter.ACTION_STATE_CHANGED;其它app发来的消息:BluetoothDevicePicker.ACTION_DEVICE_SELECTED、Constants.ACTION_INCOMING_FILE_CONFIRM;opp service发来的消息:BluetoothShare.INCOMING_FILE_CONFIRMATION_REQUEST_ACTION、BluetoothShare.TRANSFER_COMPLETED_ACTION;应用层发来的消息:Constants.ACTION_OPEN、Constants.ACTION_LIST、Constants.ACTION_OPEN_OUTBOUND_TRANSFER、Constants.ACTION_OPEN_INBOUND_TRANSFER、Constants.ACTION_HIDE、Constants.ACTION_COMPLETE_HIDE。
3、 BluetoothOppService
继承Service,所谓Service是一个能在系统后台工作,向其他app提供服务的机制。每个Service都需要在AndroidManifest.xml上声明。BluetoothOppService提供蓝牙的后台服务,包括文件传输和消息侦听。
4、 BluetoothOppTransfer
为BluetoothOppService提供对象传输客户端功能,调用BluetoothOppObexClientSession维护传输会话。
5、 BluetoothOppRfcommListener
创建进程在OPUSH(OBEX Object Push) Chanel侦听socket消息,并回调BluetoothOppService中的回调函数进行处理。
6、 BluetoothOppRfcommTransport
利用socket实现传输过程,只是封装来一下,并无实质内容。
7、 BluetoothOppObexServerSession
为BluetoothOppService提供对象传输服务器端功能。
8、 BluetoothOppObexClientSession
为BluetoothOppService提供对象传输客户端功能。
三、总结
android.bluetooth.opp包的结构大体如下图分层,其中UI交互层的类主要负责界面显示,用户交互等功能,特别还有其它app通过intent调用bluetooth应用的入口;事务逻辑层主要负责蓝牙应用层事务逻辑(BluetoothOppManager等)和数据抽象处理(BluetoothOppReceiveFileInfo)的功能;服务提供层主要提供对底层功能的封装调用(BluetoothOppProvider)和工具函数与常量(BluetoothOppUtility)。
至于双模开发,要修改的文件应该没有。
来源:oschina
链接:https://my.oschina.net/u/994235/blog/113188