1、迪文云平臺構(gòu)成
迪文云平臺由首頁數(shù)據(jù)概覽、產(chǎn)品管理、產(chǎn)品分析、運營管理、賬號管理五個主模塊組成,見圖1-1:
圖1-1迪文云平臺首頁展示圖
2、接入迪文云步驟
2.1 確認硬件已安裝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)首先,需要手機連接WiFi(同時也是設(shè)備將接入的WiFi);
2)在屏幕點擊“啟動一鍵配網(wǎng)”按鍵;
圖2-2 設(shè)備端操作示例
3)前往APP點擊“添加設(shè)備”,然后在彈出頁面上選擇“一鍵配網(wǎng)”。點擊“開始配置”輸入WiFi密碼,點擊“下一步”進入配網(wǎng)狀態(tài),等待WiFi模塊自動完成配網(wǎng)。設(shè)備端的配網(wǎng)狀態(tài)可通過圖標指示。
圖2-3 APP一鍵配網(wǎng)操作
2.2.2 方法二:設(shè)備端配網(wǎng)
在屏幕上輸入待連接的WiFi名稱和對應密碼來完成網(wǎng)絡(luò)配置,實現(xiàn)連網(wǎng)。輸入網(wǎng)絡(luò)名稱和密碼后,需點擊“啟動配網(wǎng)”按鍵以啟動配網(wǎng)流程。配網(wǎng)狀態(tài)可通過圖標指示。
圖2-4 設(shè)備端操作界面示例
2.3 注冊迪文云平臺賬號
用戶在迪文云平臺 http://merchant.dwinhmi.com.cn/ 中通過手機號即可注冊賬號。
2.4 添加產(chǎn)品
用戶注冊成功,等待審核通過后,可在迪文云平臺中添加產(chǎn)品。
點擊左側(cè)“產(chǎn)品管理”,點擊頁面右側(cè)“添加新產(chǎn)品”建立新產(chǎn)品,填寫產(chǎn)品信息后,保存,就完成了一個新產(chǎn)品的新建。
在此頁面點擊此產(chǎn)品后能重新編輯產(chǎn)品名稱、產(chǎn)品編號、終端平臺、屏幕尺寸和綁定狀態(tài)等信息。
如圖2-5:
圖2-5 產(chǎn)品管理頁面
2.5 通過云平臺進行設(shè)備調(diào)試
聯(lián)網(wǎng)的設(shè)備會自動連接到迪文云平臺。該設(shè)備在迪文云平臺→運營管理→設(shè)備列表中顯示。
圖2-6設(shè)備列表展示設(shè)備信息
設(shè)備在開發(fā)過程中,通過迪文云平臺-運營管理-設(shè)備列表-調(diào)試-內(nèi)存映射調(diào)試接口中顯示設(shè)備的內(nèi)存地址內(nèi)容(16進制)。如圖2-7,2-8所示。
圖2-7 設(shè)備列表選擇調(diào)試頁面
圖2-8 內(nèi)存映射調(diào)試頁面展示
使用APP操作設(shè)備時,發(fā)送的指令也會在迪文云平臺的內(nèi)存映射調(diào)試接口中顯示該設(shè)備的內(nèi)存地址變化信息。
3、迪文云與第三方服務(wù)器對接
第三方服務(wù)器可以通過平臺提供的http接口獲取相關(guān)設(shè)備信息,與設(shè)備進行指令交互。平臺提供的接口相關(guān)信息可以在產(chǎn)品的第三方接口中查看。
3.1API調(diào)用接口
系統(tǒng)對外提供統(tǒng)一的API接口,用戶服務(wù)器在調(diào)用接口時按照相關(guān)接口協(xié)議進行調(diào)用。
圖3-1系統(tǒng)對外提供接口地址展示
3.2Token授權(quán)信息
系統(tǒng)目前使用Token認證,用戶在調(diào)用接口時必須攜帶Token信息,用于授權(quán)。
Token信息是綁定在產(chǎn)品下的,即每款產(chǎn)品有一個Token信息。Token支持用戶自定義(Md5格式),如果用戶想在多款產(chǎn)品中使用同一個Token,將這幾款產(chǎn)品的Token設(shè)置為同一個即可。
圖3-2用戶密鑰
3.3 IP白名單
用戶服務(wù)器的IP地址必須設(shè)置在IP白名單中,不在IP白名單中的請求將被攔截。
圖3-3第三方用戶服務(wù)器IP地址
3.4 回調(diào)地址
回調(diào)地址為用戶提供給平臺的的通知接口,平臺將設(shè)備上報的指令以http協(xié)議形式回調(diào)給用戶服務(wù)器,通知用戶設(shè)備狀態(tài)的改變。
該回調(diào)地址由商戶提供,具體回調(diào)信息格式參考相關(guān)協(xié)議文檔。
圖3-4第三方服務(wù)器調(diào)用平臺接口使用的回調(diào)地址