CMRF800系列CMRF810系列程序庫函數(shù)

1、CMRF800系列CMRF810系列非接觸式智能卡讀寫器USB Reader 開發(fā)文檔1、版本說明(版本V1.00)* All rights reserved, Specifications subject to change without notice.* 版權(quán)所有,規(guī)格如有更改,恕不另行通知。2、返回值說明：21 函數(shù)返回值代碼表：0x00 命令執(zhí)行成功 0x01 命令操作失敗（失敗原因請參考2.2底層單片機(jī)上傳代碼表）0x02 地址校驗(yàn)錯誤0x04 讀寫器返回超時0x05 數(shù)據(jù)包流水號不正確: 0x07 接收異常0x0A 參數(shù)值超出范圍22 底層單片機(jī)上傳代碼表：0x80: 參數(shù)設(shè)置成

2、功0x81:參數(shù)設(shè)置失敗0x82:通訊超時 0x83:卡不存在0x84:接收卡數(shù)據(jù)出錯0x87:未知的錯誤0x85:輸入?yún)?shù)或者輸入命令格式錯誤0x8f:輸入的指令代碼不存在（）0x8A:在對于卡塊初始化命令中出現(xiàn)錯誤（僅用于14443命令）0x8B: 在防沖突過程中得到錯誤的序列號（僅用于14443命令）0x8C 密碼認(rèn)證沒通過（僅用于14443命令）0x90 卡不支持這個命令（僅用于15693命令）0x91 命令格式有錯誤（僅用于15693命令）0x92 在命令的FLAG參數(shù)中，不支持OPTION 模式（僅用于15693命令）0x93 要操作的BLOCK不存在（僅用于15693命令）0x9

3、4 要操作的對象已經(jīng)別鎖定，不能進(jìn)行修改（僅用于15693命令）0x95 鎖定操作不成功（僅用于15693命令）0x96 寫操作不成功（僅用于15693命令）3System Commands 系統(tǒng)命令5、int SetSerNum( unsigned char *newValue, unsigned char *buffer);函數(shù)功能：設(shè)置 8個字節(jié)的產(chǎn)品序列號。輸入?yún)?shù)：描述*newValue 8個字節(jié)的讀寫器序列號*buffer 用來返回接收到的數(shù)據(jù)的指針 輸出參數(shù)：*buffer 返回STATUS后的狀態(tài)，如果設(shè)置成功，則*buffer=0x 80如果設(shè)置失敗，則*buffer為底層（

4、讀卡器單片機(jī)）上傳的錯誤代碼（參照底層協(xié)議代碼表2.2）返回值：0x00，設(shè)置成功0x01，設(shè)置失敗、int GetSerNum(unsigned char *buffer);函數(shù)功能：讀取由廠家預(yù)設(shè)的1個字節(jié)的讀卡器地址和8個字節(jié)序列號. 輸入?yún)?shù)：*buffer 傳入一個指針，用來返回接收到的數(shù)據(jù) 輸出參數(shù)：*buffer buffer0 讀寫器地址 buffer1.8 8個字節(jié)的讀寫器序列號返回值：0x00，操作成功0x01，操作失敗6、 int WriteUserInfo(int num_blk, int num_length, char *user_info);函數(shù)功能：讀卡器提供4

5、個塊（每個塊不能大于120個字節(jié)），共480個字節(jié)空間的用戶數(shù)據(jù)區(qū)。用戶可以根據(jù)需要，儲存相應(yīng)的用戶信息到讀寫器中.輸入?yún)?shù)：num_blk 區(qū)域號 num_length 數(shù)據(jù)長度*user_info 用戶數(shù)據(jù)返回值： 0x00，操作成功 0x01，操作失敗7、int ReadUserInfo(int num_blk, int num_length, char *user_info);函數(shù)功能：讀取讀卡器中提供4個塊（每個塊不能大于120個字節(jié)）的數(shù)據(jù).輸入?yún)?shù)：int num_blk 區(qū)域號 int num_length 讀取的數(shù)據(jù)長度*user_info 待讀入的用戶數(shù)據(jù) 輸出參數(shù)：*us

6、er_info 如果 ：操作失敗， 則user_info0 為 錯誤代碼 如果 ：操作成功， 則user_info0.N 為讀取的用戶信息數(shù)據(jù)返回值： 0x00，操作成功 0x01，操作失敗8、int GetVersionNum(char *VersionNum);函數(shù)功能：讀取讀寫器的版本號.輸入?yún)?shù)：*VersionNum 待讀入的版本號 輸出參數(shù)：*VersionNum 如果 ：操作失敗， 則VersionNum 0 為 錯誤代碼 如果 ：操作成功， 則VersionNum 0.N 為讀入的版本號返回值： 0x00，操作成功 0x01，操作失敗9、int ControlLED( unsi

7、gned charfreq, unsigned char duration, unsigned char *buffer);函數(shù)功能： 設(shè)置燈的工作狀態(tài)，包括，燈亮的周期以及循環(huán)的次數(shù)輸入?yún)?shù)：freq 周期數(shù) duration 次數(shù)*buffer 待返回的參數(shù) 輸出參數(shù)：*buffer 如果 ：操作失敗， 則buffer 0 為 錯誤代碼（參考2.2） 如果 ：操作成功， 則buffer 0 為成功標(biāo)志 ，即為0x80返回值： 0x00，操作成功， 0x01，操作失敗 10、int ControlBuzzer(unsigned char freq, unsigned char duratio

8、n, unsigned char *buffer);函數(shù)功能： 設(shè)置蜂鳴器的工作狀態(tài)，包括，蜂鳴器的工作周期以及循環(huán)的次數(shù)輸入?yún)?shù)：freq 周期數(shù) duration 次數(shù)*buffer 待返回的參數(shù) 輸出參數(shù)：*buffer 如果 ：操作失敗， 則buffer 0 為 錯誤代碼（參考2.2） 如果 ：操作成功， 則buffer 0 為成功標(biāo)志 ，即為0x80返回值： 0x00，操作成功 0x01，操作失敗4、ISO14443 Type-A Commands41 Type-A Commands4.1.1 int MF_Request(unsigned char inf_mode, unsign

9、ed char *buffer);函數(shù)功能：發(fā)送ISO14443 A 尋卡指令.輸入?yún)?shù)：inf_mode 尋卡模式 0x01 Idle模式（一次只對一張卡操作）0x00 All模式（一次可對多張卡操作）*buffer 待返回的參數(shù) 輸出參數(shù)：*buffer 如果 ：操作失敗， 則buffer 0 為 錯誤代碼 如果 ：操作成功， 則buffer 0.1，返回2個字節(jié)的數(shù)據(jù)串返回值： 0x00，操作成功 0x01，操作失敗 4.1.2 int MF_Anticoll(unsigned char *snr,unsigned char &status);函數(shù)功能：檢測卡片數(shù)量，單卡或多卡，

10、并返回4個字節(jié)的卡號。（如果有多張卡，就返回其中一張卡的卡號） 輸入?yún)?shù)：*snr 傳送一個指針，返回4個字節(jié)的卡號&Status 傳送一個指針，返回卡片的數(shù)量輸出參數(shù)：如果操作成功Status 檢測到的卡片的數(shù)量(0x00表示檢測到單卡,0x01表示檢測到多卡)*snr 4個字節(jié)的卡號（snr0.3） 如果操作失敗*snr 為 錯誤代碼（具體參考2.2）返回值： 0x00，操作成功， 0x01，操作失敗 4.1.3 int MF_Select(unsigned char *snr);函數(shù)功能：選擇卡，使卡進(jìn)入被選擇的狀態(tài)輸入?yún)?shù)：*snr 傳送一個指針，傳入4個字節(jié)卡號，并且返回4個

11、字節(jié)的卡號輸出參數(shù)：Status 檢測到的卡片的數(shù)量*snr 4個字節(jié)的卡號（snr0.3） 返回值： 0x00，操作成功， 0x01，操作失敗 4 .1.4 int MF_Halt( ); 函數(shù)功能：選擇卡，使卡進(jìn)入被中斷的狀態(tài)輸入?yún)?shù)：無返回值：0x00，操作成功， 0x01，操作失敗4.2 Mifare Appilication Commands 4.2.1 int MF_Read( unsigned char mode, unsigned char blk_add,unsigned char num_blk, unsigned char *snr, unsigned char *buf

12、fer);函數(shù)功能：在指定位置讀取指定長度的數(shù)據(jù)輸入?yún)?shù)：mode， 讀取模式( Request Idle + Key A mode=00 , Request Idle + Key B mode= 02, Request All + Key A mode=01 , Request All + Key B mode=03）（以上數(shù)字均為十六進(jìn)制數(shù)字)blk_add， 讀取塊地址num_blk， 讀取塊數(shù)目*snr， 一個指針，傳遞的是六個字節(jié)的密鑰*buffer 等待接受輸出的指針變量輸出參數(shù)：如果操作成功*snr， 4個字節(jié)的卡號*buffer， 讀取到的數(shù)據(jù)(具體數(shù)量為： num_blk*1

13、6)如果操作失敗buffer0 錯誤代碼（具體參考2.2）返回值：0x00，操作成功， 0x01，操作失敗4.2.2 int MF_Write(unsigned char mode,unsigned char blk_add,unsigned char num_blk,unsigned char *snr, unsigned char *buffer);函數(shù)功能：在指定位置寫入數(shù)據(jù)輸入?yún)?shù)：mode， 要寫的模式( Request Idle + Key A mode=00 , Request Idle + Key B mode= 02, Request All + Key A mode=01

14、, Request All + Key B mode=03）blk_add， 要寫塊地址num_blk， 要寫塊數(shù)目*snr， 待寫入的數(shù)據(jù)*buffer， 傳入的指針符號.用來傳出數(shù)據(jù)輸出參數(shù)：如果操作成功snr0.3， 4個字節(jié)的卡號如果操作失敗buffer0 錯誤代碼（具體參考2.2）返回值：0x00，操作成功， 0x01，操作失敗4.2.3 int MF_InitVal(unsigned char mode,unsigned char SectNum,unsigned char *snr, unsigned char *value);函數(shù)功能：初始化卡輸入?yún)?shù)：mode， 初始化模式(

15、 Request Idle + Key A mode=00 , Request Idle + Key B mode= 02, Request All + Key A mode=01 , Request All + Key B mode=03）SectNum, 要初始化的扇區(qū)號00-0F*snr, 6字節(jié)密鑰（以指針的形式傳入）*value 4 字節(jié)的要初始化的數(shù)據(jù)輸出參數(shù)：如果操作成功：snr0.3， 4個字節(jié)的卡號如果操作失?。簊nr0， 錯誤代碼（具體參考2.2）返回值：0x00，操作成功， 0x01，操作失敗4.2.4 int MF_Dec(unsigned char mode,unsi

16、gned char SectNum,unsigned char *snr, int *value);函數(shù)功能：對卡的指定扇區(qū)進(jìn)行減值操作。輸入?yún)?shù)：mode， 模式控制( Request Idle + Key A mode=00 , Request Idle + Key B mode= 02, Request All + Key A mode=01 , Request All + Key B mode=03）SectNum, 要寫值的扇區(qū)號00-0F*snr, 6字節(jié)密鑰（以指針的形式傳入）value 要減的值，4個字節(jié)長度輸出參數(shù)：如果操作成功snr0.3， 4個字節(jié)的卡號value0.3

17、4個字節(jié)操作后的數(shù)據(jù)串如果操作失敗snr0 錯誤代碼（具體參考2.2）返回值：0x00，操作成功， 0x01，操作失敗4.2.5 int MF_Inc (unsigned char mode,unsigned char SectNum,unsigned char *snr, int *value);函數(shù)功能：對卡的指定扇區(qū)進(jìn)行加值操作。輸入?yún)?shù)：mode， 模式控制( Request Idle + Key A mode=00 , Request Idle + Key B mode= 02, Request All + Key A mode=01 , Request All + Key B mo

18、de=03）SectNum, 要加值的扇區(qū)號00-0F*snr, 6字節(jié)密鑰（以指針的形式傳入）value 要加的值，4個字節(jié)長度輸出參數(shù)：如果操作成功snr0.3， 4個字節(jié)的卡號value0.3 4個字節(jié)操作后的數(shù)據(jù)串如果操作失敗snr0 錯誤代碼（具體參考2.2）返回值：0x00，操作成功， 0x01，操作失敗4.2.6 int MF_Getsnr (unsigned char mode, unsigned char halt, unsigned char *snrunsigned char *value);函數(shù)功能：返回1個字節(jié)的單卡或多卡標(biāo)識，4個字節(jié)的卡號。輸入?yún)?shù)：mode， 模

19、式控制 （模式控制 26 or 52 ）0x26 Idle模式（一次只對一張卡操作）0x52 All模式（一次可對多張卡操作） halt, 是否需要halt卡 （halt選擇 00 or 01 ） 00不需要執(zhí)行halt指令 01讀寫器 執(zhí)行halt指令snr, 返回的1個字節(jié)的單卡或多卡標(biāo)識(如果讀卡不成功，返回錯誤碼)value 返回的4個字節(jié)的卡號輸出參數(shù)：如果操作成功snr0， 1個字節(jié)的單卡或多卡標(biāo)識value0.3 返回的4個字節(jié)的卡號如果操作失敗snr0 錯誤代碼（具體參考2.2）返回值：0x00，操作成功， 0x01，操作失敗4.2.7 int MF_Restore( unsi

20、gned char mode, int cardlength, unsigned char *carddata );函數(shù)功能：按照選擇的模式，進(jìn)行數(shù)據(jù)的發(fā)送輸入?yún)?shù)：mode， 模式控制 0x00 不需要進(jìn)行CRC校驗(yàn)0x01 需要進(jìn)行CRC校驗(yàn) cardlength, 卡數(shù)據(jù)長度*carddata, 發(fā)送時（卡數(shù)據(jù)） 接收時（返回?cái)?shù)據(jù)）輸出參數(shù)：如果操作成功carddata0.N, 接收返回?cái)?shù)據(jù)如果操作失敗carddata0 錯誤代碼（具體參考2.2）返回值：0x00，操作成功， 0x01，操作失敗5. ISO14443 Type-B Commands5.1 int RequestType_

21、B( unsigned char *buffer)函數(shù)功能：該命令執(zhí)行ISO14443B中的REQB命令，獲取卡片的PUPI代碼輸入?yún)?shù)：*buffer, 卡片復(fù)位后的數(shù)據(jù)串 （ATQB）輸出參數(shù)：如果操作成功：*buffer, 卡片復(fù)位后的數(shù)據(jù)串 （ATQB）buffer0 卡片復(fù)位數(shù)據(jù)的長度buffer1.N 操作后的數(shù)據(jù)串（ATQB）如果操作失?。篵uffer0 錯誤代碼（具體參考2.2）返回值：0x00，操作成功， 0x01，操作失敗5.2 int AntiType_B(unsigned char *buffer);函數(shù)功能：該命令執(zhí)行ISO14443B中的AnticollB命令輸入?yún)?/p>

22、數(shù)：*buffer, 卡片返回的數(shù)據(jù)串 （ATQB）輸出參數(shù)：如果操作成功：buffer0.N, 卡片返回的數(shù)據(jù)串 （ATQB）如果操作失?。篵uffer0 錯誤代碼（具體參考2.2）返回值：0x00，操作成功， 0x01，操作失敗5.3 int SelectType_B (unsigned char *SerialNum);函數(shù)功能：該命令執(zhí)行ISO14443B中的ATTRIB命令，給已知PUPI的卡片分配一個識別號CID輸入?yún)?shù)：*SerialNum, 卡的序列號返回值：0x00，操作成功， 0x01，操作失敗5.4 int Request_AB(unsigned char * buffe

23、r);函數(shù)功能：該命令執(zhí)行幾集成了ISO14443B中的，REQUEST和ATTRIB命令，通過一個命令使卡復(fù)位。輸入?yún)?shù)：* buffer, 返回操作后的卡的序列號4個字節(jié)輸出參數(shù)：如果操作成功： buffer0.3, 返回操作后的卡的序列號4個字節(jié)如果操作失?。?buffer0, 錯誤代碼（具體參考2.2）返回值：0x00，操作成功， 0x01，操作失敗5.5 int API_ISO14443TypeBTransCOSCmd(unsigned char *cmd, int cmdSize,unsigned char *buffer);函數(shù)功能： ISO14443傳送命令，可以通過此命令向卡

24、發(fā)任意有效的命令，數(shù)據(jù)輸入?yún)?shù)：*cmd, 待發(fā)送的數(shù)據(jù)cmdSize, 數(shù)據(jù)長度* buffer, 回收的數(shù)據(jù)輸出參數(shù)：* buffer, 回收的數(shù)據(jù)如果：操作成功，則buffer0.N 為從卡返回的數(shù)據(jù) 操作失敗，則buffer0 為錯誤代碼返回值：0x00，操作成功， 0x01，操作失敗6 ISO15693 COMMANDS6.1 ISO15693_Inventory(unsigned char *Cardnumber,unsigned char *pBuffer);函數(shù)功能：此命令通過防沖突用于得到讀卡區(qū)域內(nèi)所有卡片的序列號（能得到的卡片數(shù)量與模塊天線的輸出功率有關(guān)，一般能對26卡進(jìn)行

25、防沖突）輸入?yún)?shù)：*Cardnumber, 返回的卡的數(shù)量（一個字節(jié)）*pBuffer 返回的數(shù)據(jù)（包括FLAG和DSFID和8*n個字節(jié)的卡號）輸出參數(shù)：如果：操作成功*Cardnumber 返回的卡的數(shù)量（一個字節(jié)）*pBuffer 返回的數(shù)據(jù)（包括FLAG和DSFID和8*n個字節(jié)的卡號） 如果：操作失敗*Cardnumber 為錯誤代碼返回值：0x00，操作成功， 0x01，操作失敗6.2 int ISO15693_Read(unsigned char flags, unsigned char blk_add,unsigned char num_blk, unsigned char *

26、uid, unsigned char *buffer);函數(shù)功能：用來讀取1個或多個扇區(qū)的值，如果要讀每個塊的安全位，將FLAGS中Option_flag置為1，即FLAG = 0X42，每個扇區(qū)將返回5個字節(jié)，包括1個表示安全狀態(tài)字節(jié)和4個字節(jié)的塊內(nèi)容，這時候每次最多能讀12個塊。如果FLAG = 02，將只返回4字節(jié)的塊內(nèi)容，這時候每次最多能讀63個塊。輸入?yún)?shù)：flags 0x02 不帶uid 0x22 帶uid 0x42 不帶uid但是要讀安全位blk_add, 要讀的起始塊號num_blk, 塊的數(shù)量*uid UID信息*buffer 返回值輸出參數(shù)：如果：返回操作成功 buffer

27、0 返回的flag buffer1.N Data 操作失敗，buffer0為錯誤代碼返回值：0x00，操作成功， 0x01，操作失敗6.3 int ISO15693_Write(unsigned char flags,unsigned char blk_add,unsigned char num_blk,unsigned char *uid, unsigned char *data);函數(shù)功能： 對一個塊進(jìn)行寫操作（每次只能寫一個塊）輸入?yún)?shù)：flags 0x02 不帶uid 0x22 帶uid 0x42 不帶uid但是要讀安全位blk_add, 要寫的起始塊號num_blk, 寫的塊的數(shù)量*

28、uid UID信息*data 寫入的數(shù)據(jù)輸出參數(shù)：如果：操作失敗，則data0為錯誤代碼返回值：0x00，操作成功， 0x01，操作失敗6.4 int ISO15693_Lock(unsigned char flags,unsigned char num_blk,unsigned char *uidunsigned char *buffer);函數(shù)功能：用于鎖定塊內(nèi)容。注意：此過程不可逆（不能解鎖）塊鎖定后內(nèi)容不能在修改。輸入?yún)?shù)：flags 0x02 不帶uid 0x42 不帶uid但是要讀安全位 0x22 帶uidnum_blk, 要鎖的塊號*uid UID信息*buffer 返回值輸出參

29、數(shù)：如果：操作成功，則buffer0 值為0x80 如果：操作失敗，則buffer0為錯誤代碼返回值：0x00，操作成功， 0x01，操作失敗6.5 int ISO15693_StayQuiet(unsigned char flags,unsigned char *uid, unsigned char *buffer );函數(shù)功能：此命令用于將卡置于靜止的狀態(tài), 必須用地址模式，如果發(fā)送的數(shù)據(jù)與被操作的卡的序列號相同，操作成功后，卡將進(jìn)入靜止?fàn)顟B(tài)，否則狀態(tài)不變。輸入?yún)?shù)：flags 標(biāo)識字節(jié)1個字節(jié)*uid UID信息*buffer 返回值輸出參數(shù)：如果：操作成功 ， 則buffer0 返回的

30、0x80，表示操作成功 如果：操作失敗 ，則buffer0為錯誤代碼（具體參考2.2）返回值：0x00，操作成功0x01，操作失敗6.6 int ISO15693_Select(unsigned char flags,unsigned char *uid, unsigned char *buffer ) ;函數(shù)功能：此命令必須用地址模式，如果發(fā)送的數(shù)據(jù)與被操作的卡的序列號相同，操作成功后，卡將進(jìn)入被選擇狀態(tài)，否則狀態(tài)不變。輸入?yún)?shù)：flags 標(biāo)識字節(jié)1個字節(jié)*uid UID信息*buffer 返回值輸出參數(shù)：如果：操作成功， 則buffer0為的0x80，表示操作成功如果：操作失敗，則buf

31、fer0為錯誤代碼返回值：0x00，操作成功0x01，操作失敗6.7 int ISO15693_ResetToReady(unsigned char flags,unsigned char *uid, unsigned char *buffer );函數(shù)功能：操作成功后，卡回到Ready狀態(tài)。輸入?yún)?shù)：flags 標(biāo)識字節(jié)1個字節(jié) 0x02 不帶uid 0x42 不帶uid但是要讀安全位 0x22 帶uid*uid UID信息*buffer 返回值輸出參數(shù)：如果：操作成功， 則buffer0 的值為0x80，表示操作成功 如果：操作失敗， 則buffer0為錯誤代碼（具體參考2.2）返回值：0

32、x00，操作成功0x01，操作失敗6.8 int ISO15693_WriteAFI(unsigned char flags,unsigned char afi,unsigned char *uid, unsigned char *buffer );函數(shù)功能：對卡進(jìn)行寫AFI操作。輸入?yún)?shù)：flags 標(biāo)識字節(jié)1個字節(jié) 0x02 不帶uid 0x42 不帶uid但是要讀安全位0x22 帶uidafi 待寫的AFI*uid UID信息*buffer 返回值輸出參數(shù)：如果：操作成功， 則buffer0 值為0x80，表示操作成功 如果：操作失敗，則buffer0 為錯誤代碼（具體參考2.2）返回值

33、：0x00，操作成功0x01，操作失敗6.9 int ISO15693_LockAFI(unsigned char flags,unsigned char *uid, unsigned char *buffer );函數(shù)功能：用于鎖定卡的AFI，鎖定后AFI不可以更改輸入?yún)?shù)：flags 標(biāo)識字節(jié)1個字節(jié) 0x02 不帶uid 0x42 不帶uid但是要讀安全位0x22 帶uid*uid UID信息*buffer 返回值輸出參數(shù)：如果：操作成功， 則buffer0 返回的0x80，表示操作成功 如果：操作失敗，則buffer0 返回 為錯誤代碼返回值：0x00，操作成功0x01，操作失敗6.1

34、0 int ISO15693_WriteDSFID(unsigned char flags,unsigned char DSFID,unsigned char *uid, unsigned char *buffer );函數(shù)功能： 對卡的進(jìn)行寫DSFID操作輸入?yún)?shù)：flags 標(biāo)識字節(jié)1個字節(jié) 0x02 不帶uid 0x42 不帶uid但是要讀安全位0x22 帶uidDSFID 要寫的DSFID字節(jié)，長度為1個字節(jié)*uid UID信息*buffer 返回值輸出參數(shù)：如果：操作成功， 則buffer0 值為0x80，表示操作成功 如果：操作失敗，則buffer0 值為錯誤代碼（具體參考2.2）返回值：0x00，操作成功0x01，操作失敗6.11 int ISO15693_LockDSFID(unsigned char flags,unsigned char *uid, unsigned char *buffer );函數(shù)功能：用于鎖定卡的DSFID，鎖定后DSFID不可以更改輸入?yún)?shù)：flags 標(biāo)識字節(jié)1個字節(jié) 0x02 不帶uid 0x42 不帶u