<>

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

V1.0

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

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

Last Updated - 錯誤！未指定書簽。

< Document Title > Revision 0.1 (draft)

變更歷史

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

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

< Document Title > Revision 0.1 (draft)

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 接口函數(shù) ....................................................................................................................................................... 7 3.2.1 模塊操作： ........................................................................................................................................... 8 3.2.2 語音通話 ............................................................................................................................................... 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 性能 ..................................................................................................................................... 錯誤！未定義書簽。 未解決問題 ......................................................................................................................... 錯誤！未定義書簽。

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

< Document Title > Revision 0.1 (draft)

表格清單

Table 1: ........................................................................................................................................................... 錯誤！未定義書

圖表清單

Figure 1: ........................................................................................................................................................... 錯誤！未定義書

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

< Document Title > Revision 0.1 (draft)

1 介紹

1.1 文檔目的

用于軟件設計團隊的接口文檔，及市場需求分析人員參考

1.2 文檔范圍 1.3 參考

1.4 定義和符號縮寫

AVN audio/video navigation

API application programming Interface

2 體系結構

2.1 硬件體系結構

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

2.2 軟件體系結構 2.2.1 軟件層次結構

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

< Document Title > Revision 0.1 (draft)

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

AVN（車載語音視頻導航系統(tǒng)）應用層

數(shù)據(jù)通訊撥號程序 （語音，短信等）通訊功能中間件 USB接口驅動程序

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

2.3 通訊功能中間件

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

2.3.1 通訊中間件特點及優(yōu)勢

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

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

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

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

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

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

2.3.2 通訊中間件適用的條件

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

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

< Document Title > Revision 0.1 (draft)

3 通訊中間件接口模型

3.1 消息接口

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

3.2 接口函數(shù)

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

對于外部發(fā)起的通訊控制（車載系統(tǒng)作被叫，接收短信等）由中間件的監(jiān)控線程或任務來獲取通知，然后中間件調用事先注冊的回調函數(shù)或事件處理對象（應用系統(tǒng)支持面向對象的程序設計）來處理響應外部通訊事件，定義如下：

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

typedef enum 3GEVENTTYPE {

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

SMMT_EVENT, //新接收短信

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

< Document Title > Revision 0.1 (draft)

…… };

3.2.1 模塊操作

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

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

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

3.2.1.2 關閉模塊：int unInit3G ()

功能說明：關閉3G功能 參數(shù)說明： 返回結果：

3.2.2 語音通話

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

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

number ：電話號碼 返回結果：

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

3.2.2.2 接聽電話：int answerCall ()

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

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

3.2.2.3 拒聽電話：int rejectCall ()

功能說明：拒聽來電 參數(shù)說明： 返回結果：

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

3.2.2.4 掛聽電話：int handupCall ()

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

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

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

< Document Title > Revision 0.1 (draft)

3.2.3 音量控制

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

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

step：將音量增加的步長 返回結果：

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

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

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

step ：將音量減少的步長 返回結果：

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

3.2.4 短信收發(fā)

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

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

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

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

4

消息交互圖 （部分）

4.1 AVN主叫（示例）

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

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

撥打對方號碼：10010ATD10010;^CONF:1通知：對方已接通^CONN:1,0通知：對方已摘機通話^CEND:1,0通知：對方已掛機 4.2 AVN二次撥號（示例）

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

< Document Title > Revision 0.1 (draft)

AVNAPI3G模塊撥打對方號碼：10010ATD10010;^CONF:1通知：對方已接通^CONN:1,0通知：對方已摘機通話二次撥號1OK二次撥號成功掛機AT+CHUP

4.3 AVN被叫

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

< Document Title > Revision 0.1 (draft)

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

< Document Title > Revision 0.1 (draft)

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

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

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

Page 13 of 13 Last Updated - 錯誤！未指定書簽。