護(hù)照閱讀器串口主動(dòng)讀卡通訊協(xié)議，適用于東信智能EST-100PR-NZ&EST-100PR-T系列護(hù)照機(jī)。

該護(hù)照閱讀器采用主動(dòng)讀卡模式，需要調(diào)用SDK和API，閱讀機(jī)通電后就自動(dòng)讀卡，數(shù)據(jù)通過串口方式輸出，可接Windows、Android、Linux、單片機(jī)、國(guó)產(chǎn)系統(tǒng)、鴻蒙系統(tǒng)等設(shè)備使用。

USB虛擬串口 VID_06CE&PID_E03E

****************************使用串口助手即可收到讀卡數(shù)據(jù)****************************

串口使用波特率256000 停止位1 數(shù)據(jù)位8 校驗(yàn)位ODD

數(shù)據(jù)為JSON編碼,所有數(shù)據(jù)使用UTF-8編碼

為方便解析,實(shí)際發(fā)送數(shù)據(jù)時(shí)會(huì)添加頭部和尾部

0x02(頭部) + DATA + 0x03 + \r + \n (尾部)

設(shè)備有以下數(shù)據(jù)類型

1、CameraData : 該類型是OCR識(shí)別到的MRZ信息或二維碼信息

data:數(shù)據(jù)內(nèi)容

type:數(shù)據(jù)類型

            QRCode:二維碼數(shù)據(jù)

            PassPort:護(hù)照數(shù)據(jù)

QRType:二維碼類型(僅數(shù)據(jù)是二維碼數(shù)據(jù)是有該字段)

數(shù)據(jù)示例:

MRZ數(shù)據(jù):

    CameraData:{"data":"POCHNLIN<<***D<<<<<<<<<<<<<<<<<<<<<<<<<<<<<\nE9249***17CHN0512022F2112264MBN***HLCA078","type":"PassPort"}

二維碼數(shù)據(jù):

    CameraData:{"QRType":"QR CODE","data":"https://www.xxx.com/","type":"QRCode"}

2、PCSign : 該類型是讀取護(hù)照或身份證的流程信息

stage:設(shè)備當(dāng)前讀取狀態(tài)

    readStart:讀取開始

    readEnd:讀取結(jié)束

type:讀取類型

    IDInfo:身份證

    PassPort:護(hù)照

數(shù)據(jù)示例:

    PCSign:{"stage":"readStart","type":"PassPort"}

    PCSign:{"stage":"readEnd","type":"PassPort"}

3、ReaderData: 該類型是實(shí)際讀取到芯片的數(shù)據(jù)

ReaderData:

    reqId : 數(shù)據(jù)id,護(hù)照固定為"FF0000000001"

    signpacket : 固定為空

    travelIdentityBean:護(hù)照數(shù)據(jù)

    PersonalNumber:護(hù)照號(hào)碼

    birthDate:出生日期

    countryCode:國(guó)家代碼

    enName:英文名字

    endTime:證件有效時(shí)間

    idType:證件類型

    idnum:證件號(hào)碼

    name:名字

    personalNumber:護(hù)照號(hào)碼,同PersonalNumber

    picture1:圖片,base64編碼

    sex:性別

數(shù)據(jù)示例:

ReaderData:{"reqId":"FF0000000001","signpacket":"","travelIdentityBean":{"PersonalNumber":"CSCE21964039<3309254<7812031<8MBNGLGKM<<<<LIN<<DONG<<<<<<<<<MAAB161135<<<<<<<<<<<<<<<<<<<<","birthDate":"781203","countryCode":"","enName":"LIN<<DONG","endTime":"330925","idType":"CS","idnum":"CE2196403","name":"林*","personalNumber":"CSCE21964039<3309254<7812031<8MBNGLGKM<<<<LIN<<DONG<<<<<<<<<MAAB161135<<<<<<<<<<<<<<<<<<<<","picture1":"**********(base64編碼)","sex":"M"}}

ImageData: 該類型是實(shí)際發(fā)回的圖片數(shù)據(jù)

data: 經(jīng)過base64編碼的bitmap圖片數(shù)據(jù)

imageType: 圖片類型

    UVImage:使用紫外燈拍攝的圖片

    cameraImage:使用普通白燈拍攝的圖片

數(shù)據(jù)示例:

ImageData:{"data":"base64編碼的bitmap圖片數(shù)據(jù)","imageType":"UVImage"}

打開拍攝圖片功能:

紫外光圖片:

    使用串口發(fā)送以下信息以打開紫外圖片拍攝功能:{"ControlsType":"UVImageEnable","NewStatus":"true"}

普通白光圖片:

    使用串口發(fā)送以下信息以打開白光圖片拍攝功能:{"ControlsType":"imageEnable","NewStatus":"true"}

說明："*"號(hào)部分為個(gè)人隱私部分特作為省略說明，以實(shí)際數(shù)據(jù)為準(zhǔn)。

IdType字段解析規(guī)則

"CS","W<":    "往來港澳通行證"

"QS","Q<":    "前往港澳通行證"

"CR","C<":    "港澳居民來往大陸通行證"

"CD","D<":    "大陸往來臺(tái)灣通行證"

"CT","T<":     "臺(tái)灣往來大陸通行證"

【護(hù)照數(shù)據(jù)】

ReaderData:{"reqId":"FF0000000001","signpacket":"","travelIdentityBean":{"Nationality":"CHN","PersonalNumber":"POCHNLONG<<XIA<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<\nEN82788883CHN8702067F3488880MBPKMPLM<<<<A932\n","birthDate":"880808","countryCode":"CHN","enName":"LONG,XIA","endTime":"341202","idType":"PO","idnum":"EN8278888","name":"張三","nationality":"CHN","personalNumber":"POCHNLONG<<XIA<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<\nEN82788883CHN8702067F3412020MBPKMPLM<<<<A932\n","picture1":"/9j/4AAQSkZJRg...oS//2Q==","sex":"F"}}

【港澳通行證數(shù)據(jù)】

合并解析：

ReaderData:{"reqId":"FF0000000001","signpacket":"","travelIdentityBean":{"Nationality":"CHN","PersonalNumber":"CSCF72060774<2907147<1508082<2\nNFMFNEPDMBNFZHANG<<ZELIN<<<<<<\nFAAC168888<<<<<<<<<<<<<<<<<<<<\n","birthDate":"150921","countryCode":"CHN","enName":"ZHANG,ZELIN","endTime":"290714","idType":"CS","idnum":"CF7208888","name":"張琳","nationality":"CHN","personalNumber":"CSCF72068888<2907147<1508082<2\nNFMFNEPDMBNFZHANG<<ZELIN<<<<<<\nFAAC168888<<<<<<<<<<<<<<<<<<<<\n","picture1":"/9j/4AAQSkZJRgABAQAA...FHYz//2Q==","sex":"F"}}

【身份證數(shù)據(jù)】

解析：ReaderData:{"identity":{"address":"河北省秦皇島市撫寧縣撫寧鎮(zhèn)下莊村20號(hào)","beginTime":"20110303","birthDate":"19860808","endTime":"20210303","idType":" ","idnum":"13032319860808446X","name":"王美娜","nation":"漢","picture":"/9j/4AA/9k=","sex":"女","signingOrganization":"撫寧縣公安局","signingTimes":"20110303"}}

PCSign:{"stage":"readEnd","type":"IDInfo"}

關(guān)于日期格式的說明

護(hù)照機(jī)讀區(qū)（MRZ）中及芯片中存儲(chǔ)的 出生日期 通常為6位格式（YYMMDD），在判斷具體年份時(shí)主要通過以下方式解決跨世紀(jì)問題：

系統(tǒng)會(huì)根據(jù)當(dāng)前年份和旅客年齡估算。例如，當(dāng)前是2025年，若機(jī)讀區(qū)顯示「25」（對(duì)應(yīng)2025年），而旅客實(shí)際年齡明顯超過百歲，則可能調(diào)整為1925年。

但實(shí)際場(chǎng)景中，高齡旅客出行概率極低，因此多數(shù)情況下默認(rèn)按當(dāng)前世紀(jì)處理。國(guó)際民航組織（ICAO）未明確規(guī)定分界點(diǎn)，一般會(huì)采用「30年分界法」：

若兩位年份≤30，則默認(rèn)屬于21世紀(jì)（如「25」→2025年）；

若兩位年份＞30，則默認(rèn)屬于20世紀(jì)（如「85」→1985年）

附件1 : IdType字段解析規(guī)則

CS / W< : 往來港澳通行證

QS / Q< : 前往港澳通行證

CR / C< : 港澳居民來往大陸通行證

CD / D< : 大陸往來臺(tái)灣通行證

CT / T< : 臺(tái)灣往來大陸通行證

P* / P< : 護(hù)照 (* 為任意字母 )

附件2 : Nationality / countryCode :國(guó)家代碼說明

AFG ; 阿富汗 ; ALA ; 奧蘭群島 ; ALB ; 阿爾巴尼亞 ; DZA ; 阿爾及利亞 ; ASM ; 美屬薩摩亞 ;AND ; 安道爾 ; AGO ; 安哥拉 ; AIA ; 安圭拉 ; ATA ; 南極洲 ; ATG ; 安提瓜和巴布達(dá) ; ARG ; 阿根廷 ; ARM ; 亞美尼亞 ; ABW ; 阿魯巴 ; AUS ; 澳大利亞 ; AUT ; 奧地利 ; AZE ; 阿塞拜疆 ; BHS ;巴哈馬 ; BHR ; 巴林 ; BGD ; 孟加拉國(guó) ; BRB ; 巴巴多斯 ; BLR ; 白俄羅斯 ; BEL ; 比利時(shí) ; BLZ ;伯利茲 ; BEN ; 貝寧 ; BMU ; 百慕大 ; BTN ; 不丹 ; BOL ; 多民族玻利維亞國(guó) ; BES ; 博內(nèi)爾島、圣尤斯特歇斯島和薩巴島 ; BIH ; 波斯尼亞和黑塞哥維那 ; BWA ; 博茨瓦納 ; BVT ; 布韋島 ; BRA ; 巴西 ; IOT ; 英屬印度洋領(lǐng)地 ; BRN ; 文萊達(dá)魯薩蘭國(guó) ; BGR ; 保加利亞 ; BFA ; 布基納法索 ;BDI ; 布隆迪 ; CPV ; 佛得角 ; KHM ; 柬埔寨 ; CMR ; 喀麥隆 ; CAN ; 加拿大 ; CYM ; 開曼群島 ;CAF ; 中非共和國(guó) ; TCD ; 乍得 ; CHL ; 智利 ; CHN ; 中國(guó) ; CXR ; 圣誕島 ; CCK ; 科科斯（基靈）群島 ; COL ; 哥倫比亞 ; COM ; 科摩羅 ; COG ; 剛果 ; COD ; 剛果民主共和國(guó) ; COK ; 庫克群島 ; CRI ; 哥斯達(dá)黎加 ; CIV ; 科特迪瓦 ; HRV ; 克羅地亞 ; CUB ; 古巴 ; CUW ; 庫拉索 ; CYP ;塞浦路斯 ; CZE ; 捷克共和國(guó) ; DNK ; 丹麥 ; DJI ; 吉布提 ; DMA ; 多米尼加 ; DOM ; 多米尼加共和國(guó) ; ECU ; 厄瓜多爾 ; EGY ; 埃及 ; SLV ; 薩爾瓦多 ; GNQ ; 赤道幾內(nèi)亞 ; ERI ; 厄立特里亞 ;EST ; 愛沙尼亞 ; ETH ; 埃塞俄比亞 ; FLK1 ; ?？颂m群島（馬爾維納斯） ; FRO ; 法羅群島 ; FJI; 斐濟(jì) ; FIN ; 芬蘭 ; FRA ; 法國(guó) ; GUF ; 法屬圭亞那 ; PYF ; 法屬玻利尼西亞 ; ATF ; 法屬南領(lǐng)地; GAB ; 加蓬 ; GMB ; 岡比亞 ; GEO ; 格魯吉亞 ; D ; 德國(guó) ; GHA ; 加納 ; GIB ; 直布羅陀 ; GRC ;希臘 ; GRL ; 格陵蘭 ; GRD ; 格林納達(dá) ; GLP ; 瓜德羅普 ; GUM ; 關(guān)島 ; GTM ; 危地馬拉 ; GGY ;根西島 ; GIN ; 幾內(nèi)亞 ; GNB ; 幾內(nèi)亞—比紹 ; GUY ; 圭亞那 ; HTI ; 海地 ; HMD ; 赫德島和麥克唐納群島 ; VAT ; 教廷（梵蒂岡城國(guó)） ; HND ; 洪都拉斯 ; HKG ; 中國(guó)香港特別行政區(qū) ; HUN ; 匈牙利 ; ISL ; 冰島 ; IND ; 印度 ; IDN ; 印度尼西亞 ; IRN ; 伊朗（伊斯蘭共和國(guó)） ; IRQ ; 伊拉克 ; IRL ; 愛爾蘭 ; IMN ; 馬恩島 ; ISR ; 以色列 ; ITA ; 意大利 ; JAM ; 牙買加 ; JPN ; 日本 ;JEY ; 澤西 ; JOR ; 約旦 ; KAZ ; 哈薩克斯坦 ; KEN ; 肯尼亞 ; KIR ; 基里巴斯 ; PRK ; 朝鮮民主主義人民共和國(guó) ; KOR ; 大韓民國(guó) ; KWT ; 科威特 ; KGZ ; 吉爾吉斯斯坦 ; LAO ; 老撾人民民主共和國(guó) ; LVA ; 拉脫維亞 ; LBN ; 黎巴嫩 ; LSO ; 萊索托 ; LBR ; 利比里亞 ; LBY ; 利比亞 ; LIE ;列支敦士登 ; LTU ; 立陶宛 ; LUX ; 盧森堡 ; MAC ; 中國(guó)澳門特別行政區(qū) ; MKD ; 前南斯拉夫馬其頓共和國(guó) ; MDG ; 馬達(dá)加斯加 ; MWI ; 馬拉維 ; MYS ; 馬來西亞 ; MDV ; 馬爾代夫 ; MLI ; 馬里 ;MLT ; 馬耳他 ; MHL ; 馬紹爾群島 ; MTQ ; 馬提尼克 ; MRT ; 毛里塔尼亞 ; MUS ; 毛里求斯 ; MYT ;馬約特 ; MEX ; 墨西哥 ; FSM ; 密克羅尼西亞（聯(lián)邦） ; MDA ; 摩爾多瓦共和國(guó) ; MCO ; 摩納哥 ;MNG ; 蒙古 ; MNE ; 黑山 ; MSR ; 蒙特塞拉特 ; MAR ; 摩洛哥 ; MOZ ; 莫桑比克 ; MMR ; 緬甸 ; NAM; 納米尼亞 ; NRU ; 瑙魯 ; NPL ; 尼泊爾 ; NLD ; 荷蘭 ; ANT ; 荷屬安的列斯 ; NTZ ; 中立區(qū) ; NCL; 新喀里多尼亞 ; NZL ; 新西蘭 ; NIC ; 尼加拉瓜 ; NER ; 尼日爾 ; NGA ; 尼日利亞 ; NIU ; 紐埃 ;NFK ; 諾福克島 ; MNP ; 北馬里亞納群島 ; NOR ; 挪威 ; OMN ; 阿曼 ; PAK ; 巴基斯坦 ; PLW ; 帕勞 ; PSE ; 巴勒斯坦國(guó) ; PAN ; 巴拿馬 ; PNG ; 巴布亞新幾內(nèi)亞 ; PRY ; 巴拉圭 ; PER ; 秘魯 ; PHL; 菲律賓 ; PCN ; 皮特凱恩 ; POL ; 波蘭 ; PRT ; 葡萄牙 ; PRI ; 波多黎各 ; QAT ; 卡塔爾 ; REU ;留尼汪島 ; ROU ; 羅馬尼亞 ; RUS ; 俄羅斯聯(lián)邦 ; RWA ; 盧旺達(dá) ; BLM ; 圣巴泰勒米島 ; SHN ; 圣赫勒拿島、阿森松島和特里斯坦達(dá)庫尼亞群島 ; KNA ; 圣基茨和尼維斯 ; LCA ; 圣盧西亞 ; MAF ;圣馬丁島（法屬） ; SPM ; 圣皮埃爾和密克隆 ; VCT ; 圣文森特和格林納丁斯 ; WSM ; 薩摩亞 ;SMR ; 圣馬力諾 ; STP ; 圣多美和普林西比 ; SAU ; 沙特阿拉伯 ; SEN ; 塞內(nèi)加爾 ; SRB ; 塞爾維亞 ; SYC ; 塞舌爾 ; SLE ; 塞拉利昂 ; SGP ; 新加坡 ; SXM ; 圣馬丁島（荷屬） ; SVK ; 斯洛伐克 ;SVN ; 斯洛文尼亞 ; SLB ; 所羅門群島 ; SOM ; 索馬里 ; ZAF ; 南非 ; SGS ; 南喬治亞和南桑威奇群島 ; SSD ; 南蘇丹 ; ESP ; 西班牙 ; LKA ; 斯里蘭卡 ; SDN ; 蘇丹 ; SUR ; 蘇里南 ; SJM ; 斯瓦爾巴和揚(yáng)馬延群島 ; SWZ ; 斯威士蘭 ; SWE ; 瑞典 ; CHE ; 瑞士 ; SYR ; 阿拉伯?dāng)⒗麃喒埠蛧?guó) ;TWN ; 中國(guó)臺(tái)灣省 ; TJK ; 塔吉克斯坦 ; TZA ; 坦桑尼亞聯(lián)合共和國(guó) ; THA ; 泰國(guó) ; TLS ; 東蒂汶 ;TGO ; 多哥 ; TKL ; 托克勞群島 ; TON ; 湯加 ; TTO ; 特里尼達(dá)和多巴哥 ; TUN ; 突尼斯 ; TUR ;土耳其 ; TKM ; 土庫曼斯坦 ; TCA ; 特克斯和凱科斯群島 ; TUV ; 圖瓦盧 ; UGA ; 烏干達(dá) ; UKR ;烏克蘭 ; ARE ; 阿拉伯聯(lián)合酋長(zhǎng)國(guó) ; GBR ; 大不列顛及北愛爾蘭聯(lián)合王國(guó) ; GBD ; 英國(guó)海外領(lǐng)土公民 ; GBN ; 英國(guó)國(guó)民（海外） ; GBO ; 英國(guó)海外公民 ; GBP ; 英國(guó)被保護(hù)人 ; GBS ; 英國(guó)臣民 ;USA ; 美國(guó) ; UMI ; 美國(guó)本土外小島嶼 ; URY ; 烏拉圭 ; UZB ; 烏茲別克斯坦 ; VUT ; 瓦奴阿圖 ;VEN ; 委內(nèi)瑞拉玻利瓦爾共和國(guó) ; VNM ; 越南 ; VGB ; 維爾京群島（英屬） ; VIR ; 維爾京群島（美屬） ; WLF ; 瓦利斯和富圖納群島 ; ESH ; 西撒哈拉 ; YEM ; 也門 ; ZMB ; 贊比亞 ; ZWE ; 津巴布韋 ;