<>

<<3G車載DTU產(chǎn)品設(shè)計(jì)書>>

V1.0

<<3G車載DTU產(chǎn)品設(shè)計(jì)書V1.0——軟件API部分>>

作者 - <<為創(chuàng)科技>> 變更編號(hào) – 2010-LT-1028 發(fā)布日期 - <<10/28/2010>>

Last Updated - 錯(cuò)誤！未指定書簽。

< Document Title > Revision 0.1 (draft)

變更歷史

便更編號(hào) V1.0 (draft) 作者 姚斌 評(píng)審人員 A. 變更描述 B. 評(píng)審總結(jié) 第一版 發(fā)布日期(mm/dd/yy) 10/28/2010

Page 2 of 13 Last Updated - 錯(cuò)誤！未指定書簽。

< Document Title > Revision 0.1 (draft)

Table of Contents 1

介紹 ....................................................................................................................................................................... 5

1.1 1.2 1.3 1.4

文檔目的 ....................................................................................................................................................... 5 文檔范圍 ....................................................................................................................................................... 5 參考 ............................................................................................................................................................... 5 定義和符號(hào)縮寫 ........................................................................................................................................... 5

2 體系結(jié)構(gòu) ............................................................................................................................................................... 5

2.1 2.2

軟件體系結(jié)構(gòu) ............................................................................................................................................... 5 功能描述 ..................................................................................................................... 錯(cuò)誤！未定義書簽。

3 接口模型 ............................................................................................................................................................... 7

3.1

消息接口 ....................................................................................................................................................... 7

3.2 接口函數(shù) ....................................................................................................................................................... 7 3.2.1 模塊操作： ........................................................................................................................................... 8 3.2.2 語(yǔ)音通話 ............................................................................................................................................... 8 3.2.3 音量控制 ................................................................................................................................................. 9 3.2.4 短信收發(fā) ............................................................................................................................................... 9 4

主要消息序列圖 ................................................................................................................................................... 9

4.1 4.2

AVN主叫...................................................................................................................................................... 9 AVN發(fā)送短信 ............................................................................................................................................ 13

5 6 7

可靠性 ................................................................................................................................................................. 13 性能 ..................................................................................................................................... 錯(cuò)誤！未定義書簽。 未解決問(wèn)題 ......................................................................................................................... 錯(cuò)誤！未定義書簽。

Page 3 of 13 Last Updated - 錯(cuò)誤！未指定書簽。

< Document Title > Revision 0.1 (draft)

表格清單

Table 1: ........................................................................................................................................................... 錯(cuò)誤！未定義書

圖表清單

Figure 1: ........................................................................................................................................................... 錯(cuò)誤！未定義書

Page 4 of 13 Last Updated - 錯(cuò)誤！未指定書簽。

< Document Title > Revision 0.1 (draft)

1 介紹

1.1 文檔目的

用于軟件設(shè)計(jì)團(tuán)隊(duì)的接口文檔，及市場(chǎng)需求分析人員參考

1.2 文檔范圍 1.3 參考

1.4 定義和符號(hào)縮寫

AVN audio/video navigation

API application programming Interface

2 體系結(jié)構(gòu)

2.1 硬件體系結(jié)構(gòu)

CPU 3G模塊 接口控制電路專用 SIM卡 電源 系統(tǒng) AVN系統(tǒng) Audio信號(hào) 虛擬USB串口 電源

2.2 軟件體系結(jié)構(gòu) 2.2.1 軟件層次結(jié)構(gòu)

Page 5 of 13 Last Updated - 錯(cuò)誤！未指定書簽。

< Document Title > Revision 0.1 (draft)

為實(shí)現(xiàn)通訊功能，ANV系統(tǒng)可采用分層設(shè)計(jì)，自下而上共分為USB接口驅(qū)動(dòng)層、通訊控制層和應(yīng)用層三層，見下圖。其中，USB接口驅(qū)動(dòng)層負(fù)責(zé)需要對(duì)USB接口虛擬出多個(gè)串口，分別實(shí)現(xiàn)網(wǎng)絡(luò)數(shù)據(jù)，語(yǔ)音和短信通訊控制功能；通訊控制層負(fù)責(zé)對(duì)各個(gè)虛擬的串口進(jìn)行具體通訊控制；應(yīng)用層調(diào)用通訊控制層實(shí)現(xiàn)各類通訊業(yè)務(wù)。

AVN（車載語(yǔ)音視頻導(dǎo)航系統(tǒng)）應(yīng)用層

數(shù)據(jù)通訊撥號(hào)程序 （語(yǔ)音，短信等）通訊功能中間件 USB接口驅(qū)動(dòng)程序

其中，USB接口驅(qū)動(dòng)程序由模塊制造商提供，通訊控制層中的撥號(hào)程序由車載操作系統(tǒng)提供，語(yǔ)音和短信等通訊功能中間件需要自己開發(fā)，或第三方提供。

2.3 通訊功能中間件

為了提高車載系統(tǒng)開發(fā)通訊業(yè)務(wù)的高效和減少開發(fā)周期，同時(shí)提高系統(tǒng)的軟件兼容性和可擴(kuò)展性，我們開發(fā)了通訊中間件。

2.3.1 通訊中間件特點(diǎn)及優(yōu)勢(shì)

1) 極大縮短車載系統(tǒng)通訊業(yè)務(wù)的開發(fā)周期

車載系統(tǒng)通過(guò)調(diào)用中間件提供的大量API，來(lái)完成各類通訊業(yè)務(wù)的應(yīng)用層邏輯，中間件封裝了通訊底層所有協(xié)議細(xì)節(jié)和模塊的差異性。

2) 提高車載系統(tǒng)通訊業(yè)務(wù)的開發(fā)質(zhì)量

中間件在接口定義方面都是清晰和規(guī)范的，中間件的規(guī)范化模塊可以有效地保證應(yīng)用系統(tǒng)質(zhì)量同時(shí)減少新舊系統(tǒng)維護(hù)開銷。

3) 提高車載系統(tǒng)的可擴(kuò)充性和兼容性

中間件封裝了通訊底層所有協(xié)議細(xì)節(jié)和模塊的差異性，對(duì)于車載系統(tǒng)使用不同廠家提供的模塊或相同廠家的升級(jí)換代模塊，中間件可以適配模塊的差異性，而應(yīng)用層的接口不會(huì)改變。

2.3.2 通訊中間件適用的條件

1) 車載的操作系統(tǒng)需要支持多線程或多任務(wù)。 2) 中間件以動(dòng)態(tài)鏈接庫(kù)的形式提供

Page 6 of 13 Last Updated - 錯(cuò)誤！未指定書簽。

< Document Title > Revision 0.1 (draft)

3 通訊中間件接口模型

3.1 消息接口

AVN系統(tǒng)API3G模塊調(diào)用API發(fā)送AT指令返回AT指令結(jié)果 (圖3.1-1 車載系統(tǒng)主動(dòng)通訊的調(diào)用API方式) AVN系統(tǒng)API3G模塊 回調(diào)通知事件AT指令通知結(jié)果發(fā)送AT指令 (圖3.1-2 車載系統(tǒng)被動(dòng)通訊的事件通知方式)

3.2 接口函數(shù)

車載系統(tǒng)主動(dòng)發(fā)起的通訊控制（如車載系統(tǒng)作主叫，發(fā)送短信等）的操作可以直接調(diào)用相關(guān)API函數(shù)，以下小節(jié)給出了部分定義。

對(duì)于外部發(fā)起的通訊控制（車載系統(tǒng)作被叫，接收短信等）由中間件的監(jiān)控線程或任務(wù)來(lái)獲取通知，然后中間件調(diào)用事先注冊(cè)的回調(diào)函數(shù)或事件處理對(duì)象（應(yīng)用系統(tǒng)支持面向?qū)ο蟮某绦蛟O(shè)計(jì)）來(lái)處理響應(yīng)外部通訊事件，定義如下：

typedef unsigned long (*pcb3GEventNotice )(3GEVENTTYPE event, void* lpEventParam); 其中，

typedef enum 3GEVENTTYPE {

RING, //響鈴 CALLING, //外部呼叫

SMMT_EVENT, //新接收短信

Page 7 of 13 Last Updated - 錯(cuò)誤！未指定書簽。

< Document Title > Revision 0.1 (draft)

…… };

3.2.1 模塊操作

3.2.1.1 初始化模塊：int Init3G (void)

功能說(shuō)明：初始化3G模塊 參數(shù)說(shuō)明： 返回結(jié)果：

SUCCESS： 表示初始化模塊成功 FAILED ： 表示初始化模塊失敗

3.2.1.2 關(guān)閉模塊：int unInit3G ()

功能說(shuō)明：關(guān)閉3G功能 參數(shù)說(shuō)明： 返回結(jié)果：

3.2.2 語(yǔ)音通話

3.2.2.1 拔打電話：int dial (const char* number)

功能說(shuō)明：拔打電話 參數(shù)說(shuō)明：

number ：電話號(hào)碼 返回結(jié)果：

SUCCESS： 表示撥打電話成功 FAILED： 表示撥打電話失敗

3.2.2.2 接聽電話：int answerCall ()

功能說(shuō)明：接聽電話 參數(shù)說(shuō)明： 返回結(jié)果：

SUCCESS： 表示接聽電話成功 FAILED： 表示接聽電話失敗

3.2.2.3 拒聽電話：int rejectCall ()

功能說(shuō)明：拒聽來(lái)電 參數(shù)說(shuō)明： 返回結(jié)果：

SUCCESS： 表示拒聽電話成功 FAILED： 表示拒聽電話失敗

3.2.2.4 掛聽電話：int handupCall ()

功能說(shuō)明：掛電話 參數(shù)說(shuō)明： 返回結(jié)果：

SUCCESS： 表示掛電話成功 FAILED： 表示掛電話失敗

Page 8 of 13 Last Updated - 錯(cuò)誤！未指定書簽。

< Document Title > Revision 0.1 (draft)

3.2.3 音量控制

3.2.3.1 增加音量：int volumeUp (int step)

功能說(shuō)明：增大音量，必須在建立藍(lán)牙連接后使用。 參數(shù)說(shuō)明：

step：將音量增加的步長(zhǎng) 返回結(jié)果：

SUCCESS： 表示增加音量成功 FAILED： 表示增加音量失敗

3.2.3.2 減少音量：int volumeDowm (int step)

功能說(shuō)明：減少增大音量，必須在建立藍(lán)牙連接后使用。 參數(shù)說(shuō)明：

step ：將音量減少的步長(zhǎng) 返回結(jié)果：

SUCCESS： 表示減少音量成功 FAILED： 表示減少音量失敗

3.2.4 短信收發(fā)

3.2.4.1 發(fā)送短信：int sendSM (const char* content，const char* number)

功能說(shuō)明：發(fā)送短信 參數(shù)說(shuō)明：

content： 短信內(nèi)容。 number： 短信接收者（被叫）的電話號(hào)碼。 返回結(jié)果：

SUCCESS： 表示發(fā)送短信成功 FAILED： 表示發(fā)送短信失敗

4

消息交互圖 （部分）

4.1 AVN主叫（示例）

Page 9 of 13 Last Updated - 錯(cuò)誤！未指定書簽。

< Document Title > AVN API3G模塊Revision 0.1 (draft)

撥打?qū)Ψ教?hào)碼：10010ATD10010;^CONF:1通知：對(duì)方已接通^CONN:1,0通知：對(duì)方已摘機(jī)通話^CEND:1,0通知：對(duì)方已掛機(jī) 4.2 AVN二次撥號(hào)（示例）

Page 10 of 13 Last Updated - 錯(cuò)誤！未指定書簽。

< Document Title > Revision 0.1 (draft)

AVNAPI3G模塊撥打?qū)Ψ教?hào)碼：10010ATD10010;^CONF:1通知：對(duì)方已接通^CONN:1,0通知：對(duì)方已摘機(jī)通話二次撥號(hào)1OK二次撥號(hào)成功掛機(jī)AT+CHUP

4.3 AVN被叫

Page 11 of 13 Last Updated - 錯(cuò)誤！未指定書簽。

< Document Title > Revision 0.1 (draft)

AVNAPI3G模塊RING:\\n\\r+CLIP:”186XXXXXXXX”電話呼入通知呼入號(hào)碼：186XXXXXXXX摘機(jī)通知ATA通話OK掛機(jī)AT+CHUP Page 12 of 13 Last Updated - 錯(cuò)誤！未指定書簽。

< Document Title > Revision 0.1 (draft)

4.4 AVN發(fā)送短信（示例）

AVNAPI3G模塊發(fā)送短信至186XXXXXXXX:您好！短信編碼:長(zhǎng)度： 10內(nèi)容：pduAT+CGMS=10\\r\\npduOK發(fā)送短信成功 5 可靠性

為了提高通訊的實(shí)時(shí)性，我們采用多線程機(jī)制，同時(shí)通過(guò)利用加鎖機(jī)制防止多線程對(duì)串口訪問(wèn)沖突。 為了提高系統(tǒng)的實(shí)時(shí)性，中間件API的設(shè)計(jì)都是采用非阻塞方式訪問(wèn)串口資源。

Page 13 of 13 Last Updated - 錯(cuò)誤！未指定書簽。