公共數(shù)據(jù)平臺數(shù)據(jù)下傳協(xié)議v1

1、公共數(shù)據(jù)下傳協(xié)議V1.0一、公共數(shù)據(jù)下傳協(xié)議 V1.0說明1、 數(shù)據(jù)包結構特點數(shù)據(jù)下傳數(shù)據(jù)包的結構充份考慮了修改測站運行配置信息與參數(shù)的數(shù)據(jù)包結構的特點，公共數(shù)據(jù)服務器下傳數(shù)據(jù)包盡可能與修改數(shù)據(jù)包的結構一致。原修改運行配置的數(shù)據(jù)結構為：#n(參數(shù) 1,參數(shù) 2,參數(shù) 3,參數(shù) 4,參數(shù)x)其中 n 為設置或待查詢的功能號，可用的字符為：19，AZ。如：#01、#99、#A1、#2B。如果某個參數(shù)缺省，該參數(shù)的位置為空，但“,”不能缺省。例如：參數(shù) 2、參數(shù) 3 缺省，上述數(shù)據(jù)包為：#n(參數(shù) 1,參數(shù) 4,參數(shù)x)。2、 數(shù)據(jù)下傳主要內(nèi)容公共數(shù)據(jù)下傳的主要內(nèi)容包括：數(shù)據(jù)上傳后的“服務器時鐘與確

2、認”、用戶下傳的“附件文件”、下傳的“信息字符串”?！胺掌鲿r鐘與確認”信息由服務器產(chǎn)生，每次數(shù)據(jù)上傳（實時數(shù)據(jù)、密集數(shù)據(jù)、圖像數(shù)據(jù)）服務器都會返回服務器時鐘與確認信息。“附件文件”由用戶通過服務器瀏覽界面上傳至服務器，跟隨“服務器時鐘與確認”之后一起下傳?！案郊募笔墙o用戶大容量數(shù)據(jù)下傳的一個通道，其用途由各根據(jù)各自設備的需要而定。例如：可以，用于模式識別的圖形模板；可以表格，用于特殊計算的查表；可以下片機程序，用于測站設備單片機程序的修改與重裝等?！靶畔⒆址庇捎脩敉ㄟ^瀏覽界面上傳至服務器，跟隨“服務器時鐘與確認”之后一起下傳?！靶畔⒆址敝饕糜谛薷臏y站設備的運行配置參數(shù)、服務器下

3、傳的指令等。其中公共數(shù)據(jù)下傳協(xié)議預留了部分今后可能遇到的公共“配置參數(shù)”或“指令”的特殊字符串。除特殊字符串外，其余字符串的由用戶根據(jù)自己的需要自行定義。公共數(shù)據(jù)下傳協(xié)議預留的字符串為：#00(參數(shù) 1,參數(shù) 2,參數(shù)x) #49(參數(shù) 1,參數(shù) 2,參數(shù)x)。3、 數(shù)據(jù)下傳方式在下傳的信息中，“服務器時鐘與確認”是每次數(shù)據(jù)上傳后必返回的下傳信息，其余均為下傳信息，即“附件文件”或“信息字符串”只跟隨“服務器時鐘與確認”返回一次，直到下一次用戶在服務器上重新更新“附件文件”或“信息字符串”。1所有數(shù)據(jù)的下傳都是在測站儀器上傳數(shù)據(jù)之后隨即進行。為避免整點時刻數(shù)據(jù)上傳的測站集中而造成服務器處理的壓

4、力，請用戶或廠家在網(wǎng)上提交參數(shù)修改后招測數(shù)據(jù)，人為連通測站完成參數(shù)修改。普通瀏覽中針對本次招測，會顯示“參數(shù)修改已執(zhí)行”。4、 數(shù)據(jù)下傳確認測站儀器收到下傳數(shù)據(jù)包后，根據(jù)具體需要上傳確認信息或不上傳確認信息：收到“服務器時鐘與確認”不上傳確認信息。各儀器廠家可依據(jù)該時鐘進行儀器校時，但建議時鐘誤差超過 1 分鐘再實施校時。公共數(shù)據(jù)下傳協(xié)議預留的字符串“#00(參數(shù) 1,參數(shù) 2,參數(shù) x) #49 (參數(shù) 1,參數(shù) 2,參數(shù) x)”采用公共數(shù)據(jù)實時數(shù)據(jù)上傳協(xié)議 V2.0的數(shù)據(jù)包格式上傳確認信息：$AAA;設備;口令;名;測站名;年-月-日 時:分:秒;參數(shù); #n(參數(shù) 1,參數(shù) 2,參數(shù) 3

5、,參數(shù) 4,;參數(shù) x);$END。其中：參數(shù)是與下傳數(shù)據(jù)包相關的參數(shù)，為可選項，如果沒有參數(shù)內(nèi)容，參數(shù)可以為空，但“;”不能省略。#n(參數(shù) 1,參數(shù) 2,參數(shù) 3,參數(shù) 4,參數(shù) x)是返回修改后的相應參數(shù)。用戶自定義字符串返回：$AAA;設備;口令;名;測站名;年-月-日 時:分:秒;參數(shù);x;$END。其中：參數(shù) 的處理要求與服務器預留字符串返回數(shù)據(jù)包中的參數(shù)處理要求相同，但參數(shù)的解釋由各用戶自行處理。x 為自定義字符串，是用戶的確認標志，其解釋由用戶自行處理?！皒”不得使用 “#00”“#49”，“x”字符串中不得出現(xiàn)“;”號。5、 儀器廠家對數(shù)據(jù)下傳信息的取舍服務器數(shù)據(jù)下能是給用戶

6、修改測站運行參數(shù)、命令、文件等提供的一個。公共數(shù)據(jù)下傳協(xié)議規(guī)定（預留）的下傳數(shù)據(jù)包考慮了大多數(shù)現(xiàn)有設備的綜合情況。在具體處理下傳數(shù)據(jù)包時，用戶可根據(jù)自己設備的具體情況對下傳數(shù)據(jù)包的內(nèi)容進行取舍。如果用戶不能執(zhí)行某些下傳數(shù)據(jù)包的參數(shù)或命令，用戶可以忽略該數(shù)據(jù)包，如果用戶只能執(zhí)行下傳數(shù)據(jù)包的部分內(nèi)容，用戶可以忽略不能執(zhí)行的其它內(nèi)容。如果公共數(shù)據(jù)下傳協(xié)議規(guī)定（預留）的下傳數(shù)據(jù)包的內(nèi)容沒有包括用戶設備功能，用戶可以自定義字符串下傳令或數(shù)據(jù)。即使公共數(shù)據(jù)下傳協(xié)議規(guī)定（預留）的下傳數(shù)據(jù)包內(nèi)容包含了用戶設備功能，但用戶感覺使用不方便的，用戶仍然可以用自定義字的符串下傳與本協(xié)議功能重復的內(nèi)容。2二、公共數(shù)據(jù)下

7、傳協(xié)議預留數(shù)據(jù)包1、服務器時鐘與確認#00(年-月-日;時:分:秒;上傳數(shù)據(jù)包確認)，全部ASCII 半角字符，無確認信息。年：月：日：時：分：秒：范圍：200065535，年參數(shù)采用千年制；范圍：112范圍：131范圍：023范圍：059范圍：059上傳數(shù)據(jù)包確認：OKER上傳的數(shù)據(jù)包有效上傳的數(shù)據(jù)包無效例：#00(2010-08-20;08:15:07;OK)#00(2010-11-05;23:09:23;ER)/服務器時鐘 2010 年 08 月 20 日 08 時 15 分 07 秒，上傳的數(shù)據(jù)包有效服務器時鐘 2010 年 11 月 05 日 23 時 09 分 23 秒，上傳的數(shù)據(jù)

8、包無效2、附件文件下傳數(shù)據(jù)包#01(附件文件長度,附件文件內(nèi)容)返回數(shù)據(jù)包：$AAA;設備;口令;名;測站名;年-月-日 時:分:秒;#01(附件文件長度,);$END。“附件文件長度”指明“附件文件內(nèi)容”的大小。雖然#01 數(shù)據(jù)包的“）”是數(shù)據(jù)包的結束標志，但#01 數(shù)據(jù)包并未限定附件文件的格式，這就有可能在附件文件中出現(xiàn)與）相同的數(shù)據(jù)內(nèi)容。用“附件文件長度”可以知道附件文件的正確結束位置。 “附件文件內(nèi)容”的數(shù)據(jù)格式由附件文件而定，例如可以是TXT、HEX、BMP、JPEG等格式。#01 數(shù)據(jù)包的其余部分全部是ASCII 半角字符。舉例：下傳數(shù)據(jù)包：#01(32768,xx )附件文件內(nèi)容

9、附件文件長度識別字符上傳確認包：$AAA;設備;口令;名;測站名;年-月-日 時:分:秒;#01(32768,);$END。33、測站通信基本信息的設置：#02(,口令,名 GB2321 碼,測站名 GB2321 碼)返回數(shù)據(jù)包：$AAA;設備;口令;名;測站名;年-月-日 時:分:秒; #02(,);$END。短消息修改上傳數(shù)據(jù)包基本信息的設置可以是：#02(設備,口令,名GB2321 碼,測站名 GB2321 碼)。由于短消息識別測站的依據(jù)是測站機號碼，所以短消息修改“上傳數(shù)據(jù)包基本信息的設置”可以包括“設備”。因為即使出現(xiàn)錯誤，短消息仍可以通過機號碼識別重新修改“設備”。而服務器識別儀器

10、的依據(jù)是“設備”，如果修改“設備”出現(xiàn)錯誤，服務器將無法再以“設備”為識別依據(jù)重新修改“設備”。所以服務器修改上傳數(shù)據(jù)包基本信息不包括“設備”。#02 數(shù)據(jù)包的“口令”修改后設備將以新的“口令”上傳數(shù)據(jù)，因此“口令”修改前應得到數(shù)據(jù)接收中心的確認?？诹罘秶?；#02 數(shù)據(jù)包的“#02 數(shù)據(jù)包的“名GB2321 碼”、“測站名GB2321 碼”如果是拼音或英文，采用ASCII 半角字符；名GB2321 碼”、“測站名GB2321 碼”如果是漢字，采用 GB2321 碼（每個漢字 2 字節(jié) GB2321 碼）；#02 數(shù)據(jù)包的其余部分全部是ASCII 半角字符。目前在服務器的“名”和“測站名”顯

11、示中仍然保留著漢語拼音或英文的顯示，服務器仍然保留著漢語拼音或英文與漢字的對照翻譯。這是因為在沒有服務器修改“名”和“測站名”前，各都是采用短消息修改，而短消息不能支持用于計算機顯示的漢字GB2321 碼。采用服務器修改就名GB2321 碼”和“測站名 GB2321 碼”就可以直接顯示漢字而不再需要可以直接下翻譯。#03(位名 GB2321 碼”和“測站名GB2321 碼”。這樣修改后再上傳的“名 Unicode 碼,測站名 Unicode 碼)返回數(shù)據(jù)包：$AAA;設備;口令;名;測站名;年-月-日 時:分:秒; #03(名 Unicode 碼,測站名 Unicode 碼);$END。#03

12、 數(shù)據(jù)包的“#03 數(shù)據(jù)包的“名Unicode 碼”、“測站名Unicode 碼”為漢字Unicode 碼（每個漢字 2 字節(jié) Unicode 碼），其余部分為ASCII 半角字符。名Unicode 碼”和“測站名Unicode 碼”是為數(shù)據(jù)發(fā)送給而設置的。因為漢字發(fā)送給服務器與漢字發(fā)送給所用的漢字編碼不同，漢字發(fā)送往服務器的是GB2321 碼，漢字發(fā)送往的是Unicode 碼。#03 數(shù)據(jù)包的“名Unicode 碼”和“測站名 Unicode 碼”由服務器根據(jù)#02(;口令;名GB2321 碼;測站名GB2321 碼)中的“名 GB2321 碼”和“測站名 GB2321 碼”自動翻譯成Uni

13、code 碼，用#03(名Unicode 碼;測站名Unicode 碼)的數(shù)據(jù)形似下傳給測站設備。注：沒有查詢功能的測站可以忽略#03 數(shù)據(jù)包。4舉例：下傳數(shù)據(jù)包：/ 相當于：#02(,1122334455,C4CF BEA9 CBAE CEC4,BDAD C4FE CBAE BFE2)新的測站名GB2321 碼新的 名GB2321 碼新口令#02(,1122334455,南京水文,江寧水庫)服務器下傳的#02 數(shù)據(jù)包設備識別字符始終為空上傳確認包：$AAA;設備;1122334455;南京水文;江寧水庫;年-月-日 時:分:秒;#02(,);$END。下傳數(shù)據(jù)包：#03(53574EAC 6

14、C34 6587, 6C5F 5B81 6C34 5E93) / 相當于：#03(南京水文Unicode 碼,江寧水庫Unicode 碼) 新的測站名Unicode 碼 新的名Unicode 碼 識別字符上傳確認包：$AAA;設備;口令;名;測站名;年-月-日 時:分:秒;#03(5357 4EAC 6C34 6587, 6C5F 5B81 6C34 5E93);$END。4、服務器 IP 設置：#04(IP1 地址,IP1 啟閉,IP2 地址,IP2 啟閉)。全部ASCII 半角字符用原 IP 返回數(shù)據(jù)包：$AAA;設備;口令;名;測站名;年-月-日 時:分:秒; #04(新 IP1 地址,

15、IP1 啟閉,新 IP2 地址,IP2 啟閉);$END。特別提醒：由于修改IP 之后再上傳的數(shù)據(jù)包就會發(fā)往新的IP 地址，原IP 服務器將無法接收返回的信息，所以執(zhí)行“#04”參數(shù)修改信息必須用原IP 返回確認信息（即先返回確認信息，再修改IP 地址）。IP1 地址和 IP2 地址是測站即將修改的服務器IP，如果修改出現(xiàn)錯誤，測站將無法繼續(xù)與服務器取得聯(lián)系，糾正 IP 的錯誤只能依靠短消息進修。因此，測站必須保留短消息設置“#04(IP1 地址,IP1 啟閉,IP2 地址,IP2 啟閉)”的功能做為與測站聯(lián)系的最后保障。IP1 啟閉和 IP2 啟閉是數(shù)據(jù)上傳服務器 IP1 和 IP2 的允許

16、或上傳至相應的IP標志，取值范圍：0，1?！?” 表示不允許將數(shù)據(jù)上傳至相應的 IP；“1” 表示允許將數(shù)據(jù)5舉例：下傳數(shù)據(jù)包：#04(219.148.51.76:10808,1,112.125.33.161:10808,0)0：不允許將數(shù)據(jù)上傳至IP2 IP2：112.125.33.161:108081：允許將數(shù)據(jù)上傳至IP1 IP1：219.148.51.76:10808識別字符向原 IP 上傳確認包： $AAA;設備;口令;名;測站名;年-月-日 時:分:秒;#04(219.148.51.76:10808,1,112.125.33.161:10808,0);$END5、 數(shù)據(jù)上傳方式設置

17、#05(實時數(shù)定時上傳時間間隔,實時數(shù)加報時間間隔,加報參數(shù)變幅,密集數(shù)上傳時間間隔,密集數(shù)時間間隔)。全部 ASCII 半角字符：分鐘分鐘雨量 mm水位 m小時分鐘返回數(shù)據(jù)包：$AAA;設備;口令;名;測站名;年-月-日 時:分:秒;#05(實時數(shù)上傳時間間隔,實時數(shù)加報時間間隔,加報參數(shù)變幅,密集數(shù)上傳時間間隔,密集數(shù)時間間隔);$END舉例：下傳數(shù)據(jù)包：#05(30,6,0.02,2,6) 密集數(shù)時間間隔：6 分鐘密集數(shù)上傳時間間隔：2 小時實時數(shù)加報參數(shù)變幅：0.02實時數(shù)加報時間間隔：6 分鐘實時數(shù)定時上傳時間間隔：30 分鐘識別字符上傳確認包：$AAA;設備;口令;名;測站名;年-

18、月-日 時:分:秒;#05(30,6,0.02,2,6);$END66、 上傳（補發(fā)）歷史密集數(shù)據(jù)命令#06(年-月-日,上傳密集數(shù)的天數(shù))。全部ASCII 半角字符返回數(shù)據(jù)包：$AAA;設備;口令;名;測站名;年-月-日 時:分:秒; #06(年-月-日,實際上傳密集數(shù)的天數(shù));$END。如果測站存有的數(shù)據(jù)不足要求上傳的天數(shù)，在密集數(shù)上傳完成后，返回確認信息時上傳實際上傳天數(shù)。舉例：下傳數(shù)據(jù)包：#06(2010-07-08,31)要求上傳 31 天數(shù)的密集數(shù)；密集數(shù)據(jù)的起始日期為 2010 年 07 月 08 日識別字符如果實際只上傳了 15 天的密集數(shù)，返回確認數(shù)據(jù)包為：上傳確認包：$AAA;設備;口令;名;測站名;年-月-日 時:分:秒; #06(2010-07-08,15);$END。7、測量基值#07(測量基值)。全部 ASCII 半角字符返回數(shù)據(jù)包：$AAA;設備;口令;