甘肅萬維家校通終端接口規(guī)范V1.0

1、甘肅電信家校通終端接口規(guī)范CDMA家校通甘肅萬維信息技術(shù)有限公司2012-3目錄CDMA家校通11縮略語42協(xié)議描述53數(shù)據(jù)類型和格式定義63.1數(shù)據(jù)類型定義63.2包格式概述63.3包格式布局63.4包內(nèi)容常見數(shù)據(jù)說明63.5包的最大長度74公話通信接口包格式定義84.1學(xué)生卡老師卡請求時長短信條數(shù)操作84.1.1學(xué)生卡老師卡請求時長短信條數(shù)語法(由公話發(fā)給Server端) 0184.1.2學(xué)生卡老師卡請求時長短信條數(shù)應(yīng)答語法(由Server發(fā)給公話) 0194.2學(xué)生卡讀取短信留言操作94.2.1學(xué)生卡讀取留言請求語法(由公話發(fā)給Server端) 0294.2.2學(xué)生卡讀取留言請求應(yīng)答語法

2、(由Server端發(fā)給公話) 02104.3報警信息處理操作114.3.1傳報警信息語法(由公話發(fā)給Server端) 03114.3.2傳報警信息應(yīng)答語法(由Server發(fā)給公話) 03114.4修改服務(wù)器IP地址端口號操作124.4.1修改服務(wù)器IP地址端口號語法(由server發(fā)給公話端) 04124.4.2修改服務(wù)器IP地址端口號應(yīng)答語法(由公話發(fā)給服務(wù)器端) 04134.5上傳話單操作144.5.1上傳話單語法(由公話發(fā)給Server端) 05144.5.2上傳話單應(yīng)答語法(由server端發(fā)給公話) 05144.6上傳進出校信息操作154.6.1上傳進出校信息語法(由公話發(fā)給serv

3、er端) 08154.6.2上傳進出校信息應(yīng)答語法(由server端發(fā)給公話) 08164.7報警信息發(fā)送時間間隔下載164.7.1報警信息發(fā)送時間間隔語法(由server端發(fā)給終端) 09164.7.2報警信息發(fā)送時間間隔下載應(yīng)答語法(由公話發(fā)給server端) 09174.8查詢終端話機狀態(tài)174.8.1查詢終端話機狀態(tài)語法(由server端發(fā)給終端) 0A174.8.2查詢終端話機狀態(tài)回應(yīng)語法(由公話發(fā)給server端) 0A174.9時間校驗184.9.1時間校驗語法(由公話發(fā)給server端) 0C184.9.2時間校驗語法(由server端發(fā)給公話) 0C184.10學(xué)號登錄194

4、.10.1學(xué)號登錄語法(由公話發(fā)給server端) 0D194.10.2學(xué)號登錄應(yīng)答語法(由server端發(fā)給公話) 0D194.11心跳包204.11.1心跳包語法(由公話發(fā)給server端)10204.11.2心跳包應(yīng)答語法(由server端發(fā)給公話)10205功能號總表211 縮略語l SC (Service Center)：服務(wù)中心l CCST (Child-caring System Teminal)：親情電話公話終端，又稱家校通終端l CCS（Child-caring System）：親情電話系統(tǒng)，又稱家校通平臺l CCSCP（Child-caring System: Commun

5、ication Protocol）：親情電話系統(tǒng)通訊協(xié)議，又稱家校通平臺通訊協(xié)議l SRFC (Student RF Card)：學(xué)生、老師等專用的RF卡2 協(xié)議描述l 親情電話公話接口采用1X協(xié)議與電信SC進行數(shù)據(jù)通訊。本質(zhì)上是基于TCP/IP協(xié)議之上的應(yīng)用層協(xié)議，以TCP協(xié)議進行數(shù)據(jù)傳輸，采用請求/應(yīng)答的同步通訊模型實現(xiàn)。l SC使用公網(wǎng)地址，在某個端口偵聽親情電話公話連接，使用認證方式建立連接。注：數(shù)據(jù)包包由終端發(fā)出后未收到響應(yīng)，或終端發(fā)送不成功，終端應(yīng)該間閣T秒后重發(fā)，重新發(fā)送N-1次后放棄，建議T=30，N=3。3 數(shù)據(jù)類型和格式定義3.1 數(shù)據(jù)類型定義類型說明String僅限于09

6、 和大寫的AZ3.2 包格式概述包格式頭體較驗和同步幀序號機器號包長度功能號包內(nèi)容(功能號+包內(nèi)容)341842N23.3 包格式布局下面是一個完整包格式的布局：包格式 域長度類型說明頭同步幀3String1、 CCST上傳：同步幀=TPJ2、 SC下傳： 同步幀=JTP序號4String此域表示一個序列號，使用在異步通信模式下，由消息發(fā)起者設(shè)定，應(yīng)答者對應(yīng)給回此序列號。序列號范圍：0000ffff，循環(huán)使用。同步方式下該域保留。體機器號18String親情電話公話終端ID包長度4String2N （ASCII表示的16進制數(shù) 例 2+N=10 L=000A）功能號2String包內(nèi)容NStr

7、ing較驗和(功能號+包內(nèi)容)2String功能號+包內(nèi)容的和取低位兩個字節(jié)(ASCII表示的16進制數(shù))3.4 包內(nèi)容常見數(shù)據(jù)說明數(shù)據(jù)名稱數(shù)據(jù)類型數(shù)據(jù)長度說明可通話時長 String6HHMMSS ASCII表示的16進制數(shù)電話號碼String16TELNUM每個號碼為16字節(jié),不足16字節(jié)用空格(0x20)補足日期String6YYMMDD 時間String6HHMMSS漢字編碼StringN規(guī)定長度為N,不足N字節(jié)用0X20（空格）補足常用語編號String6BBSSNN BB表示大類 (0009) SS 表示小類(0009)NN 表示N個常用語(0009)例 生日祝福 BB 老師類 S

8、S 老師您辛苦了祝您生日快樂! NN 3.5 包的最大長度最大包長：發(fā)送一包信息的最大長度小于1024字節(jié)位數(shù)不足的情況：左對齊，用空格（0X20）補足。4 公話通信接口包格式定義4.1 學(xué)生卡老師卡請求時長短信條數(shù)操作4.1.1 學(xué)生卡老師卡請求時長短信條數(shù)語法(由公話發(fā)給Server端) 01序號域名長度類型描述1同步幀3StringTPJ2序號4流水號3機器號18公話ID4包長度45功能號201請求通話時長和短信條數(shù)6包內(nèi)容20卡號7較驗和24.1.2 學(xué)生卡老師卡請求時長短信條數(shù)應(yīng)答語法(由Server發(fā)給公話) 01序號域名長度類型描述1同步幀3StringJTP2序號4流水號3機器

9、號18公話ID4包長度45功能號201請求通話時長和短信條數(shù)以及親情號碼6包內(nèi)容卡是否有效10 無效 (>0 有效)1、學(xué)生卡2、教師卡3、家長卡4、園長卡9、巡檢卡時長6HHMMSS留言條數(shù)2親情稱呼10*6如”爸爸”5個漢字親情號碼16*6TELNUM7較驗和2功能號+包內(nèi)容的和取最后兩個字節(jié)說明: 沒有老師卡親情號碼和親情稱呼，填空格補齊4.2 學(xué)生卡讀取短信留言操作4.2.1 學(xué)生卡讀取留言請求語法(由公話發(fā)給Server端) 02序號域名長度類型描述1同步幀3StringTPJ2序號4流水號3機器號18公話ID4包長度45功能號202請求讀取留言6包內(nèi)容20卡號7較驗和24.2

10、.2 學(xué)生卡讀取留言請求應(yīng)答語法(由Server端發(fā)給公話) 02 序號域名長度類型描述1同步幀3StringJTP2序號4流水號3機器號18公話ID4包長度45功能號202讀取留言6包內(nèi)容短信條數(shù)2每次下傳的短信條數(shù)不大于10條，每條最多70個漢字。第i條短信的長度碼2i.len=(2+16+12+N), len為ASCII表示十六進制數(shù)第i條短信的發(fā)信人電話號碼16TELNUM第i條短信的發(fā)信日期時間12YYMMDDHHMMSS第i條短信的內(nèi)容N短信內(nèi)容為ASCII表示的內(nèi)碼第i+1條短信的長度碼.第.內(nèi)容7較驗和2功能號+包內(nèi)容的和取最后兩個字節(jié) 4.3 報警信息處理操作4.3.1 傳報

11、警信息語法(由公話發(fā)給Server端) 03序號域名長度類型描述1同步幀3StringTPJ2序號4流水號3機器號18公話ID4包長度45功能號203傳報警信息6包內(nèi)容SIM 卡卡號16TELNUM第1類警情2機門打開 有警情時發(fā)85無警情時發(fā)55第2類警情2手柄斷開 有警情時發(fā)85無警情時發(fā)55第3類警情2讀卡頭讀卡失敗有警情時發(fā)85無警情時發(fā)55第4類警情2供電狀態(tài)外電供電85電池供電55電池電壓底00第5類警情2預(yù)留7較驗和2功能號+包內(nèi)容的和取最后兩個字節(jié) 4.3.2 傳報警信息應(yīng)答語法(由Server發(fā)給公話) 03序號域名長度類型描述1同步幀3StringJTP2序號4流水號3機器

12、號18公話ID4包長度45功能號203請求讀取短信留言6包內(nèi)容2/5OK / ERROR7較驗和2 4.4 修改服務(wù)器IP地址端口號操作4.4.1 修改服務(wù)器IP地址端口號語法(由server發(fā)給公話端) 04序號域名長度類型描述1同步幀3StringJTP2序號4流水號3機器號18公話ID4包長度45功能號204修改IP地址和端口號信息6包內(nèi)容DATE6YYMMDD起始日期 (從此日期后開始使用新的IP地址和端口號)IP地址N例 218.17.104.80逗號1,端口號N例 2020逗號1,備用IP地址N例 121.9.168.80逗號1,備用端口號N例 2020逗號1,備用激活標(biāo)志10:不

13、激活 1:激活7較驗和2功能號+包內(nèi)容的和取最后兩個字節(jié) 注意：沒有I及端口時需要填寫000.000.000.000,0000 4.4.2 修改服務(wù)器IP地址端口號應(yīng)答語法(由公話發(fā)給服務(wù)器端) 04序號域名長度類型描述1同步幀3StringTPJ2序號4流水號3機器號18公話ID4包長度45功能號204修改IP地址和端口號應(yīng)答信息6包內(nèi)容2/5OK / ERROR7較驗和24.5 上傳話單操作4.5.1 上傳話單語法(由公話發(fā)給Server端) 05序號域名長度類型描述1同步幀3StringTPJ2序號4流水號3機器號18公話ID4包長度45功能號205上傳話單6包內(nèi)容卡號20日期6YYMM

14、DD時間6HHMMSS通話時長6HHMMSS號碼16TELNUM7較驗和2功能號+包內(nèi)容的和取最后兩個字節(jié)4.5.2 上傳話單應(yīng)答語法(由server端發(fā)給公話) 05序號域名長度類型描述1同步幀3StringJTP2序號4流水號3機器號18公話ID4包長度45功能號205 上傳話單回應(yīng)6包內(nèi)容2/5OK / ERROR7較驗和24.6 上傳進出校信息操作4.6.1 上傳進出校信息語法(由公話發(fā)給server端) 08序號域名長度類型描述1同步幀3StringTPJ2序號4流水號3機器號18公話ID4包長度45功能號208上傳考勤信息6考勤記錄總條數(shù)2最多30條7包內(nèi)容卡號20日期6YYMMD

15、D時間6HHMMSS進出校11進校 2出校狀態(tài)2學(xué)生狀態(tài)（0E確定內(nèi)容）（保留）狀態(tài)時間4HHMM（保留）8較驗和2功能號+包內(nèi)容的和取最后兩個字節(jié)附：關(guān)于包內(nèi)容-狀態(tài)值的說明：協(xié)議兼容幼教通版本，家校通版本此狀態(tài)（學(xué)生狀態(tài)）值可隨意填寫。幼教通版本說明：學(xué)生進出校用家長卡。其他教師卡、園長卡等用于考勤。家長卡：狀態(tài)值: 01 ：健康(正常） 02 ：加餐 03 ：吃藥進校：不按狀態(tài)或者按確認鍵，狀態(tài)值為01，進出校值為1，此時需要發(fā)送短信（根據(jù)不同的狀態(tài)值發(fā)短信給家長和老師）。 進出校值為1，狀態(tài)值為2或者3時，有加餐和吃藥時間。上學(xué)時可以輸入多個狀態(tài)或者狀態(tài)時間（分幾條消息上報）。需要定時

16、發(fā)短信給老師提醒。當(dāng)輸入結(jié)束后，終端發(fā)狀態(tài)值01到平臺，做考勤數(shù)據(jù)。出校： 1、當(dāng)身份得到驗證成功，直接按確認鍵，狀態(tài)值為01，進出校值為2，此時需要發(fā)送短信；2、當(dāng)身份得到驗證失敗，直接按取消鍵，狀態(tài)值為99，進出校值為2，此時不需要發(fā)送短信（小孩不能夠被接出校，也可以平臺設(shè)置是否發(fā)短信）；老師卡: 老師刷卡輸入狀態(tài)值。狀態(tài)值:06 ：考勤上班07 ：調(diào)體 08 ：公出 4.6.2 上傳進出校信息應(yīng)答語法(由server端發(fā)給公話) 08序號域名長度類型描述1同步幀3StringJTP2序號4流水號3機器號18公話ID4包長度45功能號208上傳考勤信息應(yīng)答6包內(nèi)容狀態(tài)2/5OK / ERR

17、OR7較驗和24.7 報警信息發(fā)送時間間隔下載4.7.1 報警信息發(fā)送時間間隔語法(由server端發(fā)給終端) 09序號域名長度類型描述1同步幀3StringJTP2序號4流水號3機器號18公話ID4包長度45功能號209下載時間間隔6包內(nèi)容4單位分鐘 ,16進制表示的ASC 例:0x000A 即10分鐘上傳一次報警信息7較驗和2功能號+包內(nèi)容的和取最后兩個字節(jié)4.7.2 報警信息發(fā)送時間間隔下載應(yīng)答語法(由公話發(fā)給server端) 09序號域名長度類型描述1同步幀3StringTPJ2序號4流水號3機器號18公話ID4包長度45功能號209時間間隔應(yīng)答6包內(nèi)容2/5OK / ERROR7較驗

18、和24.8 查詢終端話機狀態(tài)4.8.1 查詢終端話機狀態(tài)語法(由server端發(fā)給終端) 0A序號域名長度類型描述1同步幀3StringJTP2序號4流水號3機器號18公話ID4包長度45功能號20A查詢終端話機狀態(tài)6包內(nèi)容6STRING”STATUS”7較驗和2功能號+包內(nèi)容的和取最后兩個字節(jié)4.8.2 查詢終端話機狀態(tài)回應(yīng)語法(由公話發(fā)給server端) 0A回復(fù)內(nèi)容同：告警上報。4.9 時間校驗4.9.1 時間校驗語法(由公話發(fā)給server端) 0C序號域名長度類型描述1同步幀3StringTPJ2序號4流水號3機器號18公話ID4包長度45功能號20C時間校驗6包內(nèi)容07較驗和2功能

19、號+包內(nèi)容的和取最后兩個字節(jié)4.9.2 時間校驗語法(由server端發(fā)給公話) 0C序號域名長度類型描述1同步幀3StringJTP2序號4流水號3機器號18公話ID4包長度45功能號20C 時間校驗6包內(nèi)容14yyyyMMddHHmmss7較驗和2功能號+包內(nèi)容的和取最后兩個字節(jié)4.10 學(xué)號登錄4.10.1 學(xué)號登錄語法(由公話發(fā)給server端) 0D序號域名長度類型描述1同步幀3StringTPJ2序號4流水號3機器號18公話ID4包長度45功能號20D學(xué)號登錄6包內(nèi)容8學(xué)生ID7較驗和2功能號+包內(nèi)容的和取最后兩個字節(jié)注意：學(xué)生ID用10進制的數(shù)字表示，不滿8位的在右邊用“F”補齊

20、。4.10.2 學(xué)號登錄應(yīng)答語法(由server端發(fā)給公話) 0D序號域名長度類型描述1同步幀3StringJTP2序號4流水號3機器號18公話ID4包長度45功能號20D請求通話時長和短信條數(shù)以及親情號碼6包內(nèi)容時長6HHMMSS親情稱呼10*6如”爸爸”，5個漢字親情號碼16*6TELNUM7較驗和2功能號+包內(nèi)容的和取最后兩個字節(jié)學(xué)號登錄：是在教師刷卡后，終端收到平臺返回的卡屬性2以后，提示教師輸入學(xué)生學(xué)號獲取學(xué)生家長親情號碼。4.11 心跳包4.11.1 心跳包語法(由公話發(fā)給server端)10序號域名長度類型描述1同步幀3StringTPJ2序號4流水號3機器號18公話ID4包長度