j3021接口接口函數(shù)精簡版10-419readme

1、/-usb智能卡-常州市邦威電子科技-地址:常州市創(chuàng)新科技樓B-4樓-:(0519)5129610,5129612/-傳真:(0519)5129611/-/-/-15:58 2006-9-22-Design by TASMAN-for ATMEL24c01-24c16,sle4442,temic,mifare1,ISO7816-Mc/-include :bwusbapi.lib, bwusball, bwusbapi.h/-/* 函數(shù)返回值對(duì)照表 */*-設(shè)備、通用函數(shù)返回值*/操作成功失敗卡類型錯(cuò)誤無卡通訊錯(cuò)誤地址錯(cuò) 長度錯(cuò)誤數(shù)據(jù)錯(cuò)誤錯(cuò)012345678910111213/*/*/*/*/*

2、/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/非ASCII碼本接口不支持本卡類型ST_DHECKERR數(shù)據(jù)校驗(yàn)錯(cuò)ST_NOSYSCARDERR非本系統(tǒng)卡片無法獲得USB設(shè)備參數(shù)，需安裝設(shè)備及驅(qū)動(dòng)無法獲得USB設(shè)備路徑參數(shù)14/*打開USB設(shè)備錯(cuò)誤*/*-*/非注銷卡注銷卡 非空白卡空白卡40/*/*/*/*/*/415152/*/*-mifire1函數(shù)返回值*/255254253252251250248247246245244242241240239238237235232231/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*

3、/*/*MI_NOTAGERR MI_CRCERR MI_EMPTY MI_AUTHERR MI_PARITYERR MI_CODEERR MI_SERNRERR MI_KEYERR MI_NOTAUTHERR MI_BITCOUNTERR MI_BYTECOUNTERR MI_TRANSERR MI_WRITEERR MI_INCRERR MI_DECRERR MI_READERR MI_OVFLERR MI_FRAMINGERR MI_COLLERR MI_RESETERR無卡CRC校驗(yàn)錯(cuò)值溢出*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/*/驗(yàn)證失敗奇偶校驗(yàn)

4、錯(cuò)通信出錯(cuò)錯(cuò)誤的序列號(hào)錯(cuò)誤未驗(yàn)證接收的數(shù)據(jù)位錯(cuò)誤 接收的數(shù)據(jù)字節(jié)錯(cuò)誤Transfer錯(cuò)誤寫失敗加值失敗 減值失敗 讀失敗 FIFO溢出 數(shù)據(jù)幀錯(cuò)誤通信失敗 初始錯(cuò)誤第1 頁230/* MI_ERFACEERR接口錯(cuò)誤*/* 卡類型對(duì)照表 */-cardtype-卡類型描述-典型鎖類型-012/*AT24C01/*AT24C02/*AT24C04*/*/*/4567/*AT24C08/*AT24C16/*SLE4428/*SLE4442*/*/*/*/*BW801*/1011121314/*TEMICE5551/*TEMICE5557/*AT24C16(T)/*EM4100(ID)/*EM446

5、9*/*/*/*/*/*BW804,BW504 */*BW816,BW506 */202122/*TM1991/*TM1996/*TM1990(ID)*/*/*/*BW802,BW5020*/*BW502*/3031/*MIFARE1/*AT24C16(M)*/*/*BW803*/函數(shù)說明/第一章 簡 介bwusball為本公司提供的在Windows9x、WindowsNT(2000),WINXP環(huán)境下對(duì)智能卡進(jìn)行操作的32位動(dòng)態(tài)聯(lián)接庫。bwusbapi.h為用C調(diào)用的頭文件，用C調(diào)用需包括在源程序中,同時(shí)到EasyUSB.dll。注：USB第二章 函數(shù)介紹時(shí)，需安裝USB驅(qū)動(dòng)，在邦威門鎖光盤

6、的usb驅(qū)動(dòng)目錄。dev_類型函數(shù)為設(shè)備類型函數(shù)，對(duì)所有邦威智能卡讀寫設(shè)備通用。 st_類型函數(shù)為通用類型函數(shù)。其他為卡函數(shù)。st_rdkeycard，st_wrkeycard為邦威電子門鎖客人卡制作的接口函數(shù)。 bw50 x_wrcard,bw50 x_rdcard,bw50 x_getcheckid為讀寫型柜鎖（bw504，bw5020）二次開發(fā)函數(shù)第二章 函數(shù)說明/-/1設(shè)置時(shí)間/- bwusbapi stdcalldev_setdisptime(unsigned charcardtype,unsigned char * datetime);功能：設(shè)置讀寫設(shè)備顯示時(shí)間（無顯示功能的讀寫設(shè)

7、備本函數(shù)不作用）參數(shù)：cardtype datetime卡類型時(shí)間030820225112表示2003-8-20 22:51:12返回：成功則返回0第 2 頁Cbc例子：unsigned char datetime12; strcpy(datetime,030820225112);mv=dev_setdisptime(30,datetime);/對(duì)MIFARE1 Delphi例子：st:=dev_setdisptime(30,datetime)/-/2蜂鳴/- bwusbapi stdcalldev_openbuzz(unsigned char cardtype);功能：設(shè)置讀寫設(shè)備蜂鳴一次（

8、200MS）參數(shù)：cardtype返回：成功則返回0 Cbc例子：mv=dev_openbuzz(1); Delphi例子：卡類型st:=dev_openbuzz(1)/-/3卡/mifare1/- bwusbapi stdcallm1_halt();功能：中止對(duì)該卡操作及參數(shù)：卡（MIFARE1卡）返回：成功則返回0執(zhí)行該命令后如果是PICC_REQALL尋卡模式則必須重新能夠?qū)υ摽ú僮?，如果是PICC_REQIDL模式則必須把卡移開感應(yīng)區(qū)再進(jìn)來才能尋得這。返回：成功則返回0 Cbc例子：mv=m1_halt(); Delphi例子：st:=m1_halt()/-/4裝/- bwusbapi

9、 stdcallst_loadkey(unsigned char cardtype,unsignedchar block,unsigned char *coded);功能：參數(shù)：裝載卡cardtype卡類型塊號(hào) （mifare1卡每一扇區(qū)的block 3/5/./63） (其他為0）塊codedSLE4432-4442code6;TemicE5551-E5557code8;對(duì)卡操作前，裝載。Mifare1code12;對(duì)某一扇區(qū)操作時(shí)，首先裝載本扇區(qū)數(shù)據(jù)塊。返回：成功則返回0塊，驗(yàn)證成功后，即可操作本扇區(qū)的第 3 頁Cbc例子：unsigned char coded12; strcpy(cod

10、ed,a1a2a3a4a5a6);mv=st_loadkey(30,3,coded);/-/5高級(jí)尋卡（包含防）/- bwusbapi char *csn); stdcallm1_hiselect(unsigned char req_code,unsigned功能：從多個(gè)卡中選取一卡，并返回本卡（本操作已執(zhí)行防命令）參數(shù)： req_code尋卡模式分二種情況：PICC_REQIDL模式、PICC_REQALL模式。PICC_REQIDL0 x26 ，一次只對(duì)一操作；PICC_REQALL0 x52 ，一次可對(duì)多操作；csn 獲得的返回：成功則返回0 Cbc例子：#define IDLE 0 x

11、26，長度為8字符；unsigned char csn8;mv=m1_hiselect(IDLE,csn);/-/6驗(yàn)證/- bwusbapi stdcallm1_authkey(unsigned char auth_mode, unsignedchar *csn, unsigned char len_bck);功能： 驗(yàn)證卡（MIFARE卡）參數(shù)：auth_mode驗(yàn)證模式 ，支持兩種驗(yàn)證模式PICC_AUTHENT1A0 x60 A組 PICC_AUTHENT1B0 x61 B組驗(yàn)證方式驗(yàn)證方式注：卡上每個(gè)扇區(qū)有A和B，可根據(jù)實(shí)際需要確定是否使用B，這由該扇區(qū)的存取控制位來決定。st_lo

12、adkey()裝入的，用驗(yàn)證函數(shù)驗(yàn)證。csn len_bck返回：成功則返回0卡序號(hào)(高級(jí)尋卡獲得的）塊號(hào)（mifare1卡每一扇區(qū)的塊 3/5/./63）Cbc例子：#definCC_AUTHENT1A 0 x60 #define IDLE 0 x26unsigned char csn8; mv；mv=m1_hiselect(IDLE,csn); mv=m1_authkey(PICC_AUTHENT1A,csn，3);/-/7通寫/- bwusbapi stdcallst_wrcard(unsigned char cardtype,unsigned lengtsigned char *buf

13、fer);address_bck,unsigned char功能： 寫卡參數(shù)： cardtype卡類型第 4 頁address_bck地址（E5550E5557M1卡為塊號(hào)）M1卡塊地址（163）;塊注意操作長度字節(jié)通讀/- bwusbapi stdcallst_rdcard(unsigned char cardtype,unsigned lengtsigned char *buffer);address_bck,unsigned char功能： 讀卡參數(shù)： cardtypeaddress_bck卡類型地址（E5550E5557M1卡為塊號(hào)）M1卡塊地址（163）;塊注意操作長度字節(jié)值操作(4

14、字節(jié)）valuelsb for mifare1/- bwusbapi stdcallm1_valueindec(unsigned char dd_mode,unsignedchar bck,unsigned long value,unsigned char *pre_aft_value);功能： 值操作參數(shù)： dd_mode加減模式，支持兩種模式PICC_DECREMENT，PICC_INCREMENTPICC_DECREMENT0 xC0減數(shù)值PICC_INCREMENT0 xC1加數(shù)值M1卡塊地址（163）;塊號(hào)值塊除外。bckvaluepre_aft_value傳送將操作前后的值，4字節(jié)

15、前值(8字符)，4字節(jié)后值(8字符)返回：成功則返回0注意：1。值操作只能用于值塊。第 5 頁2。本函數(shù)包括PICC_TRANSFER命令。3。在進(jìn)行值操作時(shí)，必須先執(zhí)行初始化值函數(shù)，然后才可以減、加的操作，通過PICC_ TRANSFER命令。才真正完成數(shù)值操作。Cbc例子：#definCC_AUTHENT1A 0 x60 #define IDLE 0 x26unsigned char csn8;unsigned char pre_aft_value16; mv；mv=m1_hiselect(IDLE,csn); mv=m1_authkey(PICC_AUTHENT1A,csn，3); un

16、signed char data50；strcpy(data,00000000ff0000000002fd02fd0000000000;/寫值塊，初始為0；mv=st_rdwrcard(30,2,16,data);/寫第二塊mv=m1_valueindec(0 xc1,2,1,pre_aft_value); 加1操作。/電子門鎖客人卡讀寫函數(shù)/-/10buffer=key_type(1字符)+sys_cipher(8字符)+room_No(6字符)+check_out_time(10字符)+check_in_time(10字符)+card_no(6字符)寫客人卡/- bwusbapi char

17、 *buffer); stdcallst_wrkeycard(unsigned char cardtype,unsigned功能：參數(shù)：寫客人卡cardtype卡類型(參照卡類型對(duì)照表）buffer輸入?yún)?shù)（用戶調(diào)用時(shí)，指針或數(shù)組長度50)buffer 組成：buffer=key_type+sys_cipher+room_No+check_out_time+check_in_time+card_no；*具體解釋參看附錄1返回：成功則返回0*調(diào)用方法參看附錄2/-/11 輸入：buffer=sys_cipher(8字符)/輸出：buffer=key_type(1字符)+sys_cipher(8字

18、符)+room_No(6字符)+check_out_time (10字符)+check_in_time(10字符)+card_no(6字符)讀客人卡/- bwusbapi char *buffer); stdcallst_rdkeycard(unsigned char cardtype,unsigned功能：參數(shù)：讀客人卡cardtype卡類型(參照卡類型對(duì)照表）buffer輸入輸出參數(shù)（用戶調(diào)用時(shí)，指針或數(shù)組長度50)輸入buffer組成： buffer=sys_cipher；輸出buffer組成：第 6 頁buffer=key_type+sys_cipher+room_No+check_o

19、ut_time+check_in_time+card_no；*具體解釋參看附錄1返回：成功則返回0*調(diào)用方法參看附錄2/-讀寫型柜鎖（bw504，bw5020）二次開發(fā)函數(shù)開始-/14讀寫型柜鎖（寫卡） CardData=卡數(shù)據(jù)(30字符)校驗(yàn)(2字符)/- bwusbapi stdcallbw50 x_wrcard(unsigned char cardtype,unsignedchar *CardData,unsigned char *CardID);功能：寫bw504，bw5020柜鎖卡片（系統(tǒng)卡，設(shè)定卡，清除卡，區(qū)域卡，卡，注銷卡）參數(shù)： cardtype卡類型bw504 cardtyp

20、e10 BW5020 cardtype20CardData卡數(shù)據(jù)(30字符)校驗(yàn)(2字符)（輸入）卡數(shù)據(jù)卡類別系統(tǒng)箱柜信息寫卡時(shí)間；*具體參數(shù)解釋及調(diào)用參看附錄3(12字符)（輸出）成功寫卡后，返回本卡。CardID返回：成功則返回0，其他參考函數(shù)返回值對(duì)照表注本函數(shù)寫卡時(shí)，判斷是否為注銷卡，若是可寫為系統(tǒng)卡，設(shè)定卡，清除卡，區(qū)域卡，卡，注銷卡；否則只能寫為注銷卡。/-/15讀寫型柜鎖 (讀卡）/- bwusbapi stdcallbw50 x_rdcard(unsigned char cardtype,unsignedchar *CardData,unsigned char *CardID)

21、;功能：讀bw504，bw5020柜鎖卡片（系統(tǒng)卡，設(shè)定卡，清除卡，區(qū)域卡，卡，注銷卡）參數(shù)： cardtype卡類型bw504 cardtype10 BW5020 cardtype20系統(tǒng)（8字符）（輸入）CardData卡數(shù)據(jù)(30字符)校驗(yàn)(2字符)（輸出）卡數(shù)據(jù)卡類別系統(tǒng)箱柜信息寫卡時(shí)間；*具體參數(shù)解釋及調(diào)用參看附錄3CardID(12字符)（輸出）返回：成功則返回0，其他參考函數(shù)返回值對(duì)照表/16讀寫型柜鎖 (讀卡）/- bwusbapi char *CardID); stdcallbw50 x_getid(unsigned char cardtype,unsigned第 7 頁功能

22、： 讀bw504，bw5020柜鎖卡片參數(shù)： cardtype卡類型bw504 cardtype10 BW5020 cardtype20CardID返回：成功則返回0，同時(shí)返回(12字符)（輸出）/-讀寫型柜鎖（bw504，bw5020）二次開發(fā)函數(shù)結(jié)束-/17賓館鎖注銷卡過程（不包含判斷是否為客人卡或是否有效）/- bwusbapi 功能： stdcallst_cancelkey(unsigned char cardtype);賓館鎖注銷卡過程（不包含判斷是否為客人卡或是否有效）,使卡失效。參數(shù)： cardtype卡類型bw801 cardtype=7 bw804 cardtype10 BW

23、803 cardtype30返回：成功則返回0/-第三章 附錄1一、邦威門鎖基本概念：1。邦威電子門鎖客人卡分為“客人卡A”，“客人卡B”兩種；2。“客人卡A”為主卡，如果新的“客人卡A”在門鎖上使用后，原“客人卡A”及 “客人卡B”都被作廢（原因：新的入住時(shí)間大于原卡的入住時(shí)間）；3。對(duì)門鎖有效的卡片只可能是：一張“客人卡A”，和入住時(shí)間大于前者的若干張“客人卡B”；4。也可理解為房間的第一客人為“客人卡A”，其他的客人為“客人卡B”；5?！翱腿丝˙”之間不互相作用。6。門鎖識(shí)辨的客人卡被“終止卡”作用后，客人能開門的第一一定是“客人卡A”。二、調(diào)用函數(shù)的基本概念：1。key_type：客人

24、卡類型：“客人卡A”：key_type=A;“客人卡B”：key_type=B;2。sys_cipher：門鎖管理程序的系統(tǒng)：如：sys_cipher=11111111;長度為8個(gè)字符參看邦威門鎖管理系統(tǒng)-系統(tǒng)設(shè)置-酒店信息-系統(tǒng)-“新”。讀卡時(shí)buffer參數(shù)一定要帶入系統(tǒng)，否則可能出現(xiàn)“非本系統(tǒng)卡錯(cuò)誤”。3。room_No：客人卡的房號(hào)： 如room_No=010203;長度為6個(gè)字符房號(hào)數(shù)據(jù)一定要與邦威門鎖管理系統(tǒng)房號(hào)設(shè)置的數(shù)據(jù)一致。4。check_out_time：退房時(shí)間：格式為“YYMMDDHHNN”如check_out_time=0305121421,表示14點(diǎn)21分。第 8 頁

25、5。check_in_time：如住時(shí)間：格式為“YYMMDDHHNN”如check_in_time=0305121421,表示6。card_no：14點(diǎn)21分。個(gè)：應(yīng)具有唯一性，為6位16進(jìn)制數(shù)，及0-0 x不夠6位，補(bǔ)0。如card_no=000234,表示為0 x234;由于邦威門鎖管理系統(tǒng)發(fā)卡占用部分的原因，用戶寫卡時(shí)，.務(wù)必大于0 x100000第四章 附錄2 門鎖接口調(diào)用基本過程寫卡：unsigned char buffer100;/bw804門鎖cardtype=10; bak;Stringbuf=A11111111+room_No+check_out_time+Now().Fo

26、rmatString(yymmddhhnn)+card_no;strcpy(buffer,buf.c_str(); bak=st_wrkeycard(cardtype,buffer)；讀卡：unsigned char buffer100;/bw804門鎖cardtype=10;strcpy(buffer,11111111);bak=st_rdkeycard(cardtype,buffer);注銷卡:bak； bak=st_cancelkey(7);第五章 附錄3 讀寫型柜鎖讀寫卡參數(shù)及調(diào)用1：卡類別及各類別卡數(shù)據(jù)格式：（共30個(gè)字符）卡類別(2字符)系統(tǒng)(8字符)箱柜信息(8字符)寫卡時(shí)間(1

27、2字符)系統(tǒng)卡：A1+舊系統(tǒng)系統(tǒng)8字符新系統(tǒng)+寫卡時(shí)間設(shè)定卡：A2+6字符箱柜ID2字符區(qū)域ID寫卡時(shí)間清除卡：A3+區(qū)域卡：B1+卡：C1+注銷卡：C1+ 000000000000注：系統(tǒng)系統(tǒng)系統(tǒng)00000000+ 0000002字符區(qū)域ID+6字符箱柜ID00+00000000+寫卡時(shí)間寫卡時(shí)間寫卡時(shí)間00000000+所有字符為十六進(jìn)制數(shù)字符初始系統(tǒng)為11111111寫卡時(shí)間格式為”YYMMDDHHNNSS“*箱柜號(hào)（或箱柜名稱）不等于 箱柜ID*區(qū)稱不等于區(qū)域ID;寫入卡內(nèi)的信息為箱柜ID和區(qū)域ID而不是箱柜號(hào)和區(qū)稱。請(qǐng)參考本司柜鎖管理箱柜表的字段箱柜號(hào)和箱柜ID2: 卡類說明系統(tǒng)卡：

28、設(shè)定柜鎖系統(tǒng)，防止其他系統(tǒng)卡使用設(shè)定卡：設(shè)定柜鎖的箱柜ID及區(qū)域ID清除卡：清除柜鎖內(nèi)區(qū)區(qū)域卡：同區(qū)域的柜鎖，可被本區(qū)域ID的區(qū)域卡開啟卡：開啟箱柜ID相同的柜鎖注銷卡：清除卡數(shù)據(jù)注：系統(tǒng)卡，設(shè)定卡，清除卡，卡寫卡時(shí)間大的覆蓋小的同類卡第 9 頁；區(qū)域卡寫卡時(shí)間在同一小時(shí)內(nèi)的卡，不相互覆蓋，大于小時(shí)值的覆蓋小的區(qū)域卡；*寫卡流程：注銷卡-其他卡|-Text).SubString(00000000+edjmm-Text).Length()-7,8);xmm=(00000000+edxmm-Text).SubString(00000000+edxmm-Text).Length()-7,8);gh=

29、(000000+edgh-Text).SubString(000000+edgh-Text).Length()-5,6); qh=(00+edqh-Text).SubString(00+edqh-Text).Length()-1,2);ime=Now().FormatString(yymmddhhnnss); switch(ComboBox4-ItemIndex)case 0: tmp=Card_typeComboBox4-ItemIndex+jmm+xmm+ime;break; case 1: tmp=Card_typeComboBox4-ItemIndex+jmm+gh+qh+ime;br

30、eak; case 2:tmp=Card_typeComboBox4-ItemIndex+jmm+00000000+ime;break; case 3:tmp=Card_typeComboBox4-ItemIndex+jmm+000000+qh+ime;break;case 4:tmp=Card_typeComboBox4-ItemIndex+jmm+gh+00+ime;break;case 5:tmp=Card_typeComboBox4-ItemIndex+0000000000000000000000000000;break;unsigned char buff50,cid20; Edit

31、3-Text=tmp;/strcpy(buff,Edit3-Text.SubString(1,32).c_str(); bak=bw50 x_wrcard(10,buff,cid);Show_bak(bak);/讀卡unsigned char buff50,cid12;Stringxmm=(00000000+edxmm-Text).SubString(00000000+edxmm-Text).Length()-7,8);/系統(tǒng)strcpy(buff,xmm.c_str();/讀卡時(shí)帶入系統(tǒng) bak=bw50 x_rdcard(10,buff,cid); Show_bak(bak);if(bak)trydelete buff;catch(.);return;RichEdit1-Text=String(char *)buff).SubString(1,32)+String(char *)cid).SubString(1,12);/Delph例子寫卡 functiondev_openbuzz(cardtype:eger):eger;stdcall;far;externalbwusball第 10 頁namedev_openbuzz;functionbw50 x_wrcard(cardtype:eger