作者：刘旭晖 Raymond转载请注明出处

Email：colorant@163.com 

BLOG：http://blog.csdn.net/colorant/

主页：http://sites.google.com/site/rgbbones

 

在 蓝牙Bluetooth协议栈中，文件传输协议FTP（File Transfer Profile）和电话号码簿访问协议PBAP（Phonebook Access Profile）都是构建在对象交换协议OBEX的基础上（此外还有OPP和Synchronization），而在BlueZ的具体实现中，FTP和 PBAP都是基于类似的底层API接口和调用路径实现的，两者在内部实现中有很大的相似之处。因为在最近的工作中参与了PBAP的代码实现，所以在这里记 录一下自己对这部分内容的理解和相关协议的使用方法。

 

1         相关说明

1.1        相关网站资源

BlueZ的官方网址：http://www.bluez.org/ 这里提供最新的Release版本下载

http://git.kernel.org/ BlueZ 相关的几个Git代码仓库都放在这里，包括我们要用到的BlueZ，bluez-gnome，openobex和obexd

Bluez的Wiki：http://wiki.bluez.org/wiki/ 这里提供Bluez相关的Howto等文档资源

http://en.wikipedia.org/wiki/VCard vCard格式等相关内容

相关邮件列表：

http://vger.kernel.org/vger-lists.html#linux-bluetooth Bluez开发者活动的地方，有什么Bug之类的怀疑，还有编程接口之类的问题，就发到这里吧。

IRC Channel:

irc://freenode/obexd

irc://freenode/bluez

1.2        工作环境

因 为在BlueZ中FTP的实现最近做了一些变更，而PBAP则是新实现的Profile，所以要让这两者能正常工作，需要使用大于4.22版本的 BlueZ，同时，openobex和obexd需要使用2008/12/24日以后的版本。按Release版本号来说，应该相应的会是1.5和0.9 以后的版本（到今天2009/1/4为止，还没有正式发布版本 ：）

 

2         基本工作原理

2.1        代码框架

基本上来说，openobex实现了obex protocol中相关的API接口，实现了对Connect / Disconnect / Get / Put / Setpath / Abort 等command的支持。

 

而在obexd的代码中，则实现了对FTP、PBAP、OPP等profile的支持（包括Server端的代码和Client端的代码）

2.2        大致工作流程

因为基于OBEX的协议，基本上都会包括Server和Client两端，obexd中实现的FTP和PBAP也不例外。Obexd和上层应用的交互是通过DBUS接口来实现的。详细的dbus接口API定义可以看源码包中doc目录下的相关文档

2.2.1          Server端启动流程

Obexd 启动后，首先会初始化Manager模块，在dbus的org.openobex service中注册一个org.openobex.Manager 接口，主要用来注册Agent代理，和发送session、transfer等数据传输相关操作的signal。

 

在加载Plugin后，obexd会根据启动命令行传入的参数，相应的加载FTP、OPP、PBAP等相关Profile的server端代码，并在SDP数据库中添加相关server的记录，便于客户端查找相关服务。

 

对 于PBAP来说，为了能够支持从不同的数据来源获取电话号码簿信息，例如不同的电话协议栈或者其它联系人地址簿来源（例如从MAIL相关应用的地址簿数据 库中），Server端的实现是分成common的接口框架和具体的Plugin来实现的。Common的接口框架负责和obex交互，应答从 client端发送过来的请求，并调用具体的Plugin获取应答所需的联系人地址簿信息

 

对于FTP来说，上层应用还需要通过Manager接口在DBUS上注册一个Agent对象用来获取和处理权限和文件路径等相关信息。在test目录下可以找到一个python脚本的示例程序：simple-agent

2.2.2          Client端调用流程

在Client端，obex-client同样是作为后台守护进程来实现的，启动后，会在dbus的org.openobex.client service 中注册一个org.openobex.Client接口，用来接收上层应用发送的具体操作请求。

 

对 于FTP和PBAP来说，应用程序首先都要先通过org.openobex.Client接口创建一个数据传输的Session并在DBUS上注册 Session相关接口和函数。根据创建session时传递的参数，obex-client会加载FTP或PBAP的相关代码，在DBUS中注册FTP 或PBAP相关的具体接口函数。应用程序进一步调用这些接口上的相关函数实现所需的操作。

 

FTP和PBAP client端同样可以通过Session的接口，注册一个Agent（不是必需的）用来显示数据传输的进程，或者中断数据传输。

 

3         具体使用方法

首先，BlueZ的连接配对等流程和本文档无关，具体可以参考其他相关文档或者我的另一篇文档：ARM平台上BlueZ的移植和使用和配置（当然因为版本和平台不同，多少还是有些区别），这里就不在重复。

 

因为PBAP和FTP的相似性，而FTP在正式的代码中还没有提交正式的sample测试脚本，所以这里仅以PBAP为例介绍相关的函数接口和调用流程

 

3.1        PBAP相关函数接口的使用

PBAP的DBUS函数接口API文档可以在doc/client-api.txt中找到，在那里我描述了PBAP具体的每一个函数接口。如果想要更深入的了解相关的API，还可以参考PBAP的SPEC文档：

http://www.bluetooth.com/NR/rdonlyres/58FC38BF-9ED6-49FF-81CF-E0B95B130D72/7761/PBAP_SPEC_V10r00.pdf

 

此外，test/pbap-client 是一个基于python的sample测试脚本。

 

基本上，看上述文档和脚本应该就没问题了，不过下面还是就sample脚本中PBAP相关的操作做一些解释吧：

 

#!/usr/bin/python

 

import sys

import dbus

bus = dbus.SessionBus()

 

client = dbus.Interface(bus.get_object("org.openobex.client", "/"),

                                                "org.openobex.Client")

 

到这里为止得到org.openobex.Client的接口对象，如果obexd已经由Make Install安装的话，obex-client可以不需要手工启动，dbus会根据相关的service文件自动启动obex-client。

 

session_path = client.CreateSession({"Destination": sys.argv[1], "Target": "PBAP"})

 

为PBAP创建一个Session，这里Destination后面跟的参数是server端的BT地址，所以该脚本的命令行调用形式类似这样：

./pbap-client 11:22:33:44:55:66

如果在指定的BT地址上没有server端的进程（OBEXD）在运行，或者没有对应的服务，脚本执行到这里就会出错退出。

 

pbap = dbus.Interface(bus.get_object("org.openobex.client", session_path),

                                                "org.openobex.PhonebookAccess")

 

得到PBAP对应的接口对象

 

session = dbus.Interface(bus.get_object("org.openobex.client", session_path),

                                                        "org.openobex.Session")

 

得到session接口对象，这一步如果你不需要注册Agent代理的话，可以不需要。

 

pbap.Select("int", "pb")

 

选 择server端内部的Phonebook对象。在PBAP协议中，Phonebook对象的位置分为内部和外部SIM卡上的两类。 而具体的phonebook对象，又分pb：联系人地址簿，ich：呼入电话记录，och：呼出电话记录，mch：未接电话记录，cch：复合电话记录 （呼入 + 呼出 + 未接）等几类。通常来说Server端都会支持内部的联系人地址簿，而SIM卡上的phonebook对象，有些手机可能不会支持。

 

ret = pbap.PullAll()

print "%s" % (ret)

 

获取并打印当前选定的phonebook对象的内容，具体信息是以vCard的格式返回的字符串信息。

 

ret = pbap.GetSize()

print "Size = %d\n" % (ret)

 得到当前phonebook对象的大小（即有多少个vCard条目）

 ret = pbap.List()

for item in ret:

        print "%s : %s" % (item[0], item[1])

 列出当前Phonebook对象的vCard条目，返回结果是以结构体数组的形式组织的，每个结构体内包含一对字符串对，分别对应了vCard条目本身的名字（如0.vcf）和其中联系人的名字信息。 

if len(ret) > 0:

        ret = pbap.Pull(ret[0][0])

        print "%s" % (ret)

 Pull函数用来获取当前phonebook对象中，具体的某一条vCard的内容，输入参数为vCard条目的名字，例如1.vcf。需要注意的一点是，vCard条目的名字可能并不是连续的，最好严格按照List函数所获得的信息来调用该函数。

ret = pbap.ListFilterFields()

for item in ret:

        print "%s" % (item)

 

因 为PBAP协议中可以设置返回的vCard信息中应该包含的信息，你可以设置PBAP返回vCard中的所有内容，或着只返回名字，电话等部分内容，所以 在PBAP Client端的DBUS接口中，我们提供了一系列的函数用来设置Filter参数，sample脚本中示范的是列出当前的Filter参数。

此外，还有一些配置相关的函数没有在sample脚本中一一示例，请参考前面提到的API文档。