《數(shù)據(jù)中心節(jié)能控制可視化平臺技術(shù)要求》

ICS35.240

CCSL70/84

GDEA

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

T/GDEA004—2023

數(shù)據(jù)中心節(jié)能控制可視化平臺技術(shù)要求

Technicalrequirementsforenergy-savingcontrolvisualizationplatformofdatacenter

（征求意見稿）

（本草案完成時間：2023-9-19）

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

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

廣東省能源協(xié)會??發(fā)布

T/GDEA004—2023

數(shù)據(jù)中心節(jié)能控制可視化平臺技術(shù)要求

1范圍

本文件規(guī)定了數(shù)據(jù)中心節(jié)能控制可視化平臺的術(shù)語和定義、節(jié)能控制可視化平臺、數(shù)據(jù)交換和數(shù)據(jù)

格式。

本文件適用于數(shù)據(jù)中心節(jié)能控制可視化平臺的設(shè)計、實施與運行維護。

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

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

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

文件。

GB/T7027信息分類和編碼的基本原則與方法

GB/T10113分類與編碼通用術(shù)語

3術(shù)語和定義

GB/T7027、GB/T10113界定的以及下列術(shù)語和定義適用于本文件。

3.1

數(shù)據(jù)中心監(jiān)控系統(tǒng)datecentermonitoringsystem；DCMS

對數(shù)據(jù)中心機房電源、空調(diào)及環(huán)境等基礎(chǔ)設(shè)施進行數(shù)據(jù)采集及集中監(jiān)控的系統(tǒng)。

3.2

節(jié)能控制可視化平臺energy-savingcontrolvisualizationplatform

以可視化方式呈現(xiàn)節(jié)能數(shù)據(jù)、環(huán)境運行狀態(tài)和節(jié)能控制的操作環(huán)境。

3.3

監(jiān)控中心supervisioncenter；SC

為數(shù)據(jù)中心機房電源、空調(diào)及環(huán)境等基礎(chǔ)設(shè)施進行數(shù)據(jù)采集、集中監(jiān)控的管理中心。

3.4

監(jiān)控單元supervisionunit；SU

為數(shù)據(jù)中心機房電源、空調(diào)及環(huán)境等基礎(chǔ)設(shè)施進行數(shù)據(jù)采集、集中監(jiān)控的現(xiàn)場設(shè)備單元。

3.5

監(jiān)控對象supervisionobject；SO

被監(jiān)控的機房電源、空調(diào)及環(huán)境等基礎(chǔ)設(shè)施。

3.6

人工智能artificialintelligence；AI

模擬、延伸和擴展人的智能理論、方法、技術(shù)及應(yīng)用系統(tǒng)的一門新技術(shù)。

3.7

可視化visualization

利用計算機圖形學(xué)和圖像處理技術(shù)，將業(yè)務(wù)數(shù)據(jù)進行整合呈現(xiàn)、交互的方法和技術(shù)。

1

T/GDEA004—2023

4節(jié)能控制可視化平臺

4.1概述

數(shù)據(jù)中心節(jié)能控制可視化平臺，以數(shù)據(jù)中心監(jiān)控系統(tǒng)DCMS和人工智能AI技術(shù)為基礎(chǔ)，對節(jié)能控制

業(yè)務(wù)數(shù)據(jù)進行整合，呈現(xiàn)節(jié)能控制策略和控制效果。

節(jié)能控制可視化平臺作為數(shù)據(jù)中心監(jiān)控系統(tǒng)DCMS的一個模塊運行，從監(jiān)控系統(tǒng)獲取運行狀態(tài)數(shù)據(jù)

并通過監(jiān)控系統(tǒng)下發(fā)節(jié)能控制指令，并以可視化技術(shù)進行顯示。

4.2技術(shù)路線要求

數(shù)據(jù)中心節(jié)能控制可視化平臺應(yīng)采用先進的技術(shù)路線，符合IT行業(yè)的發(fā)展趨勢，并遵循以下原則

和要求：

a)系統(tǒng)采用開源操作系統(tǒng)和數(shù)據(jù)庫。操作系統(tǒng)宜采用Linux平臺，禁用Windows操作系統(tǒng)；

b)數(shù)據(jù)庫應(yīng)結(jié)合管理的數(shù)據(jù)類型選擇合適的開源數(shù)據(jù)庫，應(yīng)考慮與后續(xù)國產(chǎn)數(shù)據(jù)庫的兼容；

c)業(yè)務(wù)應(yīng)用應(yīng)支持Docker容器運行，簡化應(yīng)用的構(gòu)建、部署和運行過程；

d)數(shù)據(jù)中心監(jiān)控系統(tǒng)DCMS應(yīng)支持物理機、虛機和云平臺PaaS服務(wù)部署。

4.3平臺架構(gòu)

4.3.1平臺硬件架構(gòu)

平臺硬件架構(gòu)采用兩級架構(gòu)，由節(jié)能控制可視化平臺級、監(jiān)控單元級組成。平臺為節(jié)能業(yè)務(wù)管理中

心，實現(xiàn)節(jié)能業(yè)務(wù)的監(jiān)控、告警、節(jié)能控制、可視化展示和報表統(tǒng)計等業(yè)務(wù)，由數(shù)據(jù)庫服務(wù)器、監(jiān)控業(yè)

務(wù)應(yīng)用服務(wù)器、AI業(yè)務(wù)應(yīng)用服務(wù)器和客戶端組成，節(jié)能控制可視化平臺屬于監(jiān)控中心的一個業(yè)務(wù)模塊，

與監(jiān)控單元（場地采集器）交互獲取數(shù)據(jù)、訓(xùn)練學(xué)習(xí)和發(fā)送控制命令，節(jié)能控制可視化平臺部署于AI

業(yè)務(wù)應(yīng)用服務(wù)器。數(shù)據(jù)中心場地部署監(jiān)控單元SU，實現(xiàn)數(shù)據(jù)中心動力設(shè)備和環(huán)境數(shù)據(jù)的采集和控制。

系統(tǒng)硬件架構(gòu)如圖1所示。

圖1監(jiān)控系統(tǒng)硬件架構(gòu)

2

T/GDEA004—2023

4.3.2節(jié)能控制業(yè)務(wù)平臺軟件架構(gòu)

節(jié)能控制業(yè)務(wù)作為監(jiān)控系統(tǒng)業(yè)務(wù)模塊，可充分利用監(jiān)控系統(tǒng)的采集和控制功能，借助AI技術(shù)對與

節(jié)能控制業(yè)務(wù)相關(guān)的AI資源管理、安全管理、AI模型管理進行優(yōu)化處理，借助HTTP協(xié)議通信、API

接口規(guī)范接入數(shù)據(jù)采控系統(tǒng)，通過AI可視化數(shù)據(jù)接口共享平臺的可視化能力，實現(xiàn)節(jié)能控制業(yè)務(wù)與AI

技術(shù)的深度融合。節(jié)能控制業(yè)務(wù)平臺軟件架構(gòu)如圖2所示。

圖2節(jié)能控制業(yè)務(wù)架構(gòu)

4.4平臺功能

4.4.1概述

數(shù)據(jù)中心節(jié)能控制業(yè)務(wù)基于大數(shù)據(jù)、機器學(xué)習(xí)等AI人工智能前沿技術(shù)，充分利用機房現(xiàn)有條件進

行能耗優(yōu)化控制，而不是使用工程手段改變機房現(xiàn)有基礎(chǔ)設(shè)施狀況的方式進行節(jié)能，如空調(diào)設(shè)備改造、

改變機房內(nèi)地板送風(fēng)開度、加裝機柜盲板等。

節(jié)能控制可視化平臺包括可視化、共享零代碼組態(tài)和3D數(shù)字化工具、AI資源管理、安全管理、AI

模型管理和數(shù)據(jù)處理部分等子模塊。

4.4.2可視化

平臺應(yīng)采用2D和3D可視化工具整合節(jié)能控制業(yè)務(wù)數(shù)據(jù)，呈現(xiàn)節(jié)能業(yè)務(wù)的物理位置和邏輯運行關(guān)系

與效果，以2D和3D可視化工具通過組態(tài)配置實現(xiàn)節(jié)能控制業(yè)務(wù)可視化。

可視化子模塊包括樓宇3D可視化、能源KPI數(shù)據(jù)、節(jié)能展示數(shù)據(jù)、溫度云圖和空調(diào)運行展示。樓

宇及維度云圖宜采用3D可視化方式展示，為保障溫度云圖展示效果，溫度采樣時每機柜前后應(yīng)各配置

3個溫度檢測點，溫度檢測應(yīng)采用無線采樣方案。

能源KPI數(shù)據(jù)、節(jié)能展示數(shù)據(jù)和空調(diào)運行狀態(tài)等業(yè)務(wù)宜采用2D組態(tài)方式展示，組態(tài)內(nèi)容可根據(jù)需

要靈活配置調(diào)整。節(jié)能展示數(shù)據(jù)主要呈現(xiàn)節(jié)電率數(shù)據(jù)，以月為單位進行刷新。

4.4.3零代碼和3D數(shù)字化工具

3

T/GDEA004—2023

零代碼狀態(tài)和3D數(shù)字化工具屬于監(jiān)控系統(tǒng)的頁面呈現(xiàn)配置工具，支持監(jiān)控業(yè)務(wù)及AI節(jié)能控制業(yè)務(wù)

的可視化展示。零代碼狀態(tài)和3D數(shù)字化工具應(yīng)支持基礎(chǔ)設(shè)施物理位置和邏輯連接兩個維度的組態(tài)配置。

零代碼狀態(tài)和3D數(shù)字化工具應(yīng)具備豐富的組件，并支持組件的編輯。

4.4.4AI資源管理

AI資源管理具體包括機樓管理、機房管理、設(shè)備管理、信號管理等內(nèi)容。

AI資源管理提供與AI相關(guān)的機樓、機房、設(shè)備、信號和邏輯變量等參數(shù)內(nèi)容的增刪編輯功能，明

確機樓、機房、設(shè)備、信號、邏輯變量等內(nèi)容的從屬關(guān)系和物理屬性。

4.4.5安全管理

AI節(jié)能控制不能影響機房的運行安全，安全管理業(yè)務(wù)應(yīng)支持以下機制：

a)制冷量冗余：節(jié)能系統(tǒng)輸出的節(jié)能策略，應(yīng)保證制冷設(shè)備的制冷量存在安全冗余；

b)策略回退：制冷設(shè)備的節(jié)能策略執(zhí)行后，用戶可以根據(jù)需要回退到執(zhí)行前的策略狀態(tài)；

c)指標(biāo)超限告警：節(jié)能系統(tǒng)運行過程中，應(yīng)支持機房溫濕度及設(shè)備運行狀態(tài)方面的異常提醒；

d)策略安全機制：節(jié)能算法生成的調(diào)控策略，應(yīng)當(dāng)從邏輯設(shè)計層面考慮對數(shù)據(jù)的容錯處理機制，

以及對空調(diào)控制的保護，確保策略執(zhí)行的安全；

e)異常保護機制：節(jié)能系統(tǒng)在出現(xiàn)服務(wù)異常、網(wǎng)絡(luò)中斷、高溫及設(shè)備運行異常狀況時，能夠通

過高可用機制對末端空調(diào)施加應(yīng)急策略來保障機房環(huán)境安全；

f)數(shù)據(jù)備份：可對節(jié)能系統(tǒng)內(nèi)的靜態(tài)數(shù)據(jù)（如站點、設(shè)備、信號點位）、性能數(shù)據(jù)（如電表、

溫濕度、空調(diào)工況）以及策略執(zhí)行記錄等數(shù)據(jù)進行定期自動備份。

4.4.6AI模型管理

AI模型管理包括AI數(shù)據(jù)管理、狀態(tài)模型管理、控制模型管理、獎勵模型、策略模型管理等，采用

AI強化學(xué)習(xí)算法，令智能體（節(jié)能軟件）與環(huán)境不斷交互，獲取狀態(tài)信息，發(fā)出控制指令，依據(jù)當(dāng)前

動作帶來的獎勵或懲罰狀況來優(yōu)化節(jié)能控制策略，盡可能多地從環(huán)境中獲取獎勵或者少懲罰，從而實現(xiàn)

對當(dāng)前環(huán)境的最佳控制。

AI數(shù)據(jù)管理記錄AI強化學(xué)習(xí)訓(xùn)練所需要的學(xué)習(xí)數(shù)據(jù)。AI強化學(xué)習(xí)包括狀態(tài)、行動和獎勵機制三方

面的要素，分別用狀態(tài)模型、控制模型和獎勵模型來管理。

狀態(tài)模型管理對AI強化學(xué)習(xí)涉及的設(shè)施、環(huán)境狀態(tài)信息進行配置，設(shè)施、環(huán)境狀態(tài)信息主要包括

但不限于以下狀態(tài)參數(shù)：

a)空調(diào)啟停狀態(tài)；

b)風(fēng)機啟停狀態(tài)；

c)風(fēng)機實時轉(zhuǎn)速；

d)進出風(fēng)溫度；

e)壓縮機啟停狀態(tài)；

f)壓縮機工作頻率；

g)電壓、電流、有功功率、電能。

控制模型管理對AI強化學(xué)習(xí)所涉及的控制動作進行配置，控制動作主要包括但不限于以下控制參

數(shù)：

a)空調(diào)啟停；

b)風(fēng)機啟停（定頻、變頻）；

4

T/GDEA004—2023

c)進/出風(fēng)溫度設(shè)定；

d)風(fēng)機最小轉(zhuǎn)速設(shè)定（變頻）；

e)風(fēng)機額定轉(zhuǎn)速設(shè)定（變頻）；

f)壓縮機啟停（定頻、變頻）；

g)壓縮機最小負荷設(shè)定（變頻）；

h)壓縮機最大負荷設(shè)定（變頻）。

獎勵模型管理對AI節(jié)能控制的目標(biāo)進行配置，主要為PUE（PowerUsageEffectiveness）最大化

和熱點控制。

策略模型管理對AI在學(xué)習(xí)過程中陸續(xù)建立的AI節(jié)能策略進行管理，包括網(wǎng)絡(luò)模型和訓(xùn)練參數(shù)兩部

分。AI節(jié)能策略指經(jīng)過數(shù)據(jù)采集和AI分析后，得出的有針對性的空調(diào)設(shè)備調(diào)整、優(yōu)化策略，應(yīng)符合下

列要求：

a)節(jié)能系統(tǒng)能夠基于算法模型處理實時數(shù)據(jù)，輸出節(jié)能控制指令并自動下發(fā)到被控設(shè)備；

b)記錄節(jié)能策略歷史信息，包括節(jié)能策略的具體動作、控制對象、觸發(fā)時間、是否成功等，支

持指定操作對象和目標(biāo)參數(shù)手動觸發(fā)節(jié)能策略；

c)自動保存被控空調(diào)設(shè)備的歷史運行參數(shù)，在節(jié)能策略執(zhí)行后可以進行回退；

d)支持以機房維度啟用/停用節(jié)能策略，啟用時可自動生成該機房的策略并自動控制設(shè)備。

4.4.7AI數(shù)據(jù)處理

數(shù)據(jù)處理通過采集器接口和系統(tǒng)級接口獲取AI模型所需要的狀態(tài)、控制和獎勵參數(shù)，并對參數(shù)進

行正則化處理，輸出給AI數(shù)據(jù)模型管理。

4.4.8AI運行及節(jié)能評估

為保障機房運行安全，AI訓(xùn)練應(yīng)先在仿真環(huán)境下進行，訓(xùn)練到一定程度后才允許部署到涉及環(huán)境。

AI節(jié)能效果的評估通過空調(diào)節(jié)電率來評判，節(jié)電率計算如式(1)所示：

空調(diào)節(jié)電率······································(1)

式中：=(?0??1)/?0×100%

T0——未實施節(jié)能時間周期空調(diào)總耗電量，kW·h；

T1——實施節(jié)能時間周期空調(diào)總耗電量，kW·h。

注：TO和T1時間周期折算到單月進行節(jié)電比較。

5數(shù)據(jù)交換

5.1數(shù)據(jù)交換框架

節(jié)能控制可視化平臺通過API接口與節(jié)能控制后臺進行數(shù)據(jù)交互，實現(xiàn)節(jié)能控制業(yè)務(wù)的可視化展示。

如圖3所示。

5

T/GDEA004—2023

圖3可視化數(shù)據(jù)交換框架

5.2數(shù)據(jù)交換要求

可視化模塊與AI節(jié)能控制業(yè)務(wù)管理之間通過HTTP協(xié)議通信，API接口規(guī)范采用RESTful方式實施。

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

6.1通信格式

6.1.1參數(shù)請求

參數(shù)請求的數(shù)據(jù)格式和響應(yīng)數(shù)據(jù)格式為JSON，編碼統(tǒng)一為UTF-8，使用POST/GET/PUT方式進行數(shù)

據(jù)格式請求，如表1所示。

表1參數(shù)請求方式

請求方式說明

POST新建、提交數(shù)據(jù)時使用

GET查詢及批量查詢時使用

PUT修改及更新操作時候使用

6.1.2獲取令牌

獲取accessToken令牌，使用POST的請求方式，如表2所示。

表2獲取令牌接口請求樣例

用戶認證采用OAuth2方式，通過獲取accessToken，訪問其他接口，

接口功能描述

請求頭部需攜帶Authorization屬性，內(nèi)容為Bearer+accessToken

請求路徑POST/api/tokens

參數(shù)是否必傳類型描述

請求參數(shù)accessKey是String訪問憑證

accessSecret是String訪問密碼

{

請求樣例“accessKey”:“admin”,

“accessSecret”:”123456”

}

6

T/GDEA004—2023

表2獲取令牌接口請求樣例(續(xù))

用戶認證采用OAuth2方式，通過獲取accessToken，訪問其他接口，

接口功能描述

請求頭部需攜帶Authorization屬性，內(nèi)容為Bearer+accessToken

參數(shù)類型描述

idString-

accessTokenString-

響應(yīng)參數(shù)

refreshTokenString-

expiresInString-

ownerString-

{

“id”:“952365241336”,

“accessToken”:”72c17f9e-7b19-4625-b121-807947dbc99f”,

響應(yīng)樣例

“refreshToken”:“66c17f9e-7b19-4625-b121-807947dbcffff”

“expiresIn”:”1654740316090”,

“owner”:”admin”

}

6.1.3請求報文結(jié)構(gòu)

通過獲取令牌接口獲得授權(quán)令牌，在http請求中需要在請求頭部攜帶Authorization信息，如表

3所示。

表3請求頭授權(quán)認證

屬性類型示例說明

AuthorizationStringBeareraccessToken授權(quán)令牌

6.1.4響應(yīng)狀態(tài)

HTTP狀態(tài)碼請求成功返回的狀態(tài)碼信息，如表4所示。

表4請求成功狀態(tài)碼

請求方式狀態(tài)碼返回結(jié)果

GET200Json對象

POST201創(chuàng)建成功對象

PUT200更新成功對象

6.1.5異常響應(yīng)

根據(jù)HTTP狀態(tài)判斷異常響應(yīng)，如表5所示。

表5請求失敗狀態(tài)碼

狀態(tài)碼解釋場景

400BadRequest參數(shù)問題

401Unauthorized未登錄，token問題

403Forbidden無權(quán)限

404NotFound資源不存在

500InternalServerError服務(wù)器內(nèi)部錯誤

503Unavailable應(yīng)用容器異常

7

T/GDEA004—2023

6.2資源管理數(shù)據(jù)格式

6.2.1機房層級結(jié)構(gòu)

可視化模塊與AI節(jié)能控制業(yè)務(wù)管理機房層級結(jié)構(gòu)API接口樣例，使用GET的請求方式，如表6所

示。

表6可視化模塊與AI節(jié)能控制業(yè)務(wù)管理機房層級結(jié)構(gòu)API接口樣例

接口功能描述獲取所有層級對象

請求路徑GET/api/resourcestructures

參數(shù)是否必傳類型描述

請求參數(shù)

----

請求樣例-

參數(shù)類型描述

stateboolean-

timestampinteger(int64)-

dataobject-

+resourceStructureIdinteger-

+sceneIdinteger-

+structureTypeIdinteger-

+resourceStructureNamestring-

響應(yīng)參數(shù)+parentResourceStructureIdinteger-

+photo--

+position--

+levelOfPathstring-

+displayboolean-

+sortValueinteger-

+extendedFieldstring-

+originIdinteger-

+originParentIdinteger-

接口功能描述獲取所有層級對象

參數(shù)類型描述

+childrenarray-

響應(yīng)參數(shù)

err_codestring-

err_msgstring-

8

T/GDEA004—2023

表6可視化模塊與AI節(jié)能控制業(yè)務(wù)管理機房層級結(jié)構(gòu)API接口樣例(續(xù))

{

"state":true,

"timestamp":1673492857435,

"data":[

{

"resourceStructureId":22000052,

"sceneId":1,

"structureTypeId":5,

"resourceStructureName":"B101",

"parentResourceStructureId":22000003,

"photo":null,

"position":null,

"levelOfPath":"22000001.22000002.22000003.22000052",

"display":true,

"sortValue":0,

"extendedField":null,

"originId":null,

"originParentId":null,

"children":[]

響應(yīng)樣例},

{

"resourceStructureId":22000053,

"sceneId":1,

"structureTypeId":5,

"resourceStructureName":"B102",

"parentResourceStructureId":22000003,

"photo":null,

"position":null,

"levelOfPath":"22000001.22000002.22000003.22000053",

"display":true,

"sortValue":0,

"extendedField":null,

"originId":null,

"originParentId":null,

"children":[]

}],

"err_msg":null,

"err_code":"0"

}

6.2.2設(shè)備對象層級結(jié)構(gòu)

可視化模塊與AI節(jié)能控制業(yè)務(wù)管理設(shè)備對象層級結(jié)構(gòu)API接口樣例，使用GET的請求方式，如表

7所示。

9

T/GDEA004—2023

表7可視化模塊與AI節(jié)能控制業(yè)務(wù)管理設(shè)備對象層級結(jié)構(gòu)API接口樣例

接口功能描述獲取所有設(shè)備對象

請求路徑GET/api/equipmentdtos

參數(shù)是否必傳類型描述

eqCategory否integer(int32)設(shè)備類別

請求參數(shù)

eqName否string設(shè)備名

RId否integer(int32)-

請求樣例-

參數(shù)類型描述

stateboolean-

timestampinteger(int64)-

dataobject-

+eqIdinteger-

+eqNamestring-

+eqCategoryinteger-

響應(yīng)參數(shù)

+alarmState--

+displayIndexinteger-

+onlineStatestring-

+maskedinteger-

+sidinteger-

err_codestring-

err_msgstring-

{

"state":true,

"timestamp":1673492857435,

"data":[

{

"eqId":22004047,

"eqName":"中壓配電間A-A2H7(出線柜)",

"eqCategory":101,

"alarmState":null,

"displayIndex":0,

"onlineState":"ONLINE",

"masked":null,

"sid":22000002

響應(yīng)樣例},

{

"eqId":22004046,

"eqName":"中壓配電間A-A2H6(出線柜)",

"eqCategory":101,

"alarmState":null,

"displayIndex":0,

"onlineState":"ONLINE",

"masked":null,

"sid":22000002

}],

"err_msg":null,

"err_code":"0"

}

6.2.3根據(jù)設(shè)備ID獲取設(shè)備對象方式

可視化模塊與AI節(jié)能控制業(yè)務(wù)管理設(shè)備ID獲取設(shè)備對象API接口樣例，使用GET的請求方式，如

表8所示。

10

T/GDEA004—2023

表8可視化模塊與AI節(jié)能控制業(yè)務(wù)管理設(shè)備ID獲取設(shè)備對象API接口樣例

接口功能描述根據(jù)設(shè)備id獲取信號對象

請求路徑GET/api/cfgsignals

參數(shù)是否必傳類型描述

請求參數(shù)

equipmentId是string設(shè)備id

請求樣例equipmentId=2200001

參數(shù)類型描述

stateboolean-

timestampinteger(int64)-

dataobject-

+equipmentTemplateIdinteger-

+signalIdinteger-

+signalCategoryinteger-

+signalNamestring-

+unitstring-

+baseTypeIdinteger-

+displayIndexinteger-

響應(yīng)參數(shù)+showPrecisionstring-

+visibleboolean-

+meaningsListarray-

++idinteger-

++equipmentTemplateIdinteger-

++signalIdinteger-

++stateValueinteger-

++meaningsstring-

++baseCondIdinteger-

+propertiesstring-

err_codestring-

err_msgstring-

{

"state":true,

"timestamp":1673492857435,

"data":[

{

"equipmentTemplateId":22000371,

"signalId":120000010,

"signalCategory":2,

"signalName":"斷路器開關(guān)狀態(tài)",

"unit":"",

"baseTypeId":101156001,

"displayIndex":1,

"showPrecision":"0",

響應(yīng)樣例

"visible":true,

"meaningsList":[

{

"id":110023,

"equipmentTemplateId":22000371,

"signalId":120000010,

"stateValue":0,

"meanings":"分閘",

"baseCondId":null

},

{

"id":110024,

"equipmentTemplateId":22000371,

11

T/GDEA004—2023

表8可視化模塊與AI節(jié)能控制業(yè)務(wù)管理設(shè)備ID獲取設(shè)備對象API接口樣例(續(xù))

"signalId":120000010,

"stateValue":1,

"meanings":"合閘",

"baseCondId":null

}

],

"properties":"27"

},

{

"equipmentTemplateId":22000371,

"signalId":120000020,

"signalCategory":2,

"signalName":"手車工作位置",

"unit":"",

"baseTypeId":101161001,

"displayIndex":2,

"showPrecision":"0",

"visible":true,

"meaningsList":[

{

響應(yīng)樣例"id":100368,

"equipmentTemplateId":22000371,

"signalId":120000020,

"stateValue":0,

"meanings":"試驗位",

"baseCondId":null

},

{

"id":100369,

"equipmentTemplateId":22000371,

"signalId":120000020,

"stateValue":1,

"meanings":"工作位",

"baseCondId":null

}

],

"properties":"27"

},],

"err_msg":null,

"err_code":"0"

}

6.32D可視化數(shù)據(jù)結(jié)構(gòu)

可視化模塊與AI節(jié)能控制業(yè)務(wù)管理2D溫場實時數(shù)據(jù)API接口樣例，使用POST的請求方式，如表

9所示。

12

T/GDEA004—2023

表9可視化模塊與AI節(jié)能控制業(yè)務(wù)管理2D溫場實時數(shù)據(jù)API接口樣例

接口功能描述根據(jù)設(shè)備ID，信號ID列表獲取實時信號

請求路徑POST/api/equipmentactivesignalsbysignalids

參數(shù)是否必傳類型描述

equipmentId否Int設(shè)備id

請求參數(shù)

需要查詢具體設(shè)備的信號的

signalIds否Array

id(null查所有)

[

{

請求樣例"equipmentId":22000170,

"signalIds":[120000301,120000311]

}

]

參數(shù)類型描述

dataobject-

err_codeString-

響應(yīng)參數(shù)

err_msg