用途
OBEX协议通过简单的使用“PUT”和“GET”命令实现在不同的设备、不同的平台之间方便、高效的交换信息。支持的设备广泛,例如PC,PDA,电话,摄像头,自动答录机,计算器,数据采集器,手表等等。
OBEX协议定义了一种柔性的概念——objects。也即是对象。这些对象可以包括文件,诊断信息,电子商务卡片,银行的存款等等。Objects在这里没有高级的技术含义,而是视你的应用而定。
OBEX协议小到可作“命令和控制”功能,例如对电视机,录像机等的操作。大到可以做很复杂的操作,例如数据库的事务处理和同步。
OBEX能够具有以下几个特点:
1、友好的应用——可实现快速开发。
2、紧缩——可用在资源有限的小型设备上。
3、跨平台
4、柔性的数据支持。
5、方便的作为其他Internet传输协议的上层协议。
6、可扩展性——提供了对未来需求的扩充支持而不影响以存在的实现。例如可扩展安全,数据压缩等。
7、可测试可调试。
更为具体的关于OBEX的介绍请查阅IrOBEX协议。
对象模型
关于Headers
对象模型回答了对象是如何在OBEX协议描述的。这个模型必须包括被传输的对象和对对象的描述。为了做到这点,OBEX定义了Headers的概念。
一个Header反映了对象的一个方面,例如名字、长度、描述文字或者对象本身。例如,一个文件对象demo.txt会包含它的名字,一个类型标示为“text”,长度和文件本身。
Headers的构成
Headers简单的由
HI由一个字节组成,指出了Header包含的内容以及它的格式。HV包含了一个或者多个字节,其结构由HI所决定。
所有的Header都是可选的,取决于设备的类型和事务的种类。你可以使用所有的Header,或者一些,或者没有。ID可以使Header可解析以及与传输顺序无关,也可以使不支持的Header被忽略掉。
HI又可以分为两部分,高2位和低6位。高2位确定了HI的编码方式(见表二),低6位确定了HI的意义(见表三)。两个表都是我从IrOBEX中的表摘抄并部分翻译过来的。
表二
HI的第8和第7位 | 意义 |
| 00(0x00) | 以Null(0x00)结尾的的Unicode文字。2个字节的无符号整数长度前缀。 |
| 01(0x40) | Byte块,2个字节的无符号整数前缀。 |
| 10(0x80) | 1Byte容量。 |
| 11(0xC0) | 4Byte容量,以高位先传输为原则。 |
表三
HI | Header名称 | 描述 |
| 0xC0 | Count | 连接中用于指名对象的数量。 |
| 0x01 | Name | 对象的名字。一般为文件名。 |
| 0x42 | Type | 对象的类型。例如text,html,binary,manufacture specific |
| 0x440xC4 | Time | 时间戳。ISO 8601版本时间戳。4Byte版本(用于兼容) |
| 0x05 | Description | 对对象的文本描述 |
展开表格关于常用Header的更详尽的解释,更详尽信息请参考IrOBEX
1
、NameName是一个用来描述对象名称的Header,由以Null(0x00)结尾的Unicode字符串组成。例如:DEMO.TXT
2、Length
Length描述了对象的大小,由4个字节组成。如果Length事先知道,这个Header应该被用到。这样可以让接受者迅速的知道需要分配多少空间,可使处理更为迅速。但这也不是必须的,有些情况下长度无法确认,但设备可以通过End-Body Header知道什么时候结束。
3、Time
Time描述了对象的最后修改的时间。使用ISO8601格式。
本地时间格式:YYYYMMDDTHHMMSS
UTC时间格式:YYYYMMDDTHHMMSSZ
格式中的T可以方便的区分日期和时间。UTC时间使用Z作为标记。建议使用UTC时间。
4、Body、End-of-Body
Body Header由HI、一个2Byte长度的描述和整个的对象本身。End-of-Body组成和Body组成一样,但标识了这是对象的最后一部分。如果对象本来就很小,就直接使用End-of-Body。
三、请求(Request)和回应(Response)
OBEX使用Request和Response作为最基本的操作。请求的每个Request必然有一个Response,否则可认为Request失败。
Request由一个或多个的Packet(包)组成,每个包的结构如下表
Request数据包结构
Byte 0 | Byte 1,2 | Byte 3 to n |
| 操作码(opcode) | Packet Length(包长度) | Headers或请求信息 |
由于每个Request可能有多个Packet,opcode的最高位称为Final bit。如果被设置为1,那么说明这是Request的最后一个Packet。例如:当用PUT操作发送一个大文件时,会有几个Packet作为一个Request。那么只有最后一个Packet的FinalBit设置为1。
Response也由一个或多个Packet组成,每个包的结构如下表
Response数据包结构
Byte 0 | Byte 1,2 | Byte 3 to n |
| Response Code(返回值) | Response Length(回应长度) | ResponseData回应的数据 |
同样的ResponseCode的最高位也叫做FinalBit。ResponseData可能包含对象和Header,或者其它信息。
下表列出了了常见的opcode和responseCode,更详尽的请参考IrOBEX 1.2文档。
opcode
Opcode(w/high bit set) | 定义 | 意义 |
| 0x80 * | Connect | 连接 |
| 0x81 * | Disconnect | 断开连接 |
| 0x02(0x82) | Put | 发送一个对象 |
| 0x03(0x83) | Get | 取得一个对象 |
| 0x04(0x84) | Reserved | 保留的 |
展开表格*总是设置FinalBit
ResponseCode
ResponseCode | 定义 |
| 0x10(0x90) | Continue(继续) |
| 0x20(0xA0) | OK,Success |
| 0x40(0xC0) | Bad Request(服务端不明白Request) |
| 0x41(0xC1) | Unauthorized(未授权的) |
| 0x43(0xC3) | Fobidden(禁止——服务器明白Request,但拒绝) |
展开表格四、说明。
1、 Connect(连接)
此操作初始化会话然后设置参数。其Request格式为
Byte 0 | Byte 1,2 | Byte 3 | Byte 4 | Byte 5,6 | Byte 7 to n |
| 0x80 | 包长度 | OBEX版本 | 标志 | 最大OBEX包长度 | 可选Header |
注:OBEX版本现在为1.0。
Response格式为:
Byte 0 | Byte 1,2 | Byte 3 | Byte 4 | Byte 5,6 | Byte 7 to n |
| ResponseCode | 包长度 | OBEX版本 | 标志 | 最大OBEX包长度 | 可选Header |
对于更多关于Connect的说明请参考IrOBEX
2、 Disconnect(断开当前会话)
此操作断开OBEX会话。例如断开当前FolderListing Service,然后使用Connect连接到IrMC Sync Service实现同步通讯薄等功能。
Disconnect格式为:
Byte 0 | Bytes 1,2 | Bytes 3 to n |
| 0x81 | 包长度 | 可选Header |
成功的断开会返回0Xa0,拒绝会返回0xD3
3、 Put操作
Put操作从客户端发送一个对象到服务端。一般至少含有Name和Length两个Header。对于文件而言有可能还有Date/Time Header