《智慧社區物聯網設備數據接口技術要求》（征求意見稿）

編制說明

一、工作簡況

1.任務來源

本標準由清華大學提出，由中關村智慧城市產業技術創新戰略聯盟歸口。

本標準是國家重點研發計劃項目“物聯網全場景智慧社區綜合服務與應用示

范”課題“支持交互融合的社區全場景物聯網設備接入技術研究”

（2020YFB2103701）的研究成果之一。

2.編制背景及意義

國家政策要求推進智慧社區信息化建設。黨的十八大以來，習近平總書記提出

社區是國家治理的基礎。2014年，住建部辦公廳發布《智慧社區建設指南（試行）》，

明確了我國城市智慧社區建設的總體框架和評價指標體系。2017年6月，中共中

央、國務院印發《關于加強和完善城鄉社區治理的意見》，提出要依托智慧城市建

設，推進智慧社區信息化建設。2019年國家發改委發布了《綠色生活創建行動總

體方案》，提出開展綠色社區創建行動。截至2019年底，我國已建成一批具有代

表性、示范性、典型性的智慧社區，“新冠”疫情爆發后，更加凸顯了社區治理對

國家和社會的重要意義，智慧社區建設的需求也更加迫切。

科技部部署國家重點研發計劃項目《物聯網全場景智慧社區綜合服務與應用

示范》（2020YFB2103700），開展支持交互融合的社區全場景物聯網設備接入技

術研究。

智慧社區建設的推進和實施，促使單一社區服務轉向綜合便捷服務、從單點智

慧過渡到整體智慧，各類社區數據的感知、采集、融合和一體化平臺研發等成為智

慧社區的研究重點和難點。

智能化、交互化和網絡狀的行動協調是智慧社區質量標準的核心要求，目前社

區中物聯網設備具備多樣性和異構性，物聯網數據異構性使得物聯網設備在數據

互通、數據存儲和共享方面產生困難，尤其在大規模物聯網設備接入方面會極大的

影響物聯網數據接入和交換效率，不利于物聯網平臺對大規模設備數據接入的管

理。針對目前物聯網設備無統一接口技術標準規范，研發統一的資源標識數據訪問

接口，有助于提高智慧社區智能化管理水平。

部委政策鼓勵開展城市數字資源利用相關團體標準研制。《團體標準管理規

定》（國標委聯〔2019〕1號）鼓勵推進團體標準研制，《“十四五”推動高質量

發展的國家標準體系建設規劃》（國標委聯〔2021〕36號）明確指出“圍繞智慧

城市分級分類建設、基礎設施智能化改造、城市數字資源利用、城市數據大腦、人

工智能創新應用、城市數字孿生等方面完善標準體系建設”，推動城市數字資源利

用標準研制。

智慧社區物聯網設備接口相關標準研制急需開展。物聯感知數據是智慧社區

數字資源的重要組成部分。快速接入物聯感知設備并進行數據交換是提高智慧社

區智能化應用水平的基礎前提。然而，對于社區物聯網設備，由于設備多樣和異構

性導致的設備數據接口標準不一致，將使得物聯網設備在數據互通、數據存儲和共

享方面產生困難，尤其在大規模物聯網設備接入方面會極大的影響物聯網數據接

入和交換效率，不利于物聯網平臺對大規模設備數據接入的管理。

本標準依托國家重點研發計劃《支持交互融合的社區全場景物聯網設備接入

技術研究》（2020YFB2103701），結合物聯網通用接入平臺及物聯網規則匹配聯

動系統，立足智慧社區物聯網設備數據的異構傳輸與智慧社區應用場景，規定了

(智慧)社區物聯網設備與物聯網網關或物聯網接入平臺間數據接口的具體功能要

求，有助于推動物聯網系統的可靠運行，也有利于構建數據共享更為高效安全、可

操作性更強的物聯網系統，提高社區的智慧管理水平。因此，制定本標準具有一定

的必要性。

3.起草單位情況

起草單位包括：清華大學、深圳市中電數通智慧安全科技股份有限公司等。

4.工作過程

2022年9月：組建標準編制工作組,啟動本標準預研究工作。

2022年9月-2023年6月：收集相關參考資料，研究相關技術，召開線上線

下討論會，編制形成標準立項審查稿、編制說明、標準項目建議書等材料。

2023年7月7日：向中關村智慧城市產業技術創新戰略聯盟提交立項內審資

料，進行標準匯報與專家咨詢。

2023年7月12日：中關村智慧城市產業技術創新戰略聯盟下達標準研制計

劃。

2023年8月15日：期間進行標準草案起草與討論，多輪組內討論，完成標準

更名，形成標準初稿。

2023年8月30日：中關村智慧城市產業技術創新戰略聯盟召開標準咨詢會，

組織專家對標準初稿進行審核，提出了修改意見和建議。

2022年9-10月：標準草案討論與修改，多輪組內討論，技術研究，單獨征求

專家學者建議，完善標準草案。

2023年10月10日：向中關村智慧城市產業技術創新戰略聯盟提交征求意見

稿（初稿）及其編制說明等資料。

2023年10月31日：中關村智慧城市產業技術創新戰略聯盟召開標準咨詢會，

組織專家對標準征求意見稿（初稿）進行審查，提出了修改意見和建議。

2023年11月7日：根據專家咨詢意見，形成標準征求意見稿。開展為期一個

月的公開征求意見工作。

二、標準編制原則和確定主要內容的論據及解決的主要問題

1.標準的主要內容

本文件規定了(智慧)社區物聯網設備與物聯網網關或物聯網接入平臺間數據

接口的具體功能要求。

本文件適用于(智慧)社區物聯網場景下物聯網設備與物聯網網關或物聯網接

入平臺間數據接口的設計、開發和應用。

2.標準編制依據

在科學技術研究成果、物聯網設備接入應用實踐及物聯網交互聯動應用系統

基礎上，深入調查分析，進行實驗、論證，切實做到科學有效、技術指標先進。

科學技術研究成果。充分借鑒國家重點研發課題《支持交互融合的社區全場景

物聯網設備接入技術研究》（2020YFB2103701）的技術研究成果。

項目實踐及交互聯動系統應用。充分歸納多類型大量物聯感知設備接入與物

聯網交互聯動技術經驗及系統應用情況。

3.標準編制原則

（1）適用性原則，從當前城市領域物聯感知數據和物聯網交互聯動技術的應

用情況出發，使標準內容有適用性，滿足當前的實際應用需求。

（2）先進性原則，在調查研究基礎上，充分參考既有標準的技術水平和相關

規范，積極把先進技術納入標準，實現在物聯網數據融合應用領域的引領作用。

（3）合規性原則，標準編制符合法律法規的規定以及與相關標準協調，避免

與法律法規、相關標準之間出現矛盾。

（4）規范性原則，標準結構和編寫規則，按照GB/T1.1-2020執行。

4.解決的主要問題

本標準明確了生成數據接口所需的物聯網產品統一資源描述、數據接口內容

及數據接口的生成過程等要求，解決了物聯網系統數據傳輸異構性的問題。

5.主要技術內容說明

5.1物聯網產品統一資源描述的內容與JSON數據表達

物聯網產品統一資源描述（IOTURD）由物聯網產品資源標識（IOTRI）和針對

該類物聯網設備的特征功能描述兩部分組成。其中特征功能描述部分又可分為對

設備整體概要狀況描述和該類物聯網產品具備的屬性信息描述及產品所具備的事

件及服務的交互數據內容描述。

物聯網產品統一資源描述通常采用JSON數據來表達，包含整體概述(profile)、

產品的屬性（properties）、事件（events）、服務（services）四部分構成。其

字段說明如下表1：

表1物聯網產品統一資源描述JSON數據表達字段說明

序

字段名父級字段名可選/必選類型說明

號

1profile必選JSONObject整體概述

2IOTRIprofile必選Uint32物聯網產品資源標識

設備節點類型1網關設備2直連設備3網關

3nodeTypeprofile必選Enum

子設備

聯網方式,根據節點類型確定，南向聯網方式

包括Modbus、ZigBee、Lora、BLE、OPC、WiFi

4linkModeprofile必選Enum

等，北向聯網方式包括RJ45、蜂窩

2G/3G/4G/5G，NB-IoT等。

5protocolprofile必選Enum傳輸協議MQTT、HTTP、CoAP、LwM2M

6msgFormatprofile必選Enum消息格式,枚舉值，緊湊二進制、JSON

序

字段名父級字段名可選/必選類型說明

號

manufacture

7profile可選string生產廠商

r

8properties可選JSONObjectArray設備屬性定義

9propertyIDproperties必選Uint16屬性ID值

10identifierproperties必選string屬性標識符

11nameproperties必選string屬性名

12infoTypeproperties必選string屬性信息分類說明

13accessModeproperties必選string讀寫方式，r-只讀，rw-讀寫,w-只寫

14descproperties可選string屬性的描述信息

15dataTypeproperties必選JSONObject屬性類型描述信息

屬性類型，值可選text、enum、number、

16typedataType必選string

date

17specsdataType可選JSONObject屬性空間描述

18lengthspecs必選string（屬性類型為text時）文本長度

（屬性類型為enum時）枚舉內容，i為從0開始自

19ispecs可選string

然數

20minspecs可選string（屬性類型為number）數值最小值

21maxspecs可選string（屬性類型為number）數值最大值

22unitspecs可選string（屬性類型為number）數值顯示單位

23stepspecs可選string（屬性類型為number）數值精度/步長

（屬性類型為date）時間格式，例如“yyyy-

24formatspecs必選stringMM-ddHH:mm:ss”、“yyyy-MM-dd”

“HH:mm:ss”

25events可選JSONObjectArray設備事件定義

26eventIDevents必選Uint8事件ID

27identifierevents必選string事件標識符

表1（續）

序可選/必

字段名父級字段名類型說明

號選

28nameevents必選string事件名

29eventTypeevents必選string事件類型0-信息1-告警2-故障

30descevents可選string事件描述信息

31parametersevents必選JSONObjectArray事件屬性定義，同設備屬性定義properties

32services可選JSONObjectArray設備服務定義

33serviceIDservices必選Uint8服務ID

34identifierservices必選string服務標識符

35nameservices必選string服務名

36serviceTypeservices必選string服務類型0-指令下發1-指令響應回復

37descservices可選string服務描述信息

38parametersservices必選JSONObjectArray服務屬性定義，同設備屬性定義properties

5.2視頻結構化數據的統一資源描述

將視頻結構化設備視為一類特殊的物聯網設備，對具有同類型功能的視頻結

構化產品定義相同的IOTRI。將視頻結構化數據中的“視頻對象”和“對象行為”

統一用物聯網的“事件”進行表達，通過物聯網產品統一資源描述中事件屬性定

義來描述視頻結構化對象/行為的特征與屬性，實現視頻結構化數據和物聯網設備

數據在語義表達和數據接口的統一。

5.3數據接口格式

物聯網設備傳輸的數據報文宜采用可序列化的JSON（RFC4627）或緊湊二進制

流作為數據接口格式，采用HTTP協議或CoAP協議進行數據傳輸。

兩種方式只是對于傳輸數據的不同編碼方式，因此在平臺-設備交互時，可自

主選擇數據的傳輸格式，并應支持二者進行相互轉化。數據接口格式的兩種表達對

比示例參見征求意見稿附錄D。

1.JSON格式接口數據格式

物聯網設備與物聯網關或平臺交互應以物聯網產品統一資源描述約定的事件

或服務定義的描述內容進行數據交互。發送或接收時接口數據參考格式如下。

（1）事件發送

事件是由物聯網設備上傳，描述設備感知的信息。事件由設備端主動發送，表

2為物聯網設備事件發送JSON字段說明，表3為視頻結構化事件發送數據JSON格式

字段說明。相關示例參見征求意見稿附錄B.1。

表2事件發送數據JSON格式字段說明

序號字段名父級字段名可選/必選類型說明

1IOTRI必選Uint32物聯網產品資源標識

2deviceID必選string設備ID,設備的唯一標識符

3eventID必選Uint8為與平臺約定的事件ID，用于區分具體上報事件

4data必選JSONObject設備上報的事件參數信息內容，格式為"參數名":參數值

5dev可選JSONObject子設備信息：當前上報信息包含子設備信息時需具備

6devnumdev可選string用于通過RS232或RS485口接入的網關子設備地址描述

7datadev可選JSONObject子設備上報的事件參數信息內容，格式同data

表2視頻結構化事件發送數據JSON格式字段說明

序號字段名父級字段名可選/必選類型說明

1IOTRI必選Uint32視頻結構化產品資源標識

2deviceID必選string視頻源（攝像頭）設備ID,視頻源的唯一標識符

為與平臺約定的事件（視頻結構化對象或行為）ID，用于

3eventID必選Uint8

區分具體上報事件

4data必選JSONObject設備上報的事件參數信息內容，格式為"參數名":參數值

子畫面（ROI區域）信息：當前上報信息包含子畫面

5dev可選JSONObject

（ROI）信息時需具備

6devnumdev可選string

7datadev可選JSONObject子畫面（ROI）上報的事件參數信息內容，格式同data

（2）服務發送

服務發送由平臺側主動發起，設備側異步返回反饋信息，JSON數據字段說明如

表4所示。相關示例參見附錄B.2

表3服務發送數據JSON格式字段說明

序號字段名父級字段名可選/必選類型說明

1IOTRI必選Uint32物聯網產品資源標識

2deviceID必選string設備ID,設備的唯一標識符

3serviceID必選Uint8為與平臺約定的服務ID，用于區分具體下發服務

4data必選JSONObject平臺下發的服務參數信息內容，格式為"參數名":參數值

5dev可選JSONObject子設備信息：當前上報信息包含子設備信息時需具備

6devnumdev可選string用于通過RS232或RS485口接入的網關子設備地址描述

7datadev可選JSONObject子設備上報的事件參數信息內容，格式同data

（3）服務響應反饋

服務響應反饋由設備側發起返回反饋信息，其JSON數據格式字段說明如表5所

示。相關示例參見附錄B.3

表4服務相應反饋數據JSON格式字段說明

序號字段名父級字段名可選/必選類型說明

1code必選uint為設備端返回響應碼

2msg可選string設備端反饋的響應信息，可為空

3IOTRI必選Uint32物聯網產品資源標識

4deviceID必選string設備ID,設備的唯一標識符

5serviceID必選Uint8為與平臺約定的服務ID，用于區分具體下發或反饋服務

6data必選JSONObject平臺下發的服務參數信息內容，格式為"參數名":參數值

7dev可選JSONObject子設備信息：當前上報信息包含子設備信息時需具備

8devnumdev可選string用于通過RS232或RS485口接入的網關子設備地址描述

9datadev可選JSONObject子設備上報的事件參數信息內容，格式同data

2.緊湊二進制接口數據格式

（1）通信數據包結構總圖

圖1通信數據包結構總圖

通信數據包整體分為三層：

接入層：定義通信傳輸的底層格式，以便實現與各種不同媒介的信息互通。接入層承

載并保證網絡層協議數據的可靠傳輸，在本協議支持多種接入層。

應用層：針對各種監控所需功能，提供接口指令，實現了面向監控功能的數據組織。

實體層：組織應用層下數據單元的各監控量（設備屬性）的數據表達。

（2）緊湊二進制應用層數據格式說明

事件發送

事件發送的二進制格式字段說明如下表6所示。

表6事件發送數據二進制格式字段說明

序號單元名JSON字段名可選/必選長度說明

1統一資源標識符IOTRI必選4字節物聯網產品資源標識

2設備地址deviceID必選32字節設備ID,設備的唯一標識符

3通信包標識必選2字節交互類型為事件發送時，值為0x01

通信發起端用此標志通知接收端如何處理通信包，接

4交互標志必選1字節

收端用于返回發起端通信包的執行結果

5命令單元eventID必選1字節為與平臺約定的事件ID，用于區分具體上報事件

設備上報的事件參數信息內容，基本組成單元為屬性

6數據單元data必選N字節

ID和屬性值的鍵值對

7子設備數據分隔標識可選2字節子設備數據的起始標記

子設備ID,子設備的唯一標識符，按照子設備

8子設備DeviceIDdevnum可選32字節DeviceID標識-子設備DeviceID鍵值對的方式進行傳

輸

設備上報的事件參數信息內容，基本組成單元為屬性

9子設備數據單元data可選N字節

ID和屬性值的鍵值對

服務發送

服務發送的二進制格式字段說明如下表7所示。

表7服務發送數據二進制格式字段說明

序號單元名JSON字段名可選/必選類型說明

統一資源標

1IOTRI必選4字節物聯網產品資源標識

識符

2設備地址deviceID必選32字節設備ID,設備的唯一標識符

3通信包標識必選2字節交互類型為服務發送時，值為0x02

通信發起端用此標志通知接收端如何處理通信包，接收端用于

4交互標志必選1字節

返回發起端通信包的執行結果

5命令單元serviceID必選1字節為與平臺約定的服務ID，用于區分具體下發或反饋服務

平臺下發的服務參數信息內容，基本組成單元為屬性ID和屬性

6數據單元data必選N字節

值的鍵值對

子設備數據

7可選2字節子設備數據的起始標記

分隔標識

子設備子設備ID,子設備的唯一標識符，按照子設備DeviceID標識-

8devnum可選32字節

DeviceID子設備DeviceID鍵值對的方式進行傳輸

子設備數據設備上報的事件參數信息內容，基本組成單元為屬性ID和屬性

9data可選N字節

單元值的鍵值對

服務響應反饋

服務響應反饋的二進制格式字段說明如下表8所示。

表8服務響應反饋數據二進制格式字段說明

序號單元名JSON字段名可選/必選類型說明

統一資源標

1IOTRI必選4字節物聯網產品資源標識

識符

2設備地址deviceID必選32字節設備ID,設備的唯一標識符

3通信包標識必選2字節交互類型為服務發送反饋時，值為0x02

通信發起端用此標志通知接收端如何處理通信包，接收端用于返回

4交互標志code必選1字節

發起端通信包的執行結果

5命令單元serviceID必選1字節為與平臺約定的服務ID，用于區分具體下發或反饋服務

平臺下發的服務參數信息內容，基本組成單元為屬性ID和屬性值的

6數據單元data必選N字節

鍵值對

子設備數據

7可選2字節子設備數據的起始標記

分隔標識

子設備子設備ID,子設備的唯一標識符，按照子設備DeviceID標識-子設

8devnum可選32字節

DeviceID備DeviceID鍵值對的方式進行傳輸

子設備數據設備上報的事件參數信息內