電力物聯(lián)網(wǎng)邊緣物聯(lián)代理接口協(xié)議

ICS點(diǎn)擊此處添加ICS號(hào)

點(diǎn)擊此處添加中國(guó)標(biāo)準(zhǔn)文獻(xiàn)分類號(hào)

T/CEC

中國(guó)電力企業(yè)聯(lián)合會(huì)標(biāo)準(zhǔn)

T/CECXXXXX—XXXX

電力物聯(lián)網(wǎng)邊緣物聯(lián)代理接口協(xié)議

FullserviceubiquitousIOTedgeIOTagentinterfaceprotocol

點(diǎn)擊此處添加與國(guó)際標(biāo)準(zhǔn)一致性程度的標(biāo)識(shí)

文稿版次選擇

XXXX-XX-XX發(fā)布XXXX-XX-XX實(shí)施

中國(guó)電力企業(yè)聯(lián)合會(huì)發(fā)布

T/CECXXXXX—XXXX

前言

本文件按照GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定起

草。

請(qǐng)注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機(jī)構(gòu)不承擔(dān)識(shí)別這些專利的責(zé)任。

本文件由中國(guó)電力企業(yè)聯(lián)合會(huì)提出。

本文件由電力行業(yè)信息標(biāo)準(zhǔn)化技術(shù)委員會(huì)（DL/TC27）歸口。

本文件起草單位：

本文件主要起草人：。

本文件首次發(fā)布。

本文件在執(zhí)行中的意見(jiàn)或建議反饋至中國(guó)電力企業(yè)聯(lián)合會(huì)標(biāo)準(zhǔn)化管理中心（北京市宣武區(qū)白廣路二

條一號(hào)，100761）。

II

T/CECXXXXX—XXXX

電力物聯(lián)網(wǎng)邊緣物聯(lián)代理接口協(xié)議

1范圍

本文件規(guī)定了電力物聯(lián)網(wǎng)邊緣物聯(lián)代理（以下簡(jiǎn)稱“邊設(shè)備”）與物聯(lián)管理平臺(tái)之間交互協(xié)議的功

能、主題、報(bào)文格式等技術(shù)要求。

本文件適用于電力物聯(lián)網(wǎng)邊設(shè)備交互協(xié)議的設(shè)計(jì)、開(kāi)發(fā)、檢驗(yàn)和驗(yàn)收。

2規(guī)范性引用文件

下列文件對(duì)于本文件的應(yīng)用是必不可少的。凡是注日期的引用文件，僅所注日期的版本適用于本文

件。凡是不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。

GB/T22239信息安全技術(shù)網(wǎng)絡(luò)安全等級(jí)保護(hù)基本要求

GB/T33745—2017物聯(lián)網(wǎng)術(shù)語(yǔ)

IEEE802.1ARIEEE本地和城域網(wǎng)標(biāo)準(zhǔn)-安全設(shè)備標(biāo)識(shí)（IEEEStandardforLocaland

metropolitanareanetworks-SecureDeviceIdentity）

IEEE1588-2008用于網(wǎng)絡(luò)測(cè)量與控制系統(tǒng)的精確時(shí)鐘同步協(xié)議（StandardforaPrecisionClock

SynchronizationProtocolforNetworkedMeasurementandControlSystems）

MQTTV31MQTTV3.1協(xié)議規(guī)范（MQTTV3.1ProtocolSpecification）

RFC793傳輸控制協(xié)議（TransmissionControlProtocol.STD7,IETFRFC793）

RFC3629UTF-8，ISO10646的轉(zhuǎn)換格式（UTF-8,atransformationformatofISO10646）

RFC6455WebSocket協(xié)議（TheWebSocketProtocol）

3術(shù)語(yǔ)和定義

《GB/T33745—2017物聯(lián)網(wǎng)術(shù)語(yǔ)》界定的以及下列術(shù)語(yǔ)和定義適用于本文件。

4縮略語(yǔ)

下列縮略語(yǔ)適用于本文件。

IP：互聯(lián)網(wǎng)協(xié)議（InternetProtocol）

ISO：國(guó)際標(biāo)準(zhǔn)化組織（InternationalOrganizationforStandardization）

JSON：JS對(duì)象描述（JavaScriptObjectNotation）

MQTT:消息隊(duì)列遙測(cè)傳輸（MessageQueuingTelemetryTransport）

NB-IoT：窄帶物聯(lián)網(wǎng)（NarrowBandInternetofThings）

OSI：開(kāi)放系統(tǒng)互聯(lián)（OpenSystemInterconnection）

QoS：服務(wù)質(zhì)量（QualityofService）

TCP：傳輸控制協(xié)議（TransmissionControlProtocol）

4G：第4代移動(dòng)通信（The4thGenerationMobileCommunication）

1

T/CECXXXXX—XXXX

5G：第5代移動(dòng)通信（The5thGenerationMobileCommunication）

5總體要求

5.1通信架構(gòu)

邊設(shè)備與物聯(lián)管理平臺(tái)經(jīng)過(guò)安全接入網(wǎng)關(guān)，使用MQTT和HTTP協(xié)議進(jìn)行通信交互。其中，常規(guī)的管理

數(shù)據(jù)、業(yè)務(wù)數(shù)據(jù)交互通過(guò)MQTT進(jìn)行通信，HTTP僅用于應(yīng)用下發(fā)等文件傳輸場(chǎng)景，即除非特指，默認(rèn)的通

信協(xié)議為MQTT。使用MQTT和HTTP協(xié)議的通信架構(gòu)如圖1所示。

物聯(lián)管理平臺(tái)

MQTT/HTTPMQTT/HTTP

（管理數(shù)據(jù)、業(yè)務(wù)數(shù)據(jù)）（管理數(shù)據(jù)、業(yè)務(wù)數(shù)據(jù)）

安全接入網(wǎng)關(guān)

邊設(shè)備邊設(shè)備

子設(shè)備子設(shè)備子設(shè)備子設(shè)備

圖1通信架構(gòu)

5.2協(xié)議結(jié)構(gòu)

邊設(shè)備與物聯(lián)管理平臺(tái)之間所采用的MQTT和HTTP通信協(xié)議在OSI七層體系中所屬位置以及協(xié)議棧數(shù)

據(jù)結(jié)構(gòu)，如表1所示。

表1通信協(xié)議規(guī)約結(jié)構(gòu)

協(xié)議名稱對(duì)應(yīng)OSI層次

MQTT、HTTP

應(yīng)用層（第7層）

SSL、SSAL

TCP傳輸層（第4層）

IP網(wǎng)絡(luò)層（第3層）

數(shù)據(jù)鏈路層（第2層）

802.3、4G/5G、NB-IoT等協(xié)議

物理層（第1層）

注：OSI第5，第6層未用。

2

T/CECXXXXX—XXXX

5.3通用要求

邊設(shè)備與物聯(lián)管理平臺(tái)基于MQTT協(xié)議以下類型的控制報(bào)文進(jìn)行連接的維護(hù)：其中基于CONNECT/

CONNACK控制報(bào)文建立MQTT連接；基于PINGREQ/PINGRESP?；頜QTT連接；基于DISCONNECT控制報(bào)文斷開(kāi)

連接。邊設(shè)備與物聯(lián)管理平臺(tái)基于MQTT協(xié)議的發(fā)布/訂閱機(jī)制完成兩者之間請(qǐng)求/應(yīng)答報(bào)文的交互?？刂?/p>

報(bào)文應(yīng)滿足以下要求：

a)所使用的控制報(bào)文應(yīng)遵循MQTTV3.1ProtocolSpecification的格式要求。

b)PUBLISH控制報(bào)文的有效載荷字段的定義應(yīng)遵循本文件5.4的要求。

c)PUBLISH控制報(bào)文的可變報(bào)頭字段的定義應(yīng)遵循本文件5.5的要求。

d)如無(wú)特殊說(shuō)明，本文中定義的基于PUBLISH承載的請(qǐng)求/應(yīng)答報(bào)文其QoS級(jí)別默認(rèn)為0。

e)邊設(shè)備與物聯(lián)管理平臺(tái)的交互協(xié)議可不通過(guò)MQTT協(xié)議自帶的secure-MQTT提供安全保障，但

應(yīng)通過(guò)下層的SSL、SSAL協(xié)議提供客戶端身份的認(rèn)證及傳輸通道的安全。

5.4協(xié)議報(bào)文有效載荷格式

5.4.1請(qǐng)求報(bào)文

邊設(shè)備與物聯(lián)管理平臺(tái)交互的請(qǐng)求報(bào)文均承載在MQTT發(fā)布報(bào)文的有效載荷中，以JSON格式描述，請(qǐng)

求報(bào)文載荷通用字段定義應(yīng)遵循表2的要求。

表2請(qǐng)求報(bào)文有效載荷通用字段定義

字段類型是否必選描述

midnumber否在請(qǐng)求報(bào)文中該值為請(qǐng)求

ID，在終端主動(dòng)上報(bào)數(shù)據(jù)的

報(bào)文中該字段可不填寫(xiě)

deviceIdstring否設(shè)備唯一標(biāo)識(shí)，涉及批量設(shè)

備操作時(shí)該字段可不填寫(xiě)

appstring否APP應(yīng)用名稱，涉及批量設(shè)

備操作時(shí)填寫(xiě)該字段

timestamplong是消息發(fā)送的時(shí)間戳，CST時(shí)

間,精度到秒

expirenumber否此報(bào)文過(guò)期的相對(duì)時(shí)間（相

對(duì)timestamp），單位秒，不

包含該字段，或者該字段為

-1時(shí)表示永不過(guò)期

typestring是消息類型，全大寫(xiě)，單詞中

間用“_”隔開(kāi)

paramobject否報(bào)文內(nèi)容，詳見(jiàn)本文6中各

節(jié)報(bào)文定義

5.4.2應(yīng)答報(bào)文

邊設(shè)備與物聯(lián)管理平臺(tái)交互的應(yīng)答報(bào)文均承載在MQTT發(fā)布報(bào)文的有效載荷中，以JSON格式描述，應(yīng)

答報(bào)文載荷通用字段定義應(yīng)遵循表3的要求。應(yīng)答報(bào)文載荷中“code”字段的取值應(yīng)符合表4的要求。

3

T/CECXXXXX—XXXX

表3應(yīng)答報(bào)文有效載荷通用字段定義

字段類型是否必選

midnumber是在應(yīng)答報(bào)文中，該值為應(yīng)答

所對(duì)應(yīng)請(qǐng)求報(bào)文的請(qǐng)求ID

deviceIdstring否設(shè)備唯一標(biāo)識(shí)，涉及批量設(shè)

備操作時(shí)該字段可不填寫(xiě)

timestampstring是消息發(fā)送的時(shí)間戳，CST時(shí)

間，精度到秒

typestring是消息類型,全大寫(xiě)，單詞中間

用“_”隔開(kāi)

paramobject否報(bào)文內(nèi)容，詳見(jiàn)各報(bào)文定義

codenumber是標(biāo)識(shí)應(yīng)答的返回碼

msgstring否應(yīng)答結(jié)果描述，字符串，最

大256字符

表4應(yīng)答報(bào)文載荷中“code”字段的取值定義

code字段取值描述

200請(qǐng)求成功

202請(qǐng)求被接受，但是服務(wù)器未處理完

400請(qǐng)求失敗

401請(qǐng)求未認(rèn)證/認(rèn)證錯(cuò)誤

403請(qǐng)求被拒絕

404請(qǐng)求的資源不存在

408請(qǐng)求超出了服務(wù)器的等待時(shí)間

500其他錯(cuò)誤

5.4.3JSON字段命名規(guī)范

報(bào)文采用JSON格式描述，對(duì)JSON字段命名應(yīng)遵循以下要求：

a)設(shè)備名稱采用首字母大寫(xiě)；

b)變量名、屬性名第一個(gè)單詞首字母小寫(xiě)，剩余單詞首字母大寫(xiě)；

c)type字段約束如下：

1)為全大寫(xiě)單詞，單詞中間用下劃線分隔開(kāi)；

2)所有命令以“CMD_”開(kāi)頭；

3)所有上報(bào)數(shù)據(jù)均以“EVENT_”或“REP_”開(kāi)頭；

4)所有應(yīng)答報(bào)文與請(qǐng)求報(bào)文字段相同。

d)全部使用英文單詞，禁止使用拼音；

e)每個(gè)單詞長(zhǎng)度不宜超10個(gè)字符，否則盡量使用簡(jiǎn)寫(xiě)；

f)單詞簡(jiǎn)寫(xiě)時(shí)應(yīng)盡可能望文知意，以滿足易讀性為首要選擇，其次盡量縮短長(zhǎng)度。

4

T/CECXXXXX—XXXX

5.5協(xié)議報(bào)文可變報(bào)頭格式

5.5.1邊設(shè)備與物聯(lián)管理平臺(tái)交互采用基于主題的發(fā)布/訂閱模式進(jìn)行信息交互。主題承載在發(fā)布報(bào)文

的可變報(bào)頭中，主題格式應(yīng)遵守:/主題版本/邊設(shè)備或直連設(shè)備ID/消息執(zhí)行類別/消息動(dòng)作，

/{v1}/{edgeId}/{TopicType}/{TopicCommand}，其中：

a){v1}：表示目前使用的主題版本，當(dāng)前為v1,后期可發(fā)布v2、v3等版本；

b){edgeId}：表示直接與物聯(lián)管理平臺(tái)建立MQTT長(zhǎng)連接的邊設(shè)備或直連設(shè)備ID；

c){TopicType}：主題的類別，主要有device、container、app、service、topo五種。device

表示該主題為設(shè)備類消息，service表示為業(yè)務(wù)類消息，app表示應(yīng)用類消息，container表

示容器消息，topo表示端設(shè)備消息；

d){TopicCommand}：表示消息的動(dòng)作如控制、采集的數(shù)據(jù)、請(qǐng)求或應(yīng)答。

5.5.2主題的主要內(nèi)容和用途見(jiàn)表5，其中，方向取值為：up、down。當(dāng)為up時(shí)表示邊設(shè)備或直連終

端發(fā)布由物聯(lián)管理平臺(tái)訂閱的主題；為down時(shí)表示物聯(lián)管理平臺(tái)發(fā)布由邊設(shè)備或直連終端訂閱的主題。

表5主題內(nèi)容及用途

主題分類主題內(nèi)容方向用途

/v1/{edgeId}/device/commanddown用于物聯(lián)管理平臺(tái)向邊設(shè)備發(fā)送設(shè)備控制命

令，如設(shè)備升級(jí)、控制設(shè)備等

/v1/{edgeId}/device/replyup用于對(duì)物聯(lián)管理平臺(tái)發(fā)送的設(shè)備控制命令的

應(yīng)答

/v1/{edgeId}/device/requestup用于邊設(shè)備向物聯(lián)管理平臺(tái)發(fā)送設(shè)備管理相

關(guān)的請(qǐng)求命令，如請(qǐng)求連接等

設(shè)備管理/v1/{edgeId}/device/responsedown用于對(duì)邊設(shè)備發(fā)送的設(shè)備管理相關(guān)的請(qǐng)求命

令的應(yīng)答

/v1/{edgeId}/device/dataup用于邊設(shè)備向物聯(lián)管理平臺(tái)主動(dòng)上報(bào)設(shè)備相

關(guān)的狀態(tài)、事件等

/v1/{edgeId}/topo/requestup用于邊設(shè)備向物聯(lián)管理平臺(tái)發(fā)送拓?fù)湫畔⒌?/p>

請(qǐng)求命令

/v1/{edgeId}/topo/responsedown用于對(duì)邊設(shè)備發(fā)送的拓?fù)湫畔⒌恼?qǐng)求命令的

應(yīng)答

/v1/{edgeId}/container/commanddown用于物聯(lián)管理平臺(tái)向邊設(shè)備發(fā)送的容器控制

請(qǐng)求命令，如容器安裝、啟動(dòng)、停止等

容器管理/v1/{edgeId}/container/replyup用于對(duì)物聯(lián)管理平臺(tái)的容器控制請(qǐng)求命令的

應(yīng)答

/v1/{edgeId}/container/dataup用于邊設(shè)備向物聯(lián)管理平臺(tái)主動(dòng)上報(bào)容器相

關(guān)的狀態(tài)、事件等

/v1/{edgeId}/app/commanddown用于物聯(lián)管理平臺(tái)向邊設(shè)備發(fā)送應(yīng)用控制請(qǐng)

求命令，如應(yīng)用安裝、啟動(dòng)、停止等

應(yīng)用管理/v1/{edgeId}/app/replyup用于對(duì)物聯(lián)管理平臺(tái)發(fā)送的應(yīng)用控制請(qǐng)求命

令的應(yīng)答

/v1/{edgeId}/app/dataup用于邊設(shè)備向物聯(lián)管理平臺(tái)主動(dòng)上報(bào)應(yīng)用相

關(guān)的狀態(tài)、事件等

5

T/CECXXXXX—XXXX

/v1/{edgeId}/service/commanddown用于物聯(lián)管理向邊設(shè)備發(fā)送業(yè)務(wù)交互請(qǐng)求命

令

/v1/{edgeId}/service/replyup用于對(duì)物聯(lián)管理的業(yè)務(wù)交互請(qǐng)求命令的應(yīng)答

/v1/{edgeId}/service/dataup用于邊設(shè)備向物聯(lián)管理平臺(tái)主動(dòng)上報(bào)業(yè)務(wù)相

關(guān)的采集數(shù)據(jù)

業(yè)務(wù)交互/v1/{edgeId}/service/eventup用于邊設(shè)備向物聯(lián)管理平臺(tái)主動(dòng)上報(bào)業(yè)務(wù)相

關(guān)的事件數(shù)據(jù)

/v1/{edgeId}/service/requestup用于邊設(shè)備向物聯(lián)管理平臺(tái)發(fā)送業(yè)務(wù)相關(guān)的

請(qǐng)求命令

/v1/{edgeId}/service/responsedown用于物聯(lián)管理平臺(tái)對(duì)邊設(shè)備轉(zhuǎn)發(fā)業(yè)務(wù)相關(guān)的

請(qǐng)求應(yīng)答

6功能及報(bào)文格式

6.1功能概述

邊設(shè)備與物聯(lián)管理平臺(tái)交互的功能應(yīng)包含設(shè)備管理、容器管理、應(yīng)用管理、業(yè)務(wù)交互等多個(gè)方面。

設(shè)備管理包括設(shè)備升級(jí)、設(shè)備控制等。容器管理包括容器安裝、升級(jí)、啟動(dòng)、停止、刪除、配置、狀態(tài)

查詢等。應(yīng)用管理包括應(yīng)用下發(fā)、應(yīng)用控制、應(yīng)用配置、應(yīng)用升級(jí)等。業(yè)務(wù)交互應(yīng)包含物模型下發(fā)、數(shù)

據(jù)上報(bào)等。

6.2設(shè)備管理

6.2.1設(shè)備接入

設(shè)備接入主要用于邊設(shè)備的接入及主動(dòng)斷開(kāi)的操作，包括：設(shè)備接入請(qǐng)求、設(shè)備接入應(yīng)答、設(shè)備主

動(dòng)斷開(kāi)上報(bào)。

設(shè)備接入請(qǐng)求

邊設(shè)備通過(guò)發(fā)布主題“/v1/${edgeId}/device/request”消息，向物聯(lián)管理平臺(tái)發(fā)送設(shè)備接入請(qǐng)求

報(bào)文，其格式應(yīng)遵循5.4.1節(jié)的規(guī)定。報(bào)文載荷中包含的字段取值應(yīng)符合以下要求：

a)type字段：EVENT_LINKUP；

b)param字段定義如表6所示。

表6設(shè)備接入請(qǐng)求報(bào)文載荷字段定義

字段類型是否必選描述

devobject是邊設(shè)備信息，詳見(jiàn)附錄A

cpuobject是CPU信息，詳見(jiàn)附錄A

memobject是內(nèi)存信息，詳見(jiàn)附錄A

diskobject是磁盤信息，詳見(jiàn)附錄A

osobject是操作系統(tǒng)信息，詳見(jiàn)附錄A

其他的邊設(shè)備信息，其中每

linksarray是個(gè)元素為一個(gè)JSON對(duì)象，其

定義詳見(jiàn)附錄A

6

T/CECXXXXX—XXXX

設(shè)備接入應(yīng)答

物聯(lián)管理平臺(tái)對(duì)邊設(shè)備信息進(jìn)行記錄和校驗(yàn)，并通過(guò)主題“/v1/${edgeId}/device/response”向

邊設(shè)備發(fā)送設(shè)備接入應(yīng)答報(bào)文，其格式應(yīng)遵循5.4.2節(jié)的規(guī)定。報(bào)文載荷中包含的字段取值應(yīng)符合以下

要求：

a)type字段：EVENT_LINKUP；

b)param字段：無(wú)。

設(shè)備主動(dòng)斷開(kāi)上報(bào)

終端因某些原因需要與平臺(tái)主動(dòng)斷開(kāi)連接時(shí)，可通過(guò)主題“/v1/{edgeId}/device/data”向平臺(tái)發(fā)

送主動(dòng)斷開(kāi)連接請(qǐng)求報(bào)文。報(bào)文載荷中包含的字段取值應(yīng)符合以下要求：

a)type字段：EVENT_LINKDOWN；

b)param字段定義如表7所示。

表7設(shè)備主動(dòng)斷開(kāi)連接請(qǐng)求報(bào)文載荷字段定義

字段類型是否必選描述

斷開(kāi)原因，如“PowerOff”、

reasonstring是“RebootOS”、“Restart

Link”等

6.2.2設(shè)備升級(jí)

設(shè)備升級(jí)是指對(duì)設(shè)備操作系統(tǒng)及相關(guān)固件的升級(jí)：物聯(lián)管理平臺(tái)下發(fā)設(shè)備升級(jí)命令，邊設(shè)備接到升

級(jí)命令后，先對(duì)升級(jí)命令應(yīng)答，之后邊設(shè)備文件下載和安裝。在升級(jí)操作完成后，將升級(jí)結(jié)果上報(bào)至物

聯(lián)管理平臺(tái)。在升級(jí)過(guò)程中，物聯(lián)管理平臺(tái)可以發(fā)送升級(jí)狀態(tài)查詢命令，邊設(shè)備將升級(jí)任務(wù)實(shí)時(shí)狀態(tài)發(fā)

給物聯(lián)管理平臺(tái)。

設(shè)備升級(jí)命令

物聯(lián)管理平臺(tái)通過(guò)主題“/v1/${edgeId}/device/command”向邊設(shè)備下發(fā)設(shè)備升級(jí)命令，其格式應(yīng)

遵循5.4.1節(jié)的規(guī)定。報(bào)文載荷中包含的字段取值應(yīng)符合以下要求：

a)type字段：CMD_SYS_UPGRADE；

b)param字段定義如表8所示。

表8設(shè)備升級(jí)命令報(bào)文載荷字段定義

字段類型是否必選描述

本升級(jí)操作作為一個(gè)工作任

jobIdnumber是

務(wù)，分配的ID

從接收到該升級(jí)指令時(shí)間后

開(kāi)始升級(jí)的時(shí)間間隔（單位：

policynumber否

秒），缺省或等于0時(shí)，表示

立即升級(jí)

versionstring是升級(jí)后的版本號(hào)

升級(jí)類型，0表示補(bǔ)丁升級(jí)，

upgradeTypenumber是

1表示文件系統(tǒng)升級(jí)，2表示

7

T/CECXXXXX—XXXX

內(nèi)核升級(jí)，3表示全量升級(jí)

（文件系統(tǒng)+內(nèi)核升級(jí)）

fileobject是升級(jí)文件信息

設(shè)備升級(jí)命令應(yīng)答

邊設(shè)備在收到升級(jí)命令后，通過(guò)主題“/v1/${edgeId}/device/reply”向物聯(lián)管理平臺(tái)發(fā)送設(shè)備升

級(jí)命令應(yīng)答報(bào)文，其格式應(yīng)遵循5.4.2節(jié)的規(guī)定。報(bào)文載荷中包含的字段取值應(yīng)符合以下要求：

a)type字段：CMD_SYS_UPGRADE；

b)param字段：無(wú)。

設(shè)備升級(jí)狀態(tài)查詢

邊設(shè)備收到升級(jí)命令后，開(kāi)始進(jìn)行升級(jí)操作。在升級(jí)過(guò)程中，物聯(lián)管理平臺(tái)通過(guò)主題

“/v1/${edgeId}/device/command”可以查詢升級(jí)任務(wù)的狀態(tài)。報(bào)文載荷中包含的字段取值應(yīng)符合以下

要求：

a)type字段：CMD_STATUS_QUERY；

b)param字段定義如表9所示。

表9設(shè)備升級(jí)狀態(tài)查詢報(bào)文載荷字段定義

字段類型是否必選描述

升級(jí)操作作為一個(gè)工作任

jobIdnumber是

務(wù)，分配的ID

設(shè)備升級(jí)狀態(tài)查詢應(yīng)答

邊設(shè)備通過(guò)主題“/v1/${edgeId}/device/reply”向物聯(lián)管理平臺(tái)上報(bào)設(shè)備升級(jí)狀態(tài)，其格式應(yīng)遵

循5.4.2節(jié)的規(guī)定。報(bào)文載荷中包含的字段取值應(yīng)符合以下要求：

a)type字段：CMD_STATUS_QUERY；

b)param字段定義如表10所示。

表10設(shè)備升級(jí)狀態(tài)查詢應(yīng)答報(bào)文載荷字段定義

字段類型是否必選描述

progressnumber是進(jìn)度。百分比，省略百分號(hào)

描述當(dāng)前升級(jí)過(guò)程執(zhí)行過(guò)

程。包括：

1：待下載

statenumber是2：下載中

3：待安裝

4：安裝中

5：安裝完畢

升級(jí)操作作為一個(gè)工作任

jobIdnumber是

務(wù)，分配的ID

設(shè)備升級(jí)結(jié)果上報(bào)

8

T/CECXXXXX—XXXX

當(dāng)設(shè)備升級(jí)指令執(zhí)行完畢后，邊設(shè)備將執(zhí)行結(jié)果通過(guò)主題“/v1/${edgeId}/device/data”主動(dòng)上

報(bào)給物聯(lián)管理平臺(tái)。報(bào)文載荷中包含的字段取值應(yīng)符合以下要求：

a)type字段：REP_JOB_RESULT；

b)param字段定義如表11所示。

表11設(shè)備升級(jí)結(jié)果上報(bào)報(bào)文載荷字段定義

字段類型是否必選描述

升級(jí)操作作為一個(gè)工作任

jobIdnumber是

務(wù)，分配的ID

codenumber是升級(jí)結(jié)果編碼

升級(jí)結(jié)果的描述，例如下載

msgstring否

地址不可用

6.2.3設(shè)備監(jiān)視

設(shè)備監(jiān)視是指對(duì)設(shè)備運(yùn)行狀態(tài)、設(shè)備事件、設(shè)備日志進(jìn)行監(jiān)視以及對(duì)設(shè)備配置參數(shù)進(jìn)行管理的功能，

包括：設(shè)備狀態(tài)查詢、設(shè)備信息查詢、設(shè)備配置參數(shù)修改、設(shè)備日志召回等。

設(shè)備運(yùn)行參數(shù)主動(dòng)上報(bào)

邊設(shè)備通過(guò)主題“/v1/${edgeId}/device/data”向物聯(lián)管理平臺(tái)上報(bào)設(shè)備實(shí)時(shí)運(yùn)行參數(shù)。memUsed

字段為object，描述內(nèi)存的信息，其各字段定義應(yīng)符合表13要求。linkState字段為數(shù)組類型，每個(gè)成

員描述了一個(gè)外接設(shè)備的相關(guān)信息，字段定義如表14所示。報(bào)文載荷中包含的字段取值應(yīng)符合以下要求：

a)type字段：REP_SYS_STATUS；

b)param字段定義如表12所示。

表12設(shè)備運(yùn)行參數(shù)上報(bào)報(bào)文載荷字段定義

字段類型是否必選描述

cpuRatenumber是CPU負(fù)載（例如50表示50%）

memUsedobject是內(nèi)存信息

磁盤占用總空間，以M為單

diskUsednumber是

位

主板（cpu）溫度，單位：攝

tempValuenumber是

氏度℃

devDateTimestring是設(shè)備當(dāng)前時(shí)間

devStDateTimestring是設(shè)備最近一次啟動(dòng)時(shí)間

devRunTimenumber是設(shè)備運(yùn)行時(shí)長(zhǎng)，單位：秒

其他的設(shè)備信息，其中每個(gè)

linkStatearray是

元素表示一類設(shè)備元素

longitudestring否地理位置信息經(jīng)度

latitudestring否地理位置信息經(jīng)度

表13memUsed字段定義

9

T/CECXXXXX—XXXX

字段類型是否必選描述

占用的物理內(nèi)存（例如50

phynumber是

表示50%）

占用的虛擬內(nèi)存（例如50

virtnumber否

表示50%）

表14linkState字段定義

字段類型是否必選描述

接口的名稱如為以太網(wǎng)口，

namestring是

則形如“eth1”

statusstring是設(shè)備接口狀態(tài)，如up/down

設(shè)備運(yùn)行參數(shù)查詢

物聯(lián)管理平臺(tái)通過(guò)主題“v1/{edgeId}/device/command”發(fā)布設(shè)備運(yùn)行參數(shù)查詢命令。報(bào)文載荷中

包含的字段取值應(yīng)符合以下要求：

a)type字段：CMD_SYS_STATUS；

b)param字段：無(wú)。

設(shè)備運(yùn)行參數(shù)查詢應(yīng)答

邊設(shè)備通過(guò)主題“v1/{edgeId}/device/reply”對(duì)物聯(lián)管理平臺(tái)發(fā)布的設(shè)備運(yùn)行參數(shù)查詢命令進(jìn)行

應(yīng)答。報(bào)文載荷中包含的字段取值應(yīng)符合以下要求：

a)type字段：CMD_SYS_STATUS；

b)param字段的定義應(yīng)遵循表12、13、14的要求。

設(shè)備軟、硬件信息查詢

物聯(lián)管理平臺(tái)通過(guò)主題“/v1/{edgeId}/device/command”發(fā)布設(shè)備信息查詢命令，對(duì)邊設(shè)備的軟

硬件信息進(jìn)行查詢。報(bào)文載荷中包含的字段取值應(yīng)符合以下要求：

a)type字段：CMD_INFO_QUERY；

b)param字段：無(wú)。

設(shè)備軟、硬件信息查詢應(yīng)答

邊設(shè)備通過(guò)主題“v1/{edgeId}/device/reply”對(duì)物聯(lián)管理平臺(tái)發(fā)布的設(shè)備信息查詢命令進(jìn)行應(yīng)答。

報(bào)文載荷中包含的字段取值應(yīng)符合以下要求：

a)type字段：CMD_INFO_QUERY；

b)param字段的定義應(yīng)遵循表15的要求。

表15設(shè)備信息查詢應(yīng)答報(bào)文載荷字段定義

字段類型是否必選描述

devobject是邊設(shè)備信息，詳見(jiàn)附錄A

cpuobject是CPU信息，詳見(jiàn)附錄A

memobject是內(nèi)存信息，詳見(jiàn)附錄A

diskobject是磁盤信息，詳見(jiàn)附錄A

10

T/CECXXXXX—XXXX

temperatureobject否溫度監(jiān)控信息

osobject是操作系統(tǒng)信息，詳見(jiàn)附錄A

其他的邊設(shè)備信息，其中每

linksarray是個(gè)元素表示一類設(shè)備元素，

詳見(jiàn)附錄A

repPeriodobject否主動(dòng)上報(bào)的上報(bào)時(shí)間間隔

temperature字段為object類型，描述溫度監(jiān)控信息，其字段定義應(yīng)符合表16要求。

表16temperature字段定義

字段類型是否必選描述

tempnumber否主板溫度，單位℃

temLownumber是主板溫度監(jiān)控低溫閾值

temHighnumber是主板溫度監(jiān)控高溫閾值

repPeriod字段為object類型，其各字段定義如表17所示。

表17repPeriod字段定義

字段類型是否必選描述

終端狀態(tài)主動(dòng)上報(bào)的時(shí)間間

devPeriodnumber否

隔，單位：秒

容器狀態(tài)主動(dòng)上報(bào)的時(shí)間間

conPeriodnumber否

隔，單位：秒

APP狀態(tài)主動(dòng)上報(bào)的時(shí)間間

appPeriodnumber否

隔，單位：秒

注：上述表中字段應(yīng)所至少出現(xiàn)一個(gè)。

設(shè)備配置參數(shù)修改

物聯(lián)管理平臺(tái)通過(guò)主題“v1/{edgeId}/device/command”發(fā)布邊設(shè)備配置修改命令。報(bào)文載荷中包

含的字段取值應(yīng)符合以下要求：

a)type字段：CMD_SYS_SET_CONFIG；

b)param字段定義應(yīng)符合表18的要求。

表18設(shè)備配置參數(shù)修改命令報(bào)文載荷字段定義

字段類型是否必選描述

devNamestring否設(shè)備名稱

CPU監(jiān)控閾值，例如50表示

cpuLmtnumber否

50%