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

3G车载DTU产品设计书 V1.0 3G车载DTU产品设计书V1.0——软件API部分 作者 - 为创科技 变更编号 – 2010-LT-1028 发布日期 - 10/28/2010  变更历史 便更编号 作者 评审人员 A. 变更描述 B. 评审总结 发布日期(mm/dd/yy) V1.0 (draft) 姚斌 第一版 10/28/2010  Table of Contents 1 介绍 5 1.1 文档目的 5 1.2 文档范围 5 1.3 参考 5 1.4 定义和符号缩写 5 2 体系结构 5 2.1 软件体系结构 5 2.2 功能描述 6 3 接口模型 6 3.1 消息接口 6 3.2 接口函数 6 3.2.1 模块操作： 6 3.2.2 语音通话 7 3.2.3 音量控制 7 3.2.4 短信收发 8 4 主要消息序列图 8 4.1 AVN主叫 9 4.2 AVN发送短信 10 5 可靠性 10 6 性能 10 7 未解决问题 10 表格清单 Table 1: 3 图表清单 Figure 1: 3 介绍 文档目的 用于软件设计团队的接口文档，及市场需求分析人员参考 文档范围 参考 定义和符号缩写 AVN audio/video navigation API application programming Interface 体系结构 硬件体系结构 软件体系结构 软件层次结构 为实现通讯功能，ANV系统可采用分层设计，自下而上共分为USB接口驱动层、通讯控制层和应用层三层，见下图。其中，USB接口驱动层负责需要对USB接口虚拟出多个串口，分别实现网络数据，语音和短信通讯控制功能；通讯控制层负责对各个虚拟的串口进行具体通讯控制；应用层调用通讯控制层实现各类通讯业务。 其中，USB接口驱动程序由模块制造商提供，通讯控制层中的拨号程序由车载操作系统提供，语音和短信等通讯功能中间件需要自己开发，或第三方提供。 通讯功能中间件 为了提高车载系统开发通讯业务的高效和减少开发周期，同时提高系统的软件兼容性和可扩展性，我们开发了通讯中间件。 通讯中间件特点及优势 极大缩短车载系统通讯业务的开发周期 车载系统通过调用中间件提供的大量API，来完成各类通讯业务的应用层逻辑，中间件封装了通讯底层所有协议细节和模块的差异性。 提高车载系统通讯业务的开发质量 中间件在接口定义方面都是清晰和规范的，中间件的规范化模块可以有效地保证应用系统质量同时减少新旧系统维护开销。 提高车载系统的可扩充性和兼容性 中间件封装了通讯底层所有协议细节和模块的差异性，对于车载系统使用不同厂家提供的模块或相同厂家的升级换代模块，中间件可以适配模块的差异性，而应用层的接口不会改变。 通讯中间件适用的条件 车载的操作系统需要支持多线程或多任务。 中间件以动态链接库的形式提供 通讯中间件接口模型 消息接口 (图3.1-1 车载系统主动通讯的调用API方式) (图3.1-2 车载系统被动通讯的事件通知方式) 接口函数 车载系统主动发起的通讯控制（如车载系统作主叫，发送短信等）的操作可以直接调用相关API函数，以下小节给出了部分定义。 对于外部发起的通讯控制（车载系统作被叫，接收短信等）由中间件的监控线程或任务来获取通知，然后中间件调用事先注册的回调函数或事件处理对象（应用系统支持面向对象的程序设计）来处理响应外部通讯事件，定义如下： typedef unsigned long (*pcb3GEventNotice )(3GEVENTTYPE event, void* lpEventParam); 其中， typedef enum 3GEVENTTYPE { RING, //响铃 CALLING, //外部呼叫 SMMT_EVENT, //新接收短信 …… }; 模块操作 初始化模块：int Init3G (void) 功能说明：初始化3G模块 参数说明： 返回结果： SUCCESS： 表示初始化模块成功 FAILED ： 表示初始化模块失败 关闭模块：int unInit3G () 功能说明：关闭3G功能 参数说明： 返回结果： 语音通话 拔打电话：int dial (const char* number) 功能说明：拔打电话 参数说明： number ：电话号码 返回结果： SUCCESS： 表示拨打电话成功 FAILED： 表示拨打电话失败 接听电话：int answerCall () 功能说明：接听电话 参数说明： 返回结果： SUCCESS： 表示接听电话成功 FAILED： 表示接听电话失败 拒听电话：int