ICS93.080.30

CCSR85

團體標準

T/ITS0229—XXXX

數字交通隧道機電設備物模型規范

Specificationforphysicalmodelofelectromechanicalequipmentindigitaltraffic

tunnels

（征求意見稿）

本稿完成日期：2023年07月28日

在提交反饋意見時，請將您知道的相關專利連同支持性文件一并附上。

XXXX-XX-XX發布XXXX-XX-XX實施

中國智能交通產業聯盟發布

T/ITS0229—XXXX

數字交通隧道機電設備物模型規范

1范圍

本文件定義了公路機電系統物模型標準規范。以確定隧道內數字交通場景下的智能路側設備在進行

物聯網組網的過程中應當具備的模型。

本文件適用于指導公路機電系統物聯網組網過程中物模型功能的評測和認證，以確定隧道機電設備

物聯網組網能力的技術指數水平。

2規范性引用文件

下列文件中的內容通過文中的規范性引用而構成本文件必不可少的條款。其中，注日期的引用文件，

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

文件。

3術語和定義、縮略語

3.1術語和定義

下列術語和定義適用于本文件。

3.1.1

物模型iotmodel

物模型是對設備的數字化抽象描述，描述該型號設備是什么，能做什么，能對外提供哪些方法。物

模型將物理空間中的實體設備數字化，在云端構建該實體的數據模型，即將物理空間的實體在云端進行

格式化表示。

3.1.2

物聯網internetofthings；iot

通過感知設備，按照約定協議，連接物、人、系統和信息資源，實現圣物理智虛擬世界的信息進行

處理并作出反應的智能方法系統。

3.2縮略語

下列縮略語適用于本文件

IoT：物聯網(InternetofThings)

4物模型規范設計

4.1整體架構

1

T/ITS0229—XXXX

隧道中由于涉及眾多機電設備，且設備來自不同的設備廠商不同產品。因此需要定義一套統一的設

備物模型規范，消除業務中設備數據間的描述差異，使得數據在設備與平臺、平臺與平臺間傳輸時其描

述規則是統一的，并提供設備間互聯互通互懂的能力。

本文件定義了隧道機電設備在交互過程中的數據描述規范。如圖1所示，用于描述物模型的關鍵元

素包含設備描述、屬性、方法和事件。

圖1物模型設計元素邏輯關系圖

4.2設備描述

設備描述，用于描述設備的基本信息(如設備版本號、制造商、設備類型、設備SN等)和設備的功能

集(模塊)列表（屬性、方法、事件），一個設備(Device)只包含一個設備描述(如設備版本號、制造商、

設備類型、設備SN等)。

4.3模塊定義

模塊（Module)，具有獨立功能并且可復用的單元，由屬性（Attributes）、方法（Action）、事

件（Event）組成，一個模塊至少包含三者中的一種。

4.3.1屬性

屬性概述

2

T/ITS0229—XXXX

指描述設備的狀態、數據、關系、功能等的最小單位，用于描述設備運行時具體信息和狀態。屬性

可分為讀寫和只讀兩種類型。讀寫類型支持讀取和設置屬性值，只讀類型僅支持讀取屬性值。屬性

(Attributes)是描述設備的狀態、數據、關系、功能等的最小單位。屬性屬于某一個模塊(Module)；例

如，開關設備的抽象模型中，經度屬性只屬于位置模塊，而不會出現在網絡模塊中。如果一個屬性在設

計的時候出現可以放入兩個模塊的情況，可能需要重新考慮模塊劃分的合理性；屬性主要分為基礎屬性、

網絡屬性、位置屬性、功能描述屬性、擴展屬性等幾個大類，模塊的劃分可以參考這個大類劃分來，也

可自行定義。屬性定義采用描述項的方式呈現。

必選屬性、可選屬性、自定義屬性

為了更好地規范隧道機電物聯網的互操作性，我們規定若干屬性為必選屬性，要求接入到隧道機電

物聯網的設備都必須提供必選屬性；同時為了更好地擴展隧道機電物聯網的功能，我們也定義了若干可

選屬性，可選屬性為選擇提供，也可根據需求按照規定的方式添加自定義屬性。

.1必選屬性

機電設備通用的屬性信息必選必填，包括但不限于設備類型、名稱、業務參數、運行狀態、日志上

報等內容。

.2可選屬性

機電設備非通用屬性信息，根據每個設備情況可選可填，包括但不限于設備網卡、芯片編碼、應用

說明等內容。

.3自定義屬性

機電設備廠家除通用屬性信息之外的還需要額外添加的屬性，一般是設備之間的差異化設計帶來的

自定義屬性，包括但不限于各類設備的控制指令、狀態等內容。

屬性基本結構

用于描述設備運行時具體信息和狀態。屬性的基本結構見表1。

表1屬性的基本結構

參數描述是否必選

屬性的名稱，例如：洞內照度值。同一產品下功能名稱不能重復。支持中文、英文字母、

功能名稱數字、短劃線（-）、下劃線（_）、正斜線（/）和英文句號（.），且必須以中文、英文必選

或數字開頭，不超過30個字符。

屬性唯一標識符，在產品下具有唯一性。支持英文、數字和下劃線（_），不超過50個字

標識符必選

符。

3

T/ITS0229—XXXX

表1（續）

參數描述是否必選

int32：32位整型。需定義取值范圍、步長和單位符號。

float：單精度浮點型。需定義取值范圍、步長和單位符號。

double：雙精度浮點型。需定義取值范圍、步長和單位符號。

enum：枚舉型。定義枚舉項的參數值和參數描述，例如：0表示無故障、1表示有故障。

bool：布爾型。采用0或1來定義布爾值，例如：0表示關、1表示開。

數據類型string：字符串。需定義字符串的數據長度，最長支持10240字節。必選

date：時間戳。格式為string類型的UTC時間戳，單位：毫秒。

struct：JSON對象。定義一個JSON結構體，新增JSON參數項，例如：定義燈的顏色是由

Red、Green、Blue三個參數組成的結構體。不支持結構體嵌套。

array：數組。需聲明數組內的元素類型、數組元素個數。元素類型可選擇int32、float、

double、text或struct，需確保同一個數組元素類型相同。元素個數，限制1~512個。

取值范圍數據類型為int32、float、double時，可設置屬性值的取值范圍。必選

屬性值變化的最小粒度。數據類型為int32、float、double時，可根據您的業務需要設

置步長。

步長必選

例如：為CPU核心溫度定義溫度屬性時，將數據類型設置為int32，步長為1，單位為℃，

取值范圍0~100。即溫度每變化兩度，設備上報溫度值，例如：0℃、1℃、2℃等。

單位單位可選擇為無，或根據實際情況選擇。可選

讀寫：RW。

讀寫類型必選

只讀：R。

描述輸入文字，對該方法功能進行說明或備注。長度限制為100個字符。可選

.1設備描述

機電設備描述包括但不限于設備安裝信息、設備信息等信息，設備描述的基本結構見表2。

表2設備描述的基本結構

物模型類單讀寫類解析示例數是否必

名稱標識符數據類型說明

ID型位型據選

設備具體類型（照明

屬設備

devTypestring-讀寫不允許NULL類、通風類、消防必選

性類型

類...）

屬設備

namestring-讀寫不允許NULL設備全稱必選

性名稱

000001

字符串，可變

屬設備

snstring-讀長度，最設備編號必選

性SN

長:32個字符

設備字符串，可變

屬

版本versionstring-讀長度，最設備版本代號必選

性

號長:32個字符

4

T/ITS0229—XXXX

表2（續）

物模型類單讀寫類解析示例數是否必

名稱標識符數據類型說明

ID型位型據選

字符串，可變

屬規格contruction

string-讀長度，最控制器規格型號說明必選

性型號Stakenum

長:32個字符

字符串，可變

屬安裝contruction

string-讀長度，最設備安裝樁號必選

性位置Stakenum

長:32個字符

字符串，可變

屬使用

000001useInfostring-讀長度，最設備使用單位名稱可選

性單位

長:32個字符

字符串，格

屬安裝式：

timestring-讀設備安裝的時間必選

性時間yyyy-MM-dd

hh:mm:ss

字符串，可變

屬負責

userstring-讀長度，最設備使用的負責人可選

性人

長:32個字符

注：物模型ID用來標識該物模型在整個模型庫里面的身份,使用6位字符串描述，其中前2位建議為固定值(行業自定義),

標識該內容為屬性。剩余的4位用來標識不同的屬性基本結構。

.2業務參數（BusinessParameters）

機電設備業務參數包括但不限于硬件故障情況、設備類型、網絡狀態等信息。業務參數的基本結構

見表3。

表3業務參數的基本結構

物模型類數據類單讀寫是否

名稱標識符解析示例數據說明

ID型型位類型必選

屬網關字符串，可變長度，最設備連接的網

gatewayIDstring-讀可選

性ID長:32個字符關ID

000002

屬是否硬0--無故障設備的故障代

isFaultbool-讀寫必選

性件故障1--存在故障碼

5

T/ITS0229—XXXX

表3（續）

物模型類數據類單讀寫是否

名稱標識符解析示例數據說明

ID型型位類型必選

01--車道指示器

(三燈版)

02--交通信號燈

03--車道指示器

(雙燈版)

屬接入設05--橫洞門接入設備的類

devTypeenum-讀寫必選

性備類型06--風機型編號

07--風速風向檢測器

08--CO/VI檢測器

09--洞內照度檢測器

10--洞外光強檢測器

...

0000021.網口連接異常

屬網絡狀2.網絡正常設備當前網絡

networkStataenum-讀寫必選

性態3.平臺連接正常狀態

4.平臺連接異常

設備長度：32位唯一值，每一個

屬

id編devIDstring-讀寫允許空字符串，不允許機電設備都有必選

性

碼NULL唯一id編碼

每一個控制器

控制器長度：32位

屬都有唯一id編

id編idstring-讀寫允許空字符串，不允許必選

性碼，需要填寫當

碼NULL

前接的控制器

.3運行狀態

機電設備運行狀態包括但不限于：CPU占有率、片內內存占有率、片外內存占有率、啟動至今CPU

（tick）周期總數、CPU核心工作溫度等基礎信息。與業務相關的信息包括但不限于設備類型、設備當

前業務狀態、當前故障狀態反饋、當前設備采集的數值。交互式控制器運行狀態見表4，車道指示器運

行狀態見表5，交通信號燈運行狀態見表5，橫洞卷簾門運行狀態見表6，風機運行狀態見表7，風速風向

檢測器運行狀態見表8，CO/VI檢測器運行狀態見表9，洞內照度檢測器運行狀態見表10，洞外亮度檢測

器運行狀態見表11。

表4交互式控制器運行狀態

物模型設備類讀寫是否

標識符名稱數據類型單位解析示例數據說明

ID類型型類型必選

范圍：1～1000

交互步長：10設備當前

屬

000003式控cpuUsageCPU占有率int32%讀初始值:300CPU占有必選

性

制器示例：率值

300/10=30%

6

T/ITS0229—XXXX

表4交互式控制器運行狀態（續）

設讀

物模型備類數據單寫是否

標識符名稱解析示例數據說明

ID類型類型位類必選

型型

范圍：1～1000設備當

屬memoryUsaint3步長：10前內存

內存占有率%讀必選

性ge2初始值:300占有率

示例：300/10=30%值

CPU

啟動至今CPU

屬int3范圍：1～int32+（tick

tick（tick）周期次讀可選

性2步長：1）周期

總數

總數值

CPU核

屬CPU核心工作int3范圍：-50-100

cpuTemp℃讀心工作可選

性溫度2步長：1

溫度值

操作系

屬stri

OSVersionOS版本-讀建議參考xxx.xxx.xxx統版本必選

性ng

號

應用程

屬AppVersiostri

APP版本-讀建議參考xxx.xxx.xxx序版本可選

性nng

號

屬stri本機的

localIP本地IP-讀建議參考xxx.xxx.xxx.xxx必選

性ngIP地址

范圍：1～1000

設備當

步長：10

屬storageUsint3前存儲

交存儲占有率%讀初始值:300必選

性age2占有率

互示例：

式值

000003300/10=30%

控000000：一切正常

制各種告警

器100001：CPU使用率超過90%

100002：內存使用率超過90%

100003：存儲空間不足5%

100004：OTA下載失敗故障狀

屬stri100005：OTA升級失敗態碼可

faultCode故障狀態碼-讀必選

性ng100006：應用下載失敗動態擴

100007：應用安裝失敗展

100008：以太網通信連接失敗

100009：藍牙通信數據傳輸失

敗

100010：WIFI通信數據傳輸

失敗

Mb設備當

屬totalStorint3

存儲大小yt讀步長：1前存儲可選

性age2

e大小

Kb設備當

屬totalMemoint3可選

內存大小yt讀步長：1前內存

性ry2必選

e大小

7

T/ITS0229—XXXX

表5車道指示器運行狀態

設讀

物模型備類單寫是否

標識符名稱數據類型解析示例數據說明

ID類型位類必選

型型

不允許為空

第一位是正面，第二

位是反面：

0：滅

1：綠箭

屬燈狀讀2：紅叉

liRunStatusenum-燈狀態數據必選

性態寫3：橫向

F：異常

00：全滅，12：正綠

車

反紅，21：正紅反綠，

道

22：正紅反紅，FF：

000005指

異常

示

器date

最后字符串類型表達時

屬（string毫讀最后更新時

time更新間，不允許為NULL必選

性類型UTC秒寫間

時間或空字符串

毫秒）

不允許為空

屬設備讀00=在線當前設備狀

devStatusenum-必選

性狀態寫01=離線態

02=故障

表6交通信號燈運行狀態

設

物模型備類單讀寫是否必

標識符名稱數據類型解析示例數據說明

ID類型位類型選

型

不允許為空

1=紅燈

屬運行

tlRunStatusenum-讀寫2=綠燈當前運行狀態必選

性狀態

3=黃燈

4=左轉

交

date字符串類型表

通最后

屬（string毫達時間，不允許

000005信time更新讀寫最后更新時間必選

性類型UTC秒為NULL或空

號時間

毫秒）字符串

燈

不允許為空

屬設備00=在線

devStatusenum-讀寫當前設備狀態必選

性狀態01=離線

02=故障

8

T/ITS0229—XXXX

表7橫洞卷簾門運行狀態

設讀

物模型備類單寫是否必

標識符名稱數據類型解析示例數據說明

ID類型位類選

型型

不允許為空

屬運行讀

rdRunStatusenum-1=打開當前運行狀態必選

性狀態寫

2=關閉

橫

date字符串類型表

洞最后

屬（string毫讀達時間，不允

000006卷time更新最后更新時間必選

性類型UTC秒寫許為NULL或

簾時間

毫秒）空字符串

門

不允許為空

屬設備讀00=在線

devStatusenum-當前設備狀態必選

性狀態寫01=離線

02=故障

表8風機運行狀態

設讀

物模型備類單寫解析示例數是否必