“隴明公”平臺(tái)終端數(shù)據(jù)接口規(guī)范

VI.0

版本信息:vi.o

文檔日期：2020-12

目錄

一、概述.........................................................................4

二、目的及范圍...................................................................4

三、術(shù)語(yǔ)定義及縮略語(yǔ)............................................................4

四、數(shù)據(jù)包通訊規(guī)范..............................................................4

4.1通訊方式......................................................................4

4.2通訊數(shù)據(jù)包格式定義...........................................................4

五、數(shù)據(jù)包內(nèi)容格式定義..........................................................5

5.1設(shè)備登錄[823]...............................................................................................................................5

5.2獲取白名單[824]............................................................................................................................5

5.3上傳考勤信息[828]........................................................................................................................6

5.4獲取特征信息[841]........................................................................................................................7

5.5上傳包含勤照片及體溫的考勤信息[844]..................................................................................8

5.6獲取服務(wù)器時(shí)間[65532]................................................................................................................9

5.7心跳包[65535]................................................................................................................................9

六、常見(jiàn)問(wèn)題.....................................................................9

6.1獲取信息長(zhǎng)度是用來(lái)做什么的，對(duì)接的流程是什么...............................9

6.2關(guān)于數(shù)字是怎么傳輸?shù)?........................................................9

版本說(shuō)明

修訂人修訂版本描述修訂時(shí)間修訂內(nèi)容

蔣健vl.O2020/12

一、概述

本終端數(shù)據(jù)接口規(guī)范主要是為考勤設(shè)備的供應(yīng)商與“隴明公”平臺(tái)進(jìn)行數(shù)據(jù)

交互對(duì)接時(shí)使用。

本接口規(guī)范以“隴明公”平臺(tái)數(shù)據(jù)標(biāo)準(zhǔn)為指導(dǎo)，明確定義了考勤設(shè)備數(shù)據(jù)與“

隴明公”平臺(tái)對(duì)接的流程規(guī)范以及數(shù)據(jù)接口規(guī)范，用以指導(dǎo)相關(guān)對(duì)接工作的執(zhí)行。

本文主要讀者為相關(guān)廠商的技術(shù)人員。

二、目的及范圍

制定本規(guī)范的目的是為了統(tǒng)一考勤設(shè)備與“隴明公”平臺(tái)的對(duì)接標(biāo)準(zhǔn)；

本規(guī)范定義了終端設(shè)備登陸、上傳采集信息、獲取白名單、獲取人員特征信

息、上傳考勤信息，獲取服務(wù)器時(shí)間、上傳心跳信息等接口內(nèi)容。

三、術(shù)語(yǔ)定義及縮略語(yǔ)

下列縮略詞適用于本規(guī)范:

縮寫中文描述

實(shí)名制模塊“隴明公”平臺(tái)實(shí)名制模塊

白名單允許通過(guò)考勤設(shè)備進(jìn)行考勤的人員清單

四、數(shù)據(jù)包通訊規(guī)范

4.1通訊方式

本系統(tǒng)通訊方式采用Socket通訊方式。Socket連接建立后，按照通訊包格

式定義組合通訊包。通訊包的請(qǐng)求與響應(yīng)格式保持一致。

通訊失?。篺lag=1,Content二用于卡機(jī)顯示的錯(cuò)誤提示,UTF-8編碼。

4.2通訊數(shù)據(jù)包格式定義

起始位置長(zhǎng)度內(nèi)容說(shuō)明標(biāo)記類型備注

01開(kāi)始標(biāo)記HeaderByte0x01

14長(zhǎng)度LENLengthJint內(nèi)容的長(zhǎng)度

54分包順序索引Pai,tIndexUint0x00

94分包總數(shù)PartCountUint0x00

131版本VersionByte默認(rèn)0x03

142命令CommandUshort0x10

1616會(huì)話標(biāo)識(shí)SessionlDByte[16]通訊唯一標(biāo)識(shí)，每一個(gè)tcp連

接由設(shè)備隨機(jī)生成

32LEN內(nèi)容ContentByte[LEN]數(shù)據(jù)包內(nèi)容

32+LEN1狀態(tài)FlagByte0x0為成功，0x01為失敗

33+LEN1結(jié)束標(biāo)記TailByte0x01

五、數(shù)據(jù)包內(nèi)容格式定義

5.1設(shè)備登錄[823]

說(shuō)明

備通訊的其他命令必須在本命令執(zhí)行成功后，才可以使用。

Content

位置名稱字節(jié)格式說(shuō)明

數(shù)

0-31廠家識(shí)別碼32ASCII32位廠家識(shí)別碼由騰暉提供，所

有設(shè)備一樣

32-63設(shè)備的唯一標(biāo)識(shí)碼32ASCH每臺(tái)設(shè)備的唯一標(biāo)識(shí)

64校驗(yàn)和1HEXXor校驗(yàn)運(yùn)算

5?2獲取白名單[824]

說(shuō)明

Content：

位置名稱字節(jié)數(shù)格式說(shuō)明

0-31設(shè)備的唯一標(biāo)識(shí)32ASCII每臺(tái)設(shè)備的唯一標(biāo)識(shí)

碼

32-38該設(shè)備最后獲取7HEXBCD碼，年占2字節(jié)，月、日、

數(shù)據(jù)時(shí)間時(shí)、分、秒各占一個(gè)字節(jié)

39校驗(yàn)和1HEXXor校驗(yàn)運(yùn)算

返回值:

位置名稱字節(jié)格式說(shuō)明

數(shù)

0-3項(xiàng)目編號(hào)4HEX低位在前

4-103項(xiàng)目名稱100UTF-8用于機(jī)器顯示用

104-104+CL數(shù)據(jù)記錄CL數(shù)據(jù)記錄可以為多條記

錄，根據(jù)每條記錄的第一

個(gè)字節(jié)來(lái)判斷每條記錄

的長(zhǎng)度和格式

105+CL-106+CL校驗(yàn)和1HEX

重復(fù)追加的內(nèi)容

Content：Add

位置名稱字節(jié)格式說(shuō)明

數(shù)

0增加或者刪1Hex0為新增用戶，1為刪除

除標(biāo)志用戶

1-4工人編號(hào)-1HEX刷卡成功上傳時(shí)需要用

到

5-14工人姓名10UTF-8

15-32身份證號(hào)碼18ASCII

33-62工作崗位30UTF-8

63-69最后培訓(xùn)時(shí)7HEXBCD碼，年占2字節(jié)，月、

間日、時(shí)、分、秒各占一個(gè)

字節(jié)

70-73特征信息長(zhǎng)4Hex固定值0

度(FL)

74-74+FL特征信息FLHEX人員特征信息，根據(jù)特長(zhǎng)

度

74+FL-80+FL其他6

80+FL-81+FL備份1備份

Content：Del

位置名稱字節(jié)格式說(shuō)明

數(shù)

0增加或者刪1Hex0為新增用戶，1為刪除

除標(biāo)志用戶

1-4工人編號(hào)4HEX刷卡成功上傳時(shí)需要用

到

若第一個(gè)字節(jié)為1則格式使用Content：Del.

若第一個(gè)字節(jié)為0,則格式使用Content：Add.

該命令一個(gè)小時(shí)調(diào)用一次，設(shè)備必須記錄每次獲取特征信息成功的時(shí)間。

5.3上傳考勤信息[828]

說(shuō)明

多條信息重復(fù)追加Content

Content：

位置名稱字節(jié)數(shù)格式說(shuō)明

0-3工人編號(hào)4HEX低位在前

4-10刷卡時(shí)間7HEXBCD碼，年占2字節(jié)，月、日、

時(shí)、分、秒各占一個(gè)字節(jié)

11刷卡模式1HEX1表示虹膜，6表示人臉

12-15照片長(zhǎng)度(PL)4HEX低位在前

16-照片信息PLHEX考勤照片的字節(jié)數(shù)組

(PL+16-

1)

LEN-1校驗(yàn)和1HEXXor校驗(yàn)運(yùn)算

5.4獲取特征信息[841]

Content：

位置名稱字節(jié)格式說(shuō)明

數(shù)

0-15驗(yàn)證票據(jù)16ASCII安全性驗(yàn)證

（固定值：FACESOCKETACCESS）

16-19項(xiàng)目編號(hào)4HEX項(xiàng)目ID

20-20是否全量獲1HEX1：是0：否

取

21-21身份證個(gè)數(shù)1HEX最大100

22-22+CL身份證列表身份證列表，最大限制100個(gè)

CL

23+CL-23+CL校驗(yàn)和1HEXXor校驗(yàn)運(yùn)算

重復(fù)追加身份證列表:

位置名稱字節(jié)格式說(shuō)明

數(shù)

0-17身份證號(hào)碼18ASCII身份證號(hào)碼

返回值:

位置名稱字節(jié)數(shù)格式說(shuō)明

0-1記錄條數(shù)2HEX記錄條數(shù)

2-2+C數(shù)據(jù)記錄CL數(shù)據(jù)記錄可以為多條記錄

L

2+CL校驗(yàn)和1HEXXor校驗(yàn)運(yùn)算

重復(fù)追加身人員數(shù)據(jù)記錄:

位置名稱字節(jié)數(shù)格式說(shuō)明

0-9姓名10UTF-8姓名

10-27身份證號(hào)18ASCII

身份證號(hào)碼

碼

28民族1HEX代號(hào)

29-30性別2ASCII1：男：0：女

31-170身份證地140UTF8身份證地址

址

171-186出生年月16ASCIIyyyyMMdd()

日

187-246發(fā)證機(jī)關(guān)60UTF8發(fā)證機(jī)關(guān)

247-310有效期64UTF8有效期

311-314項(xiàng)目編號(hào)4HEX項(xiàng)目編號(hào)

315-318班組編號(hào)4HEX班組編號(hào)

319-322工種編號(hào)4HEX工種編號(hào)

323-326采集照片4Hl-X

采集照片長(zhǎng)度

長(zhǎng)度(GL)

326-(326+GL-GLHEX

采集照片采集照片

1)

(326+GL)-身份證照4HEX

(326+GL+3)片長(zhǎng)度身份證照片長(zhǎng)度

(PL)

(326+GL+4)-(PLHEX

身份證照

身份證照片

316+GL+4+PL-片

1)

(326+GL+4+PL4Hl-X

紅外照片

)-(326+GL+4紅外照片長(zhǎng)度

長(zhǎng)度(HL)

+PL+3)

(326+GL+4+PL紅外照片HLHEX紅外照片

+4)-

(326+GL+4+PL

+4+HL-1)

5.5上傳包含勤照片及體溫的考勤信息[844]

說(shuō)明

多條信息重復(fù)追加Content

Content:

位置名稱字節(jié)數(shù)格式說(shuō)明

0-3工人編號(hào)4HEX低位在前

4-10刷卡時(shí)間7HEXBCD碼，年占2字節(jié)，月、日、