智能網(wǎng)關(guān)及應(yīng)用平臺接口精選ppt此文件標(biāo)題此文件標(biāo)題智能網(wǎng)關(guān)系統(tǒng)總體框架分發(fā)平臺：網(wǎng)關(guān)出廠首次啟動連接應(yīng)先到分發(fā)平臺進(jìn)行連接，分發(fā)平臺將根據(jù)一定的策略，要求網(wǎng)關(guān)今后指向相應(yīng)的運(yùn)營平臺運(yùn)營平臺：負(fù)責(zé)對網(wǎng)關(guān)的注冊、管理、業(yè)務(wù)運(yùn)營等功能。數(shù)據(jù)管理總體原則家庭網(wǎng)關(guān)遠(yuǎn)程管理涉及到的應(yīng)用數(shù)據(jù)可分為三大類：ITMS獨立管理的數(shù)據(jù)、手機(jī)APP管理平臺獨立管理的數(shù)據(jù)以及ITMS和手機(jī)APP管理平臺共同管理的數(shù)據(jù)。這三類數(shù)據(jù)應(yīng)遵循以下原則進(jìn)行管理：ITMS獨立管理數(shù)據(jù)（主要包括TR098中定義但在本方案中沒有涉及到的相關(guān)參數(shù)）：只能通過ITMS進(jìn)行參數(shù)配置、恢復(fù)出廠預(yù)配置等操作，不能由手機(jī)APP管理平臺進(jìn)行參數(shù)配置、恢復(fù)出廠預(yù)配置等操作。手機(jī)APP管理平臺獨立管理數(shù)據(jù)（包括WIFI定時開關(guān)參數(shù)、DNS重定向配置參數(shù)等）：只能通過手機(jī)APP管理平臺進(jìn)行參數(shù)配置、恢復(fù)出廠預(yù)配置等操作，不能由ITMS進(jìn)行參數(shù)配置、恢復(fù)出廠預(yù)配置等操作。手機(jī)APP管理平臺和ITMS共同管理數(shù)據(jù)：ITMS和手機(jī)APP管理平臺都可以進(jìn)行參數(shù)配置，并以最后一個平臺配置的數(shù)值為準(zhǔn)。ITMS進(jìn)行恢復(fù)出廠配置時，可對該類參數(shù)進(jìn)行出廠預(yù)配置。當(dāng)手機(jī)APP管理平臺進(jìn)行恢復(fù)出廠配置時，僅能對下述參數(shù)進(jìn)行操作：網(wǎng)關(guān)下掛終端接入控制相關(guān)參數(shù)。智能網(wǎng)關(guān)對外接口在網(wǎng)絡(luò)中的位置1)網(wǎng)關(guān)和ITMS+（G1）：遵循《中國電信家庭網(wǎng)關(guān)與增強(qiáng)型終端綜合管理系統(tǒng)接口技術(shù)要求》定義的相關(guān)內(nèi)容，在現(xiàn)網(wǎng)已實現(xiàn)的管理內(nèi)容、接口、業(yè)務(wù)流程不變。2)網(wǎng)關(guān)和智能網(wǎng)關(guān)及應(yīng)用管理平臺接口（G2）:通過對網(wǎng)關(guān)的封裝能力調(diào)用，實現(xiàn)手機(jī)app對網(wǎng)關(guān)的配置管理；通過對網(wǎng)關(guān)上插件的接口調(diào)用，實現(xiàn)對插件的安裝、刪除、動態(tài)加載等操作。3)手機(jī)APP和智能網(wǎng)關(guān)及應(yīng)用管理平臺接口（G3）：

通過與平臺接口，實現(xiàn)對網(wǎng)關(guān)進(jìn)行配置、管理。4）手機(jī)APP和網(wǎng)關(guān)接口（G4）：

通過對網(wǎng)關(guān)本地能力封裝接口調(diào)用，實現(xiàn)本地對網(wǎng)關(guān)進(jìn)行管理。智能網(wǎng)關(guān)對外接口概述智能網(wǎng)關(guān)和智能網(wǎng)關(guān)及應(yīng)用管理平臺接口:網(wǎng)關(guān)分發(fā)接口（1）：平臺按照一定的策略，將網(wǎng)關(guān)分發(fā)到不同的服務(wù)器中網(wǎng)關(guān)接入接口（2）：支持網(wǎng)關(guān)注冊、心跳、反向觸發(fā)等接口網(wǎng)關(guān)插件管理接口（3）：支持對網(wǎng)關(guān)插件的安裝、卸載、配置等功能網(wǎng)關(guān)消息推送接口（4）：支持網(wǎng)關(guān)向平臺上報消息智能網(wǎng)關(guān)和手機(jī)app接口（5）：通過本地接口，實現(xiàn)對網(wǎng)關(guān)進(jìn)行配置、管理。前置條件網(wǎng)關(guān)信息已經(jīng)在分發(fā)平臺和運(yùn)營平臺預(yù)置

“MAC”:定義為12字節(jié)的十六進(jìn)制ASCII碼，如：“64D95420214B”

家庭網(wǎng)關(guān)設(shè)備標(biāo)識（sn）定義為<OUI>-<SerialNumber>，如64D954-D6AEE64D95420214B2.網(wǎng)關(guān)分發(fā)平臺地址為189；可以修改

智能網(wǎng)關(guān)TR098擴(kuò)充參數(shù)說明名稱類型寫描述InternetGatewayDevice.X_CT-COM_Mgt.Object-本節(jié)點參數(shù)在參數(shù)模型中不可見，而且在軟件升級、配置文件下發(fā)、恢復(fù)出廠預(yù)配等操作時，本節(jié)點參數(shù)應(yīng)保持原有參數(shù)值MgtURLString（256）W分發(fā)平臺地址缺?。?89PortunsignedIntW訪問端口，缺?。?2112（UDP和TCP端口一致）HeartbeatunsignedIntW終端和運(yùn)營平臺心跳，缺省60秒

AbilityunsignedIntW網(wǎng)關(guān)封裝接口能力是否向本地開放，0：開放，1：不開放，缺?。?LocatePortunsignedIntW網(wǎng)關(guān)內(nèi)部為客戶端本地訪問的TCP端口，缺?。?7998VersionStringR網(wǎng)關(guān)通信接口版本號，缺?。?.0設(shè)備首次注冊流程設(shè)備首次注冊流程1）網(wǎng)關(guān)上電啟動（假設(shè)寬帶業(yè)務(wù)已開通，和運(yùn)營管理平臺IP可達(dá)）；2）網(wǎng)關(guān)向DNS服務(wù)器解析分發(fā)平臺URL；3）DNS返回一個IP地址，作為網(wǎng)關(guān)訪問的目的IP地址；4）網(wǎng)關(guān)連接分發(fā)平臺，成功后分發(fā)平臺返回網(wǎng)關(guān)要連接的運(yùn)營平臺地址；5）網(wǎng)關(guān)根據(jù)該地址向運(yùn)營管理平臺發(fā)注冊消息，上報：設(shè)備廠商、型號、MAC、軟件版本、硬件版本、IP地址、邏輯ID等信息6）平臺驗證設(shè)備MAC合法性，并回復(fù)網(wǎng)關(guān)7）網(wǎng)關(guān)周期心跳上報到平臺設(shè)備非首次注冊流程設(shè)備重啟或者WANIP變化1）網(wǎng)關(guān)上電啟動（假設(shè)寬帶業(yè)務(wù)已開通，和運(yùn)營管理平臺IP可達(dá)），且首次注冊后運(yùn)營平臺地址已記錄；4）網(wǎng)關(guān)連接運(yùn)營平臺地址；5）網(wǎng)關(guān)根據(jù)該地址向運(yùn)營管理平臺發(fā)注冊消息，上報：設(shè)備廠商、型號、MAC、軟件版本、硬件版本、IP地址、邏輯ID等信息6）平臺驗證設(shè)備MAC合法性，并回復(fù)網(wǎng)關(guān)7）網(wǎng)關(guān)周期心跳上報到平臺智能網(wǎng)關(guān)接口技術(shù)要求5.1智能網(wǎng)關(guān)分發(fā)接口技術(shù)要求本協(xié)議目的是實現(xiàn)網(wǎng)關(guān)與分發(fā)模塊間的連接。本協(xié)議基于UDP實現(xiàn)。5.1.a) 網(wǎng)關(guān)向分發(fā)平臺接口注冊1BootFirst5.1.b) 網(wǎng)關(guān)向分發(fā)平臺接口注冊2RegisterFirst5.2智能網(wǎng)關(guān)接入接口技術(shù)要求本協(xié)議目的是保持網(wǎng)關(guān)與接入接口模塊間的狀態(tài)同步，即IP地址、在線狀態(tài)信息的同步，同時，它是接入模塊通知網(wǎng)關(guān)發(fā)起連接到插件管理模塊的反向觸發(fā)通道。本協(xié)議基于UDP實現(xiàn)。5.2.a) 網(wǎng)關(guān)向運(yùn)營平臺注冊1Boot5.2.b) 網(wǎng)關(guān)向運(yùn)營平臺注冊2Register5.2.c) 心跳保活Hb5.2.d) 反向觸發(fā)網(wǎng)關(guān)連接到插件中心RequestPlug-in5.2.e) 反向觸發(fā)網(wǎng)關(guān)重新注冊RequestDistri5.3智能網(wǎng)關(guān)插件管理接口技術(shù)要求通過本協(xié)議，平臺實現(xiàn)對網(wǎng)關(guān)資源的調(diào)用；網(wǎng)關(guān)應(yīng)作為client向平臺發(fā)起TCP連接。本協(xié)議采用TCP。5.3.a) 連接保持Heartbeat5.3.b) 應(yīng)用管理Post5.3.c) 服務(wù)器斷開連接Disconnect5.3.d) Boot（Boot

Register）智能網(wǎng)關(guān)接口技術(shù)要求5.5智能網(wǎng)關(guān)與手機(jī)APP接口技術(shù)要求智能網(wǎng)關(guān)應(yīng)作為server接受手機(jī)APP發(fā)起的TCP連接。智能網(wǎng)關(guān)如接受到手機(jī)APP的”Post1”命令，且由本地發(fā)起的，提供本地能力接口。承載協(xié)議與網(wǎng)關(guān)與平臺間的插件協(xié)議相同，但僅能在LAN側(cè)發(fā)起請求。網(wǎng)關(guān)通過本接口，返回消息到客戶端后，應(yīng)主動關(guān)閉TCP連接。智能網(wǎng)關(guān)接口技術(shù)要求方向

手機(jī)客戶端至網(wǎng)關(guān)網(wǎng)關(guān)

智能網(wǎng)關(guān)req.JSON{”RPCMethod”:”Post1”,“ID”:數(shù)字,”Plugin_Name”:“Plugin_ID”,“Version”:”插件版本”,“Parameter”:”string”}resp.JSON{“Result”:Value,”return_Parameter”:”string”,”ID”:數(shù)字}備注

完成插件的參數(shù)獲取或配置功能其中string為插件參數(shù)base64的編碼0：成功；-5:忙；-12：插件不存在，-16：插件未處于是運(yùn)行狀態(tài)，-100:插件操作超時智能網(wǎng)關(guān)能力封裝8.2.4查詢CPU占用率開放權(quán)限：適合遠(yuǎn)程提供網(wǎng)關(guān)接收消息格式發(fā)送值%s填充含義智能網(wǎng)關(guān)發(fā)送消息返回值及%s填充含義｛"RPCMethod":"Post"，"ID":數(shù)字，"Plugin_Name":"Plugin_ID"，"Version":"1.0"，"Parameter":"String"}

Parameter的String定義為{"CmdType":"QUERY_CPU_INFO"，"SequenceId":"8位16進(jìn)制數(shù)"}

SequenceId為手機(jī)客戶端動態(tài)生成，表示命令序列，網(wǎng)關(guān)按照請求的原值返回（8位十六進(jìn)制數(shù)）；ID為平臺維護(hù)的事物ID；Version為插件的版本號（已點分十進(jìn)制表示，分為2段）查詢成功｛“Result”:0，"ID":數(shù)字,"return_Parameter":"String"}

return_Parameter中的String為{"CmdType":"QUERY_CPU_INFO","SequenceId":"8位16進(jìn)制","Status":"0","Percent":"%s"}Status=0表示查詢CPU占用率成功；PERCENT=%s表示CPU占用的百分比（十進(jìn)制表示）查詢失敗｛“Result”:0，"ID":數(shù)字,"return_Parameter":"String"}

return_Parameter中的String為{"CmdType":"QUERY_CPU_INFO","SequenceId":"8位16進(jìn)制數(shù)","Status":"1","FailReason":"%s"}Status=1表示查詢CPU占用率失??；FailReason為具體失敗的原因智能網(wǎng)關(guān)能力封裝8.2.2查詢設(shè)備的基本信息開放權(quán)限：適合本地提供網(wǎng)關(guān)接收消息格式發(fā)送值%s填充含義智能網(wǎng)關(guān)發(fā)送消息返回值及%s填充含義｛"RPCMethod":"Post1"，"ID":數(shù)字，"Plugin_Name":"Plugin_ID"，"Version"："1.0"，"Parameter":"String"}

Parameter的String定義為{"CmdType":"GET_SN_INFO"，"SequenceId":"8位十六進(jìn)制"}SequenceId為手機(jī)客戶端動態(tài)生成，表示命令序列，網(wǎng)關(guān)按照請求的原值返回（8位十六進(jìn)制數(shù)）；ID為平臺維護(hù)的事物ID；Version為插件的版本號（已點分十進(jìn)制表示，分為2段）；查詢成功｛“Result”:0，"ID":數(shù)字,"return_Parameter":"String"}return_Parameter中的String為{"CmdType":"GET_SN_INFO","SequenceId":"8位十六進(jìn)制","Status":"0","MAC":"%s""BussinessStatus":"%s"}查詢成功：MAC=%s表示設(shè)備SN中的MAC信息；BussinessStatus表示業(yè)務(wù)是否已開通，取值范圍：SUCCESS為業(yè)務(wù)已開通；FAIL為業(yè)務(wù)未開通；

Stauts=0表示查詢成功；查詢失?。癛esult”:0，"ID":數(shù)字,"return_Parameter":"String"}return_Parameter中的String為{"CmdType":"GET_SN_INFO","SequenceId":"8位十六進(jìn)制","Status":"1"，"FailReason":"1"}

Status=1表示查詢失敗；FailReason表示網(wǎng)關(guān)返回的具體出錯原因；智能網(wǎng)關(guān)管理流程說明智能網(wǎng)關(guān)管理流程說明智能網(wǎng)關(guān)管理流程說明6.1首次注冊流程6.2

設(shè)備綁定流程

1）手機(jī)客戶端只能通過本地發(fā)起綁定流程2）用戶完成手機(jī)客戶端和平臺的認(rèn)證流程智能網(wǎng)關(guān)管理流程說明智能網(wǎng)關(guān)管理流程說明智能網(wǎng)關(guān)管理流程說明3）手機(jī)客戶端本地向網(wǎng)關(guān)發(fā)起交互接口，調(diào)用5.5接口，輸入?yún)?shù)包括：”Post1”,“ID（手機(jī)客戶端生成隨機(jī)十進(jìn)制數(shù)字，長度為8位）”,”Plugin_Name（通過調(diào)用8.2.2接口）”,“Version（暫定為：1.0）””,“Parameter（參見8.2.2）”，手機(jī)客戶端通過和網(wǎng)關(guān)的交互，獲取網(wǎng)關(guān)的MAC?！癈mdType”:“GET_SN_INFO”------->“MAC”:“%s”4）客戶端彈出認(rèn)證界面，用戶需要填入本地用戶名、密碼，客戶端調(diào)用5.5接口，輸入?yún)?shù)包括：”Post1”,“ID（手機(jī)客戶端生成隨機(jī)十進(jìn)制數(shù)字，長度為8位）”,”Plugin_Name（通過調(diào)用8.2.38接口）”,“Version（暫定為：1.0）””,“Parameter（參見8.2.38）”，手機(jī)客戶端通過和網(wǎng)關(guān)的交互，驗證設(shè)備用戶名、密碼，獲取網(wǎng)關(guān)的loid和加密的sn。“CmdType”，“PassWD”:“%s”，PassWD=%s表示需要進(jìn)行驗證的”:“CHECK_PASSWD_PARAM或Telecomadmin的帳號訪問密碼；Useradmin的帳號訪問密碼“LOID”:“%s”，“SN”=%s，LOID=%s表示返回此設(shè)備的LOID信息，SN=%s為MD5(DevRND,SN)；其中DevRND為網(wǎng)關(guān)最新生產(chǎn)的16字節(jié)隨機(jī)數(shù)。5）手機(jī)客戶端向分發(fā)平臺上報sn、loid信息，進(jìn)行綁定請求6）平臺回復(fù)，綁定成功。智能網(wǎng)關(guān)管理流程說明6.3設(shè)備解綁流程6.4遠(yuǎn)程配置流程智能網(wǎng)關(guān)管理流程說明手機(jī)客戶端在平臺進(jìn)行認(rèn)證手機(jī)客戶端主動查詢該賬號綁定的設(shè)備手機(jī)客戶端選定目標(biāo)網(wǎng)關(guān)后，即可訪問平臺反向觸發(fā)當(dāng)前網(wǎng)關(guān)連接到插件中心，參數(shù)包括：Request”，”DeviceSN（設(shè)備序列號OUI+S