社保卡讀寫(xiě)器用戶(hù)手冊(cè)

1、M&W社會(huì)保障（個(gè)人）卡讀寫(xiě)器（DP-R123-U-SB）用戶(hù)使用手冊(cè)深圳市明華澳漢科技股份有限公司ShenZhenMingWah AoHan High Technologycorporation Ltd.第一章社會(huì)保障個(gè)為卡讀寫(xiě)器簡(jiǎn)介 21.1 特點(diǎn) 21.2 裝箱清單 21.3 讀寫(xiě)器連接方式 21.4 指示燈21.5 技術(shù)指標(biāo)2第二章IC卡讀寫(xiě)器驅(qū)動(dòng)程序函數(shù)說(shuō)明 32.1函數(shù)使用說(shuō)明第一章 社會(huì)保障（個(gè)人）卡讀寫(xiě)器簡(jiǎn)介1. 1特點(diǎn)支持IC卡類(lèi)型A類(lèi)、AB類(lèi)； 可支持T=0通訊協(xié)議的CPU#;支持對(duì)多個(gè)卡操作的功能；與PC機(jī)通訊采用US噴口；1.2 裝箱清單讀寫(xiě)器一臺(tái)串口線一條安裝

2、盤(pán)一張產(chǎn)品質(zhì)量反饋表一張產(chǎn)品保修卡 一張1.3 讀寫(xiě)器連接方式DP讀寫(xiě)器US噴口直接接至計(jì)算機(jī)上。1.4 指示燈三色指示燈:綠色紅色橙色用戶(hù)卡已插入，閃爍時(shí)表示正在對(duì)用戶(hù)卡操作未插用戶(hù)卡或 SAM卡用戶(hù)卡未插入，SAM#已插入，閃爍日表示正在對(duì) SAM#操作1.5 技術(shù)指標(biāo)通訊接口： USB串口的波特率：電源：由鍵盤(pán)取電，不外帶電源最大功耗：100 mW環(huán)境溫度：商業(yè)級(jí) 0° 70 ° C工業(yè)級(jí)-25° 85 ° C相對(duì)濕度：30% - 95%抗靜電干擾：15KV抗磁場(chǎng)干擾：19奧斯特抗振動(dòng)能力：振幅 0.35mm,頻率10-55Hz,三個(gè)軸方向掃頻振動(dòng)

3、絕緣電阻：濕熱情況下（400 95%絕緣電阻應(yīng)不小于 5M。外型尺寸：長(zhǎng) 父寬父高110mm85mm60mm重量：約475克第二章接口函數(shù)使用說(shuō)明高級(jí)應(yīng)用編程接口本附錄描述了讀卡器的高級(jí)應(yīng)用編程接口:高級(jí)應(yīng)用編程接口是提供給終端上的應(yīng)用程序用來(lái)與讀卡器進(jìn)行交互操作的函數(shù)集。高級(jí)應(yīng)用編程接口的具體表現(xiàn)形式必須包括：a. 可以在 32 位 WINDOWS 環(huán)境下(WINDOWS95/98/ME,WIN NT/2000/XP 等) 運(yùn)行的動(dòng)態(tài)鏈接庫(kù)(SSSE32.DLL)。b. 可以在16位 WINDOWS環(huán)境下(WINDOWS3.1等)運(yùn)行的動(dòng)態(tài)鏈接庫(kù) (SSSE16.DLL)。c. 可以在DOS

4、環(huán)境下運(yùn)行的 C語(yǔ)言(MSC或BORLAND C)函數(shù)庫(kù)(SSSE16.LIB)。d. 可以在DOS環(huán)境下運(yùn)行的FOXPRO函數(shù)庫(kù)(SSSE16.PLB)。高級(jí)應(yīng)用編程接口的具體表現(xiàn)形式也可以包括：a.可以在Unix環(huán)境下運(yùn)行的C語(yǔ)言函數(shù)庫(kù)。b.可以在基于特定硬件平臺(tái)上的C語(yǔ)言函數(shù)庫(kù)。上述所有高級(jí)應(yīng)用編程接口應(yīng)具有本規(guī)范所規(guī)定的統(tǒng)一的庫(kù)名、函數(shù)名、參數(shù)類(lèi)型和 順序。應(yīng)用開(kāi)發(fā)者或用戶(hù)在對(duì)讀卡器編程時(shí)，可使用相應(yīng)的庫(kù)名和函數(shù)名。注：在以下的描述中，分別使用C語(yǔ)言和FOXPRO語(yǔ)言的風(fēng)格來(lái)說(shuō)明高級(jí)應(yīng)用編程接口中的函數(shù)81 C語(yǔ)言函數(shù)81.1 “打開(kāi)設(shè)備”函數(shù)函數(shù)：long ICC_Reader_Op

5、en(char* dev_Name)功能：該函數(shù)通知終端操作系統(tǒng)打開(kāi)與讀卡器所對(duì)應(yīng)的終端設(shè)備端口，以便兩者建立通信的邏輯關(guān)系。(使用讀寫(xiě)器已固定的波特率)參數(shù)說(shuō)明：dev_Name：設(shè)備名稱(chēng)。取值范圍” AUT。、” COMA、，其中" r的取值范圍為19。返回值：若正常，返回值為不小于 0的設(shè)備句柄；反之返回值為狀態(tài)碼，其含義見(jiàn)B1.8。注：對(duì)16位WINDOWS境下運(yùn)行的動(dòng)態(tài)鏈接庫(kù)、DO科境下運(yùn)行的靜態(tài)函數(shù)庫(kù)返回的設(shè)備句柄，其含義均不同于 32位WINDOWS境下動(dòng)態(tài)鏈接庫(kù)返回的設(shè)備句柄，僅為區(qū)分設(shè)社會(huì)保障(個(gè)人)卡讀寫(xiě)器使用手冊(cè) 備之用。81.2 “關(guān)閉設(shè)備”函數(shù)函數(shù)：long

6、 ICC_Reader_Close(long ReaderHandle)功能：該函數(shù)通知操作系統(tǒng)關(guān)閉所指定的設(shè)備。參數(shù)說(shuō)明：ReaderHandle：設(shè)備句柄。返回值：返回值的含義見(jiàn)B1.8。81.3 “卡上電”或“熱復(fù)位“函數(shù)函數(shù)：long ICC_Reader_PowerOn(long ReaderHandle, unsigned char ICC_Slot_No, unsigned char* Response)功能：該函數(shù)要求t卡器對(duì)ICC進(jìn)行冷復(fù)位，若冷復(fù)位失敗讀卡器應(yīng)啟動(dòng)一個(gè)熱復(fù)位。參數(shù)說(shuō)明：ReaderHandle：設(shè)備句柄；ICC_Slot_No ： ICC連接器號(hào)；用戶(hù)卡連接

7、器號(hào)0x0n, SAM卡連接器號(hào)0x1n,其中”n”的取值范圍為1F。Response：指向存放響應(yīng)數(shù)據(jù)的存儲(chǔ)區(qū)的指針?lè)祷刂担喝绻麑?duì)ICC復(fù)位成功，則在 Response的存儲(chǔ)區(qū)中返回ICC的復(fù)位應(yīng)答字節(jié)，返回值 為存儲(chǔ)區(qū)中的字節(jié)數(shù)；返回值小于。為狀態(tài)碼，其含義見(jiàn) B1.8。81.4 “卡下電”函數(shù)函數(shù)：long ICC_Reader_PowerOff(long ReaderHandle, unsigned char ICC_Slot_No)功能：該函數(shù)要求讀卡器撤消與ICC之間的電氣連接。參數(shù)說(shuō)明：ReaderHandle：設(shè)備句柄；ICC_Slot_No : ICC 連接器號(hào)；返回值：如果

8、該函數(shù)成功執(zhí)行，則返回值為0;返回值小于0為狀態(tài)碼，其含義見(jiàn)B1.8。81.5 "獲取卡片狀態(tài)”函數(shù)函數(shù)：long ICC_Reader_GetStatus(long ReaderHandle, unsigned char ICC_Slot_No) 功能：查詢(xún)有無(wú)卡以及卡片當(dāng)前狀態(tài)信息。參數(shù)說(shuō)明：ReaderHandle：設(shè)備句柄；ICC_Slot_No : ICC 連接器號(hào)；返回值：返回0表示有卡且已上電；返回值小于0為狀態(tài)碼，其含義見(jiàn) B1.8。81.6 “應(yīng)用命令”函數(shù)函數(shù)：long ICC_Reader_Application(long ReaderHandle, unsig

9、ned char ICC_ Slot_No, long Lenth_of_Command_APDU, unsigned char* Command_APDU, unsigned char* Response_APDU) 功能：該函數(shù)用于將符合ISO7816中所規(guī)定的基本和特殊功能的行業(yè)間交換用命令發(fā)送給指定的ICC連接器，并獲得對(duì)應(yīng)的響應(yīng)。參數(shù)說(shuō)明：ReaderHandle：設(shè)備句柄；ICC_Slot_No : ICC 連接器號(hào)；Lenth_of_Command_APDU :其值為 Command_APDU所指向緩沖區(qū)中的字節(jié)數(shù)；Command_APDU :指向存放命令的緩沖區(qū)的指針；Resp

10、onse_APDU :指向存放響應(yīng)數(shù)據(jù)的存儲(chǔ)區(qū)的指針(包才sw1,sw2)。返回值：如果函數(shù)執(zhí)行成功，則在 Response_APDU的存儲(chǔ)區(qū)中返回響應(yīng)數(shù)據(jù)，函數(shù)返回值為存 儲(chǔ)區(qū)中的字節(jié)數(shù)；返回值小于0為狀態(tài)碼，其含義見(jiàn) B1.8, Response_APDU的存儲(chǔ)區(qū)無(wú)任何數(shù)據(jù)。81.7 取信息”函數(shù)函數(shù)：long ICC_Reader_Libinfo(char* info)功能：該函數(shù)取得當(dāng)前函數(shù)庫(kù)的廠家信息參數(shù)說(shuō)明：info：指向存放廠家信息的存儲(chǔ)區(qū)的指針。表-B1.1廠家信息的存儲(chǔ)格式第116字符第1730字符第31、32字符廠家名稱(chēng)（不足補(bǔ)空格）設(shè)備型號(hào)或系列號(hào)（不足補(bǔ)空格）函數(shù)庫(kù)版本

11、號(hào)返回值:返回的廠家名稱(chēng)；明華澳漢公司返回的設(shè)備型號(hào)或系列號(hào)：DP_123_SB返回的庫(kù)版本號(hào)升級(jí)規(guī)則：每次小升級(jí)X0升為X1.X2.X3直到X0是一個(gè)穩(wěn)定版本。返回值的含義見(jiàn)B1.8。81.8 函數(shù)返回值表-B1.2高級(jí)編程接口 C語(yǔ)言函數(shù)的返回值應(yīng)用編程的標(biāo)識(shí)符返回值含義IFD_OK0執(zhí)行成功IFD_ICC_TypeError-1卡片類(lèi)型不對(duì)IFD_ICC_NoExist-2小IFD_ICC_NoPower-3有卡未上電IFD_ICC_NoResponse-4卡片無(wú)應(yīng)答IFD_ConnectError-11誤卡器連接錯(cuò)IFD_UnConnected-12未建立連接（沒(méi)有執(zhí)行打開(kāi)設(shè)備函數(shù)）I

12、FD_BadCommand-13（動(dòng)態(tài)庫(kù)）不支持該命令I(lǐng)FD_ParameterError-14（發(fā)給動(dòng)態(tài)庫(kù)的）命令參數(shù)錯(cuò)IFD_CheckSumError-15信息校驗(yàn)和出錯(cuò)82 FOXPRO語(yǔ)言函數(shù)注：在以下的描述中，所指字符為 ASCII字符82.1 “打開(kāi)設(shè)備”函數(shù)函數(shù)：ICCR_Open（dev_Name）功能：該函數(shù)通知終端操作系統(tǒng)打開(kāi)與讀卡器所對(duì)應(yīng)的終端設(shè)備端口，以便兩者建立通信的 邏輯關(guān)系。參數(shù)說(shuō)明：dev_Name：設(shè)備名稱(chēng)。取值范圍 ” AUTO、" COM4、" USBn'： " LPTn'；其中" n的取 值范圍為

13、19。返回值：返回值為一字符串，前兩個(gè)字符為函數(shù)執(zhí)行狀態(tài)碼，其含義見(jiàn)B2.8;若執(zhí)行成功，第3、4個(gè)字符為函數(shù)執(zhí)行后返回的設(shè)備句柄R_Handle,該句柄僅為區(qū)分設(shè)備之用。82.2 “關(guān)閉設(shè)備”函數(shù)函數(shù)：ICCR_Close(R_Handle)功能：該函數(shù)通知操作系統(tǒng)關(guān)閉所指定的設(shè)備。參數(shù)說(shuō)明：R_Handle:設(shè)備句柄。返回值：返回值為兩個(gè)字符的狀態(tài)碼，其含義見(jiàn)B2.8。82.3 “卡上電”或“熱復(fù)位“函數(shù)函數(shù)：ICCR_Pon(R_Handle,ICCSlotNo)功能：該函數(shù)要求t卡器對(duì)ICC進(jìn)行冷復(fù)位，若冷復(fù)位失敗讀卡器應(yīng)啟動(dòng)一個(gè)熱復(fù)位。參數(shù)說(shuō)明：R_Handle:設(shè)備句柄；ICCSl

14、otNo : ICC連接器號(hào)；用戶(hù)卡連接器號(hào)0x0n, SAM卡連接器號(hào)0x1n,其中“ n"的取值范圍為1F。返回值：返回值為一字符串，前兩個(gè)字符為函數(shù)執(zhí)行狀態(tài)碼，其含義見(jiàn)B2.8;若執(zhí)行成功，第3、4兩個(gè)字符為復(fù)位應(yīng)答中的字節(jié)數(shù)(十六進(jìn)制)，從第五字符起為ICC的復(fù)位應(yīng)答字符(字符個(gè)數(shù)為字節(jié)數(shù)的 2倍)。82.4 “卡下電”函數(shù)函數(shù)：ICCR_Poff(R_Handle,ICCSlotNo)功能：該函數(shù)要求讀卡器撤消與 ICC之間的電氣連接。參數(shù)說(shuō)明：R_Handle:設(shè)備句柄；ICCSlotNo : ICC 連接器號(hào)；返回值：返回值為兩個(gè)字符的狀態(tài)碼，其含義見(jiàn)B2.8。82.5

15、 "獲取卡片狀態(tài)”函數(shù)函數(shù)：ICCR_GetS（R_Handle,ICCSlotNo）功能：查詢(xún)有無(wú)卡以及卡片當(dāng)前狀態(tài)信息。參數(shù)說(shuō)明：R_Handle:設(shè)備句柄；ICCSlotNo : ICC 連接器號(hào)；返回值：返回值為兩個(gè)字符的狀態(tài)碼，” 00表示有卡且已上電，其他含義見(jiàn)B2.8。82.6 “應(yīng)用命令”函數(shù)函數(shù)：ICCR_App（R_Handle,ICCSlotNo, ComAPDU）功能：該函數(shù)用于將符合ISO7816中所規(guī)定的基本和特殊功能的行業(yè)間交換用命令發(fā)送給指 定的ICC連接器，并獲得對(duì)應(yīng)的響應(yīng)。參數(shù)說(shuō)明：R_Handle:設(shè)備句柄；ICCSlotNo : ICC 連接器

16、號(hào)；ComAPDU :命令字符串，每?jī)勺址硎景l(fā)送命令的一字節(jié)；返回值：返回值為一字符串，前兩個(gè)字符為函數(shù)執(zhí)行狀態(tài)碼，其含義見(jiàn) B2.8;若執(zhí)行成功，第 3、4、5、6字符為響應(yīng)數(shù)據(jù)的字節(jié)數(shù)（十六進(jìn)制），從第7字符起為響應(yīng)數(shù)據(jù)字符（字符個(gè)數(shù)為字節(jié)數(shù)的2倍）。82.7 取信息”函數(shù)函數(shù)：ICCR_Linfo（）功能：該函數(shù)取得當(dāng)前函數(shù)庫(kù)的廠家信息參數(shù)說(shuō)明：返回值：返回值為一字符串，前兩個(gè)字符為函數(shù)執(zhí)行狀態(tài)碼，其含義見(jiàn) B2.8;若執(zhí)行成功，從 第3字符起為廠家信息字符串。表-B2.1廠家信息的存儲(chǔ)格式第116字符第1730字符第31、32字符廠家名稱(chēng)（不足補(bǔ)空格）設(shè)備型號(hào)或系列號(hào)（不足補(bǔ)空格）函數(shù)庫(kù)版本號(hào)82.8 函數(shù)返回值表-B2.2高級(jí)編程接口 FOXPRO函數(shù)的返回值應(yīng)用編程的