ICS91.160.20

Q84

SPIA

團(tuán)體標(biāo)準(zhǔn)

T/SPIA007—2023

多功能智能桿系統(tǒng)通信接口技術(shù)與數(shù)據(jù)規(guī)范

Communicationinterfacetechnologyanddataspecificationof

multifunctionalintelligentpolesystem

學(xué)兔兔標(biāo)準(zhǔn)下載

2023-12-08發(fā)布2023-12-10實(shí)施

深圳市智慧桿產(chǎn)業(yè)促進(jìn)會(huì)發(fā)布

T/SPIA007—2023

多功能智能桿系統(tǒng)通信接口技術(shù)與數(shù)據(jù)規(guī)范

1范圍

本文件規(guī)定了多功能智能桿系統(tǒng)在感知層接口、平臺(tái)層接口、應(yīng)用層接口的通信與協(xié)議要求。

本文件適用于新建多功能智能桿系統(tǒng)通信接口的設(shè)計(jì)、運(yùn)行管理與維護(hù)。

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

下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，

僅該日期對(duì)應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本

文件。

GB/T2900.96—2015電工術(shù)語計(jì)算機(jī)網(wǎng)絡(luò)技術(shù)

GB/T19582.3—2008基于Modbus協(xié)議的工業(yè)自動(dòng)化網(wǎng)絡(luò)規(guī)范第3部分：Modbus協(xié)議在TCP/IP

上的實(shí)現(xiàn)指南

GB/T28181—2016公共安全視頻監(jiān)控聯(lián)網(wǎng)系統(tǒng)信息傳輸、交換、控制技術(shù)要求

GB/T33474—2016物聯(lián)網(wǎng)參考體系結(jié)構(gòu)

GB/T34428.4—2017高速公路監(jiān)控設(shè)施通信規(guī)程第4部分:氣象檢測(cè)器

GB/T34923.6—2017路燈控制管理系統(tǒng)第6部分：通信協(xié)議技術(shù)規(guī)范

GB/T40994—2021智慧城市—智慧多功能桿—服務(wù)功能與運(yùn)行管理規(guī)范

DL/T698.44—2016電能信息采集與管理系統(tǒng)第4-4部分：通信協(xié)議-微功率無線通信協(xié)議

GM/T0024—2014SSLVPN技術(shù)規(guī)范

GM/T0025—2014SSLVPN網(wǎng)關(guān)產(chǎn)品規(guī)范

HJ212—2017污染物在線監(jiān)控（監(jiān)測(cè)）系統(tǒng)數(shù)據(jù)傳輸標(biāo)準(zhǔn)

SL651—2014水文監(jiān)測(cè)數(shù)據(jù)通信規(guī)約

DB4403/T30—2019多功能智能桿系統(tǒng)設(shè)計(jì)與工程建設(shè)規(guī)范

T/CSA051—2019智能道路照明終端控制器接口要求

Q/GDW11612低壓電力線寬帶載波通信互聯(lián)互通技術(shù)規(guī)范

3術(shù)語、定義及縮略語

3.1術(shù)語和定義

GB/T2900.96—2015、DB4403/T30—2019界定的以及下列術(shù)語和定義適用于本文件。

3.1.1

感知層sensinglayer

二維碼標(biāo)簽和識(shí)讀器、RFID標(biāo)簽和讀寫器、攝像頭、GPS、傳感器、M2M終端、傳感器網(wǎng)關(guān)等終端識(shí)

學(xué)兔兔別物體、采集信息，通過傳感網(wǎng)絡(luò)獲取場(chǎng)境相關(guān)信息。標(biāo)準(zhǔn)下載

3.1.2

基礎(chǔ)設(shè)施層basiclayer

為用戶提供其所需的計(jì)算和存儲(chǔ)等資源，通過虛擬化等技術(shù)獎(jiǎng)資源池化實(shí)現(xiàn)資源的按需分配和快速

部署。

1

T/SPIA007—2023

3.1.3

平臺(tái)層platformlayer

運(yùn)行于基礎(chǔ)設(shè)施層之上以軟件為核心，為應(yīng)用服務(wù)提供開發(fā)、運(yùn)行和管控環(huán)境即中間件功能的層次。

解決IT資源的虛擬化和自動(dòng)化管理問題，基于基礎(chǔ)設(shè)施層的資源管理能力提供一個(gè)高可用、可伸縮及易

于管理的云中間件平臺(tái)。平臺(tái)層位于基礎(chǔ)設(shè)施層與應(yīng)用層之間，利用基礎(chǔ)設(shè)施層的能力面向上層應(yīng)用提

供通用服務(wù)。

3.1.4

應(yīng)用層applicationlayer

通過云計(jì)算平臺(tái)進(jìn)行信息處理。應(yīng)用層可以對(duì)感知層采集數(shù)據(jù)進(jìn)行計(jì)算、處理和知識(shí)挖掘，從而實(shí)

現(xiàn)對(duì)物理層的控制、管理和決策。

3.1.5

多功能智能桿系統(tǒng)multi-functionsmartpolesystem

多功能智能桿系統(tǒng)由桿子系統(tǒng)、供電和防雷子系統(tǒng)、通信子系統(tǒng)、多功能智能桿管理平臺(tái)等組成。

[來源：DB4403/T30—2019,3.1.2]

3.1.6

管理平臺(tái)smartpoleplatform

對(duì)多功能智能桿的相關(guān)配置和設(shè)備進(jìn)行管理、控制、運(yùn)行監(jiān)測(cè)、數(shù)據(jù)運(yùn)維的軟件管理系統(tǒng)?？刹杉?、

存儲(chǔ)多功能智能桿掛載設(shè)備感知數(shù)據(jù)，監(jiān)測(cè)桿和掛載設(shè)備的狀態(tài)、告警、故障信息等。

[來源：DB4403/T30—2019,3.1.19]

3.1.7

通信協(xié)議communicationprotocol

規(guī)范雙方實(shí)體之間通信或者服務(wù)的規(guī)則和約定。

3.1.8

網(wǎng)關(guān)gateway

連接使用不同的網(wǎng)絡(luò)體系結(jié)構(gòu)和協(xié)議的兩個(gè)計(jì)算機(jī)網(wǎng)絡(luò)的功能單元。

注1：計(jì)算機(jī)網(wǎng)絡(luò)可以是局域網(wǎng)絡(luò)、廣域網(wǎng)絡(luò)，或其它類型的網(wǎng)絡(luò)。

注2：網(wǎng)關(guān)的例子有LAN網(wǎng)關(guān)、郵件網(wǎng)關(guān)。

[來源：GB/T2900.96—2015,732—17]

3.1.9

通信接口communicationinterface

系統(tǒng)不同功能單元之間信號(hào)傳輸通道的邊界，包括功能、物理連接類型、信號(hào)交換方式等特性。

3.1.10

A接口Ainterface

學(xué)兔兔網(wǎng)關(guān)與多功能智能桿掛載設(shè)備的接口，支持MODBUS、OPC、BACNET、MQ標(biāo)準(zhǔn)下載TT、HTTP、ONVIF、TCP、CoAP

等協(xié)議。

B接口Binterface

平臺(tái)層與網(wǎng)關(guān)、直連掛載設(shè)備、以及第三方中間件平臺(tái)的接口，支持TCP/IP協(xié)議、MQTT協(xié)議、HTTPS

協(xié)議等協(xié)議。

2

T/SPIA007—2023

C接口Cinterface

平臺(tái)層與應(yīng)用層、以及第三方應(yīng)用系統(tǒng)的接口，支持HTTPS/HTTP等協(xié)議。

3.2縮略語

下列縮略語適用于本文件。

HTTP:超文本傳輸協(xié)議（HyperTextTransferProtocol）

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

JSON：JS對(duì)象簡(jiǎn)譜，一種輕量級(jí)數(shù)據(jù)交換格式（JavaScriptObjectNotation）

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

OPC：工業(yè)控制領(lǐng)域提供了一種標(biāo)準(zhǔn)的數(shù)據(jù)訪問機(jī)制

4系統(tǒng)組成

4.1多功能智能桿系統(tǒng)架構(gòu)

多功能智能桿系統(tǒng)總體架構(gòu)是由應(yīng)用層、平臺(tái)層和感知層組成。多功能智能桿系統(tǒng)架構(gòu)示意圖見圖

1。

圖1多功能智能桿系統(tǒng)架構(gòu)示意圖

4.2通信接口說明

學(xué)兔兔通信接口確定了軟件系統(tǒng)間相互傳遞、接收數(shù)據(jù)所需要的通信協(xié)議及標(biāo)準(zhǔn)下載接口設(shè)計(jì)需要滿足的要求，硬

件接口遵循設(shè)備的行業(yè)技術(shù)規(guī)范要求。

3

T/SPIA007—2023

5接口安全要求

多功能智能桿管理平臺(tái)（以下簡(jiǎn)稱平臺(tái)）連接桿體上照明控制設(shè)備、氣象監(jiān)測(cè)設(shè)備、環(huán)境監(jiān)測(cè)設(shè)備

等多種掛載設(shè)備，具備完整的物聯(lián)網(wǎng)系統(tǒng)特性，平臺(tái)與設(shè)備的長(zhǎng)連接通信（B接口）應(yīng)使用業(yè)界物聯(lián)網(wǎng)

廣泛支持的MQTT協(xié)議，平臺(tái)、網(wǎng)關(guān)、直連設(shè)備，以及相互之間的數(shù)據(jù)通訊，應(yīng)滿足法律法規(guī)的要求。

平臺(tái)可通過實(shí)現(xiàn)涉及SM2/SM3/SM4或其他符合國(guó)家密碼管理局要求的密碼套件，提升平臺(tái)的安全兼

容性及整體安全能力。網(wǎng)關(guān)或直連設(shè)備加載密碼套件的，應(yīng)做好對(duì)網(wǎng)關(guān)和直連設(shè)備的保護(hù)防止泄密。

6A接口

6.1接口原理

網(wǎng)關(guān)與近場(chǎng)設(shè)備連接，包括IP方式、有線方式（如串口、并口等）、近場(chǎng)無線方式（如Zigbee、藍(lán)

牙等），進(jìn)行數(shù)據(jù)交換，再通過網(wǎng)關(guān)與平臺(tái)層進(jìn)行數(shù)據(jù)交換。

對(duì)于無線直連設(shè)備，直接與平臺(tái)層進(jìn)行數(shù)據(jù)交換，例如NB-IoT設(shè)備等。

具備獨(dú)立管理平臺(tái)設(shè)備，通過其管理平臺(tái)轉(zhuǎn)發(fā)與平臺(tái)層進(jìn)行數(shù)據(jù)交換。

6.2視頻監(jiān)控設(shè)備

視頻監(jiān)控通信協(xié)議應(yīng)滿足ONVIF2.0標(biāo)準(zhǔn)協(xié)議中標(biāo)準(zhǔn)規(guī)定要求。

6.3公共安全視頻監(jiān)控

公共安全行業(yè)應(yīng)用的視頻監(jiān)控設(shè)備通信協(xié)議應(yīng)滿足GB/T28181規(guī)定要求。

6.4環(huán)境監(jiān)測(cè)設(shè)備

6.4.1水位監(jiān)測(cè)傳感器

水務(wù)行業(yè)應(yīng)用傳感器設(shè)備通信協(xié)議應(yīng)滿足SL651水文監(jiān)測(cè)數(shù)據(jù)通信規(guī)約中規(guī)定要求。

6.4.2環(huán)境監(jiān)測(cè)傳感器

環(huán)境行業(yè)應(yīng)用傳感器設(shè)備通信協(xié)議應(yīng)滿足GB/T19582.3、HJ212要求。

6.4.3氣象監(jiān)測(cè)傳感器

學(xué)兔兔氣象環(huán)境應(yīng)用傳感器設(shè)備的通信協(xié)議應(yīng)滿足GB/T34428.4要求。標(biāo)準(zhǔn)下載

6.5智慧照明設(shè)備

6.5.1有線智慧照明燈控設(shè)備

有線智慧照明燈控設(shè)備通信協(xié)議應(yīng)滿足GB/T34923.6要求。

4

T/SPIA007—2023

6.5.2NB-lot無線通訊智慧照明燈控設(shè)備

NB類智能道路照明燈控設(shè)備通信協(xié)議應(yīng)滿足T/CSA051的要求。

6.6其它類設(shè)備

其他類設(shè)備應(yīng)首先滿足該類設(shè)備行業(yè)標(biāo)準(zhǔn)的要求，若無相應(yīng)行業(yè)標(biāo)準(zhǔn)，則應(yīng)滿足網(wǎng)關(guān)相應(yīng)接口通訊

協(xié)議的要求。

7B接口

7.1接口原理

平臺(tái)是多功能智能桿系統(tǒng)的服務(wù)子系統(tǒng)，提供海量多功能智能桿終端設(shè)備的接入及管理，B接口作

為多功能智能桿終端設(shè)備（以下簡(jiǎn)稱設(shè)備）與平臺(tái)數(shù)據(jù)交換的傳輸途徑，MQTT作為應(yīng)用層通信協(xié)議保

障數(shù)據(jù)交換的實(shí)時(shí)性、可靠性，TLS作為傳輸層安全機(jī)制，抵御設(shè)備數(shù)據(jù)被截取竊聽的風(fēng)險(xiǎn)，HTTPS

為設(shè)備提供安全鏈路上的非結(jié)構(gòu)化數(shù)據(jù)服務(wù)（音頻/視頻/圖片/文本/軟件包等）。

B接口適用于設(shè)備與平臺(tái)的連接通信，由于網(wǎng)關(guān)的匯聚特性，更多是網(wǎng)關(guān)設(shè)備與平臺(tái)的通信及數(shù)據(jù)

交換。如圖2所示，其中設(shè)備和網(wǎng)關(guān)可采用適配接入?yún)f(xié)議接入智能桿平臺(tái)。

圖2設(shè)備接入示意圖

7.2設(shè)備接入通信流程

按照GB/T33474的要求，設(shè)備接入平臺(tái)的整個(gè)流程分為以下四個(gè)階段：

a)連接建立階段:網(wǎng)關(guān)或設(shè)備與平臺(tái)建立連接；

b)設(shè)備注冊(cè)階段:網(wǎng)關(guān)或設(shè)備向平臺(tái)發(fā)起注冊(cè)請(qǐng)求，并得到回復(fù)，平臺(tái)顯示網(wǎng)關(guān)或設(shè)備在線；

c)消息交互階段:網(wǎng)關(guān)或設(shè)備與平臺(tái)之間進(jìn)行信息交互，比如平臺(tái)下發(fā)命令、網(wǎng)關(guān)或設(shè)備上報(bào)數(shù)

據(jù)以及兩者之間發(fā)送連接保持消息；

d)連接斷開階段:網(wǎng)關(guān)或設(shè)備向平臺(tái)發(fā)送注銷請(qǐng)求，平臺(tái)不再保持相關(guān)設(shè)備的狀態(tài)。

7.3適配協(xié)議

學(xué)兔兔7.3.1接口約束標(biāo)準(zhǔn)下載

智能設(shè)備與平臺(tái)接口規(guī)定了網(wǎng)關(guān)與平臺(tái)信息交互的通信方式、數(shù)據(jù)類型、數(shù)據(jù)格式、編碼方式和通

信協(xié)議的要求。接口約束詳細(xì)參考表1接口約束。

5

T/SPIA007—2023

表1接口約束

通信方式傳輸數(shù)據(jù)類型傳輸數(shù)據(jù)格式編碼方式通信協(xié)議

MQTT字符串指令集JSONUTF-8B接口通信協(xié)議

文本、圖片、視頻、

HTTPS音頻、軟件更新包通信協(xié)議約定通信協(xié)議約定協(xié)商約定

等非結(jié)構(gòu)化數(shù)據(jù)

圖3通信方式

7.3.2網(wǎng)關(guān)接入通信協(xié)議

網(wǎng)關(guān)接入多功能智能桿管理平臺(tái)的通信協(xié)議采用物聯(lián)網(wǎng)行業(yè)主流MQTT協(xié)議為載體，通過信令數(shù)據(jù)的

交互及業(yè)務(wù)數(shù)據(jù)的交互，使能多功能智能桿管理平臺(tái)業(yè)務(wù)訴求。

基本流程

B接口通信協(xié)議是平臺(tái)與設(shè)備的通信協(xié)議，具有雙向通信的功能。設(shè)備可以向平臺(tái)上報(bào)數(shù)據(jù)，平臺(tái)

可以將指令下發(fā)給設(shè)備，實(shí)現(xiàn)對(duì)設(shè)備的遠(yuǎn)程控制。

a)平臺(tái)通過特定的Topic向設(shè)備發(fā)布消息；

b)網(wǎng)關(guān)（GW）通過特定的Topic向平臺(tái)服務(wù)平臺(tái)(CS)發(fā)布消息；

c)雙方發(fā)布消息應(yīng)采用QOSlevel1（QOS1）。消息處理方應(yīng)根據(jù)消息中的時(shí)間戳和序列號(hào)來判

斷消息是否過期或重復(fù)。對(duì)于過期和重復(fù)的消息，處理方應(yīng)將消息丟棄；

d)鑒于MQTT的訂閱發(fā)布消息的特殊性，對(duì)于需要應(yīng)答的消息，消息處理方需向信息發(fā)布Topic

發(fā)布應(yīng)答；

e)對(duì)于重要的消息，如告警，服務(wù)平臺(tái)(CS)收到告警后需進(jìn)行應(yīng)答，如果網(wǎng)關(guān)收不到應(yīng)答，應(yīng)重

新發(fā)送告警消息，重試次數(shù)達(dá)到3次后放棄重試。

學(xué)兔兔標(biāo)準(zhǔn)下載

6

T/SPIA007—2023

認(rèn)證流程

圖4認(rèn)證流程

a)網(wǎng)關(guān)連接消息隊(duì)列，網(wǎng)關(guān)將設(shè)備登錄鑒權(quán)信息（如用戶名、密碼、網(wǎng)關(guān)Id等）信息打包為認(rèn)

證報(bào)文，發(fā)送給相關(guān)的認(rèn)證TopicA；

b)服務(wù)平臺(tái)(CS)對(duì)用戶名和密碼進(jìn)行驗(yàn)證，驗(yàn)證成功后，通過TopicA_reply發(fā)送認(rèn)證成功。否

則拒絕網(wǎng)關(guān)的認(rèn)證，并斷開網(wǎng)關(guān)與平臺(tái)的通信連接；

c)網(wǎng)關(guān)認(rèn)證成功后，訂閱其他的Topic。

平臺(tái)向網(wǎng)關(guān)下發(fā)消息的流程

圖5平臺(tái)向網(wǎng)關(guān)下發(fā)消息的流程

a)平臺(tái)向TooicA發(fā)送消息，包括時(shí)間戳，消息序列號(hào)，消息類型等字段；

b)網(wǎng)關(guān)獲取該消息后進(jìn)行去重和超時(shí)判斷，通過判斷后，向TopicA_reply發(fā)送回應(yīng)消息。消息

中包括時(shí)間戳，消息序列號(hào)，消息類型等字段；

c)平臺(tái)從TopicA_reply獲取回應(yīng)，進(jìn)行消息匹配，完成自身處理過程。

學(xué)兔兔標(biāo)準(zhǔn)下載

7

T/SPIA007—2023

網(wǎng)關(guān)向平臺(tái)上報(bào)消息的流程

圖6網(wǎng)關(guān)向平臺(tái)上報(bào)消息的流程

a)網(wǎng)關(guān)通過TopicA上報(bào)消息；

b)平臺(tái)從TopicA獲取消息后，進(jìn)行處理如需要回應(yīng)，則通過TopicA_REPLY將回應(yīng)發(fā)送給相應(yīng)網(wǎng)

關(guān)，回應(yīng)消息中包括時(shí)間戳，消息序列號(hào)，消息類型等字段。

通信報(bào)文及數(shù)據(jù)類型

詳見附錄A.1B接口通信協(xié)議通信報(bào)文及數(shù)據(jù)結(jié)構(gòu)定義。

7.3.3HTTPS協(xié)議

在平臺(tái)側(cè)搭建HTTP服務(wù)器作為非結(jié)構(gòu)化數(shù)據(jù)交互的媒介，網(wǎng)關(guān)作為客戶端向HTTP服務(wù)器發(fā)出請(qǐng)

求，交互非結(jié)構(gòu)化數(shù)據(jù)。請(qǐng)求方法如表2所示。

表2請(qǐng)求方法

方法描述

GET客戶端請(qǐng)求指定資源信息，服務(wù)器返回指定資源

HEAD只請(qǐng)求響應(yīng)報(bào)文中的HTTP首部

POST將客戶端的數(shù)據(jù)提交到服務(wù)器

PUT用從客戶端向服務(wù)器傳送的數(shù)據(jù)取代指定文檔內(nèi)容

DELETE請(qǐng)求服務(wù)器刪除Request-URI所表示的資源

MOVE請(qǐng)求服務(wù)器將指定的頁(yè)面移至另一個(gè)網(wǎng)絡(luò)地址

8C接口

8.1版本規(guī)范

為便于后期接口維護(hù)和升級(jí)，C接口需提供驗(yàn)證接口版本的方法，輔助接口管理，實(shí)現(xiàn)接口多版本

的可維護(hù)性。

學(xué)兔兔a)版本號(hào)表達(dá)形式為v{N}，N為版本號(hào)，整數(shù)為大功能版本，如v標(biāo)準(zhǔn)下載1、v2、v3等，小數(shù)為補(bǔ)充或

改進(jìn)功能版本，如v1.1、v2.3等等；

b)WebService接口需在訪問路徑中加入版本號(hào)，規(guī)范格式為：/xx/v1/xx。SDK需提供getVision

獲取版本號(hào)；

8

T/SPIA007—2023

c)可采用增量發(fā)布多版本并存方式發(fā)布接口，對(duì)于特點(diǎn)API或服務(wù)，生產(chǎn)環(huán)境中最多保留3個(gè)最

詳細(xì)版本。

8.2命名規(guī)范

接口命名需要良好的可讀性，要求使用駝峰命名法，按照實(shí)現(xiàn)接口的業(yè)務(wù)類型、業(yè)務(wù)場(chǎng)景及功能特

性等命名。

命名示例：/v1/device/getEquStutas。

8.3返回?cái)?shù)據(jù)

接口返回?cái)?shù)據(jù)的格式應(yīng)該統(tǒng)一，返回?cái)?shù)據(jù)應(yīng)有具體的業(yè)務(wù)執(zhí)行狀態(tài)，包括但不限于狀態(tài)碼、返回狀

態(tài)信息、具體數(shù)據(jù)。下圖為RESTful接口的json示例:

{

"status":"00000",

"msg":"success",

"data":{

//具體數(shù)據(jù)

}

}

8.4安全性功能

8.4.1C接口作為管理使用者，為上層應(yīng)用或第三方軟件平臺(tái)提供授信注冊(cè)的接口，獲取多功能智能桿

管理平臺(tái)提供的APPKEY和APPSECRET；

8.4.2使用C接口的應(yīng)用或服務(wù)利用APPKEY與APPSECRET，按照多功能智能桿管理平臺(tái)的通信協(xié)議與加

密算法，換取通信可用的TOKEN；

8.4.3應(yīng)用或服務(wù)使用C接口時(shí)需獲得多功能智能桿管理平臺(tái)頒發(fā)的TOKEN；

8.4.4C接口的調(diào)用及訪問次數(shù)均受多功能智能桿管理平臺(tái)管控。

學(xué)兔兔標(biāo)準(zhǔn)下載

9

T/SPIA007—2023

附錄A

（規(guī)范性）

B接口通信協(xié)議通信報(bào)文及數(shù)據(jù)結(jié)構(gòu)定義

A.1B接口通信協(xié)議通信報(bào)文及數(shù)據(jù)結(jié)構(gòu)定義

A.1.1報(bào)文原則

平臺(tái)(CS)與網(wǎng)關(guān)(GW)之間的接口基于MQTT技術(shù)，消息協(xié)議采用JSON或Protobuf序列化協(xié)議的結(jié)構(gòu)化

數(shù)據(jù)格式。

A.1.2基本報(bào)文格式定義

表A.1基本報(bào)文格式定義

類型一級(jí)節(jié)點(diǎn)定義

type命令類型（參見A.3.4）

seq序列號(hào)

請(qǐng)求報(bào)文timeStamp時(shí)間戳（長(zhǎng)整型）報(bào)文發(fā)送的時(shí)間

version版本

info報(bào)文內(nèi)容

type命令類型（參見A.3.4）

seq序列號(hào)

響應(yīng)報(bào)文timeStamp時(shí)間戳（整型）報(bào)文回應(yīng)的時(shí)間

code響應(yīng)號(hào)（整型）

info報(bào)文內(nèi)容

響應(yīng)報(bào)文中的seq應(yīng)與請(qǐng)求報(bào)文中的seq相同。

響應(yīng)報(bào)文中通過code來標(biāo)識(shí)響應(yīng)狀態(tài)。在code為0時(shí)則響應(yīng)正常

請(qǐng)求消息例子如下：

{“id”:”XXXXX”，

“type”:”XXXXX”,

“seq”:”123345”,

“timeStamp”:2233442222，

“version”:”1.1”，

info:{...}

}

回應(yīng)消息的例子如下：

{“id”:”XXXXX”,

“type”:”XXXXX”,

“seq”:”123345”,

“timeStamp”:2233443333,

學(xué)兔兔“errorCode”:0標(biāo)準(zhǔn)下載

}

A.1.3基本數(shù)據(jù)類型定義

10

T/SPIA007—2023

a)告警消息：網(wǎng)關(guān)(GW)上報(bào)的所有告警信息。告警消息包括告警和告警消除兩類，消除指告警狀

態(tài)已經(jīng)解除；

b)通知消息：網(wǎng)關(guān)(GW)通知平臺(tái)，或平臺(tái)通知網(wǎng)關(guān)的消息，該消息一般不需要應(yīng)用層的回應(yīng)；

c)消息序列號(hào)：網(wǎng)關(guān)或平臺(tái)發(fā)送的消息需要有一個(gè)唯一標(biāo)識(shí)；

d)網(wǎng)關(guān)Id：網(wǎng)關(guān)的全網(wǎng)唯一Id；

e)掛載設(shè)備Id：即監(jiān)控對(duì)象的編碼，該編碼在一個(gè)網(wǎng)關(guān)內(nèi)唯一；

f)監(jiān)控量Id：同類型設(shè)備唯一；

g)時(shí)間戳：表示從1970年1月1日00:00:00起的總毫秒數(shù)；

h)枚舉定義

表A.2枚舉定義

屬性名稱屬性描述枚舉類型類型定義

EnumState信號(hào)值的狀態(tài)NOALARM＝0正常數(shù)據(jù)

INVALId＝1無效數(shù)據(jù)

EnumLevel告警等級(jí)CRITICAL＝1一級(jí)告警

MAJOR＝2二級(jí)告警

MINOR＝3三級(jí)告警

HINT＝4四級(jí)告警

EnumFlag告警標(biāo)志BEGIN開始

CLEAR告警消除

i)數(shù)據(jù)結(jié)構(gòu)定義

表A.3數(shù)據(jù)結(jié)構(gòu)定義

結(jié)構(gòu)名稱結(jié)構(gòu)描述屬性名稱數(shù)據(jù)類型類型定義必填

TMete監(jiān)控量的值的結(jié)deviceId字符串設(shè)備IdY

構(gòu)meteId字符串監(jiān)控量標(biāo)識(shí)Y

value字符串實(shí)時(shí)測(cè)量值。Y

stateEnumState狀態(tài)Y

time時(shí)間格式采集測(cè)量時(shí)Y

間，格式

YYYY-MM-DD<S

PACE

鍵>hh:mm:ss

（采用24小時(shí)

的時(shí)間制式）

TMeteSet設(shè)置可控量的值meteId字符串監(jiān)控量標(biāo)識(shí)Y

value浮點(diǎn)/字符控制的目標(biāo)值

串/或

學(xué)兔兔JSON標(biāo)準(zhǔn)下載

數(shù)據(jù)

（根據(jù)

量的類

型填

11

T/SPIA007—2023

結(jié)構(gòu)名稱結(jié)構(gòu)描述屬性名稱數(shù)據(jù)類型類型定義必填

寫）

TAlarmAttr監(jiān)控量的門限值meteId量Id設(shè)備監(jiān)控量標(biāo)Y

的結(jié)構(gòu)識(shí)

rangeMax浮點(diǎn)/字符告警范圍的上

串限

MAX表示正無

窮

-MAX表示負(fù)無

窮

前開后閉

rangeMin浮點(diǎn)/字符告警范圍

串的下限

MAX表示正無

窮

-MAX表示負(fù)無

窮

前開后閉

alarmLev整型（1到告警等級(jí)Y

el4）

alarmId量Id告警量IdY

TStorageRule信號(hào)數(shù)據(jù)存儲(chǔ)規(guī)deviceId設(shè)備id設(shè)備IdY

則的結(jié)構(gòu)meteId量Id設(shè)備監(jiān)控量標(biāo)Y

識(shí)

absolute浮點(diǎn)絕對(duì)閥值

Val

relative浮點(diǎn)百分比閥值

Val

storageI整型存儲(chǔ)時(shí)間間隔

nter（單位：分鐘）

val

storageR時(shí)間存儲(chǔ)參考時(shí)

efTi間，格式

meYYYY-MM-DD<S

PACE

鍵>hh:mm:ss

（采用24小時(shí)

學(xué)兔兔的標(biāo)準(zhǔn)下載時(shí)間制式）

TMeteAttr信號(hào)數(shù)據(jù)存儲(chǔ)規(guī)meteId量Id設(shè)備監(jiān)控量標(biāo)Y

則的結(jié)構(gòu)識(shí)

12

T/SPIA007—2023

結(jié)構(gòu)名稱結(jié)構(gòu)描述屬性名稱數(shù)據(jù)類型類型定義必填

absolute浮點(diǎn)絕對(duì)閥值

Val

relative浮點(diǎn)百分比閥值

Val

reportIn整型上報(bào)時(shí)間間隔

terv（單位：分鐘）

al

TAlarm告警消息的結(jié)構(gòu)alarmId量Id告警IdY

meteId

deviceId量Id設(shè)備IdY

alarmTim時(shí)間告警時(shí)間，Y

eYYYY-MM-DD<S

PACE

鍵>hh:mm:ss

（采用24小時(shí)

的時(shí)間制式）

alarmLevEnumLevel告警級(jí)別Y

el

alarmFlaEnumFlagY

g

alarmDec字符串告警的事件描

s述

N*TMete觸發(fā)值

triggerV

alue

TGwState網(wǎng)關(guān)(GW)狀態(tài)參cpuUsage浮點(diǎn)CPU使用率Y

數(shù)boardTem浮點(diǎn)主板溫度

pera

ture

cpuTempe浮點(diǎn)CPU溫度

ratu

re

memUsage浮點(diǎn)內(nèi)存使用率Y

storeUsa浮點(diǎn)網(wǎng)關(guān)(GW)存儲(chǔ)Y

學(xué)兔兔ge占標(biāo)準(zhǔn)下載用率（含SD

卡等存儲(chǔ)介

質(zhì)）

longitud浮點(diǎn)小數(shù)6經(jīng)度

e位表示

13

T/SPIA007—2023

結(jié)構(gòu)名稱結(jié)構(gòu)描述屬性名稱數(shù)據(jù)類型類型定義必填

法

latitude浮點(diǎn)小數(shù)6緯度

位表示

法

altitude整數(shù)海拔

TDevConf監(jiān)控對(duì)象配置信deviceId設(shè)備Id設(shè)備IdY

息devicetyEnumDevice設(shè)備類型Y

petype

model字符串設(shè)備型號(hào)Y

brand字符串設(shè)備品牌Y

version字符串版本Y

beginRun時(shí)間啟用時(shí)間Y

Time

devDecsr字符串設(shè)備描述信息

ibe（包含設(shè)備的

安裝位置）

cfgN*TAlarmAt告警量屬性+Y

tr監(jiān)控量屬性+

N*TMeteAtt告警規(guī)則

r

NTStorageR

ule

confResv字符串配置預(yù)留字段

er

注：絕對(duì)閥值和百分比閥值同時(shí)僅有一個(gè)字段生效，即當(dāng)絕對(duì)閥值生效時(shí)，百分比閥值置空；反過

來，當(dāng)百分比閥值生效時(shí)，絕對(duì)閥值置空。當(dāng)?shù)竭_(dá)上報(bào)間隔時(shí)，網(wǎng)關(guān)應(yīng)上報(bào)數(shù)據(jù)。

A.1.4B接口通信消息定義

MQTT的Topic定義如下：

表A.4Topic定義

功能地址

網(wǎng)關(guān)發(fā)送信令發(fā)送Topic:/mfip/edge/cmd/{{fieldId}}/{{gatewayId}}

響應(yīng)Topic:/mfip/svr/cmdresponse/{{fieldId}}/{{gatewayId}}

網(wǎng)關(guān)上報(bào)數(shù)據(jù)發(fā)送Topic:/mfip/edge/data/{{fieldId}}/{{gatewayId}}

響應(yīng)Topic:/mfip/svr/cmdresponse/{{fieldId}}/{{gatewayId}}

學(xué)兔兔服務(wù)器發(fā)送信令發(fā)送Topic:/mfip/svr/cmd/{{fieldId}}/{{gatewa標(biāo)準(zhǔn)下載yId}}

響應(yīng)Topic:/mfip/edge/cmdresponse/{{fieldId}}/{{gatewayId}}

注1：mfip是Multi-functionintelligentpole的縮寫

注2：fieldId：區(qū)域id

14

T/SPIA007—2023

注3：gatewayId：網(wǎng)關(guān)id

表A.5報(bào)文類型定義

報(bào)文類型報(bào)文動(dòng)作數(shù)據(jù)流向類型名稱協(xié)議類型

平臺(tái)(CS)<—

網(wǎng)關(guān)向平臺(tái)注

注冊(cè)網(wǎng)關(guān)LOGIN信令

冊(cè)

(GW)

平臺(tái)(CS)—>

平臺(tái)向網(wǎng)關(guān)應(yīng)

注冊(cè)應(yīng)答網(wǎng)關(guān)LOGIN_ACK信令

答

(GW)

平臺(tái)(CS)<—

實(shí)時(shí)告警發(fā)送網(wǎng)關(guān)ALARM_REPORT數(shù)據(jù)

(GW)

上報(bào)告警信息

平臺(tái)(CS)

告警回應(yīng)—>網(wǎng)關(guān)ALARM_REPORT_ACK信令

(GW)

上報(bào)網(wǎng)關(guān)自身平臺(tái)(CS)<—

上報(bào)網(wǎng)關(guān)自身

狀態(tài)網(wǎng)關(guān)GW_STATE_REPORT信令

狀態(tài)

(心跳包)(GW)

上報(bào)網(wǎng)關(guān)自身

平臺(tái)(CS)—>

狀態(tài)平臺(tái)向網(wǎng)關(guān)應(yīng)

網(wǎng)關(guān)GW_STATE_REPORT_ACK信令

（心跳包應(yīng)答

(GW)

答）

平臺(tái)(CS)<—

實(shí)時(shí)監(jiān)控?cái)?shù)據(jù)METE_REPORT

網(wǎng)關(guān)數(shù)據(jù)

上報(bào)

上報(bào)監(jiān)控量數(shù)(GW)

據(jù)平臺(tái)(CS)—>

實(shí)時(shí)監(jiān)控?cái)?shù)據(jù)

網(wǎng)關(guān)METE_REPORT_ACK數(shù)據(jù)

上報(bào)響應(yīng)

(GW)

平臺(tái)(CS)—>

監(jiān)控量數(shù)據(jù)請(qǐng)

網(wǎng)關(guān)QUERY_METE數(shù)據(jù)

求

請(qǐng)求監(jiān)控量數(shù)(GW)

據(jù)平臺(tái)(CS)<—

請(qǐng)求監(jiān)控量數(shù)

網(wǎng)關(guān)QUERY_METE_ACK數(shù)據(jù)

據(jù)響應(yīng)

(GW)

平臺(tái)(CS)—>

寫監(jiān)控量設(shè)置

網(wǎng)關(guān)SET_METE數(shù)據(jù)

值請(qǐng)求

(GW)

學(xué)兔兔寫監(jiān)控量設(shè)置標(biāo)準(zhǔn)下載

值平臺(tái)(CS)<—

寫監(jiān)控量設(shè)置

網(wǎng)關(guān)SET_METE_ACK數(shù)據(jù)

值響應(yīng)

(GW)

15

T/SPIA007—2023

平臺(tái)(CS)—>

查詢監(jiān)控量屬

網(wǎng)關(guān)QUERY_METE_ATTR信令

性請(qǐng)求

查詢監(jiān)控量屬(GW)

性平臺(tái)(CS)<—

查詢監(jiān)控量屬

網(wǎng)關(guān)QUERY_METE_ATTR_ACK信令

性響應(yīng)

(GW)

平臺(tái)(CS)—>

寫監(jiān)控量屬性

網(wǎng)關(guān)SET_METE_ATTR信令

請(qǐng)求

(GW)

寫監(jiān)控量屬性

平臺(tái)(CS)<—

寫監(jiān)控量屬性

網(wǎng)關(guān)SET_METE_ATTR_ACK信令

響應(yīng)

(GW)

平臺(tái)(CS)—>

查詢告警量請(qǐng)

網(wǎng)關(guān)QUERY_ALARM_ATTR信令

求

(GW)

查詢告警屬性

平臺(tái)(CS)<—

查詢告警量響

網(wǎng)關(guān)QUERY_ALARM_ATTR_ACK信令

應(yīng)

(GW)

平臺(tái)(CS)—>

寫告警量屬性

網(wǎng)關(guān)SET_ALARM_ATTR信令

請(qǐng)求

(GW)

寫告警量屬性

平臺(tái)(CS)<—

寫告警量屬性

網(wǎng)關(guān)SET_ALARM_ATTR_ACK信令

響應(yīng)

(GW)

平臺(tái)(CS)—>

重啟網(wǎng)關(guān)(GW)

網(wǎng)關(guān)REBOOT信令

請(qǐng)求

(GW)

重啟網(wǎng)關(guān)(GW)

平臺(tái)(CS)<—

重啟網(wǎng)關(guān)(GW)

網(wǎng)關(guān)REBOOT_ACK信令

響應(yīng)

(GW)