能源控制器

APP接口及開發(fā)規(guī)范

二。二O年六月

目錄

1范圍...................................................................................3

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

3術(shù)語和定義..............................................................................3

4App框架概述...........................................................................3

5App通信架構(gòu)...........................................................................4

6App消息模型...........................................................................6

7App接入規(guī)范..........................................................................11

8App設計方案..........................................................................13

9App消息接口標識......................................................................17

附錄A（規(guī)范性附錄）App消息接口定義...............................................22

附錄B（規(guī)范性附錄）訪問交采數(shù)據(jù)的約定............................................49

附錄C（規(guī)范性附錄）透明任務結(jié)果的存儲............................................52

附錄D（規(guī)范性附錄）電能表事件上報流程............................................53

附錄E（規(guī)范性附錄）桌面顯示實現(xiàn)的約定............................................58

附錄F（規(guī)范性附錄）消息舉例.......................................................59

能源控制器APP接口及開發(fā)規(guī)范

1范圍

本標準規(guī)定了能源控制器APP接口以及APP的開發(fā)規(guī)范。

本標準適用于用能源控制器［以下簡稱“終端”）中APP之間的通信數(shù)據(jù)交換。

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

下列文件對于本文件的應用是必不可少的。凡是注日期的引用文件，僅注日期的版本適

用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。

GB/T16262.1-2006信息技術(shù)抽象語法記法（ASN.1）第1部分基本記法規(guī)范

GB/T17966—2000微處理器系統(tǒng)的二進制浮點運算

DL/T790.6-2010采用配電線載波系統(tǒng)的配電自動化第6部分A-XDR編碼規(guī)則

3術(shù)語和定義

ASN.1

AbstractSyntaxNotationOne,一種ISO/ITU-T標準，描述了一種對數(shù)據(jù)進行表示、編

碼、傳輸和解碼的數(shù)據(jù)格式。

A-XDR

AbstractexternalDataRepresentation,抽象的外部數(shù)據(jù)表示。

MQTT

MessageQueuingTelemetryTransport?消息隊列遙測傳輸。ISO標準（ISO/IECPRF20922）

下基于發(fā)布/訂閱范式的消息協(xié)議。它工作在TCP/IP協(xié)議族上，是為硬件性能低下的遠

程設備以及網(wǎng)絡狀況糟糕的情況下而設計的發(fā)布/訂閱型消息協(xié)議，需要一個消息中間

件。

4App框架概述

基于統(tǒng)一終端平臺的App,使用消息總線框架,App之間的交互全部通過消息總線進行。

消息驅(qū)動支持IPC（Inter-ProcessCommunication,進程間通信）、TCP、UDP、MQTT等多

種模式，可根據(jù)系統(tǒng)資源及運行環(huán)境靈活剪裁僅支持其中一種或多種。基于本消息總線架構(gòu)，

App需符合消息驅(qū)動規(guī)范，方可接入系統(tǒng)，消息驅(qū)動規(guī)范見下文描述。

系統(tǒng)管理器，負責所有用戶App以及其他系統(tǒng)級App的接入以及管理。系統(tǒng)管理器具

有軟、硬件看門狗雙重保護，異?？勺詣踊謴汀Ｆ渌鸄即的生命周期，由系統(tǒng)管理器的保

活機制負責監(jiān)控并管理。

用戶App

消息總線

系統(tǒng)App

系統(tǒng)管理器

圖1消息框架

5App通信架構(gòu)

5.1信息交換模型

5.1.1概述

圖2消息交換模型

App之間的數(shù)據(jù)交換借助于消息實現(xiàn)。消息的傳輸可支持IPC、TCP、UDP或MQTT

等方式。由服務提供方（服務器角色）定義消息接口，服務使用方（客戶機角色）根據(jù)定義

的消息接口訪問相應的服務。一個App既可以是服務提供方，同時乜可以是某些服務的使

用方，同時具有服務器與客戶機多重角色。

5.1.2消息的優(yōu)先級

在本消息通信框架中，消息隊列帶有優(yōu)先級機制，確保高優(yōu)先級消息可以優(yōu)先處理，應

對某曲對時效性要求高的操作。優(yōu)先級數(shù)組越小，表示優(yōu)先級越高，0為最高優(yōu)先級。

陽：笛品訥閩

圖3消息隊列

5.1.3同步消息

發(fā)送程序首先向接收程序發(fā)起一個請求（發(fā)送消息），發(fā)送程序緊接著就會堵塞它自身

的進程，直到收到接收程序的響應。發(fā)送程序在收到響應后會繼續(xù)向下進行處理。同步方

式的請求/響應通信如下圖所示。

發(fā)送程序接收程序

圖4同步消息模型

5.1.4異步消息

當使用異步消息傳送時，調(diào)用者在發(fā)送消息以后可以不用等待響應，可以接著處理其

他任務。對于異步通信，一個應用程序（請求者或發(fā)送者）將請求發(fā)送給另一個應用程序，

然后可以繼續(xù)向下執(zhí)行它自身的其他任務。發(fā)送程序無須等待接收程序的執(zhí)行和返回結(jié)果,

而是可以繼續(xù)處理其他請求。

1.服求

r|二＞2后續(xù)處理［一

圖5異步消息模型

5.2請求/響應類型的數(shù)據(jù)交換

該數(shù)據(jù)交換模型支持App的客戶機進程，向其他App的服務器應用進程提出服務請求,

服務器應用進程向客戶機應用進程提供服務響應。

客戶機應用服務器應用

服務請求

客戶機服務器

--------------------服務響應-------------------------

圖6請求/響應模式的消息交換

5.3通知類型的數(shù)據(jù)交換

該數(shù)據(jù)交換模型支持App的服務器進程向其他App的客戶機應用進程發(fā)出通知，同時

不需要客戶機應用進程確認。

服務器應用客戶機應用

圖7通知模式的消息交換

6App消息模型

6.1消息驅(qū)動

6.1.1點對點通信

點對點通信模式，不需要系統(tǒng)管理器參與消息路由，App互相之間可直接點對點通信。

此種模式適用于App基于IPC或UDP驅(qū)動方式?；贗PC驅(qū)動的App,必須位于同一

主機內(nèi)?；赨DP驅(qū)動的App無此限制，可位于任意具有獨立IP地址的設備內(nèi)（容器或

其他智能終端或計算機）。

示意圖如下：

6.1.2路由轉(zhuǎn)發(fā)

需要系統(tǒng)管理器參與消息路由，App互相之間不可以直接通信。

此種模式適用于任意異構(gòu)驅(qū)動模式App之間的互相通信，或基于TCP驅(qū)動方式的App

之間互相通信。系統(tǒng)管理器內(nèi)置TCP服務器，其他采用TCP驅(qū)動的App為客戶機。

示意圖如下：

圖9路由轉(zhuǎn)發(fā)消息驅(qū)動

6.1.3MQTT

基于MQTT模式，由系統(tǒng)內(nèi)置MQTTBroker充當消息中心角色，完成消息轉(zhuǎn)發(fā)。MQTT

主題規(guī)則：消息發(fā)送方名稱/消息接收方名稱，接收方名稱為“Broadcast”表示廣播。

V_____________________________T

圖10MQTT消息驅(qū)動

6.2消息結(jié)構(gòu)定義

圖11消息幀組成

字段/位域76513210長度格式定義

1PRIORITYPRM1BIN

2INDEX2BIN

3LABEL2BINHEAD

4SOURCE（以0結(jié)尾）NASCII

5DESTINATION(以0結(jié)尾)NASCII

6MSG，s-TAG4BIN

7MSG,s-LengthNA-XDRMSG

8MSG's-PayloadNA-XDR

圖12消息幀結(jié)構(gòu)定義

PRM：啟動標志位（PRM=1,表示啟動）；

PRIORITY：優(yōu)先級（數(shù)值越小優(yōu)先級越高，。為最高優(yōu)先級）；

INDEX：消息序號（從0循環(huán)遞增,響應消息同請求消息保持一致）;

LABEL：消息標簽（發(fā)送方附加標簽，響應時帶回）；

SOURCE：消息發(fā)送方名稱，字符串，以0結(jié)尾，命名規(guī)范見7.2；

DESTINATION：消息接收方名稱，字符串，以0結(jié)尾，命名規(guī)范見7.2；

MSG,s—TAG：消息接口ID（消息接口定義見9）；

MSG's—Length：消息有效載荷長度，采用可變長度編碼（A-XDR）；

MSG's—Payload：有效載荷，即消息數(shù)據(jù)單元（定義見附錄

6.3字節(jié)格式

消息幀的基本單元為8位字節(jié)，傳輸順序為低位在前，高位在后；低字節(jié)在前，高字節(jié)

在后。

6.4消息數(shù)據(jù)單元

6.4.1標記規(guī)則與編碼規(guī)則

消息數(shù)據(jù)單元（MPDU）的標記規(guī)則遵循ASN.1的抽象語法，詳見GB/T16262.1—2006。

消息數(shù)據(jù)單元（MPDU）的編碼規(guī)則遵循A-XDR,詳見DL/T790.6—2010。

6.4.2通用數(shù)據(jù)類型

消息數(shù)據(jù)單元使用的數(shù)據(jù)類型見錯誤!未找到引用源。。

表1消息數(shù)據(jù)單元使用的數(shù)據(jù)類型定義

類型描述標記定義數(shù)值范圍

NULL0空

bool3布爾值（BOOLEAN）1或0

bit-string4位串(BITSTRING)

double-long532位整數(shù)(Integer32)

double-long-unsi

632位正整數(shù)(doub1e-1ong-unsigned)

gned

類型描述標記定義數(shù)值范圍

保留7-8

octet-string98位位組(字節(jié))串(OCTETSTRING)

ASCII字符串(VisibleString)

visible-string10

中文編碼格式為GB2312

保留11

UTF8-string12UTF-8編碼的字符串

保留13-14

integer158位整數(shù)(integer)-128...127

long1616位整數(shù)(long)-32768...32767

unsigned178位正整數(shù)(Unsigned8)0...255

long-unsigned1816位正整數(shù)(Unsignedl6)0...65535

保留19

long642064位整數(shù)(Integer64)-22...2"T

long64-unsigned2164位正整數(shù)(Unsigned64)0...2e-l

enum22枚舉的元素在對象屬性或方法的描述中定義0...255

float3223octet-string(SIZE(4))

float6424octet-string(SIZE(8))

date_time25octet-string(SIZE(10))

date26octet-string(SIZE(5))

time27octet-string(SIZE(3))

date_time_s28octet-string(SIZE(7))

29-25

保留

5

6.4.3數(shù)據(jù)類型定義

6.4.3.1浮點數(shù)據(jù)類型

浮點數(shù)據(jù)類型包括float32以及float64,格式定義見GB/T17966-2000?

6.4.3.2date_time數(shù)據(jù)類型

日期時間date_time的數(shù)據(jù)類型定義見錯誤!未找到引用源。。

表2date_time數(shù)據(jù)類型定義

數(shù)據(jù)類型定義說明

date_time：：=SEQUENCE日期和時間的十六進制格式。

(year、milliseconds=FFFFH表示無效。

yearlong-unsigned,month、day_of_month、day_of_weekhour、minute>

monthunsigned,second=FFll表示無效。

day_of_monthunsigned.dayofweek：。表示周日，1…6分別表示周一到周六。

數(shù)據(jù)類型定義說明

day_of_weekunsigned,

hourunsigned.

minuteunsigned,

secondunsigned.

millisecondslong-unsigned

}

6.4.3.3date_time_s數(shù)據(jù)類型

日期時間date_time_s的數(shù)據(jù)類型定義見錯誤!未找到引用源。。

表3date_time_s數(shù)據(jù)類型定義

數(shù)據(jù)類型定義說明

date_time_s：：=SEQUENCE日期和時間的十六進制格式。

(year=FFFFH表示無效。

yearlong-unsigned.monthsday、hour、minute、second=FFH表示無效。

monthunsigned,

dayunsigned,

hourunsigned.

minuteunsigned,

secondunsigned

}

6.4.3.4date數(shù)據(jù)類型

日期date的數(shù)據(jù)類型定義見錯誤!未找到引用源。。

表4date數(shù)據(jù)類型定義

數(shù)據(jù)類型定義說明

date：：=SEQUENCE日期的十六進制格式。

(year=FFFFH表示無效。

yearlong-unsigned,monthNday_of_month、day_of_week=FEH

monthunsigned,表示無效。

day_of_monthunsigned.

dayofweekunsigned

)

6.4.3.5time數(shù)據(jù)類型

時間time的數(shù)據(jù)類型定義見錯誤!未找到引用源。。

表5time數(shù)據(jù)類型定義

數(shù)據(jù)類型定義說明

time：：=SEQUENCE時間的十六進制格式。

(hour、minute、second=FFH表示無效。

hourunsigned,

minuteunsigned,

secondunsigned

}

7App接入規(guī)范

7.1App校驗

每個App(package)在提交軟件中心時，由軟件管理中心通過ESAM加密機自動在app

末尾增加RN以及MAC,App在下載到終端后，由終端通過本體ESAM芯片對MAC進行

校驗，校驗通過方可執(zhí)行。

App

bin

RNMAC

圖13App校驗碼

7.2命名規(guī)范

App消息隊列命名規(guī)則(以名稱第一個字符為關(guān)鍵字)：

V：表示App內(nèi)部線程消息隊列，如[monitor”,App可將接口消息分發(fā)至內(nèi)部處

理線程，達到高并發(fā)的目的；

T：表示App使用基于TCP方式的消息驅(qū)動，如"T-myAppl”；

4U\表示App使用基于UDP方式的消息驅(qū)動，基于該模式，名稱中必須包含App

所在的設備IP地址以及使用的端口號，如"U-myApp2:locaIhost[9000/；

名稱中出現(xiàn)localhost,表示使用本機地址，9000為UDP端口號；

4M5：表示App使用基于MQTT方式的消息驅(qū)動，如“M-myApp2”；

T：表示App使用基于IPC驅(qū)動方式，如LsmiOS。

App消息隊列名稱在消息傳輸過程中，用來對源、目標App消息隊列進行尋址，并填

充在消息結(jié)構(gòu)中的SOURCEWDESTINATION字段中。如果DESTINATION字段為

空字符串，表示改消息廣播至所有注冊的其他App。

7.3注冊機制

App下載到終端后，經(jīng)終端校驗通過，加入到啟動列表，由系統(tǒng)管理器負責啟動執(zhí)行,

如果App在啟動后三分鐘內(nèi)仍未發(fā)送注冊消息到系統(tǒng)管理器完成注冊，將會被系統(tǒng)管理器

kill。注冊請求由App發(fā)起，系統(tǒng)管理器給與確認。

7.4注冊查詢

App可以向系統(tǒng)管理器查詢已注冊App信息，支持通過關(guān)鍵詞查詢，獲取待交互App

信息（如IP地址及端口號等），無論App如何部署，均可達成互相通信目的。

圖15注冊查詢

7.5保活機制

系統(tǒng)管理器按設定間隔自動向所有注冊的App發(fā)送Keepalive消息，App收到該消息后

給予確認，如果連續(xù)多個周期（間隔）未收到App的確認，系統(tǒng)管理器認為該App為異常

狀態(tài)，將執(zhí)行后續(xù)異?；旨安呗浴?/p>

7.6事件通知

App可以向系統(tǒng)管理器訂閱事件，當事件發(fā)生時，由系統(tǒng)管理器通知到App,系統(tǒng)級消

息主要包含：緊急停電、系統(tǒng)停電、系統(tǒng)復位、系統(tǒng)上電、校時。

緊急停電一表示系統(tǒng)的后備電源系統(tǒng)無法支撐繼續(xù)運行；

系統(tǒng)停電一供電電源系統(tǒng)已關(guān)閉，后備電源已啟用，在后備電源工作時間滿后自動關(guān)機;

系統(tǒng)復位一系統(tǒng)需要重啟；

系統(tǒng)上電一由掉電轉(zhuǎn)為上電狀態(tài)時通知；

系統(tǒng)校時一當系統(tǒng)時鐘被修改時。

8App設計方案

8.1系統(tǒng)App

系統(tǒng)App在智能終端中有且僅有唯一一個App即系統(tǒng)管理器，系統(tǒng)管理器命名為

“smiOS”,系統(tǒng)管理器負責終端內(nèi)部App的管理以及系統(tǒng)監(jiān)控，確保系統(tǒng)穩(wěn)定可靠運行。

1、系統(tǒng)監(jiān)控功能

監(jiān)控系統(tǒng)軟件、硬件工作情況，當發(fā)生告警或故障時生產(chǎn)相應的日志文件，提供設

備維護相關(guān)接口。具體包括：

a）遠程查看設備信息，包括設備廠商及版本信息、設備生產(chǎn)信息、設備編號、設

備操作系統(tǒng)版本、CPU使用率、RAM使用率、存儲使用率等。

b）遠程配置設備信息。

c）檢測的設備故障，包括FLASH故障、時鐘故障、RAM故障、ESAM故障等。

d）設備維護，提供設備對時、設備重啟等。

e）日志管理，提供統(tǒng)一的日志記錄功能，日志分類管理，日志級別可分為信息、

告警、錯誤、調(diào)試等。

2、容器管理功能

負責容器的安裝、卸載、啟動、停止和狀態(tài)查詢，提供管理接口指令和接口APL

并具有對容器監(jiān)控功能，對容器內(nèi)的使用資源如CPU使用率、RAM使用率和存儲

使用率超限進行監(jiān)控并產(chǎn)生告警和H志。

3、APP管理功能：對APP進行管理，包括APP安裝、升級、卸載、啟停、查看APP

狀態(tài)。

4、系統(tǒng)安全：檢查容器鏡像和APP的合法性。

5、連接物聯(lián)管理平臺：負責連接物聯(lián)管理平臺，接收和實現(xiàn)物聯(lián)管理平臺的管理請求;

6、系統(tǒng)管理器具備消息分發(fā)路由的功能，在使用異構(gòu)通信環(huán)境中負責消息轉(zhuǎn)發(fā)；

7、系統(tǒng)管理器消息接口定義見9.3°

8.2基礎App

8.2.1設計原則

對“共享資源”進行管理，避免多App并發(fā)訪問帶來的沖突，同時對“共享資源”進

行優(yōu)先級管理，且具有與業(yè)務無關(guān)特征。共享資源包括數(shù)據(jù)、外設等。

基礎App通過消息總線以消息的方式為其他App提供服務。

基礎App不應與主站系統(tǒng)之間存在數(shù)據(jù)交換。

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

數(shù)據(jù)中心負責對整個系統(tǒng)的數(shù)據(jù)存儲管理、數(shù)據(jù)服務，數(shù)據(jù)中心命名為“dbCenter”。各

App通過消息總線與數(shù)據(jù)中心進行交互。

1、數(shù)據(jù)存儲服務

數(shù)據(jù)中心提供針對應用APP的數(shù)據(jù)存儲服務，并根據(jù)分類存儲機制，支持基于

SQLITE3的數(shù)據(jù)文件方式存儲以及基于內(nèi)存文件的非持久化數(shù)據(jù)存儲。

2、數(shù)據(jù)訪問服務

數(shù)據(jù)中心提供針對應用APP的數(shù)據(jù)訪問服務，支持精準和模糊方式查詢，同時，

針對應用APP訪問較多的終端參數(shù)文件，提供參數(shù)文件在系統(tǒng)內(nèi)存中的加載，實

現(xiàn)更高速度的響應。

3、數(shù)據(jù)備份和檢查

數(shù)據(jù)中心可以向系統(tǒng)管理器訂閱系統(tǒng)級事件，當事件發(fā)生時，由系統(tǒng)管理器通知到

數(shù)據(jù)中心，當收到系統(tǒng)級事件（緊急停電、系統(tǒng)停電、系統(tǒng)復位、系統(tǒng)上電）時進

行易失性數(shù)據(jù)的備份，系統(tǒng)恢復正常后恢復易失性數(shù)據(jù)。

數(shù)據(jù)中心運行過程中，定期對易失性數(shù)據(jù)進行備份，確保異常狀態(tài)下數(shù)據(jù)無丟失。

數(shù)據(jù)中心根據(jù)先入先出規(guī)則，定期刪除過期數(shù)據(jù)，保證系統(tǒng)有充足的數(shù)據(jù)存儲空間

存儲數(shù)據(jù)。

4、數(shù)據(jù)中心應有數(shù)據(jù)安全保證策略和措施，確保數(shù)據(jù)文件不被損壞和丟失；

5、數(shù)據(jù)中心應自動統(tǒng)計其他App訪問頻率，通過安全策略防止其他App惡意攻擊；

6、數(shù)據(jù)中心消息接口定義見0。

8.2.3無線遠程撥號管理

無線遠程撥號管理App負責無線公/專網(wǎng)通信模塊的管理，負責完成撥號、模塊狀態(tài)監(jiān)

控以及相關(guān)統(tǒng)計功能，無線遠程撥號管理App命名為“wirelessDCM”。

1、撥號功能

無線遠程撥號管理App可根據(jù)當前SIM卡運營商信息和網(wǎng)絡制式，自動匹配相應

的APN、用戶名和密碼等參數(shù)，進行撥號，建立PPP鏈接。優(yōu)先使用4G或更高

速率的網(wǎng)絡。

App支持以指定的網(wǎng)絡制式進行撥號鏈接。

App支持斷開當前PPP桂接功能；

當無線網(wǎng)絡出現(xiàn)異常，可自動在不同網(wǎng)絡制式見切換，異常解除后，可自動恢復。

2、狀態(tài)監(jiān)控功能

無線公網(wǎng)撥號管理App應能實時監(jiān)控當前撥號網(wǎng)絡狀態(tài)，一旦鏈路狀態(tài)發(fā)生變更，

應及時發(fā)出網(wǎng)絡變更消息，通知其他APP。

3、數(shù)據(jù)統(tǒng)計功能

無線公網(wǎng)撥號管理App應能實時統(tǒng)計撥號次數(shù)、失敗次數(shù)、最后一次撥號成功時

間等數(shù)據(jù)。

4、無線遠程撥號管理消息定義見A.3。

8.2.4本地通信管理

本地通信管理App負責終端本地通信模塊（以下簡稱CCO）的管理，依據(jù)《Q/GDW1376.2

集中器本地通信模塊接口協(xié)議》及其后續(xù)修訂，遵照相關(guān)流程完成對CCO的初始化和檔案

同步，通過CCO實現(xiàn)與STA節(jié)點的數(shù)據(jù)交互。本地通信管理App命名為“ccoRouter”。

1、本地通信管理App實現(xiàn)“虛擬路由”功能，支持通過分時竟略實現(xiàn)“多通道”鏈

路，應用App可通過各自鏈路通道實現(xiàn)“并發(fā)”抄表；

2、支持HPLC、窄帶載波、微功率無線等符合Q/GDW1376.2標準的本地模塊；

3、針對本地通信模塊（CCO）運行過程中STA主動上報的事件進行管理，將上報內(nèi)

容推送給訂閱事件的關(guān)聯(lián)應用App；

4、針對終端與本地通信模塊（CCO）交互中的各類異常，以及關(guān)聯(lián)應用APP的異常

訪問進行處理，保證控制通道和抄表通道通暢；

5、本地通信消息定義見A.4。

8.2.5模組管理器

模組管理器實現(xiàn)模組插拔檢查，根據(jù)《能源控制器功能模組接口協(xié)議》獲取并提供模組

設備基本信息，實現(xiàn)模組設備即插即用，模組管理器App命名為“mapManager”。

1、管理物理端口與模塊的對應關(guān)系，不同物理接口上插入同類型或不同類型的模組,

可對模組進行類型識別，并對同類型的模組的物理順序進行管理，實現(xiàn)邏輯端口與

物理端口的映射關(guān)系；

2、模組管理器管理與所有模組的控制命令通道的數(shù)據(jù)交互，實現(xiàn)終端本地模組的通用

操作（如重啟、初始化等）以及模組信息查詢，可轉(zhuǎn)發(fā)其它應用與控制命令通道的

數(shù)據(jù)：

3、模組管理器負責對模組進行狀態(tài)監(jiān)控，異常可自動恢復，支持對模組的在線升級；

4、模組管理器消息定義見A.5。

8.3邊緣計算App

8.3.1設計原則

邊緣計算App完成功能純粹的邊緣計算、分析類業(yè)務（如電能質(zhì)量分析、線損分析等）。

邊緣計算App不對外提供服務。

邊緣計算App與主站系統(tǒng)間不存在數(shù)據(jù)交互。

8.3.2App規(guī)劃

邊緣計算App規(guī)劃詳見《統(tǒng)一終端平臺一邊緣計算及業(yè)務App功能規(guī)范》。

8.4業(yè)務App

8.4.1設計原則

業(yè)務App與主站系統(tǒng)間存在數(shù)據(jù)交互，遵循一App對應一主站原則，不允許一個App

連接到多個不同的主站。

業(yè)務App的實現(xiàn)方式不拘泥于單一二進制文件/單一進程，可以多樣化（多二進制文件

或者多進程），可通過多進程協(xié)作模式完成某一特定場景業(yè)務功能。

8.4.2App規(guī)劃

業(yè)務App規(guī)劃詳見《能源控制器邊緣計算及業(yè)務App功能規(guī)范》c

9App消息接口標識

9.1接口標識

接口標識由四字節(jié)組成，采用十六進制編碼表示，其格式定義見下表所示。

表6接口標識格式定義

接口標識

IIDI0P

bit31-bitl6bitl5-bitO

接口標識按字節(jié)劃分為HD和IOP,采用分類編碼的方式定義各個接口標識編碼，未定

義的接口標識編碼保留。

9.2IID=0000H

IIDROOOH的接口標識定義見表7o

表7IIDR000H接口標識定義

接口標識

IIDI0P

0001H：緊急停電（事件）

0002H：系統(tǒng)停電（事件）

0003H：系統(tǒng)復位（事件）

0004H：系統(tǒng)上電（事件）

0005H：系統(tǒng)校時（事件）

0000H：通用消息接口

0010H：心跳檢測

0011H：執(zhí)行維護命令

001211：透明傳輸

0013H：版本信息

0014H：錯誤信息

9.3IID=0001H

IIDROOIH的接口標識定義見表8o

表8IID=OOO1H接口標識定義

接口標識

IIDI0P

0001H：以太網(wǎng)插拔（事件）

0010H：App請求注冊

001111：App取消注冊

0012H：查詢已注冊App

0001H：系統(tǒng)管理器消息接口

001311：查詢指定App信息

0020H：事件訂閱

0021H：事件取消訂閱

0022H：查詢訂閱的事件信息

接口標識

IIDIOP

0030H：請求系統(tǒng)審尼

0031H：查詢電源狀態(tài)

0032H：查詢以太網(wǎng)插拔狀態(tài)

0035H：配置本機IP地址

0036H：添加路由表

0037H：刪除路由表

0038H：時鐘同步

0039H：啟動SNTP對時

003AH：獲取設備信息

003BII：執(zhí)行system命令

003CH：獲取容器信息

003DH：獲取容器內(nèi)App信息

9.4IID=0002H

UDROU2H的接LI標識定義見表9。

表9IID=02H接口標識定義

接口標識

IIDIOP

0001H：撥號狀態(tài)變化事件（事件）

OO1OH：查詢模塊信息

0011H：查詢撥號狀態(tài)

0012H：發(fā)送短信

0013H：接收短信

0002H：無線模塊撥號管理App消息接口

0014H：修改撥號參數(shù)

0015H：重新?lián)芴?/p>

0016H：獲取GPS定位信息

0017H：設置鑒權(quán)方式

001811：設置短信參數(shù)

9.5IID=0003H

IID=0003H的接口標識定義見表10。

表10IID=0003H接口標識定義

接口標識

IIDIOP

0001H：上報事件數(shù)據(jù)（事件）

0002H：上報離網(wǎng)事件（事件）

0010H：抄表端口功能配置

000311：本地通信管理App消息接口

0020H：添加表檔案

0021H：刪除表檔案

0022H：清除表檔案

接口標識

IIDIOP

0031H：上報抄表數(shù)據(jù)

0033H：數(shù)據(jù)透傳

0034H：啟動搜表

0035H：暫停搜表

0036H：上報搜表數(shù)據(jù)

0037H：獲取從節(jié)點監(jiān)控延時

0038H：從節(jié)點監(jiān)控

0039H：獲取廣播延時

003AH：廣播

003BH：模塊地址設置

003DH：當前配置檔案數(shù)

003EH：主動抄表

0040H：暫停抄表

0041H：恢復抄表

0042H：里啟抄表

0043H：查詢檔案

0050H：查詢HPLC信息

0051H：上報HPLC查詢信息

0052H：HPLC頻點設置

0053H：HPLC頻點查詢

005411：HPLC臺區(qū)識別

0055H：HPLC離網(wǎng)感知

0056H：HPLC拒絕節(jié)點上報

0060H：查詢抄表狀態(tài)

0061H：查詢抄表模塊信息

9.6IID=0004H

IID=0004H的接口標識定義見表11。

表11IID=04H接口標識定義

接口標識

1ID1OP

0001H：模組插拔事件（事件）

0010H：查詢模組信息

0011H：查詢模組槽位信息

0012H：查詢模組插拔狀態(tài)

0004H：模組管理器消息接口

0013H：模組復位

0014H：模組重啟

0015H：文件傳輸

0016H：查詢所有模組信息

9.7IID=0005H

IID=0005H的接口標識定義見表12

表12IID=0005H接口標識定義

接口標識

IIDIOP

0001H：數(shù)據(jù)更新事件（事件）

0002H：初始化事件（事件）

0010H：讀普通數(shù)據(jù)

0011H：寫普通數(shù)據(jù)

0012H：開始讀記錄型數(shù)據(jù)

0013H：單步讀取記錄數(shù)據(jù)

0014H：結(jié)束記錄型數(shù)據(jù)讀取

0005H：數(shù)據(jù)中心消息接口

0015H：寫記錄型數(shù)據(jù)

0016H；更新記錄數(shù)據(jù)

0020H：獲取存儲記錄條數(shù)

0021H：獲取存儲記錄深度

003011：數(shù)據(jù)初始化

0031H：清除指定數(shù)據(jù)

0032H：恢復出廠

9.8IID=0006H

IID=0006H的接口標識定義見表13。

表13IID=0006H接口標識定義

接口標識

IIDI0P

0001H：以太網(wǎng)遠程端口開放監(jiān)控（事件）

0002H：以太網(wǎng)外聯(lián)信息監(jiān)控（事件）

0003H：關(guān)鍵目錄文件變更監(jiān)控（事件）

0006H：安全在線監(jiān)測消息接口0004H：以太網(wǎng)登錄控制臺監(jiān)控（事件）

000511：危險命令操作監(jiān)控（事件）

0006H：Root口令變更監(jiān)控（事件）

0010H：啟動/關(guān)閉SSH服務

9.9IID=0007H

IID=0007H的接口標識定義見表14