道閘一體機對接方案介紹
1．概述
1.1 編寫目的
本文檔介紹道閘一體機（包括費用顯示屏、車輛道閘、車輛識別攝像頭）接入到邊緣服務器的對接方案和設備驅(qū)動的開發(fā)流程。
1.2名詞解釋
名詞 | 解釋 |
Link IoT Edge | 物聯(lián)網(wǎng)邊緣計算產(chǎn)品（Link IoT Edge，簡稱LE），即阿里云物聯(lián)網(wǎng)平臺（IoT）中的邊緣計算產(chǎn)品。提供安全可靠的數(shù)據(jù)計算能力，可供本地處理設備數(shù)據(jù)，減少上傳云端的成本。 |
網(wǎng)關(guān) | 運行Link IoT Edge軟件的計算設備統(tǒng)稱為邊緣網(wǎng)關(guān)或邊緣服務器，簡稱網(wǎng)關(guān)。 |
子設備 | 指通過一定的協(xié)議或接口接入到Link IoT Edge網(wǎng)關(guān)上的設備（即設備接入到網(wǎng)關(guān)后稱為子設備），網(wǎng)關(guān)代理該子設備與云端進行通信。 |
驅(qū)動 | Link IoT Edge中的設備接入模塊稱為驅(qū)動（driver）或設備接入驅(qū)動。所有連接到Link IoT Edge的設備都需要通過驅(qū)動實現(xiàn)接入。 |
2．系統(tǒng)架構(gòu)圖
圖解說明：
① 云端應用：停車應用軟件。功能包括訂單管理、車輛管理、事件管理等，該軟件基于云平臺提供的領(lǐng)域服務API開發(fā)，實現(xiàn)對設備上報事件的處理及對設備的控制。
② 云平臺：物聯(lián)網(wǎng)云平臺。向托管在邊緣網(wǎng)關(guān)內(nèi)的停車應用軟件提供空間管理及停車領(lǐng)域服務。向自定義驅(qū)動提供物模型。
③ 邊緣網(wǎng)關(guān)：邊緣網(wǎng)關(guān)內(nèi)主要角色分自定義協(xié)議驅(qū)動和停車邊緣應用，驅(qū)動運行在LE組件中，負責管理及控制設備，其中包含阿里云提供的設備接入SDK（LEDA）部分和開發(fā)者實現(xiàn)部分。停車邊緣應用負責各場景應用實現(xiàn)。
④ 設備端：道閘一體機，包括攝像頭、道閘、費顯屏，設備供應商應提供設備通信協(xié)議，供驅(qū)動訪問或控制設備使用。設備供應商應提供硬件配置工具，可以進行設備初始化、設備參數(shù)配置及故障定位功能。
⑤ 圖片上傳：攝像頭應通過邊緣網(wǎng)關(guān)文件服務提供的訪問端口，使用HTTP協(xié)議上傳車輛及車牌圖片。
3. 交互流程
3.1 車輛入場/出場
3.2 上傳車輛圖片
4．對接流程
4.1 明確方案分工
根據(jù)系統(tǒng)架構(gòu)圖的內(nèi)容，進行方案可行性評估，理解自定義協(xié)議驅(qū)動所處的位置。
明確各環(huán)節(jié)項目分工——需要設備端技術(shù)人員和協(xié)議驅(qū)動開發(fā)人員明確各自負責內(nèi)容。
明確自定義協(xié)議驅(qū)動需要實現(xiàn)的功能，參考對應設備的物模型（請參考《3.3 道閘一體機設備物模型》文檔的物模型介紹）。
明確自定義協(xié)議驅(qū)動與設備的通信方式，需要設備廠商提供設備端SDK，使自定義協(xié)議驅(qū)動可以基于該SDK實現(xiàn)訪問設備數(shù)據(jù)和下發(fā)控制命令的功能。
4.2 信息收集
提供設備的硬件型號、設備ID。
4.3 驅(qū)動開發(fā)
參考《3.2 道閘一體機驅(qū)動開發(fā)指導》文檔，了解物聯(lián)網(wǎng)設備接入，熟悉LEDA接口，熟悉實現(xiàn)驅(qū)動的基本方式，開發(fā)自定義協(xié)議驅(qū)動。
參考《3.4 邊緣文件服務接口說明》文檔，實現(xiàn)車輛圖片上傳功能。
自定義協(xié)議驅(qū)動需通過驅(qū)動日志確認設備向云平臺注冊上線的接口被調(diào)用，并保證設備持續(xù)穩(wěn)定地處于在線狀態(tài)。
自定義協(xié)議驅(qū)動需通過驅(qū)動日志確認設備上報事件的接口被調(diào)用，通過驅(qū)動日志確認服務方法接口被調(diào)用。
5. 物模型
請參考物聯(lián)網(wǎng)應用服務平臺里品類管理-車輛通行，如下圖所示：
附錄
驅(qū)動命名規(guī)則
在物聯(lián)網(wǎng)應用服務平臺，新創(chuàng)建的驅(qū)動英文名稱定義有下面的規(guī)范建議：
驅(qū)動名稱包含內(nèi)容：
廠商名稱_廠商產(chǎn)品型號_適用領(lǐng)域_驅(qū)動功能
如果這個驅(qū)動是通用驅(qū)動，適用所有廠商，則驅(qū)動名稱里可以去掉廠商名稱和廠商產(chǎn)品型號；
如果這個驅(qū)動支持某個廠商的所有產(chǎn)品型號，則驅(qū)動名稱里可以去掉廠商產(chǎn)品型號。
適用領(lǐng)域說明：
人行：PerAccess（personal access）
車行：VehAccess（vehicle access）
EBA：EBA
安防：SecSystem（security system）
驅(qū)動功能說明：
例如EBA領(lǐng)域，Modbus功能，例如人行領(lǐng)域，可視對講功能。
驅(qū)動名稱使用大駝峰命名規(guī)范，即每個單詞的首字母都要求是大寫。
舉例說明：
有一個驅(qū)動，可以支持能效通公司的所有型號的EBA Modbus設備，驅(qū)動名稱可定義為：Nxtone_EBA_Modbus.