< <<3G车载DTU产品设计书>> V1.0 <<3G车载DTU产品设计书V1.0——软件API部分>> 作者 - <<为创科技>> 变更编号 – 2010-LT-1028 发布日期 - <<10/28/2010>> Last Updated - 错误！未指定书签。 < Document Title > 变更历史 便更编号 V1.0 (draft) 作者 姚斌 评审人员 A. 变更描述 B. 评审总结 第一版 发布日期(mm/dd/yy) 10/28/2010 Page 2 of 13 Last Updated - 错误！未指定书签。 < Document Title > Table of Contents 1 介绍 ....................................................................................................................................................................... 5 1.1 1.2 1.3 1.4 文档目的 ....................................................................................................................................................... 5 文档范围 ....................................................................................................................................................... 5 参考 ............................................................................................................................................................... 5 定义和符号缩写 ........................................................................................................................................... 5 2 体系结构 ............................................................................................................................................................... 5 2.1 2.2 软件体系结构 ............................................................................................................................................... 5 功能描述 ..................................................................................................................... 错误！未定义书签。 3 接口模型 ............................................................................................................................................................... 7 3.1 消息接口 ....................................................................................................................................................... 7 3.2 接口函数 ....................................................................................................................................................... 7 3.2.1 模块操作： ........................................................................................................................................... 8 3.2.2 语音通话 ............................................................................................................................................... 8 3.2.3 音量控制 ................................................................................................................................................. 9 3.2.4 短信收发 ............................................................................................................................................... 9 4 主要消息序列图 ................................................................................................................................................... 9 4.1 4.2 AVN主叫...................................................................................................................................................... 9 AVN发送短信 ............................................................................................................................................ 13 5 6 7 可靠性 ................................................................................................................................................................. 13 性能 ..................................................................................................................................... 错误！未定义书签。 未解决问题 ......................................................................................................................... 错误！未定义书签。 Page 3 of 13 Last Updated - 错误！未指定书签。 < Document Title > 表格清单 Table 1: ........................................................................................................................................................... 错误！未定义书 图表清单 Figure 1: ........................................................................................................................................................... 错误！未定义书 Page 4 of 13 Last Updated - 错误！未指定书签。 < Document Title > 1 介绍 1.1 文档目的 用于软件设计团队的接口文档，及市场需求分析人员参考 1.2 文档范围 1.3 参考 1.4 定义和符号缩写 AVN audio/video navigation API application programming Interface 2 体系结构 2.1 硬件体系结构 CPU 3G模块 接口控制电路专用 SIM卡 电源 系统 AVN系统 Audio信号 虚拟USB串口 电源 2.2 软件体系结构 2.2.1 软件层次结构 Page 5 of 13 Last Updated - 错误！未指定书签。 < Document Title > 为实现通讯功能，ANV系统可采用分层设计，自下而上共分为USB接口驱动层、通讯控制层和应用层三层，见下图。其中，USB接口驱动层负责需要对USB接口虚拟出多个串口，分别实现网络数据，语音和短信通讯控制功能；通讯控制层负责对各个虚拟的串口进行具体通讯控制；应用层调用通讯控制层实现各类通讯业务。 AVN（车载语音视频导航系统）应用层 数据通讯拨号程序 （语音，短信等）通讯功能中间件 USB接口驱动程序 其中，USB接口驱动程序由模块制造商提供，通讯控制层中的拨号程序由车载操作系统提供，语音和短信等通讯功能中间件需要自己开发，或第三方提供。 2.3 通讯功能中间件 为了提高车载系统开发通讯业务的高效和减少开发周期，同时提高系统的软件兼容性和可扩展性，我们开发了通讯中间件。 2.3.1 通讯中间件特点及优势 1) 极大缩短车载系统通讯业务的开发周期 车载系统通过调用中间件提供的大量API，来完成各类通讯业务的应用层逻辑，中间件封装了通讯底层所有协议细节和模块的差异性。 2) 提高车载系统通讯业务的开发质量 中间件在接口定义方面都是清晰和规范的，中间件的规范化模块可以有效地保证应用系统质量同时减少新旧系统维护开销。 3) 提高车载系统的可扩充性和兼容性 中间件封装了通讯底层所有协议细节和模块的差异性，对于车载系统使用不同厂家提供的模块或相同厂家的升级换代模块，中间件可以适配模块的差异性，而应用层的接口不会改变。 2.3.2 通讯中间件适用的条件 1) 车载的操作系统需要支持多线程或多任务。 2) 中间件以动态链接库的形式提供 Page 6 of 13 Last Updated - 错误！未指定书签。 < Document Title > 3 通讯中间件接口模型 3.1 消息接口 AVN系统API3G模块调用API发送AT指令返回AT指令结果 (图3.1-1 车载系统主动通讯的调用API方式) AVN系统API3G模块 回调通知事件AT指令通知结果发送AT指令 (图3.1-2 车载系统被动通讯的事件通知方式) 3.2 接口函数 车载系统主动发起的通讯控制（如车载系统作主叫，发送短信等）的操作可以直接调用相关API函数，以下小节给出了部分定义。 对于外部发起的通讯控制（车载系统作被叫，接收短信等）由中间件的监控线程或任务来获取通知，然后中间件调用事先注册的回调函数或事件处理对象（应用系统支持面向对象的程序设计）来处理响应外部通讯事件，定义如下： typedef unsigned long (*pcb3GEventNotice )(3GEVENTTYPE event, void* lpEventParam); 其中， typedef enum 3GEVENTTYPE { RING, //响铃 CALLING, //外部呼叫 SMMT_EVENT, //新接收短信 Page 7 of 13 Last Updated - 错误！未指定书签。 < Document Title > …… }; 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) 功能说明：拔打电话 参数说明： 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： 表示挂电话失败 Page 8 of 13 Last Updated - 错误！未指定书签。 < Document Title > 3.2.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主叫（示例） Page 9 of 13 Last Updated - 错误！未指定书签。 < Document Title > 拨打对方号码：10010ATD10010;^CONF:1通知：对方已接通^CONN:1,0通知：对方已摘机通话^CEND:1,0通知：对方已挂机 4.2 AVN二次拨号（示例） Page 10 of 13 Last Updated - 错误！未指定书签。 < Document Title > AVNAPI3G模块拨打对方号码：10010ATD10010;^CONF:1通知：对方已接通^CONN:1,0通知：对方已摘机通话二次拨号1OK二次拨号成功挂机AT+CHUP 4.3 AVN被叫 Page 11 of 13 Last Updated - 错误！未指定书签。 < Document Title > AVNAPI3G模块RING:\\n\\r+CLIP:”186XXXXXXXX”电话呼入通知呼入号码：186XXXXXXXX摘机通知ATA通话OK挂机AT+CHUP Page 12 of 13 Last Updated - 错误！未指定书签。 < Document Title > 4.4 AVN发送短信（示例） AVNAPI3G模块发送短信至186XXXXXXXX:您好！短信编码:长度： 10内容：pduAT+CGMS=10\\r\\npduOK发送短信成功 5 可靠性 为了提高通讯的实时性，我们采用多线程机制，同时通过利用加锁机制防止多线程对串口访问冲突。 为了提高系统的实时性，中间件API的设计都是采用非阻塞方式访问串口资源。 Page 13 of 13 Last Updated - 错误！未指定书签。 因篇幅问题不能全部显示，请点此查看更多更全内容