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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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