1、社會保障 ( 個人 )卡讀寫器使用手冊1社會保障 ( 個人 ) 卡讀寫器（ DP R123 U SB）用戶使用手冊深圳市明華澳漢科技股份有限公司ShenZhen MingWah AoHan High Technology Corporation Ltd.深圳市明華澳漢科技股份有限公司TEL：（ 0755 ） 83361083FAX ：83361921社會保障 ( 個人 )卡讀寫器使用手冊2目錄第一章社會保障 ( 個人 ) 卡讀寫器簡介21.1特點21.2裝箱清單21.3讀寫器連接方式21.4指示燈21.5技術(shù)指標2第二章IC卡讀寫器驅(qū)動程序函數(shù)說明32.1函數(shù)使用說明3深圳市明華澳漢科技股份有

2、限公司TEL：（ 0755 ） 83361083FAX ：83361921社會保障 ( 個人 )卡讀寫器使用手冊3第一章社會保障（個人）卡讀寫器簡介1. 1 特點支持 IC 卡類型 A 類、 AB 類；可支持 T=0 通訊協(xié)議的CPU卡；支持對多個卡操作的功能；與 PC機通訊采用USB接口；1.2裝箱清單讀寫器串口線安裝盤產(chǎn)品質(zhì)量反饋表產(chǎn)品保修卡一臺一條一張一張一張1.3讀寫器連接方式DP讀寫器 USB接口直接接至計算機上。1.4指示燈三色指示燈：綠色用戶卡已插入，閃爍時表示正在對用戶卡操作紅色未插用戶卡或SAM卡橙色用戶卡未插入，SAM卡已插入，閃爍時表示正在對SAM卡操作1.5技術(shù)指標通訊

3、接口： USB串口的波特率：電源：由鍵盤取電，不外帶電源最大功耗： 100 mW環(huán)境溫度：商業(yè)級0°70°C工業(yè)級 -25 °85°C相對濕度： 30%95%抗靜電干擾：15KV抗磁場干擾：19 奧斯特抗振動能力：振幅0.35mm，頻率 10-55Hz ，三個軸方向掃頻振動絕緣電阻：濕熱情況下（40°， 95%）絕緣電阻應(yīng)不小于5M 。外型尺寸：長寬高 110mm 85mm60mm重量：約 475 克深圳市明華澳漢科技股份有限公司TEL：（ 0755 ） 83361083FAX ：83361921社會保障 ( 個人 )卡讀寫器使用手冊4第二章接

4、口函數(shù)使用說明高級應(yīng)用編程接口本附錄描述了讀卡器的高級應(yīng)用編程接口：高級應(yīng)用編程接口是提供給終端上的應(yīng)用程序用來與讀卡器進行交互操作的函數(shù)集。高級應(yīng)用編程接口的具體表現(xiàn)形式必須包括：a.可以在 32 位 WINDOWS環(huán)境下（ WINDOWS95/98/ME,WIN NT/2000/XP等）運行的動態(tài)鏈接庫(SSSE32.DLL) 。b. 可以在 16 位 WINDOWS 環(huán)境下（ WINDOWS3.1 等）運行的動態(tài)鏈接庫(SSSE16.DLL) 。c.可以在 DOS 環(huán)境下運行的C 語言 (MSC 或 BORLAND C) 函數(shù)庫 (SSSE16.LIB) 。d. 可以在 DOS 環(huán)境下運

5、行的 FOXPRO 函數(shù)庫 (SSSE16.PLB) 。高級應(yīng)用編程接口的具體表現(xiàn)形式也可以包括：a. 可以在 Unix 環(huán)境下運行的 C 語言函數(shù)庫。b.可以在基于特定硬件平臺上的C 語言函數(shù)庫。上述所有高級應(yīng)用編程接口應(yīng)具有本規(guī)范所規(guī)定的統(tǒng)一的庫名、函數(shù)名、參數(shù)類型和順序。應(yīng)用開發(fā)者或用戶在對讀卡器編程時，可使用相應(yīng)的庫名和函數(shù)名。注：在以下的描述中，分別使用 C 語言和 FOXPRO 語言的風格來說明高級應(yīng)用編程接口中的函數(shù)B1C 語言函數(shù)B1.1“打開設(shè)備”函數(shù)函數(shù)：longICC_Reader_Open(char* dev_Name)功能：該函數(shù)通知終端操作系統(tǒng)打開與讀卡器所對應(yīng)的終

6、端設(shè)備端口，以便兩者建立通信的邏輯關(guān)系。（使用讀寫器已固定的波特率）參數(shù)說明：dev_Name：設(shè)備名稱。取值范圍”AUTO ”、 ”COMn ”、，其中 ”n”的取值范圍為19。返回值：若正常，返回值為不小于 0 的設(shè)備句柄；反之返回值為狀態(tài)碼，其含義見 B1.8 。注：對 16 位 WINDOWS環(huán)境下運行的動態(tài)鏈接庫、 DOS環(huán)境下運行的靜態(tài)函數(shù)庫返回的設(shè)備句柄，其含義均不同于32 位WINDOWS環(huán)境下動態(tài)鏈接庫返回的設(shè)備句柄，僅為區(qū)分設(shè)備之用。深圳市明華澳漢科技股份有限公司TEL：（ 0755 ） 83361083FAX ：83361921社會保障 ( 個人 )卡讀寫器使用手冊5B1

7、.2“關(guān)閉設(shè)備”函數(shù)函數(shù)：longICC_Reader_Close(long ReaderHandle)功能：該函數(shù)通知操作系統(tǒng)關(guān)閉所指定的設(shè)備。參數(shù)說明：ReaderHandle：設(shè)備句柄。返回值：返回值的含義見B1.8 。B1.3“卡上電”或“熱復(fù)位“函數(shù)函數(shù)：long ICC_Reader_PowerOn(long ReaderHandle, unsigned char ICC_Slot_No, unsignedchar* Response)功能：該函數(shù)要求讀卡器對ICC 進行冷復(fù)位，若冷復(fù)位失敗讀卡器應(yīng)啟動一個熱復(fù)位。參數(shù)說明：ReaderHandle：設(shè)備句柄；ICC_Slot_No

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

9、 ： ICC 連接器號；返回值：如果該函數(shù)成功執(zhí)行，則返回值為0；返回值小于0 為狀態(tài)碼，其含義見B1.8 。B1.5“獲取卡片狀態(tài)”函數(shù)深圳市明華澳漢科技股份有限公司TEL：（ 0755 ） 83361083FAX ：83361921社會保障 ( 個人 )卡讀寫器使用手冊6函數(shù)：long ICC_Reader_GetStatus(long ReaderHandle, unsigned char ICC_Slot_No)功能：查詢有無卡以及卡片當前狀態(tài)信息。參數(shù)說明：ReaderHandle：設(shè)備句柄；ICC_Slot_No： ICC連接器號；返回值：返回 0 表示有卡且已上電；返回值小于0

10、為狀態(tài)碼，其含義見B1.8 。B1.6“應(yīng)用命令”函數(shù)函數(shù)：long ICC_Reader_Application(long ReaderHandle, unsigned char ICC_ Slot _No, long Lenth_of_Command_APDU, unsigned char* Command_APDU, unsigned char* Response_APDU)功能：該函數(shù)用于將符合ISO7816 中所規(guī)定的基本和特殊功能的行業(yè)間交換用命令發(fā)送給指定的 ICC 連接器，并獲得對應(yīng)的響應(yīng)。參數(shù)說明：ReaderHandle：設(shè)備句柄；ICC_Slot_No ： ICC 連接器

11、號；Lenth_of_Command_APDU ：其值為Command_APDU 所指向緩沖區(qū)中的字節(jié)數(shù)；Command_APDU ：指向存放命令的緩沖區(qū)的指針；Response_APDU ：指向存放響應(yīng)數(shù)據(jù)的存儲區(qū)的指針(包括 sw1,sw2) 。返回值：如果函數(shù)執(zhí)行成功，則在 Response_APDU 的存儲區(qū)中返回響應(yīng)數(shù)據(jù)，函數(shù)返回值為存儲區(qū)中的字節(jié)數(shù)；返回值小于 0 為狀態(tài)碼，其含義見 B1.8 ，Response_APDU 的存儲區(qū)無任何數(shù)據(jù)。B1.7“取信息”函數(shù)函數(shù)：long ICC_Reader_Libinfo(char* info)功能：該函數(shù)取得當前函數(shù)庫的廠家信息參數(shù)說

12、明：info ：指向存放廠家信息的存儲區(qū)的指針。表 -B1.1 廠家信息的存儲格式第 116 字符第 1730 字符第 31、 32 字符深圳市明華澳漢科技股份有限公司TEL：（ 0755 ） 83361083FAX ：83361921社會保障( 個人 )卡讀寫器使用手冊7廠家名稱（不足補空格）設(shè)備型號或系列號（不足補空格）函數(shù)庫版本號返回值：返回的廠家名稱；明華澳漢公司返回的設(shè)備型號或系列號: DP_123_SB返回的庫版本號升級規(guī)則 : 每次小升級 X0 升為 X1.X2.X3 直到 X0 是一個穩(wěn)定版本。返回值的含義見B1.8 。B1.8 函數(shù)返回值表 -B1.2高級編程接口 C 語言函

13、數(shù)的返回值應(yīng)用編程的標識符返回值含義IFD_OK0執(zhí)行成功IFD_ICC_TypeError-1卡片類型不對IFD_ICC_NoExist-2無卡IFD_ICC_NoPower-3有卡未上電IFD_ICC_NoResponse-4卡片無應(yīng)答IFD_ConnectError-11讀卡器連接錯IFD_UnConnected-12未建立連接 ( 沒有執(zhí)行打開設(shè)備函數(shù) )IFD_BadCommand-13( 動態(tài)庫 ) 不支持該命令I(lǐng)FD_ParameterError-14( 發(fā)給動態(tài)庫的 ) 命令參數(shù)錯IFD_CheckSumError-15信息校驗和出錯B2FOXPRO 語言函數(shù)注：在以下的描述中

14、，所指字符為ASCII 字符B2.1“打開設(shè)備”函數(shù)函數(shù)：ICCR_Open(dev_Name)功能：該函數(shù)通知終端操作系統(tǒng)打開與讀卡器所對應(yīng)的終端設(shè)備端口，以便兩者建立通信的邏輯關(guān)系。參數(shù)說明：dev_Name：設(shè)備名稱。取值范圍”AUTO ”、 ”COMn ”、”USBn ”、”LPTn ”，其中 ”n”的取值范圍為19。返回值：返回值為一字符串, 前兩個字符為函數(shù)執(zhí)行狀態(tài)碼，其含義見B2.8 ；若執(zhí)行成功， 第3、4 個字符為函數(shù)執(zhí)行后返回的設(shè)備句柄R_Handle ，該句柄僅為區(qū)分設(shè)備之用。深圳市明華澳漢科技股份有限公司TEL：（ 0755 ） 83361083FAX ：8336192

15、1社會保障 ( 個人 )卡讀寫器使用手冊8B2.2“關(guān)閉設(shè)備”函數(shù)函數(shù)：ICCR_Close(R_Handle)功能：該函數(shù)通知操作系統(tǒng)關(guān)閉所指定的設(shè)備。參數(shù)說明：R_Handle ：設(shè)備句柄。返回值：返回值為兩個字符的狀態(tài)碼，其含義見B2.8。B2.3“卡上電”或“熱復(fù)位“函數(shù)函數(shù)：ICCR_Pon(R_Handle,ICCSlotNo)功能：該函數(shù)要求讀卡器對ICC 進行冷復(fù)位，若冷復(fù)位失敗讀卡器應(yīng)啟動一個熱復(fù)位。參數(shù)說明：R_Handle ：設(shè)備句柄；ICCSlotNo ： ICC 連接器號；用戶卡連接器號0x0n， SAM 卡連接器號0x1n，其中 ”n”的取值范圍為1F。返回值：返回

16、值為一字符串 , 前兩個字符為函數(shù)執(zhí)行狀態(tài)碼， 其含義見 4 兩個字符為復(fù)位應(yīng)答中的字節(jié)數(shù) （十六進制） ，從第五字符起為B2.8 ；若執(zhí)行成功， 第 3、ICC 的復(fù)位應(yīng)答字符 （字符個數(shù)為字節(jié)數(shù)的2 倍）。B2.4“卡下電”函數(shù)函數(shù)：ICCR_Poff(R_Handle,ICCSlotNo)功能：該函數(shù)要求讀卡器撤消與ICC 之間的電氣連接。參數(shù)說明：R_Handle ：設(shè)備句柄；ICCSlotNo ： ICC 連接器號；返回值：返回值為兩個字符的狀態(tài)碼，其含義見B2.8。B2.5“獲取卡片狀態(tài)”函數(shù)函數(shù)：ICCR_GetS(R_Handle,ICCSlotNo)深圳市明華澳漢科技股份有限

17、公司TEL：（ 0755 ） 83361083FAX ：83361921社會保障 ( 個人 )卡讀寫器使用手冊9功能：查詢有無卡以及卡片當前狀態(tài)信息。參數(shù)說明：R_Handle ：設(shè)備句柄；ICCSlotNo ： ICC 連接器號；返回值：返回值為兩個字符的狀態(tài)碼，”00”表示有卡且已上電，其他含義見B2.8。B2.6“應(yīng)用命令”函數(shù)函數(shù)：ICCR_App(R_Handle,ICCSlotNo, ComAPDU)功能：該函數(shù)用于將符合ISO7816 中所規(guī)定的基本和特殊功能的行業(yè)間交換用命令發(fā)送給指定的ICC連接器，并獲得對應(yīng)的響應(yīng)。參數(shù)說明：R_Handle ：設(shè)備句柄；ICCSlotNo

18、： ICC 連接器號；ComAPDU ：命令字符串，每兩字符表示發(fā)送命令的一字節(jié)；返回值：返回值為一字符串, 前兩個字符為函數(shù)執(zhí)行狀態(tài)碼，4、5、6 字符為響應(yīng)數(shù)據(jù)的字節(jié)數(shù)（十六進制），從第其含義見B2.8 ；若執(zhí)行成功， 第7 字符起為響應(yīng)數(shù)據(jù)字符（字符個數(shù)3、為字節(jié)數(shù)的2 倍）。B2.7“取信息”函數(shù)函數(shù)：ICCR_Linfo()功能：該函數(shù)取得當前函數(shù)庫的廠家信息參數(shù)說明：返回值：返回值為一字符串 , 前兩個字符為函數(shù)執(zhí)行狀態(tài)碼，其含義見 B2.8 ；若執(zhí)行成功，從第 3 字符起為廠家信息字符串。表 -B2.1 廠家信息的存儲格式第 116 字符第 1730 字符第 31、 32 字符廠家名稱（不足補空格）設(shè)備型號或系列號（不足補空格）函數(shù)庫版本號B2.8函數(shù)返回值表 -B2.2 高級編程接口FOXPRO 函數(shù)的返回值深圳市明華澳漢科技股份有限公司TEL：（ 0755 ） 83361083FAX ：83361921社會保障 ( 個人 )卡讀寫器使用手冊10應(yīng)用編程的標識符返回值含義IFD_OK00執(zhí)行成功I