3G车载DTU产品设计书软件API部分.docx
- 文档编号:5443898
- 上传时间:2022-12-16
- 格式:DOCX
- 页数:11
- 大小:112.32KB
3G车载DTU产品设计书软件API部分.docx
《3G车载DTU产品设计书软件API部分.docx》由会员分享,可在线阅读,更多相关《3G车载DTU产品设计书软件API部分.docx(11页珍藏版)》请在冰豆网上搜索。
3G车载DTU产品设计书软件API部分
<<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
TableofContents
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.1AVN主叫9
4.2AVN发送短信10
5可靠性10
6性能10
7未解决问题10
表格清单
Table1:
3
图表清单
Figure1:
3
介绍
文档目的
用于软件设计团队的接口文档,及市场需求分析人员参考
文档范围
参考
定义和符号缩写
AVNaudio/videonavigation
APIapplicationprogrammingInterface
体系结构
硬件体系结构
软件体系结构
软件层次结构
为实现通讯功能,ANV系统可采用分层设计,自下而上共分为USB接口驱动层、通讯控制层和应用层三层,见下图。
其中,USB接口驱动层负责需要对USB接口虚拟出多个串口,分别实现网络数据,语音和短信通讯控制功能;通讯控制层负责对各个虚拟的串口进行具体通讯控制;应用层调用通讯控制层实现各类通讯业务。
其中,USB接口驱动程序由模块制造商提供,通讯控制层中的拨号程序由车载操作系统提供,语音和短信等通讯功能中间件需要自己开发,或第三方提供。
通讯功能中间件
为了提高车载系统开发通讯业务的高效和减少开发周期,同时提高系统的软件兼容性和可扩展性,我们开发了通讯中间件。
通讯中间件特点及优势
1)极大缩短车载系统通讯业务的开发周期
车载系统通过调用中间件提供的大量API,来完成各类通讯业务的应用层逻辑,中间件封装了通讯底层所有协议细节和模块的差异性。
2)提高车载系统通讯业务的开发质量
中间件在接口定义方面都是清晰和规范的,中间件的规范化模块可以有效地保证应用系统质量同时减少新旧系统维护开销。
3)提高车载系统的可扩充性和兼容性
中间件封装了通讯底层所有协议细节和模块的差异性,对于车载系统使用不同厂家提供的模块或相同厂家的升级换代模块,中间件可以适配模块的差异性,而应用层的接口不会改变。
通讯中间件适用的条件
1)车载的操作系统需要支持多线程或多任务。
2)中间件以动态链接库的形式提供
通讯中间件接口模型
消息接口
(图3.1-1车载系统主动通讯的调用API方式)
(图3.1-2车载系统被动通讯的事件通知方式)
接口函数
车载系统主动发起的通讯控制(如车载系统作主叫,发送短信等)的操作可以直接调用相关API函数,以下小节给出了部分定义。
对于外部发起的通讯控制(车载系统作被叫,接收短信等)由中间件的监控线程或任务来获取通知,然后中间件调用事先注册的回调函数或事件处理对象(应用系统支持面向对象的程序设计)来处理响应外部通讯事件,定义如下:
typedefunsignedlong(*pcb3GEventNotice)(3GEVENTTYPEevent,void*lpEventParam);
其中,
typedefenum3GEVENTTYPE
{
RING,//响铃
CALLING,//外部呼叫
SMMT_EVENT,//新接收短信
……
};
模块操作
初始化模块:
intInit3G(void)
功能说明:
初始化3G模块
参数说明:
返回结果:
SUCCESS:
表示初始化模块成功
FAILED:
表示初始化模块失败
关闭模块:
intunInit3G()
功能说明:
关闭3G功能
参数说明:
返回结果:
语音通话
拔打电话:
intdial(constchar*number)
功能说明:
拔打电话
参数说明:
number:
电话号码
返回结果:
SUCCESS:
表示拨打电话成功
FAILED:
表示拨打电话失败
接听电话:
intanswerCall()
功能说明:
接听电话
参数说明:
返回结果:
SUCCESS:
表示接听电话成功
FAILED:
表示接听电话失败
拒听电话:
intrejectCall()
功能说明:
拒听来电
参数说明:
返回结果:
SUCCESS:
表示拒听电话成功
FAILED:
表示拒听电话失败
挂听电话:
inthandupCall()
功能说明:
挂电话
参数说明:
返回结果:
SUCCESS:
表示挂电话成功
FAILED:
表示挂电话失败
音量控制
增加音量:
intvolumeUp(intstep)
功能说明:
增大音量,必须在建立蓝牙连接后使用。
参数说明:
step:
将音量增加的步长
返回结果:
SUCCESS:
表示增加音量成功
FAILED:
表示增加音量失败
减少音量:
intvolumeDowm(intstep)
功能说明:
减少增大音量,必须在建立蓝牙连接后使用。
参数说明:
step:
将音量减少的步长
返回结果:
SUCCESS:
表示减少音量成功
FAILED:
表示减少音量失败
短信收发
发送短信:
intsendSM(constchar*content,constchar*number)
功能说明:
发送短信
参数说明:
content:
短信内容。
number:
短信接收者(被叫)的电话号码。
返回结果:
SUCCESS:
表示发送短信成功
FAILED:
表示发送短信失败
消息交互图(部分)
AVN主叫(示例)
AVN二次拨号(示例)
AVN被叫
AVN发送短信(示例)
可靠性
为了提高通讯的实时性,我们采用多线程机制,同时通过利用加锁机制防止多线程对串口访问冲突。
为了提高系统的实时性,中间件API的设计都是采用非阻塞方式访问串口资源。
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 3G 车载 DTU 产品设计 软件 API 部分