3G车载DTU产品设计书(软件API部分)

1、 revision 0.1 (draft) v1.0作者 - 变更编号 2010-lt-1028 发布日期 - 变更历史便更编号作者评审人员a. 变更描述b. 评审总结发布日期(mm/dd/yy)v1.0 (draft)姚斌第一版10/28/2010table of contents1介绍51.1文档目的51.2文档范围51.3参考51.4定义和符号缩写52体系结构52.1软件体系结构52.2功能描述63接口模型63.1消息接口63.2接口函数63.2.1模块操作：63.2.2语音通话73.2.3音量控制73.2.4短信收发84主要消息序列图84.1avn主叫94.2avn发送短信105可靠性

2、106性能107未解决问题10表格清单table 1: 3图表清单figure 1:31 介绍1.1 文档目的用于软件设计团队的接口文档，及市场需求分析人员参考1.2 文档范围1.3 参考1.4 定义和符号缩写avn audio/video navigationapi application programming interface 2 体系结构2.1 硬件体系结构3g模块专用sim卡电源系统接口控制电路avn系统audio信号虚拟usb串口电源cpu2.2 软件体系结构2.2.1 软件层次结构为实现通讯功能，anv系统可采用分层设计，自下而上共分为usb接口驱动层、通讯控制层和应用层三层，

3、见下图。其中，usb接口驱动层负责需要对usb接口虚拟出多个串口，分别实现网络数据，语音和短信通讯控制功能；通讯控制层负责对各个虚拟的串口进行具体通讯控制；应用层调用通讯控制层实现各类通讯业务。avn（车载语音视频导航系统）应用层数据通讯拨号程序 （语音，短信等）通讯功能中间件usb接口驱动程序其中，usb接口驱动程序由模块制造商提供，通讯控制层中的拨号程序由车载操作系统提供，语音和短信等通讯功能中间件需要自己开发，或第三方提供。2.3 通讯功能中间件为了提高车载系统开发通讯业务的高效和减少开发周期，同时提高系统的软件兼容性和可扩展性，我们开发了通讯中间件。2.3.1 通讯中间件特点及优势1)

4、 极大缩短车载系统通讯业务的开发周期车载系统通过调用中间件提供的大量api，来完成各类通讯业务的应用层逻辑，中间件封装了通讯底层所有协议细节和模块的差异性。2) 提高车载系统通讯业务的开发质量中间件在接口定义方面都是清晰和规范的，中间件的规范化模块可以有效地保证应用系统质量同时减少新旧系统维护开销。3) 提高车载系统的可扩充性和兼容性中间件封装了通讯底层所有协议细节和模块的差异性，对于车载系统使用不同厂家提供的模块或相同厂家的升级换代模块，中间件可以适配模块的差异性，而应用层的接口不会改变。 2.3.2 通讯中间件适用的条件1) 车载的操作系统需要支持多线程或多任务。2) 中间件以动态链接库的

5、形式提供3 通讯中间件接口模型3.1 消息接口 (图3.1-1 车载系统主动通讯的调用api方式) (图3.1-2 车载系统被动通讯的事件通知方式)3.2 接口函数车载系统主动发起的通讯控制（如车载系统作主叫，发送短信等）的操作可以直接调用相关api函数，以下小节给出了部分定义。对于外部发起的通讯控制（车载系统作被叫，接收短信等）由中间件的监控线程或任务来获取通知，然后中间件调用事先注册的回调函数或事件处理对象（应用系统支持面向对象的程序设计）来处理响应外部通讯事件，定义如下：typedef unsigned long (*pcb3geventnotice )(3geventtype even

6、t, void* lpeventparam); 其中，typedef enum 3geventtypering,/响铃 calling,/外部呼叫smmt_event, /新接收短信;3.2.1 模块操作3.2.1.1 初始化模块：int init3g (void)功能说明：初始化3g模块参数说明：返回结果：success：表示初始化模块成功failed ：表示初始化模块失败3.2.1.2 关闭模块：int uninit3g ()功能说明：关闭3g功能参数说明：返回结果：3.2.2 语音通话3.2.2.1 拔打电话：int dial (const char* number)功能说明：拔打电话参

7、数说明：number ：电话号码返回结果：success： 表示拨打电话成功failed： 表示拨打电话失败3.2.2.2 接听电话：int answercall ()功能说明：接听电话参数说明：返回结果：success： 表示接听电话成功failed： 表示接听电话失败3.2.2.3 拒听电话：int rejectcall ()功能说明：拒听来电参数说明：返回结果：success： 表示拒听电话成功failed： 表示拒听电话失败3.2.2.4 挂听电话：int handupcall ()功能说明：挂电话参数说明：返回结果：success： 表示挂电话成功failed： 表示挂电话失败3.2

8、.3 音量控制3.2.3.1 增加音量：int volumeup (int step)功能说明：增大音量，必须在建立蓝牙连接后使用。参数说明：step：将音量增加的步长返回结果：success： 表示增加音量成功failed： 表示增加音量失败3.2.3.2 减少音量：int volumedowm (int step)功能说明：减少增大音量，必须在建立蓝牙连接后使用。参数说明：step ：将音量减少的步长返回结果：success： 表示减少音量成功failed： 表示减少音量失败3.2.4 短信收发3.2.4.1 发送短信：int sendsm (const char* content，const char* number)功能说明：发送短信参数说明：content：短信内容。number：短信接收者（被叫）的电话号码。返回结果：success： 表示发送短信成功failed： 表示发送短信失败4 消息交互图 （部分）4.1 avn主叫（示例）4.2 avn二次拨号（示例）4.3 avn被叫4.4 avn发送短信（示