《數(shù)字交通隧道機(jī)電設(shè)備物模型規(guī)范》

ICS93.080.30

CCSR85

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

T/ITS0229—XXXX

數(shù)字交通隧道機(jī)電設(shè)備物模型規(guī)范

Specificationforphysicalmodelofelectromechanicalequipmentindigitaltraffic

tunnels

（征求意見(jiàn)稿）

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

在提交反饋意見(jiàn)時(shí)，請(qǐng)將您知道的相關(guān)專(zhuān)利連同支持性文件一并附上。

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

中國(guó)智能交通產(chǎn)業(yè)聯(lián)盟發(fā)布

T/ITS0229—XXXX

數(shù)字交通隧道機(jī)電設(shè)備物模型規(guī)范

1范圍

本文件定義了公路機(jī)電系統(tǒng)物模型標(biāo)準(zhǔn)規(guī)范。以確定隧道內(nèi)數(shù)字交通場(chǎng)景下的智能路側(cè)設(shè)備在進(jìn)行

物聯(lián)網(wǎng)組網(wǎng)的過(guò)程中應(yīng)當(dāng)具備的模型。

本文件適用于指導(dǎo)公路機(jī)電系統(tǒng)物聯(lián)網(wǎng)組網(wǎng)過(guò)程中物模型功能的評(píng)測(cè)和認(rèn)證，以確定隧道機(jī)電設(shè)備

物聯(lián)網(wǎng)組網(wǎng)能力的技術(shù)指數(shù)水平。

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

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

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

文件。

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

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

下列術(shù)語(yǔ)和定義適用于本文件。

3.1.1

物模型iotmodel

物模型是對(duì)設(shè)備的數(shù)字化抽象描述，描述該型號(hào)設(shè)備是什么，能做什么，能對(duì)外提供哪些方法。物

模型將物理空間中的實(shí)體設(shè)備數(shù)字化，在云端構(gòu)建該實(shí)體的數(shù)據(jù)模型，即將物理空間的實(shí)體在云端進(jìn)行

格式化表示。

3.1.2

物聯(lián)網(wǎng)internetofthings；iot

通過(guò)感知設(shè)備，按照約定協(xié)議，連接物、人、系統(tǒng)和信息資源，實(shí)現(xiàn)圣物理智虛擬世界的信息進(jìn)行

處理并作出反應(yīng)的智能方法系統(tǒng)。

3.2縮略語(yǔ)

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

IoT：物聯(lián)網(wǎng)(InternetofThings)

4物模型規(guī)范設(shè)計(jì)

4.1整體架構(gòu)

1

T/ITS0229—XXXX

隧道中由于涉及眾多機(jī)電設(shè)備，且設(shè)備來(lái)自不同的設(shè)備廠(chǎng)商不同產(chǎn)品。因此需要定義一套統(tǒng)一的設(shè)

備物模型規(guī)范，消除業(yè)務(wù)中設(shè)備數(shù)據(jù)間的描述差異，使得數(shù)據(jù)在設(shè)備與平臺(tái)、平臺(tái)與平臺(tái)間傳輸時(shí)其描

述規(guī)則是統(tǒng)一的，并提供設(shè)備間互聯(lián)互通互懂的能力。

本文件定義了隧道機(jī)電設(shè)備在交互過(guò)程中的數(shù)據(jù)描述規(guī)范。如圖1所示，用于描述物模型的關(guān)鍵元

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

圖1物模型設(shè)計(jì)元素邏輯關(guān)系圖

4.2設(shè)備描述

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

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

設(shè)備類(lèi)型、設(shè)備SN等)。

4.3模塊定義

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

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

4.3.1屬性

屬性概述

2

T/ITS0229—XXXX

指描述設(shè)備的狀態(tài)、數(shù)據(jù)、關(guān)系、功能等的最小單位，用于描述設(shè)備運(yùn)行時(shí)具體信息和狀態(tài)。屬性

可分為讀寫(xiě)和只讀兩種類(lèi)型。讀寫(xiě)類(lèi)型支持讀取和設(shè)置屬性值，只讀類(lèi)型僅支持讀取屬性值。屬性

(Attributes)是描述設(shè)備的狀態(tài)、數(shù)據(jù)、關(guān)系、功能等的最小單位。屬性屬于某一個(gè)模塊(Module)；例

如，開(kāi)關(guān)設(shè)備的抽象模型中，經(jīng)度屬性只屬于位置模塊，而不會(huì)出現(xiàn)在網(wǎng)絡(luò)模塊中。如果一個(gè)屬性在設(shè)

計(jì)的時(shí)候出現(xiàn)可以放入兩個(gè)模塊的情況，可能需要重新考慮模塊劃分的合理性；屬性主要分為基礎(chǔ)屬性、

網(wǎng)絡(luò)屬性、位置屬性、功能描述屬性、擴(kuò)展屬性等幾個(gè)大類(lèi)，模塊的劃分可以參考這個(gè)大類(lèi)劃分來(lái)，也

可自行定義。屬性定義采用描述項(xiàng)的方式呈現(xiàn)。

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

為了更好地規(guī)范隧道機(jī)電物聯(lián)網(wǎng)的互操作性，我們規(guī)定若干屬性為必選屬性，要求接入到隧道機(jī)電

物聯(lián)網(wǎng)的設(shè)備都必須提供必選屬性；同時(shí)為了更好地?cái)U(kuò)展隧道機(jī)電物聯(lián)網(wǎng)的功能，我們也定義了若干可

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

.1必選屬性

機(jī)電設(shè)備通用的屬性信息必選必填，包括但不限于設(shè)備類(lèi)型、名稱(chēng)、業(yè)務(wù)參數(shù)、運(yùn)行狀態(tài)、日志上

報(bào)等內(nèi)容。

.2可選屬性

機(jī)電設(shè)備非通用屬性信息，根據(jù)每個(gè)設(shè)備情況可選可填，包括但不限于設(shè)備網(wǎng)卡、芯片編碼、應(yīng)用

說(shuō)明等內(nèi)容。

.3自定義屬性

機(jī)電設(shè)備廠(chǎng)家除通用屬性信息之外的還需要額外添加的屬性，一般是設(shè)備之間的差異化設(shè)計(jì)帶來(lái)的

自定義屬性，包括但不限于各類(lèi)設(shè)備的控制指令、狀態(tài)等內(nèi)容。

屬性基本結(jié)構(gòu)

用于描述設(shè)備運(yùn)行時(shí)具體信息和狀態(tài)。屬性的基本結(jié)構(gòu)見(jiàn)表1。

表1屬性的基本結(jié)構(gòu)

參數(shù)描述是否必選

屬性的名稱(chēng)，例如：洞內(nèi)照度值。同一產(chǎn)品下功能名稱(chēng)不能重復(fù)。支持中文、英文字母、

功能名稱(chēng)數(shù)字、短劃線(xiàn)（-）、下劃線(xiàn)（_）、正斜線(xiàn)（/）和英文句號(hào)（.），且必須以中文、英文必選

或數(shù)字開(kāi)頭，不超過(guò)30個(gè)字符。

屬性唯一標(biāo)識(shí)符，在產(chǎn)品下具有唯一性。支持英文、數(shù)字和下劃線(xiàn)（_），不超過(guò)50個(gè)字

標(biāo)識(shí)符必選

符。

3

T/ITS0229—XXXX

表1（續(xù)）

參數(shù)描述是否必選

int32：32位整型。需定義取值范圍、步長(zhǎng)和單位符號(hào)。

float：?jiǎn)尉雀↑c(diǎn)型。需定義取值范圍、步長(zhǎng)和單位符號(hào)。

double：雙精度浮點(diǎn)型。需定義取值范圍、步長(zhǎng)和單位符號(hào)。

enum：枚舉型。定義枚舉項(xiàng)的參數(shù)值和參數(shù)描述，例如：0表示無(wú)故障、1表示有故障。

bool：布爾型。采用0或1來(lái)定義布爾值，例如：0表示關(guān)、1表示開(kāi)。

數(shù)據(jù)類(lèi)型string：字符串。需定義字符串的數(shù)據(jù)長(zhǎng)度，最長(zhǎng)支持10240字節(jié)。必選

date：時(shí)間戳。格式為string類(lèi)型的UTC時(shí)間戳，單位：毫秒。

struct：JSON對(duì)象。定義一個(gè)JSON結(jié)構(gòu)體，新增JSON參數(shù)項(xiàng)，例如：定義燈的顏色是由

Red、Green、Blue三個(gè)參數(shù)組成的結(jié)構(gòu)體。不支持結(jié)構(gòu)體嵌套。

array：數(shù)組。需聲明數(shù)組內(nèi)的元素類(lèi)型、數(shù)組元素個(gè)數(shù)。元素類(lèi)型可選擇int32、float、

double、text或struct，需確保同一個(gè)數(shù)組元素類(lèi)型相同。元素個(gè)數(shù)，限制1~512個(gè)。

取值范圍數(shù)據(jù)類(lèi)型為int32、float、double時(shí)，可設(shè)置屬性值的取值范圍。必選

屬性值變化的最小粒度。數(shù)據(jù)類(lèi)型為int32、float、double時(shí)，可根據(jù)您的業(yè)務(wù)需要設(shè)

置步長(zhǎng)。

步長(zhǎng)必選

例如：為CPU核心溫度定義溫度屬性時(shí)，將數(shù)據(jù)類(lèi)型設(shè)置為int32，步長(zhǎng)為1，單位為℃，

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

單位單位可選擇為無(wú)，或根據(jù)實(shí)際情況選擇。可選

讀寫(xiě)：RW。

讀寫(xiě)類(lèi)型必選

只讀：R。

描述輸入文字，對(duì)該方法功能進(jìn)行說(shuō)明或備注。長(zhǎng)度限制為100個(gè)字符。可選

.1設(shè)備描述

機(jī)電設(shè)備描述包括但不限于設(shè)備安裝信息、設(shè)備信息等信息，設(shè)備描述的基本結(jié)構(gòu)見(jiàn)表2。

表2設(shè)備描述的基本結(jié)構(gòu)

物模型類(lèi)單讀寫(xiě)類(lèi)解析示例數(shù)是否必

名稱(chēng)標(biāo)識(shí)符數(shù)據(jù)類(lèi)型說(shuō)明

ID型位型據(jù)選

設(shè)備具體類(lèi)型（照明

屬設(shè)備

devTypestring-讀寫(xiě)不允許NULL類(lèi)、通風(fēng)類(lèi)、消防必選

性類(lèi)型

類(lèi)...）

屬設(shè)備

namestring-讀寫(xiě)不允許NULL設(shè)備全稱(chēng)必選

性名稱(chēng)

000001

字符串，可變

屬設(shè)備

snstring-讀長(zhǎng)度，最設(shè)備編號(hào)必選

性SN

長(zhǎng):32個(gè)字符

設(shè)備字符串，可變

屬

版本versionstring-讀長(zhǎng)度，最設(shè)備版本代號(hào)必選

性

號(hào)長(zhǎng):32個(gè)字符

4

T/ITS0229—XXXX

表2（續(xù)）

物模型類(lèi)單讀寫(xiě)類(lèi)解析示例數(shù)是否必

名稱(chēng)標(biāo)識(shí)符數(shù)據(jù)類(lèi)型說(shuō)明

ID型位型據(jù)選

字符串，可變

屬規(guī)格contruction

string-讀長(zhǎng)度，最控制器規(guī)格型號(hào)說(shuō)明必選

性型號(hào)Stakenum

長(zhǎng):32個(gè)字符

字符串，可變

屬安裝contruction

string-讀長(zhǎng)度，最設(shè)備安裝樁號(hào)必選

性位置Stakenum

長(zhǎng):32個(gè)字符

字符串，可變

屬使用

000001useInfostring-讀長(zhǎng)度，最設(shè)備使用單位名稱(chēng)可選

性單位

長(zhǎng):32個(gè)字符

字符串，格

屬安裝式：

timestring-讀設(shè)備安裝的時(shí)間必選

性時(shí)間yyyy-MM-dd

hh:mm:ss

字符串，可變

屬負(fù)責(zé)

userstring-讀長(zhǎng)度，最設(shè)備使用的負(fù)責(zé)人可選

性人

長(zhǎng):32個(gè)字符

注：物模型ID用來(lái)標(biāo)識(shí)該物模型在整個(gè)模型庫(kù)里面的身份,使用6位字符串描述，其中前2位建議為固定值(行業(yè)自定義),

標(biāo)識(shí)該內(nèi)容為屬性。剩余的4位用來(lái)標(biāo)識(shí)不同的屬性基本結(jié)構(gòu)。

.2業(yè)務(wù)參數(shù)（BusinessParameters）

機(jī)電設(shè)備業(yè)務(wù)參數(shù)包括但不限于硬件故障情況、設(shè)備類(lèi)型、網(wǎng)絡(luò)狀態(tài)等信息。業(yè)務(wù)參數(shù)的基本結(jié)構(gòu)

見(jiàn)表3。

表3業(yè)務(wù)參數(shù)的基本結(jié)構(gòu)

物模型類(lèi)數(shù)據(jù)類(lèi)單讀寫(xiě)是否

名稱(chēng)標(biāo)識(shí)符解析示例數(shù)據(jù)說(shuō)明

ID型型位類(lèi)型必選

屬網(wǎng)關(guān)字符串，可變長(zhǎng)度，最設(shè)備連接的網(wǎng)

gatewayIDstring-讀可選

性ID長(zhǎng):32個(gè)字符關(guān)ID

000002

屬是否硬0--無(wú)故障設(shè)備的故障代

isFaultbool-讀寫(xiě)必選

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

5

T/ITS0229—XXXX

表3（續(xù)）

物模型類(lèi)數(shù)據(jù)類(lèi)單讀寫(xiě)是否

名稱(chēng)標(biāo)識(shí)符解析示例數(shù)據(jù)說(shuō)明

ID型型位類(lèi)型必選

01--車(chē)道指示器

(三燈版)

02--交通信號(hào)燈

03--車(chē)道指示器

(雙燈版)

屬接入設(shè)05--橫洞門(mén)接入設(shè)備的類(lèi)

devTypeenum-讀寫(xiě)必選

性備類(lèi)型06--風(fēng)機(jī)型編號(hào)

07--風(fēng)速風(fēng)向檢測(cè)器

08--CO/VI檢測(cè)器

09--洞內(nèi)照度檢測(cè)器

10--洞外光強(qiáng)檢測(cè)器

...

0000021.網(wǎng)口連接異常

屬網(wǎng)絡(luò)狀2.網(wǎng)絡(luò)正常設(shè)備當(dāng)前網(wǎng)絡(luò)

networkStataenum-讀寫(xiě)必選

性態(tài)3.平臺(tái)連接正常狀態(tài)

4.平臺(tái)連接異常

設(shè)備長(zhǎng)度：32位唯一值，每一個(gè)

屬

id編devIDstring-讀寫(xiě)允許空字符串，不允許機(jī)電設(shè)備都有必選

性

碼NULL唯一id編碼

每一個(gè)控制器

控制器長(zhǎng)度：32位

屬都有唯一id編

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

性碼，需要填寫(xiě)當(dāng)

碼NULL

前接的控制器

.3運(yùn)行狀態(tài)

機(jī)電設(shè)備運(yùn)行狀態(tài)包括但不限于：CPU占有率、片內(nèi)內(nèi)存占有率、片外內(nèi)存占有率、啟動(dòng)至今CPU

（tick）周期總數(shù)、CPU核心工作溫度等基礎(chǔ)信息。與業(yè)務(wù)相關(guān)的信息包括但不限于設(shè)備類(lèi)型、設(shè)備當(dāng)

前業(yè)務(wù)狀態(tài)、當(dāng)前故障狀態(tài)反饋、當(dāng)前設(shè)備采集的數(shù)值。交互式控制器運(yùn)行狀態(tài)見(jiàn)表4，車(chē)道指示器運(yùn)

行狀態(tài)見(jiàn)表5，交通信號(hào)燈運(yùn)行狀態(tài)見(jiàn)表5，橫洞卷簾門(mén)運(yùn)行狀態(tài)見(jiàn)表6，風(fēng)機(jī)運(yùn)行狀態(tài)見(jiàn)表7，風(fēng)速風(fēng)向

檢測(cè)器運(yùn)行狀態(tài)見(jiàn)表8，CO/VI檢測(cè)器運(yùn)行狀態(tài)見(jiàn)表9，洞內(nèi)照度檢測(cè)器運(yùn)行狀態(tài)見(jiàn)表10，洞外亮度檢測(cè)

器運(yùn)行狀態(tài)見(jiàn)表11。

表4交互式控制器運(yùn)行狀態(tài)

物模型設(shè)備類(lèi)讀寫(xiě)是否

標(biāo)識(shí)符名稱(chēng)數(shù)據(jù)類(lèi)型單位解析示例數(shù)據(jù)說(shuō)明

ID類(lèi)型型類(lèi)型必選

范圍：1～1000

交互步長(zhǎng)：10設(shè)備當(dāng)前

屬

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

性

制器示例：率值

300/10=30%

6

T/ITS0229—XXXX

表4交互式控制器運(yùn)行狀態(tài)（續(xù)）

設(shè)讀

物模型備類(lèi)數(shù)據(jù)單寫(xiě)是否

標(biāo)識(shí)符名稱(chēng)解析示例數(shù)據(jù)說(shuō)明

ID類(lèi)型類(lèi)型位類(lèi)必選

型型

范圍：1～1000設(shè)備當(dāng)

屬memoryUsaint3步長(zhǎng)：10前內(nèi)存

內(nèi)存占有率%讀必選

性ge2初始值:300占有率

示例：300/10=30%值

CPU

啟動(dòng)至今CPU

屬int3范圍：1～int32+（tick

tick（tick）周期次讀可選

性2步長(zhǎng)：1）周期

總數(shù)

總數(shù)值

CPU核

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

cpuTemp℃讀心工作可選

性溫度2步長(zhǎng)：1

溫度值

操作系

屬stri

OSVersionOS版本-讀建議參考xxx.xxx.xxx統(tǒng)版本必選

性ng

號(hào)

應(yīng)用程

屬AppVersiostri

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

性nng

號(hào)

屬stri本機(jī)的

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

性ngIP地址

范圍：1～1000

設(shè)備當(dāng)

步長(zhǎng)：10

屬storageUsint3前存儲(chǔ)

交存儲(chǔ)占有率%讀初始值:300必選

性age2占有率

互示例：

式值

000003300/10=30%

控000000：一切正常

制各種告警

器100001：CPU使用率超過(guò)90%

100002：內(nèi)存使用率超過(guò)90%

100003：存儲(chǔ)空間不足5%

100004：OTA下載失敗故障狀

屬stri100005：OTA升級(jí)失敗態(tài)碼可

faultCode故障狀態(tài)碼-讀必選

性ng100006：應(yīng)用下載失敗動(dòng)態(tài)擴(kuò)

100007：應(yīng)用安裝失敗展

100008：以太網(wǎng)通信連接失敗

100009：藍(lán)牙通信數(shù)據(jù)傳輸失

敗

100010：WIFI通信數(shù)據(jù)傳輸

失敗

Mb設(shè)備當(dāng)

屬totalStorint3

存儲(chǔ)大小yt讀步長(zhǎng)：1前存儲(chǔ)可選

性age2

e大小

Kb設(shè)備當(dāng)

屬totalMemoint3可選

內(nèi)存大小yt讀步長(zhǎng)：1前內(nèi)存

性ry2必選

e大小

7

T/ITS0229—XXXX

表5車(chē)道指示器運(yùn)行狀態(tài)

設(shè)讀

物模型備類(lèi)單寫(xiě)是否

標(biāo)識(shí)符名稱(chēng)數(shù)據(jù)類(lèi)型解析示例數(shù)據(jù)說(shuō)明

ID類(lèi)型位類(lèi)必選

型型

不允許為空

第一位是正面，第二

位是反面：

0：滅

1：綠箭

屬燈狀讀2：紅叉

liRunStatusenum-燈狀態(tài)數(shù)據(jù)必選

性態(tài)寫(xiě)3：橫向

F：異常

00：全滅，12：正綠

車(chē)

反紅，21：正紅反綠，

道

22：正紅反紅，F(xiàn)F：

000005指

異常

示

器date

最后字符串類(lèi)型表達(dá)時(shí)

屬（string毫讀最后更新時(shí)

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

性類(lèi)型UTC秒寫(xiě)間

時(shí)間或空字符串

毫秒）

不允許為空

屬設(shè)備讀00=在線(xiàn)當(dāng)前設(shè)備狀

devStatusenum-必選

性狀態(tài)寫(xiě)01=離線(xiàn)態(tài)

02=故障

表6交通信號(hào)燈運(yùn)行狀態(tài)

設(shè)

物模型備類(lèi)單讀寫(xiě)是否必

標(biāo)識(shí)符名稱(chēng)數(shù)據(jù)類(lèi)型解析示例數(shù)據(jù)說(shuō)明

ID類(lèi)型位類(lèi)型選

型

不允許為空

1=紅燈

屬運(yùn)行

tlRunStatusenum-讀寫(xiě)2=綠燈當(dāng)前運(yùn)行狀態(tài)必選

性狀態(tài)

3=黃燈

4=左轉(zhuǎn)

交

date字符串類(lèi)型表

通最后

屬（string毫達(dá)時(shí)間，不允許

000005信time更新讀寫(xiě)最后更新時(shí)間必選

性類(lèi)型UTC秒為NULL或空

號(hào)時(shí)間

毫秒）字符串

燈

不允許為空

屬設(shè)備00=在線(xiàn)

devStatusenum-讀寫(xiě)當(dāng)前設(shè)備狀態(tài)必選

性狀態(tài)01=離線(xiàn)

02=故障

8

T/ITS0229—XXXX

表7橫洞卷簾門(mén)運(yùn)行狀態(tài)

設(shè)讀

物模型備類(lèi)單寫(xiě)是否必

標(biāo)識(shí)符名稱(chēng)數(shù)據(jù)類(lèi)型解析示例數(shù)據(jù)說(shuō)明

ID類(lèi)型位類(lèi)選

型型

不允許為空

屬運(yùn)行讀

rdRunStatusenum-1=打開(kāi)當(dāng)前運(yùn)行狀態(tài)必選

性狀態(tài)寫(xiě)

2=關(guān)閉

橫

date字符串類(lèi)型表

洞最后

屬（string毫讀達(dá)時(shí)間，不允

000006卷time更新最后更新時(shí)間必選

性類(lèi)型UTC秒寫(xiě)許為NULL或

簾時(shí)間

毫秒）空字符串

門(mén)

不允許為空

屬設(shè)備讀00=在線(xiàn)

devStatusenum-當(dāng)前設(shè)備狀態(tài)必選

性狀態(tài)寫(xiě)01=離線(xiàn)

02=故障

表8風(fēng)機(jī)運(yùn)行狀態(tài)

設(shè)讀

物模型備類(lèi)單寫(xiě)解析示例數(shù)是否必