融合終端微應(yīng)用開發(fā)設(shè)計(jì)規(guī)范

營(yíng)配融合終端

微應(yīng)用開發(fā)設(shè)計(jì)規(guī)范

一、總體框架

1.1總體原則

營(yíng)配融合終端微應(yīng)用總體架構(gòu)設(shè)計(jì)遵循三個(gè)基本原則：一是微應(yīng)

用之間交互完全基于消息機(jī)制，達(dá)到數(shù)據(jù)交互解耦，避免私有交互造成

的管理復(fù)雜性；二是數(shù)據(jù)集中管理原則，避免各微應(yīng)用建立私有數(shù)據(jù)庫(kù)

進(jìn)行數(shù)據(jù)存儲(chǔ)與使用；三是微應(yīng)用開發(fā)統(tǒng)一預(yù)留接口，保證互通互用。

從微應(yīng)用開發(fā)管理角度，按照微應(yīng)用使用數(shù)據(jù)、硬件接口的需求分

析，微應(yīng)用分為四個(gè)主要類型：

基礎(chǔ)管理：通信規(guī)約、數(shù)據(jù)庫(kù)、配置文件等

采集監(jiān)測(cè)：配變交采、低壓分路采集監(jiān)測(cè)、分支監(jiān)測(cè)與用戶端監(jiān)測(cè)、

環(huán)境監(jiān)測(cè)等

運(yùn)維管理：低壓拓?fù)鋭?dòng)態(tài)識(shí)別、低壓故障定位、無功自動(dòng)調(diào)節(jié)、低

壓分路分段線損分析、營(yíng)配融合終端狀態(tài)管理等

用戶服務(wù)：配變負(fù)荷預(yù)測(cè)、臺(tái)區(qū)及用戶供電可靠性計(jì)算、低壓分布

式電源即插即用等

1.2總體架構(gòu)

微應(yīng)用總體流程圖

總體架構(gòu)分析5個(gè)主要部分：

(1)基礎(chǔ)平臺(tái)部分，包含硬件通訊接口及驅(qū)動(dòng)、基礎(chǔ)操作系統(tǒng)、后

期增加的AI芯片及訪問接口等系統(tǒng)級(jí)模塊。

(2)資源虛擬化部分，主要由分配硬件資源的管理容器組成，對(duì)容

器實(shí)現(xiàn)mqtt消息接口與硬件接口訪問。

(3)微應(yīng)用部分，運(yùn)行于容器內(nèi)部，通過配電自動(dòng)化主站進(jìn)行部署

下發(fā)與運(yùn)行監(jiān)控。

(4)數(shù)據(jù)交互總線部分，基于容器間IP化技術(shù)與MQTT協(xié)議，實(shí)現(xiàn)

跨容器的消息交互。

(5)信息安全部分，可細(xì)分為數(shù)據(jù)采集安全、數(shù)據(jù)存儲(chǔ)安全、數(shù)據(jù)

訪問安全與數(shù)據(jù)上行通訊安全四個(gè)主要部分。

L3消息交互流程

信息交互流程是微應(yīng)用數(shù)據(jù)訪問、采集數(shù)據(jù)存儲(chǔ)、微應(yīng)用間消息交

互的核心部分?；贛QTT協(xié)議，各微應(yīng)用均按照規(guī)則實(shí)現(xiàn)消息接口，

實(shí)現(xiàn)微應(yīng)用間消息訪問松耦合機(jī)制，以監(jiān)測(cè)采集微應(yīng)用與高級(jí)分析類

消息交互流程具體流程如下所示：

消息訂閱機(jī)制流程圖

關(guān)鍵節(jié)點(diǎn)如下：

(1)基于低壓臺(tái)區(qū)統(tǒng)一數(shù)據(jù)模型，定義數(shù)據(jù)采集節(jié)點(diǎn)唯一名稱，同

時(shí)根據(jù)微應(yīng)用發(fā)布需求，也可以定義私有節(jié)點(diǎn)名稱供交互使用。

(2)消息總線提供發(fā)布訂閱主題接口，各微應(yīng)用運(yùn)行啟動(dòng)需先進(jìn)行

發(fā)布、訂閱數(shù)據(jù)主題注冊(cè)，注冊(cè)接口見附件。

(3)對(duì)外提供數(shù)據(jù)的微應(yīng)用，在生成新數(shù)據(jù)后調(diào)用總線消息發(fā)布接

口進(jìn)行數(shù)據(jù)發(fā)布。

(4)消息總結(jié)接收到發(fā)布數(shù)據(jù)后，將數(shù)據(jù)存儲(chǔ)至實(shí)時(shí)數(shù)據(jù)庫(kù)。

消息總線在發(fā)現(xiàn)被訂閱的點(diǎn)數(shù)據(jù)變化后，啟動(dòng)主題推送程序，根據(jù)訂閱

主題信息調(diào)用訂閱方接收接口，推送數(shù)據(jù)。

1.4數(shù)據(jù)存儲(chǔ)架構(gòu)

營(yíng)配融合終端需存儲(chǔ)多類數(shù)據(jù)信息，根據(jù)數(shù)據(jù)來源分為低壓電網(wǎng)

模型臺(tái)賬數(shù)據(jù)、二次設(shè)備定值配置數(shù)據(jù)、電網(wǎng)運(yùn)行數(shù)據(jù)、營(yíng)銷采集數(shù)據(jù)、

分析類微應(yīng)用計(jì)算結(jié)果數(shù)據(jù)等，按照模型統(tǒng)一、本地化自管理的數(shù)據(jù)管

理原則，需建立唯一的數(shù)據(jù)管理及讀寫通道，并建立數(shù)據(jù)庫(kù)自維護(hù)機(jī)制,

以提高數(shù)據(jù)融合與采集的效率，降低管理難度。

數(shù)據(jù)存儲(chǔ)總架構(gòu)如下所示：

數(shù)據(jù)存儲(chǔ)訪問架構(gòu)圖

數(shù)據(jù)存儲(chǔ)總體架構(gòu)由5個(gè)主要部分組成：

(1)發(fā)布訂閱總線：基于MQTT協(xié)議的跨容器消息定與發(fā)布管理微

應(yīng)用，直接對(duì)數(shù)據(jù)中心進(jìn)行讀寫操作，主要功能為在實(shí)時(shí)數(shù)據(jù)庫(kù)值發(fā)生

變化時(shí)，檢索變化值被訂閱方，取得相關(guān)訂閱主題發(fā)布訂閱消息。并實(shí)

時(shí)監(jiān)聽各發(fā)布微應(yīng)用的發(fā)布接口，將發(fā)布數(shù)據(jù)寫入實(shí)時(shí)數(shù)據(jù)庫(kù)。

(2)數(shù)據(jù)庫(kù)管理模塊：數(shù)據(jù)庫(kù)管理模塊主要功能有四項(xiàng)：一是根據(jù)

主站下發(fā)的模型與本臺(tái)區(qū)設(shè)備列表實(shí)例化，初始化實(shí)時(shí)數(shù)據(jù)庫(kù)與歷史

數(shù)據(jù)庫(kù)；二是在設(shè)備臺(tái)賬發(fā)生變化、新微應(yīng)用注冊(cè)新發(fā)布數(shù)據(jù)時(shí)進(jìn)行數(shù)

據(jù)庫(kù)擴(kuò)展；三是根據(jù)發(fā)布數(shù)據(jù)采集頻率屬性，采樣實(shí)時(shí)數(shù)據(jù)至歷史數(shù)據(jù)

庫(kù)；四是在數(shù)據(jù)備份與數(shù)據(jù)庫(kù)超出容量上限后進(jìn)行循環(huán)覆蓋操作。

(3)內(nèi)存數(shù)據(jù)庫(kù)(實(shí)時(shí)數(shù)據(jù)庫(kù))：為避免數(shù)據(jù)快速讀寫造成的終端

壽命問題，建議采用內(nèi)存數(shù)據(jù)庫(kù)進(jìn)行頻繁數(shù)據(jù)讀寫支撐，按照定時(shí)采樣

原則，將數(shù)據(jù)存儲(chǔ)至歷史數(shù)據(jù)庫(kù)。

(4)關(guān)系數(shù)據(jù)庫(kù)(歷史數(shù)據(jù)庫(kù))：關(guān)系數(shù)據(jù)庫(kù)存儲(chǔ)三個(gè)部分內(nèi)容，

一是存儲(chǔ)該低壓臺(tái)區(qū)模型實(shí)例；二是為各微應(yīng)用提供過程數(shù)據(jù)臨時(shí)存

儲(chǔ)；三是進(jìn)行運(yùn)行數(shù)據(jù)采樣存儲(chǔ)。

數(shù)據(jù)訪問總線：基于MQTT定義統(tǒng)一的實(shí)時(shí)、歷史數(shù)據(jù)查詢總線，避免

多微應(yīng)用同時(shí)并聯(lián)造成的資源浪費(fèi)。

二、數(shù)據(jù)中心框架

2.1數(shù)據(jù)分類

電力系統(tǒng)中數(shù)據(jù)可分為遙測(cè)數(shù)據(jù)、遙信數(shù)據(jù)、事件數(shù)據(jù)。

遙測(cè)數(shù)據(jù)由實(shí)時(shí)數(shù)據(jù)和凍結(jié)數(shù)據(jù)組成，分鐘凍結(jié)、小時(shí)凍結(jié)、日凍結(jié)、

月凍結(jié)等都屬于凍結(jié)數(shù)據(jù)，遙測(cè)數(shù)據(jù)類型多樣，多用float,int等類

型表示；

遙信數(shù)據(jù)是一種狀態(tài)，反應(yīng)設(shè)備在某時(shí)間點(diǎn)上狀態(tài)信息，數(shù)據(jù)類型為

bool；

事件數(shù)據(jù)是一種記錄型數(shù)據(jù)，表示某時(shí)間點(diǎn)設(shè)備生的異常狀況，事件

數(shù)據(jù)信息含量大，一般為struct結(jié)構(gòu)體表述。

綜合上述分析，設(shè)備數(shù)據(jù)由數(shù)據(jù)名稱、數(shù)據(jù)值、單位、數(shù)據(jù)類型、

數(shù)據(jù)時(shí)間、凍結(jié)類型幾部分組成，并且定位了設(shè)備的唯一數(shù)據(jù)量。例如:

電能表，A相電壓、220.OV、float數(shù)據(jù)類型、xxxx年xx月xx日xx

分xx秒xx毫秒，曲線凍結(jié)，這樣能夠確認(rèn)數(shù)據(jù)的唯一性；再例如：電

能表，失壓事件、失壓時(shí)的各種狀態(tài)、數(shù)據(jù)類型為struct結(jié)構(gòu)體、產(chǎn)

生時(shí)間XXXX-XX-XXXX：XX：xx^事件記錄。

數(shù)據(jù)中心模型是對(duì)設(shè)備所有遙測(cè)/遙信數(shù)據(jù)名稱、數(shù)據(jù)類型、數(shù)據(jù)單

位的抽象，其中某一數(shù)據(jù)項(xiàng)成為屬性。例如：電能表可以抽象成表模型,

A相電壓、float、V為模型屬性。

2.2設(shè)計(jì)原則

數(shù)據(jù)中心核心功能是數(shù)據(jù)的存儲(chǔ)與管理以及對(duì)外提供標(biāo)準(zhǔn)的調(diào)用

接口。數(shù)據(jù)中心遵循以下原則：

1.在通信接口中屬性數(shù)值全部采用string類型；

2.數(shù)據(jù)按設(shè)備（包括物理設(shè)備、虛擬設(shè)備）分類管理；

3.數(shù)據(jù)按實(shí)時(shí)數(shù)據(jù)、凍結(jié)數(shù)據(jù)、事件、參數(shù)分類管理，每一類

數(shù)據(jù)具有獨(dú)立的、標(biāo)準(zhǔn)的調(diào)用接口；

4.接口中的拓展數(shù)據(jù)或私有數(shù)據(jù)采用自定義格式，并用base64

編碼；

5.數(shù)據(jù)中心接口采用MQTT+JS0N方式。

2.3數(shù)據(jù)管理規(guī)范

數(shù)據(jù)中心從數(shù)據(jù)安全角度考慮，遵循以下安全策略：

1模型屬性具有訪問權(quán)限，根據(jù)權(quán)限可以禁止某些APP訪問；

2實(shí)時(shí)數(shù)據(jù)、參數(shù)數(shù)據(jù)只有數(shù)據(jù)生成者具有數(shù)據(jù)更新權(quán)限；

3歷史數(shù)據(jù)任何APP無權(quán)修改；

4APP可以任意訪問權(quán)限允許的模型屬性；

5參數(shù)具有備份和回滾能力。

三、數(shù)據(jù)存儲(chǔ)規(guī)范

3.1模型屬性命名原則

為了數(shù)據(jù)中心數(shù)據(jù)統(tǒng)一管理，變量應(yīng)具有統(tǒng)一命名標(biāo)識(shí)，屬性命名

參考附件《設(shè)備模型屬性規(guī)范》。

以電壓電流為例，規(guī)定PhV_phsA、PhV_phsB>PhV_phsC為三相電

壓標(biāo)識(shí)，A_phsA、A_phsB、A_phsC、A_neut為三相及零序電流標(biāo)識(shí)，任

意設(shè)備的相同變量使用同一個(gè)標(biāo)識(shí)。

序號(hào)變量名稱描述

1PhV_phsAA相電壓

2PhV_phsBB相電壓

3PhV_phsCC相電壓

4A_phsAA相電流

5A_phsBB相電流

6A_phsCC相電流

7A_neut零序電流

3.2模型命名規(guī)則

選定一類設(shè)備，在變量命名表中選出該類設(shè)備能夠采集的全部變

量，即構(gòu)成了該類設(shè)備的設(shè)備模型表。將設(shè)備模型表初始化為數(shù)據(jù)庫(kù)表,

即實(shí)現(xiàn)了設(shè)備模型到數(shù)據(jù)庫(kù)的映射。

以漏保為例:

IDNameTypeUnit

1PhV_phsAfloatV

2PhV_phsBfloatV

3PhV_phsCfloatV

4A_phsAfloatA

5A_phsBfloatA

6A_phsCfloatA

7ResPhaseintnull

8ResAfloatA

9Timesintnull

10Almboolnull

11PTUV_strValboolV

12PTOV_strValboolV

13ResAlmboolnull

14PTOV_Open_Opboolnull

15PhAlmboolnull

設(shè)備的實(shí)時(shí)數(shù)據(jù)與凍結(jié)數(shù)據(jù)應(yīng)分別建模，凍結(jié)數(shù)據(jù)模型表應(yīng)以“模

型名.frozen”命名。以漏保為例，實(shí)時(shí)數(shù)據(jù)模型表名為MCCB,凍結(jié)

數(shù)據(jù)模型表名為MCCB?frozen0

3.3設(shè)備命名規(guī)則

為方便臺(tái)區(qū)設(shè)備模型建立，臺(tái)區(qū)設(shè)備應(yīng)采取統(tǒng)一命名規(guī)則，同一臺(tái)

區(qū)下的相同設(shè)備間以“模型名—唯一碼”的形式區(qū)分。該關(guān)鍵字為一臺(tái)

設(shè)備在臺(tái)區(qū)下的唯一標(biāo)識(shí)，也是業(yè)務(wù)APP訂閱/發(fā)布的信息對(duì)象及數(shù)據(jù)

庫(kù)存儲(chǔ)的表名。

注：要求設(shè)備ID的唯一性，算法另考慮。

序號(hào)設(shè)備類型infoPath/數(shù)據(jù)庫(kù)表名

1交流采樣ADC

2開關(guān)量采樣DI

3模擬量采樣AI

MCCB_1

MCCB_2

4塑殼斷路器

MCCB_frozen_l

.......

RCD_010000000001

RCD_010000000002

5漏保

RCD_frozen_010000000001

.......

MultiMeter」

MultiMeter_2

6多功能表

MultiMeter_frozen_l

.......

7電容器CAP

8靜止無功發(fā)生器SVG

THSensor_l

THSensor_2

9溫濕度傳感器

THSensor_frozen_l

.......

ChargingPile_l

ChargingPile_2

10充電樁

ChargingPile_frozen_l

.......

PhaseSwitch_020000000001

PhaseSwitch_020000000002

11換相開關(guān)PhaseSwitch_

frozen_020000000001

.......

EndTerminal_030000000001

EndTerminal_030000000002

12末端/分支終端EndTerminal_

frozen_030000000001

.......

DistributedPower_l

13分布式電源DistributedPower_2

.......

TempSensor_l

14溫度傳感器TempSensor_2

.......

WaterLevelSensor_l

15水位傳感器WaterLevelSensor_2

.......

SmokeSensor_l

16煙感傳感器SmokeSensor_2

.......

MGSensor_l

17門磁傳感器MGSensor_2

.......

SF6Sensor_l

18SF6傳感器SF6Sensor_2

.......

VibSensor_l

19振動(dòng)傳感器

VibSensor_2

.......

PDSensor_l

20局放傳感器PDSensor_2

.......

CondenseSensor_1

21冷凝除濕傳感器CondenseSensor_2

.......

22營(yíng)配融合終端TTU

3.4設(shè)備信息臺(tái)賬

臺(tái)區(qū)設(shè)備信息應(yīng)下表所示的方式存儲(chǔ)到終端中。

序號(hào)設(shè)備名稱設(shè)備類型TTU端口地址碼

1MCCB_3MCCBRS485-23

2RCD_010000000001RCDRS485-1010000000001

3SVG_26SVGRS485-226

四、數(shù)據(jù)類型

4.1數(shù)據(jù)類型列表

常用數(shù)據(jù)類型如下:

名稱類型標(biāo)記（TAG）長(zhǎng)度(LENGTH)值(VALUE)

布爾Boolean11l:tnie.O:folse

小整形Tiny431-128...127

無符號(hào)小整形UTiny3210...255

短整形Short332-32768...32767

無符號(hào)短整形UShort4520…65535

整形Int24-2147483648...2147483648

無符號(hào)整形Uint3540...4294967295

長(zhǎng)整形Long368?2八64…2A64

無符號(hào)長(zhǎng)整形Ulong3780…2T284

單精度浮點(diǎn)Float384-2A128...2A128

雙精度浮點(diǎn)Double398-2T024…2T024

八位位串類型OcterString4可變OcterString

字符串類型String4可變一個(gè)或者多個(gè)Ascn組成一最長(zhǎng)

64個(gè)字節(jié)，以'\0'結(jié)尾

4.2數(shù)據(jù)類型轉(zhuǎn)換

模型屬性的數(shù)據(jù)類型參照《設(shè)備模型屬性規(guī)范》，采用《數(shù)據(jù)類型

表》中的類型；接口規(guī)范中的模型屬性的數(shù)據(jù)類型全部采用string

類型傳輸；實(shí)際應(yīng)用中需要《設(shè)備模型屬性規(guī)范》數(shù)據(jù)類型與string

類型相互轉(zhuǎn)換。

五、數(shù)據(jù)中心接口調(diào)用

數(shù)據(jù)中心調(diào)用分四步：模型注冊(cè)、設(shè)備注冊(cè)、GUID獲取、數(shù)據(jù)/參

數(shù)的讀寫操作。對(duì)于APP（數(shù)據(jù)生成者）四步不可少，對(duì)于APP（消費(fèi)者）

可缺少模型注冊(cè)和設(shè)備注冊(cè)。

數(shù)據(jù)中心綜合考慮了配電、營(yíng)銷、物聯(lián)網(wǎng)、邊緣計(jì)算的業(yè)務(wù)，基本

能夠滿足電力所有業(yè)務(wù)的數(shù)據(jù)管理需要。

5.1接口概述

1版本信查詢版本信息{app}/get/request/database/version

息查詢

查詢版本信息返回database/get/response/{app}/version

2模型管模型名稱查詢{app}/get/request/database/modelschema

理

模型名稱查詢返回database/get/response/{app}/modelschema

模型刪除{app}/action/request/database/deletemodel

模型刪除返回database/action/response/{app}/deletemodel

3模型交模型內(nèi)容查詢{app}/get/request/database/model

互

模型內(nèi)容查詢返回database/get/response/{app}/model

模型設(shè)置{app}/set/request/database/model

模型設(shè)置返回database/set/response/{app}/model

4設(shè)備/應(yīng)設(shè)備GUID查詢app}/get/request/database/guid

用注冊(cè)

設(shè)備GUID查詢返回database/get/response/{app}/guid

設(shè)備查詢{app}/get/request/database/register

設(shè)備查詢返回database/get/response/{app}/register

設(shè)備注冊(cè){app}/set/request/database/register

設(shè)備注冊(cè)返回database/set/response/{app}/register

5定值交定值查詢{app}/get/request/database/parameter

互

定值查詢返回database/get/response/{app}/parameter

定值設(shè)置{app}/set/request/database/parameter

定值設(shè)置返回database/set/response/{app}/parameter

定值刪除{app}/action/request/database/deleteparameter

定值刪除返回database/action/response/{app}/deleteparameter

6數(shù)據(jù)主數(shù)據(jù)?主動(dòng)上報(bào){app}/notify/event/database/{設(shè)備類型}/{設(shè)備標(biāo)識(shí)}

動(dòng)上報(bào)

數(shù)據(jù)主動(dòng)上報(bào)返回database/notify/response/{app}/{設(shè)備類型}/{設(shè)備標(biāo)識(shí)}

7數(shù)據(jù)變數(shù)據(jù)變化上報(bào){app}/notify/spont/*/{設(shè)備類型}/{設(shè)備標(biāo)識(shí)}

化上報(bào)

8應(yīng)用訂應(yīng)用訂閱接口{app}/get/request/database/subscribe

閱接口

應(yīng)用訂閱接口返回database/get/response/{app}/subscribe

9實(shí)時(shí)數(shù)實(shí)時(shí)數(shù)據(jù)查詢{app}/get/request/database/realtime

據(jù)查詢

實(shí)時(shí)數(shù)據(jù)查詢返回database/get/response/{app}/realtime

10歷史數(shù)實(shí)例數(shù)據(jù)查詢{app}/get/request/database/history

據(jù)查詢database/get/response/{app}/history

5.2接口基本時(shí)序

數(shù)據(jù)中心基本操作采用問答式時(shí)序，示意圖如下:

APP數(shù)據(jù)中心

發(fā)送

'消息體、*數(shù)據(jù)中心處理一

處理結(jié)果

息體返

接收

基礎(chǔ)交互時(shí)序示意圖

5.3業(yè)務(wù)流程

1采集類微應(yīng)用APP接口調(diào)用流程

采集微應(yīng)用APP交互流程

數(shù)據(jù)中心采集微應(yīng)用APP

保存模型調(diào)3接口注冊(cè)模型

保存設(shè)備調(diào)4接口注冊(cè)設(shè)備

彝...........

驟|生成GUID---------?調(diào)用4接*取GUID

保存數(shù)據(jù)——調(diào)用6/10接口寫數(shù)據(jù)

保存事件——調(diào)用11接口寫事件

2邊緣計(jì)算類APP接口調(diào)用流程

邊緣計(jì)算微應(yīng)用APP交互流程

數(shù)據(jù)中心邊緣計(jì)算微應(yīng)用APP

保存模型一—調(diào)3接口注冊(cè)模型

保存設(shè)備一—調(diào)4接口注冊(cè)設(shè)備

步生成GUID——?調(diào)用4接口獲取GUID

驟

查詢數(shù)據(jù)一一調(diào)用9/10接口獲取讀取數(shù)據(jù)

保固數(shù)據(jù)一調(diào)用6/10接口寫數(shù)據(jù)

保存事件一—調(diào)用11接口寫事件

3業(yè)務(wù)類APP接口調(diào)用流程

業(yè)務(wù)類微應(yīng)用APP交互流程

數(shù)據(jù)中心業(yè)務(wù)類微應(yīng)用APP

步獲取GUID-----?調(diào)用4接口獲取GUID

驟

查詢數(shù)據(jù)-----?調(diào)用9/10接口獲取讀取數(shù)據(jù)

六、MQTT接口規(guī)范

?注：消息體內(nèi)的時(shí)標(biāo)均為北京時(shí)間。

?注：未標(biāo)注可選項(xiàng)的字段，都為必填項(xiàng)。

?注：JSON值為string類選，不能為空，若需要為空填寫NULL,例

如："token"：“NULL”。設(shè)備/應(yīng)用注冊(cè)接口中的“desc”：""為設(shè)備

的描述可以為空，不用填寫NULL。

1.版本信息查詢接口

獲取當(dāng)前數(shù)據(jù)中心微應(yīng)用的版本信息。

app發(fā)布/database訂閱

主題{app}/get/request/database/version

說明

注：JSON值為string類選，不能為空，若需要為空填寫NULL,例如：“token”：

“NULL”o

請(qǐng)求(

“token“：“123”,

“timestamp”：“2019-03-0ITOgBOQgZBO+OgOO”，

“body”:[]

)

database發(fā)布/app訂閱

主題database/get/response/{app}/version

響應(yīng)(

“token”：“123”，

“timestamp”：“2019-03-01T09:30:08.230+0800”,

“version":"v5.91”,

“Compatible":'1"http://最低版本號(hào)

}

注版本號(hào)大小版本號(hào)，小數(shù)點(diǎn)前為大版本，小數(shù)點(diǎn)后為小版本；

其中Compatible兼容版本只體現(xiàn)大版本。

2.模型管理接口

可獲取當(dāng)前庫(kù)中已有的全部模型名稱，可刪除指定名稱的模型。

模型名稱查詢app發(fā)布/database訂閱

主題{app}/get/request/database/modelschema

說明注：JSON值為string類選，不能為空，若需要為空填寫NULL,例如：“token”：

“NULL”o

請(qǐng)求(

“token”:"123”,

,)

“timestamp”：“2019-03-01T09:30:08.230+08005

“body":口

)

模型名稱查詢結(jié)果返回database發(fā)布/app訂閱

主題database/get/response/{app}/modelschema

響應(yīng)(

“token”:"123”,

“timestamp”:"2019-03-0lT09:30:09.230+0800”，

“body”:

[

“ADC”，

“DI”，

]

}

指定模型刪除app發(fā)布/database訂閱

主題{app}/action/request/database/deletemodel

說明注：JSON值為string類選，不能為空，若需要為空填寫NULL,例如：“token”：

“NULL”o

請(qǐng)求(

“token”:"123”,

“timestamp”:"2019-03-01T09:30:08.230+0800”,

“body”:

[

“ADC”，

“DI”，

]

}

模型刪除結(jié)果返回database發(fā)布/app訂閱

主題database/action/response/{app}/deletemodel

響應(yīng)(

“token”：“234”，

“timestamp”：“2019-03-01T09:30:09.230+0800”,

“status”:"OK”/“FAILURE”

)

3.模型交互接口

微應(yīng)用初始化時(shí)，應(yīng)調(diào)用模型交互接口設(shè)置應(yīng)用/設(shè)備的數(shù)據(jù)模型，同

一設(shè)備的實(shí)時(shí)數(shù)據(jù)與凍結(jié)數(shù)據(jù)需分別建立不同的模型，凍結(jié)數(shù)據(jù)的模

型名稱后綴規(guī)定為_frozen,如MCCB與MCCB_frozen0

模型查詢app發(fā)布/database訂閱

主題{app}/get/request/database/model

說明注：JSON值為string類選，不能為空，若需要為空填寫NULL,例如：“token”：

“NULL”o

請(qǐng)求(

“token”:"123”,

,)

“timestamp”:"2019-03-01T09:30:08.230+08005

“body”:

[

“ADC”，〃模型名稱

“DI”，

]

)

模型查詢結(jié)果返回database發(fā)布/app訂閱

主題database/get/response/{app}/model

響應(yīng)(

“token“：“123”,

“timestamp”:"2019-03-0lT09:30:09.230+0800'',

“body”:

[

(

“model”:“ADC”,

“body”:

[

(

"name":"PhV_phsA”,

“type”:“float”，

“unit”:“V”，

“deadzone”：“0.5”，

“ratio”:“1”，

“isReport”：“1”，

“userdefine”:〃最大256字節(jié)

｝，

(

“name”:"PhV_phsB”，

“type”:“float”，

“unit”:“V”，

“deadzone":"0.5'’,

“ratio"："1",

“isReport”:"1",

"userdeflne":""

),

]

｝，

｛

“model"：“DI”,

“body”：

[

(

“name”:"DIO1",

“type”：“bool”,

"unit":null,

“deadzone"：““，

“ratio”：“1”，

“isReport”：“1”，

“userdefine"：

｝，

]

｝，

]

)

模型設(shè)置app發(fā)布/database訂閱

主題｛app｝/set/request/database/model

說明例如：正確表示“name”:"PhV_phsA”或“name”:“NULL”，錯(cuò)誤表示：

“name。

請(qǐng)求(

“token”:“234”,

“timestamp”：“2019-03-011'09:30:09.230+0800”，

“model”:“MCCB”，

“body”:

[

{

"name":"PhV_phsA”,

“type”:“float”，

“unit”:“V”，

“deadzone”：“0.5”，

“ratio"："1",

“isReport”:"1",

“userdefine":

},

(

“name”：“PhV_phsB”，

“type”:“float”，

“unit”:“V”，

“deadzone”：“0.5”，

“ratio"："1",

“isReport”:"1",

“userdefine":

},

]

)

database發(fā)布/app訂閱

主題database/set/response/{app}/model

響應(yīng)(

“token“：“234”，

,,

“timestamp”:“2019-03-01T09:30:09.230+0800)

“status"："OK”/"FAILURE”

)

4.設(shè)備/應(yīng)用注冊(cè)接口

微應(yīng)用初始化時(shí)應(yīng)調(diào)用注冊(cè)接口注冊(cè)設(shè)備/應(yīng)用的名稱、地址碼等信息,

不同設(shè)備應(yīng)用“模型名稱+唯一編碼(GUID)”進(jìn)行標(biāo)識(shí)，同一設(shè)備的實(shí)

時(shí)數(shù)據(jù)和凍結(jié)數(shù)據(jù)應(yīng)分別注冊(cè)，如MCCB_1與MCCB_frozen_lo

設(shè)備取消注冊(cè)后，對(duì)應(yīng)的所有設(shè)備數(shù)據(jù)應(yīng)當(dāng)清除。

唯一編碼查詢app發(fā)布/database訂閱

主題{app}/get/request/database/guid

說明1、正確表示“name”:“PhV_phsA"或"name":"NULL"，錯(cuò)誤表示：

uname。

2、“desc”:此字段作為設(shè)備描述，可以為空，不用填寫NULL。

請(qǐng)求(

“token”:“234”,

“timestamp”：“2019-03-011'09:30:09.230+0800”，

“body”:

[

(

“model”:“MCCB",

“port”："RS485-2”,〃可選(RS485-1、RS485-2、RS485-3、RS485-4、

PLC)

“addr”:“1”，

“desc”:""〃此處值可以為空

},

(

“model”：“APP”，

“port”:“RS485-1”，

“addr”：“2”，

“desc":'"，

},

]

)

唯一編碼查詢結(jié)果返回database發(fā)布/app訂閱

主題database/get/response/{app}/guid

響應(yīng)(

“token”:“234”，

,)

“timestamp”:"2019-03-01T09:30:09.230+08005

“body”:

[

(

“dev”:“MCCB_guid”，

“guid”:“guid”，

),

(

“dev”:“MCCB_guid”，

“guid”:"guid”，

｝，

]

)

注冊(cè)關(guān)系查詢app發(fā)布/database訂閱

主題{app}/get/request/database/register

說明1、正確表示“name":"PhV_phsA"或"name":"NULL"，錯(cuò)誤表示：

"name"：“”。

2、“desc”:“"，此字段作為設(shè)備描述,可以為空，不用填寫NULL。

請(qǐng)求{

“token”:“123”,

u,,

“timestamp”:2019-03-01T09:30:08.230+08005

“body”:[]

)

注冊(cè)關(guān)系查詢結(jié)果返回database發(fā)布/app訂閱

主題database/get/response/{app}/register

響應(yīng)(

“token“：“234”，

“timestamp”：“2019-03-01T09:30:09.230+0800”，

“body”：

[

(

“model”:“MCCB”，

“port”:“RS485-2”,

“body”:

[

(

“dev”:“MCCB_guid",

“addr”:“1”，

"appname":"MCCB_collector”,

“desc”:“"，

“guid”：“guid”，

),

(

“dev”:"MCCB_guid”，

“addr”：“2”，

“appname":"MCCB_collector”,

“desc”:“"，

“guid”：“guid”，

｝,

]

｝，

(

“model"：“RCD”，

“port”:“RS485-1”，

“body”：

[

(

“dev”:“RCDguid”，

“addr”:"010000000001”,

“appname":"RCD_coHector”,

“desc”:“'，

“guid”:“guid”，

),

]

｝，

]

)

設(shè)備/APP注冊(cè)app發(fā)布/database訂閱

主題{app}/set/request/database/register

說明1、正確表示“name”:“PhV_phsA"或"name":"NULL"，錯(cuò)誤表示：

uname。

2、“desc”:"”,此字段作為設(shè)備描述，可以為空，不用填寫NULL。

請(qǐng)求(

“token”:“234”，

“timestamp”:“2019-03-0lT09:30:09.230+0800”,

“body”:

[

(

“model”:“MCCB",

“port”:"RS485-2”,

“addr”:“1”，

“desc”:

},

(

“model”:“FaultAnalysis”,〃高級(jí)APP名稱(未實(shí)體設(shè)備)

“port":

“addr”:“”，

“desc"：

},

{

“model”:“RCD”，

“port”:"RS485-1”,

“addr”：“010000000001”，

“desc”:““

},

]

)

注冊(cè)結(jié)果返回database發(fā)布/app訂閱

主題database/set/response/{app}/register

響應(yīng)(

“token”:“234”，

“timestamp”:"2019-03-01T09:30:09.230+0800”，

“status":"OK”/"FAILURE”

}

設(shè)備/APP取消注冊(cè)app發(fā)布/database訂閱

主題{app}/action/request/database/unregister

說明1、正確表示“name”:“PhV_phsA”或"name”:"NULL”，錯(cuò)誤表示：

"name":。

2、“desc”:“"，此字段作為設(shè)備描述，可以為空，不用填寫NULL。

請(qǐng)求{

“token”:"234”,

“timestamp":"Oig-fn-OlTOWOpg3O+OgOO”，

“body”:

[

{

“model”:“MCCB”，

“port”:“RS485-1”,

“addr”：“1”，

“desc"：

},

]

)

取消注冊(cè)結(jié)果返回database發(fā)布/app訂閱

主題database/action/response/{app}/unregister

響應(yīng)(

“token”:“234”，

“timestamp”:“2019-03-0lT09:30:09.230+0800”，

“status”:"OK”/“FAILURE"

}

5.定值交互接口

采集類微應(yīng)用初始化時(shí)可調(diào)用定值交互接口設(shè)置/獲取程序運(yùn)行需要

的定值參數(shù)。

定值查詢app發(fā)布/database訂閱

主題{app}/get/request/database/parameter

說明正確表示"name":"PhV_phsA"或"name":"NULL”,錯(cuò)誤表示："name”:

a，，

o

請(qǐng)求(

消息“token”:“123”，

體,)

“timestamp”：“2019-03-01T09:30:08.230+08005

“body”:

[

(

“dev”:“MCCB_guid”，

“totalcall'':"0",〃是否查詢?nèi)繑?shù)據(jù)

“body”:[

“span",〃定值名稱

“ratio”

]

)，(

“dev'':"MCCB_guid”，

“totalcall'':"1",〃是否查詢?nèi)繑?shù)據(jù)

“body”:口

}，

]

)

定值查詢結(jié)果返回database發(fā)布/app訂閱

主題database/get/response/{app}/parameter

應(yīng)

響

息(

涌

體“token”:"123”,

,)

“timestamp”：“2019-03-01T09:30:09.230+08005

“body”:[

{

“dev":''MCCB_guid”,

“body”:[

{“name”:“span",''va『:"5"},

{panme”:"span",''val”:”5"},

]

}，{

“dev":''MCCB_guid”，

“body”:[

{“name”廣span”,“val":”5"},

{“name”:“ratio”,“val":“50"},

]

｝，

]

)

定值設(shè)置app發(fā)布/database訂閱

主題{app}/set/request/database/parameter

說明正確表示"name":"PhV_phsA"或"name":"NULL",錯(cuò)誤表示：“name”：

a，，

o

應(yīng)

響

息(

游

體“token”:"234”,

u,,

“timestamp”:2019-03-0lT09:30:09.230+0800,

“body”:

[

{

“dev”:“MCCB_guid”，

“body”:[

{“name*'span”,“val":''5"},

{“name”:“ratio”,“val":“50"}

]

}，{

“dev”:“MCCB_guid”，

“body”:[

{“name”:“span”,”var':"5"},

{“name”:“ratio",“va『:“50"},

]

},

]

}

定值設(shè)置返回結(jié)果database發(fā)布/app訂閱

主題database/set/response/{app}/parameter

響應(yīng)(

消息“token”:“234”，

體,)

“timestamp”:"2019-03-01T09:30:09.230+08005