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

1、公共數(shù)據(jù)下傳協(xié)議V1.0一、公共數(shù)據(jù)下傳協(xié)議 V1.0說明1、 數(shù)據(jù)包結(jié)構(gòu)特點(diǎn)數(shù)據(jù)下傳數(shù)據(jù)包的結(jié)構(gòu)充份考慮了修改測(cè)站運(yùn)行配置信息與參數(shù)的數(shù)據(jù)包結(jié)構(gòu)的特點(diǎn)，公共數(shù)據(jù)服務(wù)器下傳數(shù)據(jù)包盡可能與修改數(shù)據(jù)包的結(jié)構(gòu)一致。原修改運(yùn)行配置的數(shù)據(jù)結(jié)構(gòu)為：#n(參數(shù) 1,參數(shù) 2,參數(shù) 3,參數(shù) 4,參數(shù)x)其中 n 為設(shè)置或待查詢的功能號(hào)，可用的字符為：19，AZ。如：#01、#99、#A1、#2B。如果某個(gè)參數(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ù)上傳后的“服務(wù)器時(shí)鐘與確

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

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

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

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

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

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

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

9、附件文件長度識(shí)別字符上傳確認(rèn)包：$AAA;設(shè)備;口令;名;測(cè)站名;年-月-日 時(shí):分:秒;#01(32768,);$END。33、測(cè)站通信基本信息的設(shè)置：#02(,口令,名 GB2321 碼,測(cè)站名 GB2321 碼)返回?cái)?shù)據(jù)包：$AAA;設(shè)備;口令;名;測(cè)站名;年-月-日 時(shí):分:秒; #02(,);$END。短消息修改上傳數(shù)據(jù)包基本信息的設(shè)置可以是：#02(設(shè)備,口令,名GB2321 碼,測(cè)站名 GB2321 碼)。由于短消息識(shí)別測(cè)站的依據(jù)是測(cè)站機(jī)號(hào)碼，所以短消息修改“上傳數(shù)據(jù)包基本信息的設(shè)置”可以包括“設(shè)備”。因?yàn)榧词钩霈F(xiàn)錯(cuò)誤，短消息仍可以通過機(jī)號(hào)碼識(shí)別重新修改“設(shè)備”。而服務(wù)器識(shí)別儀器

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

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

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

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

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

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

16、或上傳至相應(yīng)的IP標(biāo)志，取值范圍：0，1?！?” 表示不允許將數(shù)據(jù)上傳至相應(yīng)的 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識(shí)別字符向原 IP 上傳確認(rèn)包： $AAA;設(shè)備;口令;名;測(cè)站名;年-月-日 時(shí):分:秒;#04(219.148.51.76:10808,1,112.125.33.161:10808,0);$END5、 數(shù)據(jù)上傳方式設(shè)置

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

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