1、迪文云平臺(tái)構(gòu)成

迪文云平臺(tái)由首頁數(shù)據(jù)概覽、產(chǎn)品管理、產(chǎn)品分析、運(yùn)營管理、賬號(hào)管理五個(gè)主模塊組成，見圖1-1：

圖1-1迪文云平臺(tái)首頁展示圖

2、接入迪文云步驟

2.1 確認(rèn)硬件已安裝WiFi-10模塊

圖2-1 WiFi-10模塊安裝

2.2 設(shè)備通過WiFi上網(wǎng)

2.2.1 方法一：APP一鍵配網(wǎng)

一鍵配網(wǎng)功能需配合迪文云APP完成。

(APP下載地址http://www.pgyer.com/dwin)

1)首先，需要手機(jī)連接WiFi（同時(shí)也是設(shè)備將接入的WiFi）；

2)在屏幕點(diǎn)擊“啟動(dòng)一鍵配網(wǎng)”按鍵； 

圖2-2 設(shè)備端操作示例

3)前往APP點(diǎn)擊“添加設(shè)備”，然后在彈出頁面上選擇“一鍵配網(wǎng)”。點(diǎn)擊“開始配置”輸入WiFi密碼，點(diǎn)擊“下一步”進(jìn)入配網(wǎng)狀態(tài)，等待WiFi模塊自動(dòng)完成配網(wǎng)。設(shè)備端的配網(wǎng)狀態(tài)可通過圖標(biāo)指示。

圖2-3 APP一鍵配網(wǎng)操作

2.2.2 方法二：設(shè)備端配網(wǎng)

在屏幕上輸入待連接的WiFi名稱和對(duì)應(yīng)密碼來完成網(wǎng)絡(luò)配置，實(shí)現(xiàn)連網(wǎng)。輸入網(wǎng)絡(luò)名稱和密碼后，需點(diǎn)擊“啟動(dòng)配網(wǎng)”按鍵以啟動(dòng)配網(wǎng)流程。配網(wǎng)狀態(tài)可通過圖標(biāo)指示。

圖2-4 設(shè)備端操作界面示例

2.3 注冊(cè)迪文云平臺(tái)賬號(hào)

用戶在迪文云平臺(tái) http://merchant.dwinhmi.com.cn/  中通過手機(jī)號(hào)即可注冊(cè)賬號(hào)。

2.4 添加產(chǎn)品

用戶注冊(cè)成功，等待審核通過后，可在迪文云平臺(tái)中添加產(chǎn)品。

點(diǎn)擊左側(cè)“產(chǎn)品管理”，點(diǎn)擊頁面右側(cè)“添加新產(chǎn)品”建立新產(chǎn)品，填寫產(chǎn)品信息后，保存，就完成了一個(gè)新產(chǎn)品的新建。

在此頁面點(diǎn)擊此產(chǎn)品后能重新編輯產(chǎn)品名稱、產(chǎn)品編號(hào)、終端平臺(tái)、屏幕尺寸和綁定狀態(tài)等信息。

如圖2-5：

圖2-5 產(chǎn)品管理頁面

2.5 通過云平臺(tái)進(jìn)行設(shè)備調(diào)試

聯(lián)網(wǎng)的設(shè)備會(huì)自動(dòng)連接到迪文云平臺(tái)。該設(shè)備在迪文云平臺(tái)→運(yùn)營管理→設(shè)備列表中顯示。

圖2-6設(shè)備列表展示設(shè)備信息

設(shè)備在開發(fā)過程中，通過迪文云平臺(tái)-運(yùn)營管理-設(shè)備列表-調(diào)試-內(nèi)存映射調(diào)試接口中顯示設(shè)備的內(nèi)存地址內(nèi)容（16進(jìn)制）。如圖2-7，2-8所示。

圖2-7 設(shè)備列表選擇調(diào)試頁面

圖2-8 內(nèi)存映射調(diào)試頁面展示

使用APP操作設(shè)備時(shí)，發(fā)送的指令也會(huì)在迪文云平臺(tái)的內(nèi)存映射調(diào)試接口中顯示該設(shè)備的內(nèi)存地址變化信息。

3、迪文云與第三方服務(wù)器對(duì)接

第三方服務(wù)器可以通過平臺(tái)提供的http接口獲取相關(guān)設(shè)備信息，與設(shè)備進(jìn)行指令交互。平臺(tái)提供的接口相關(guān)信息可以在產(chǎn)品的第三方接口中查看。

3.1API調(diào)用接口

系統(tǒng)對(duì)外提供統(tǒng)一的API接口，用戶服務(wù)器在調(diào)用接口時(shí)按照相關(guān)接口協(xié)議進(jìn)行調(diào)用。

圖3-1系統(tǒng)對(duì)外提供接口地址展示

3.2Token授權(quán)信息

系統(tǒng)目前使用Token認(rèn)證，用戶在調(diào)用接口時(shí)必須攜帶Token信息，用于授權(quán)。

Token信息是綁定在產(chǎn)品下的，即每款產(chǎn)品有一個(gè)Token信息。Token支持用戶自定義（Md5格式），如果用戶想在多款產(chǎn)品中使用同一個(gè)Token，將這幾款產(chǎn)品的Token設(shè)置為同一個(gè)即可。

圖3-2用戶密鑰

3.3 IP白名單

用戶服務(wù)器的IP地址必須設(shè)置在IP白名單中，不在IP白名單中的請(qǐng)求將被攔截。

圖3-3第三方用戶服務(wù)器IP地址

3.4 回調(diào)地址

回調(diào)地址為用戶提供給平臺(tái)的的通知接口，平臺(tái)將設(shè)備上報(bào)的指令以http協(xié)議形式回調(diào)給用戶服務(wù)器，通知用戶設(shè)備狀態(tài)的改變。

該回調(diào)地址由商戶提供，具體回調(diào)信息格式參考相關(guān)協(xié)議文檔。

圖3-4第三方服務(wù)器調(diào)用平臺(tái)接口使用的回調(diào)地址