【正文】 節(jié)：指明報文開始字節(jié)。? 報文類型：指明該幀的具體含義。? 報文長度：指明該報文全部長度。? 測點(diǎn) ID：該測點(diǎn)的標(biāo)識。? 測點(diǎn)類型：該測點(diǎn)的數(shù)據(jù)類型，其取值包括模擬量、數(shù)字量和開關(guān)量。? 起始秒級時間戳（ST）：本報文發(fā)送數(shù)據(jù)的起始 UTC 時間戳。? 起始毫秒時間戳（MT）：本報文發(fā)送數(shù)據(jù)的起始秒值。? 時間間隔：指明點(diǎn)值之間的時間間隔，以毫秒計算。? 點(diǎn)值個數(shù)：指明實時數(shù)據(jù)值的數(shù)目。? 結(jié)構(gòu)體（1~N ）：指明每個實時數(shù)據(jù)，該結(jié)構(gòu)體不包含測點(diǎn)標(biāo)識。? 校驗:校驗碼。? 尾標(biāo)識：報文結(jié)束標(biāo)識。點(diǎn)值結(jié)構(gòu) 3 描述：40 / 94? 點(diǎn)值（V）：點(diǎn)的測量值? 質(zhì)量戳（Q）：源系統(tǒng)標(biāo)記的點(diǎn)值質(zhì)量信息；【操作流程】發(fā)送實時/歷史數(shù)據(jù)給服務(wù)端?！竟δ苊枋觥颗繉懭胪粫r間戳多個測點(diǎn)的實時/歷史數(shù)據(jù)。【傳輸格式說明】頭標(biāo)識(EB90H) 無符號短整型報文類型(23H) 無符號 char 型報文長度 無符號長整型秒級時間戳（ST） 無符號長整型毫秒時間戳（MT） 無符號短整型模擬量個數(shù) n 無符號長整型點(diǎn)值 1……點(diǎn)值 n根據(jù) n 值動態(tài)變化 見點(diǎn)值結(jié)構(gòu) 3數(shù)字量個數(shù) m 無符號長整型點(diǎn)值 1……點(diǎn)值 m根據(jù) m 值動態(tài)變化 見點(diǎn)值結(jié)構(gòu) 3數(shù)字量個數(shù) p 無符號長整型點(diǎn)值 1……點(diǎn)值 p根據(jù) p 值動態(tài)變化 見點(diǎn)值結(jié)構(gòu) 3校驗 無符號 char 型尾標(biāo)識(09BEH) 無符號短整型點(diǎn)值結(jié)構(gòu) 3：點(diǎn)標(biāo)識符（ID） 無符號長整型點(diǎn)值（V） 模擬量為浮點(diǎn)型；數(shù)字量為整型；開關(guān)量為 uchar質(zhì)量戳（Q） 無符號長整型【報文分析】41 / 94? 標(biāo)識字節(jié)：指明報文開始字節(jié)。? 報文類型：指明該幀的具體含義。? 報文長度：指明該報文全部長度。? 時間戳：斷面產(chǎn)生的時刻的 UTC 時間。? 模擬量個數(shù)：指明實時數(shù)據(jù)中模擬量的數(shù)目，沒有該類型數(shù)據(jù)時，該域設(shè)為 0。? 數(shù)字量個數(shù)：指明實時數(shù)據(jù)中數(shù)字量的數(shù)目，沒有該類型數(shù)據(jù)時，該域設(shè)為 0。? 開關(guān)量個數(shù)：指明實時數(shù)據(jù)中開關(guān)量的數(shù)目，沒有該類型數(shù)據(jù)時，該域設(shè)為 0。? 結(jié)構(gòu)體（1~N ）：指明每個實時數(shù)據(jù)，該結(jié)構(gòu)體不包含時間戳。? 校驗:校驗碼。? 尾標(biāo)識：報文結(jié)束標(biāo)識。點(diǎn)值結(jié)構(gòu) 3 描述：? 點(diǎn)標(biāo)識符（ID）：點(diǎn)通知時由源系統(tǒng)提供的點(diǎn)標(biāo)識；? 點(diǎn)值（V）：點(diǎn)的測量值? 質(zhì)量戳（Q）：源系統(tǒng)標(biāo)記的點(diǎn)值質(zhì)量信息；【操作流程】發(fā)送實時/歷史數(shù)據(jù)給服務(wù)端?！竟δ苊枋觥啃薷膯蝹€歷史數(shù)據(jù)?！緜鬏敻袷秸f明】42 / 94頭標(biāo)識(EB90H) 無符號短整型報文類型(24H) 無符號 char 型報文長度 無符號長整型模擬量個數(shù) n 無符號長整型點(diǎn)值 1……點(diǎn)值 n根據(jù) n 值動態(tài)變化 見點(diǎn)值結(jié)構(gòu) 1數(shù)字量個數(shù) m 無符號長整型點(diǎn)值 1……點(diǎn)值 m根據(jù) m 值動態(tài)變化 見點(diǎn)值結(jié)構(gòu) 1數(shù)字量個數(shù) p 無符號長整型點(diǎn)值 1……點(diǎn)值 p根據(jù) p 值動態(tài)變化 見點(diǎn)值結(jié)構(gòu) 1校驗 無符號 char 型尾標(biāo)識(09BEH) 無符號短整型點(diǎn)值結(jié)構(gòu) 1：點(diǎn)標(biāo)識符（ID） 無符號長整型點(diǎn)值（V） 模擬量為浮點(diǎn)型；數(shù)字量為整型；開關(guān)量為 uchar質(zhì)量戳（Q） 無符號長整型秒級時間戳（ST） 無符號長整型毫秒時間戳（MT） 無符號短整型【報文分析】? 標(biāo)識字節(jié)：指明報文開始字節(jié)。? 報文類型：指明該幀的具體含義。? 報文長度：指明該報文全部長度。? 模擬量個數(shù)：指明實時數(shù)據(jù)中模擬量的數(shù)目，沒有該類型數(shù)據(jù)時，該域設(shè)為 0。? 數(shù)字量個數(shù)：指明實時數(shù)據(jù)中數(shù)字量的數(shù)目，沒有該類型數(shù)據(jù)時，該域設(shè)為 0。? 開關(guān)量個數(shù)：指明實時數(shù)據(jù)中開關(guān)量的數(shù)目，沒有該類型數(shù)據(jù)時，該域設(shè)為 0。43 / 94? 結(jié)構(gòu)體：指明每個實時數(shù)據(jù)，該結(jié)構(gòu)體包括測點(diǎn) ID、測點(diǎn)值、時間戳、質(zhì)量碼。? 校驗:校驗碼。? 尾標(biāo)識：報文結(jié)束標(biāo)識?！静僮髁鞒獭靠蛻舳税l(fā)送指令，修改服務(wù)端的某個歷史數(shù)據(jù)?！竟δ苊枋觥縿h除單個測點(diǎn)某時間戳的歷史數(shù)據(jù)?！緜鬏敻袷秸f明】頭標(biāo)識(EB90H) 無符號短整型報文類型(24H) 無符號 char 型報文長度 無符號長整型點(diǎn) ID 無符號短整型起始秒級時間戳（ST） 無符號長整型起始毫秒時間戳（MT） 無符號短整型截止秒級時間戳（ST） 無符號長整型截止毫秒時間戳（MT） 無符號短整型校驗 無符號 char 型尾標(biāo)識(09BEH) 無符號短整型【報文分析】? 標(biāo)識字節(jié)：指明報文開始字節(jié)。? 報文類型：指明該幀的具體含義。? 報文長度：指明該報文全部長度。? 測點(diǎn) ID：測點(diǎn)標(biāo)識。? 起始秒級時間戳（ST）：秒級時間戳。? 起始毫秒時間戳（MT）：毫秒級時間戳。44 / 94? 截止秒級時間戳（ST）：秒級時間戳。? 截止毫秒時間戳（MT）：毫秒級時間戳。? 校驗:校驗碼。? 尾標(biāo)識：報文結(jié)束標(biāo)識?！静僮髁鞒獭靠蛻舳税l(fā)送指令，刪除服務(wù)端的某個歷史數(shù)據(jù)。 事件寫入組（Event Input Group）【功能描述】寫入事件日志。【傳輸格式說明】頭標(biāo)識(EB90H) 無符號短整型報文類型(24H) 無符號 char 型報文長度 無符號長整型等級 無符號短整型秒級時間戳（ST） 無符號長整型毫秒時間戳（MT） 無符號短整型消息內(nèi)容 64 字節(jié)字符數(shù)組校驗 無符號 char 型尾標(biāo)識(09BEH) 無符號短整型【報文分析】? 類型：指明該幀的具體含義。? 長度：指明該幀數(shù)據(jù)的全部長度。? 等級：指明該事件的重要等級。? 秒級時間戳（ST）：秒級時間戳。? 毫秒時間戳（MT）：毫秒級時間戳。45 / 94? 消息內(nèi)容：指明該事件的具體內(nèi)容，以字符數(shù)組的方式。? 校驗:校驗碼。? 尾標(biāo)識：報文結(jié)束標(biāo)識?！静僮髁鞒獭堪l(fā)送事件數(shù)據(jù)給服務(wù)端。 報文清單 控制組Control Group名稱 描述連接 與實時數(shù)據(jù)庫服務(wù)器建立連接斷連 與實時數(shù)據(jù)庫服務(wù)器斷開測點(diǎn)通知 通知服務(wù)端添加、刪除和修改標(biāo)簽點(diǎn) 數(shù)據(jù)錄入組Data Input Group名稱 描述批量寫入數(shù)據(jù) 批量寫入多個測點(diǎn)的實時/歷史數(shù)據(jù)。批量寫入單側(cè)點(diǎn)數(shù)據(jù) 批量寫入單個測點(diǎn)多個不同時間戳的實時/歷史數(shù)據(jù)。批量寫入斷面數(shù)據(jù) 批量寫入同一時間戳多個測點(diǎn)的實時/歷史數(shù)據(jù)。修改歷史數(shù)據(jù) 修改單個歷史數(shù)據(jù)。刪除歷史數(shù)據(jù) 刪除單個測點(diǎn)某時間戳的歷史數(shù)據(jù)。 事件錄入組Event Input Group名稱 描述事件寫入 寫入事件日志46 / 945. 附錄 2 規(guī)約約定 數(shù)據(jù)類型項目 定義 說明傳輸方式 平衡方式應(yīng)用服務(wù)數(shù)據(jù)單元公共地址 2 字節(jié)信息體地址 3 字節(jié)傳送原因 2 字節(jié)單點(diǎn)信息 M_SP_NA_1 01H雙點(diǎn)信息 M_DP_NA_1 03H測量值, 規(guī)一化值 M_ME_NA_1 09H帶 CP56Time2a 時標(biāo)的單點(diǎn)信息 M_SP_TB_1 1EH帶 CP56Time2a 時標(biāo)的雙點(diǎn)信息 M_DP_TB_1 1FH初始化結(jié)束 M_EI_NA_1 46H總召喚命令 C_IC_NA_1 64H時鐘同步命令 C_CS_NA_1 67H 信息體地址分配對象名稱 十六進(jìn)制地址（HEX） 信息量個數(shù)狀態(tài)量信息 000001H400000H 4194304模擬量信息 400001H800000H 4194304累計電度量 800001HF00000H 7340032其他 F00001HFFFFFFH 10485756. 附錄 3 E 語言格式參見《XX 系統(tǒng)數(shù)據(jù)標(biāo)記語言E 語言規(guī)范》附錄 4 通用應(yīng)用編程接口（UAPI） 接口概述實時數(shù)據(jù)庫統(tǒng)一訪問接口（UAPI）屏蔽了底層數(shù)據(jù)庫的具體實現(xiàn)細(xì)節(jié)及差異，對外提供統(tǒng)一的訪問接口為上層應(yīng)用服務(wù)，對用戶來說是只有一個邏輯實時數(shù)據(jù)庫，從而實現(xiàn)了47 / 94透明性以及分布式訪問。實時數(shù)據(jù)庫統(tǒng)一訪問接口的實現(xiàn)以標(biāo)準(zhǔn) C/C++語言為編程語言并充分考慮接口的跨平臺性，接口至少支持 Windows、Linux 等平臺。 接口分組根據(jù)功能的不同，統(tǒng)一數(shù)據(jù)訪問接口（UAPI）被分成組進(jìn)行描述。每一個分組作為一個章節(jié)。UAPI 分組包括：? Connect Management Group—— 連接維護(hù)組；? Tag Management Group—— 測點(diǎn)管理組；? Data Input Group —— 數(shù)據(jù)寫入組；? Data Query Group —— 數(shù)據(jù)查詢組；? Summary Group —— 統(tǒng)計分析組；? Extended Functions Group —— 擴(kuò)展功能組； 說明規(guī)范每一個接口說明都包括原型定義、接口功能描述、參數(shù)列表及參數(shù)描述、返回碼定義和編程實例?！驹投x】描述接口的函數(shù)聲明，接口名稱、參數(shù)類型、返回值類型等；【功能描述】描述接口功能；【參數(shù)列表】描述參數(shù)類型、含義等；【返回碼】描述返回值的含義。48 / 94 類型定義為了屏蔽不同操作系統(tǒng)的差異，實現(xiàn)跨平臺，統(tǒng)一訪問接口特別重定義了以下基本的數(shù)據(jù)類型，與標(biāo)準(zhǔn) C++語言基本保持一致。在具體實現(xiàn)過程中，盡量以統(tǒng)一訪問接口中的定義基本數(shù)據(jù)類型為準(zhǔn)。UAPI 類型定義如下表所示：類型名 占用存儲大?。ㄗ止?jié)） 對應(yīng) C++類型CDNN_CHAR8 1 字節(jié) CharCDNN_BYTE8 1 字節(jié) Unsigned charCDNN_INT16 2 字節(jié) ShortCDNN_UINT16 2 字節(jié) Unsigned shortCDNN_INT32 4 字節(jié) LongCDNN_UINT32 4 字節(jié) Unsigned longCDNN_INT64 8 字節(jié) Long longCDNN_UINT64 8 字節(jié) Unsigned long longCDNN_FLOAT32 4 字節(jié) floatCDNN_DOUBLE64 8 字節(jié) DoubleCDNN_BOOL32 4 字節(jié) BOOL 常量定義C_MAX_TAGNAME_LEN =64C_MAX_UNIT_LEN =16C_MAX_DESC_LEN =64C_MAX_SOUR_LEN =32C_MAX_SOURCE_TAG_LEN =128C_MAX_EXTEND_LEN =6449 / 94C_STRINGVALUE_LEN =128C_MAX_USER_LEN =32C_MAX_PASSWORD_LEN =64C_MAX_REALUSER_LEN =64 結(jié)構(gòu)體 typedef struct STRU_PointField{CDNN_LONG32 pt。 //測點(diǎn)唯一標(biāo)識CDNN_CHAR8 tag[C_MAX_TAGNAME_LEN]。//測點(diǎn)名稱CDNN_CHAR8 unit[C_MAX_UNIT_LEN]。//工程單位CDNN_CHAR8 desc[C_MAX_DESC_LEN]。 //描述CDNN_BYTE8 type。 //數(shù)值類型CDNN_CHAR8 source[C_MAX_SOUR_LEN]。 //數(shù)據(jù)源CDNN_CHAR8 sourcetag[C_MAX_SOURCE_TAG_LEN]。//源點(diǎn)名CDNN_CHAR8 descex[C_MAX_DESCEX_LEN]。 //描述擴(kuò)展CDNN_BYTE8 digitalset。 //狀態(tài)集CDNN_CHAR8 digits。 //數(shù)值位數(shù)CDNN_INT32 record。 //存檔記錄號CDNN_CHAR8 scan。 //是否采集CDNN_CHAR8 archive。 //是否存檔CDNN_CHAR8 status。 //狀態(tài)字CDNN_FLOAT32 llimit。 //量程下限50 / 94CDNN_FLOAT32 hlimit。 //量程上限CDNN_CHAR8 step。 //是否階躍CDNN_FLOAT32 typicalvalue。 //典型值CDNN_CHAR8 press。 //是否壓縮CDNN_FLOAT32 pdev。 //壓縮偏差CDNN_FLOAT32 pdevpercent。 //壓縮偏差百分比CDNN_INT32 ptimemax。 //最大壓縮間隔CDNN_INT32 ptimemin。 //最短壓縮間隔CDNN_FLOAT32 excdev。 //例外偏差CDNN_FLOAT32 excdevpercent。 //例外偏差百分比CDNN_INT32 exctimemax。 //最大例外間隔CDNN_INT32 exctimemin。 //最短例外間隔CDNN_BYTE8 access。 //訪問權(quán)限CDNN_UINT16 group。 //所屬組CDNN_UINT16 owner。 //擁有者CDNN_INT32 createdate。 //創(chuàng)建時間CDNN_UINT16 creator。 //創(chuàng)建人CDNN_INT32 changedate。 //修改時間CDNN_UINT16 changer。 //修改者CDNN_BYTE8 dataaccess。 //數(shù)據(jù)訪問權(quán)限CDNN_UINT16 datagroup。 //數(shù)據(jù)所屬組CDNN_UINT16 dat