社?？ㄗx寫器用戶手冊

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

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

3、絕緣電阻：濕熱情況下（400 95%絕緣電阻應(yīng)不小于 5M。外型尺寸：長 父寬父高110mm85mm60mm重量：約475克第二章接口函數(shù)使用說明高級應(yīng)用編程接口本附錄描述了讀卡器的高級應(yīng)用編程接口:高級應(yīng)用編程接口是提供給終端上的應(yīng)用程序用來與讀卡器進(jìn)行交互操作的函數(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

4、環(huán)境下運行的 C語言(MSC或BORLAND C)函數(shù)庫(SSSE16.LIB)。d. 可以在DOS環(huán)境下運行的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語言的風(fēng)格來說明高級應(yīng)用編程接口中的函數(shù)81 C語言函數(shù)81.1 “打開設(shè)備”函數(shù)函數(shù)：long ICC_Reader_Op

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

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

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

8、該函數(shù)成功執(zhí)行，則返回值為0;返回值小于0為狀態(tài)碼，其含義見B1.8。81.5 "獲取卡片狀態(tài)”函數(shù)函數(shù)：long ICC_Reader_GetStatus(long ReaderHandle, unsigned char ICC_Slot_No) 功能：查詢有無卡以及卡片當(dāng)前狀態(tài)信息。參數(shù)說明：ReaderHandle：設(shè)備句柄；ICC_Slot_No : ICC 連接器號；返回值：返回0表示有卡且已上電；返回值小于0為狀態(tài)碼，其含義見 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連接器，并獲得對應(yīng)的響應(yīng)。參數(shù)說明：ReaderHandle：設(shè)備句柄；ICC_Slot_No : ICC 連接器號；Lenth_of_Command_APDU :其值為 Command_APDU所指向緩沖區(qū)中的字節(jié)數(shù)；Command_APDU :指向存放命令的緩沖區(qū)的指針；Resp

10、onse_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ù)。81.7 取信息”函數(shù)函數(shù)：long ICC_Reader_Libinfo(char* info)功能：該函數(shù)取得當(dāng)前函數(shù)庫的廠家信息參數(shù)說明：info：指向存放廠家信息的存儲區(qū)的指針。表-B1.1廠家信息的存儲格式第116字符第1730字符第31、32字符廠家名稱（不足補空格）設(shè)備型號或系列號（不足補空格）函數(shù)庫版本

11、號返回值:返回的廠家名稱；明華澳漢公司返回的設(shè)備型號或系列號：DP_123_SB返回的庫版本號升級規(guī)則：每次小升級X0升為X1.X2.X3直到X0是一個穩(wěn)定版本。返回值的含義見B1.8。81.8 函數(shù)返回值表-B1.2高級編程接口 C語言函數(shù)的返回值應(yīng)用編程的標(biāo)識符返回值含義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ù)）I

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

13、19。返回值：返回值為一字符串，前兩個字符為函數(shù)執(zhí)行狀態(tài)碼，其含義見B2.8;若執(zhí)行成功，第3、4個字符為函數(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ù)說明：R_Handle:設(shè)備句柄。返回值：返回值為兩個字符的狀態(tài)碼，其含義見B2.8。82.3 “卡上電”或“熱復(fù)位“函數(shù)函數(shù)：ICCR_Pon(R_Handle,ICCSlotNo)功能：該函數(shù)要求t卡器對ICC進(jìn)行冷復(fù)位，若冷復(fù)位失敗讀卡器應(yīng)啟動一個熱復(fù)位。參數(shù)說明：R_Handle:設(shè)備句柄；ICCSl

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

15、 "獲取卡片狀態(tài)”函數(shù)函數(shù)：ICCR_GetS（R_Handle,ICCSlotNo）功能：查詢有無卡以及卡片當(dāng)前狀態(tài)信息。參數(shù)說明：R_Handle:設(shè)備句柄；ICCSlotNo : ICC 連接器號；返回值：返回值為兩個字符的狀態(tài)碼，” 00表示有卡且已上電，其他含義見B2.8。82.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 : ICC 連接器

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