1、案卷號日期用 戶 手 冊作者：完成日期：簽收人：簽收日期：修改情況記錄：版本號修改批準人修改人安裝日期簽收人目錄1 SDK開發(fā)說明11.1 簡介11.2 背景11.3 定義11.4 SDK 安裝1接口調用流程7l修改密碼（加密）7l初始化IC卡（清空IC卡）8l發(fā)卡8l讀卡9l充值102 數(shù)據(jù)結構說明112.1 消費機器數(shù)據(jù)結構11l消費機中數(shù)據(jù)表說明：11l數(shù)據(jù)添加格式162.2 卡片數(shù)據(jù)結構162.3 狀態(tài)報告16l返回狀態(tài)碼及意義163 SDK開發(fā)函數(shù)說明183.1 消費機器sdk開發(fā)函數(shù)183.2 卡操作sdk卡發(fā)函數(shù)18l1 ZK_PosClearICCard18l2ZK_PosIs

2、sueICCard18l3ZK_PosReadICCard19l4ZK_PosWriteICCardMoney19l5ZK_PosWriteICCardPassWord19l6ZK_PosUpdateParam20l7ZK_PosReadCardSerial204 開發(fā)建議201 SDK開發(fā)說明1.1 簡介SDK：是針對獨立軟件開發(fā)商（ISV）和系統(tǒng)集成商（SI）的軟件開發(fā)及技術產(chǎn)品服務的需求，提供的消費軟件系統(tǒng)與消費機及IC卡讀寫器通訊的開發(fā)組件（SDK，Software Development Kit)1.2 背景 系統(tǒng)名稱：SDK消費系統(tǒng)開發(fā)組件1.3 定義 參數(shù)KEY值卡密碼,格式為每

3、個字節(jié)密碼以逗號分隔如“FF,FF,FF,FF,FF,FF”， 每個字節(jié)是該數(shù)字的ASCII碼的16進制表示形式，如：卡密碼是123456，那么轉化后為“31，32，33，34，35，36 ”， 所有函數(shù)的卡密碼格式相同，不在贅述1.4 SDK 安裝l 使用消費機sdk接口函數(shù)需要用到多個動態(tài)庫文件，詳見“消費機dll庫”文件夾，把該文件夾的所以dll文件放到工程目錄下即可，具體應用參考例程l 使用卡操作sdk時，采用ocx控件形式，需要安裝本公司提供的驅動程序獲得控件庫文件。驅動程序在“控件”文件夾中,安裝好驅動后，默認目錄（xp系統(tǒng)）在c:windowssystem32下找到以下兩個文件。

4、Biokey.ocx控件庫文件控件庫文件l 分別注冊控件控件庫文件：regsvr32.exe c:windowssystem32regsvr32.exe c:windowssystem32ZKO注意：Windows Vista客戶需要以管理員權限才能正確執(zhí)行regsvr32；l 注冊成功后，就可以在相應的開發(fā)環(huán)境中導入控件。A：在Delphi 7 開發(fā)環(huán)境:第一步：ComponentImport Activex Control如下圖所示：進入如下界面，按下圖所示操作，安裝兩個控件B：在Microsoft Visual Studio .NET 2003的VB項目中第一步：注冊控件，如下圖所示進入

5、注冊界面然后進入ActiveX控件測試容器界面，如下圖：選擇“文件注冊控件”，找到注冊文件，如下圖所示：注冊成功后，多了剛才注冊的選項，如下圖所示：第二步：添加控件到工具欄中，方法如下圖所示：添加好后，在控件里就添加好了該控件，如下圖所示：C：在中使用 第一步：注冊控件，方法跟VB的類似。 第二步：使用控件，操作如下圖所示在下圖中選擇要插入的控件：接口調用流程接口調用流程如下： 消費機器接口調用流程 IC卡操作業(yè)務流程l 修改密碼（加密）連接發(fā)卡器讀取卡序列號成功修改主、備份扇區(qū)密碼結束YN沒有找到IC卡或卡是否損壞判斷是否白卡白卡YNl 初始化IC卡（清空IC卡）連接發(fā)卡器讀取卡序列號成功清

6、空主、備份扇區(qū)密碼結束YN沒有找到IC卡或卡是否損壞l 發(fā)卡連接發(fā)卡器讀取卡序列號成功判斷是否白卡結束YN沒有找到IC卡或卡是否損壞白卡Y判斷各參數(shù)正確這不是一張空白卡，不能發(fā)卡。請將該卡先初始化!發(fā)卡寫主扇區(qū)NYN成功發(fā)卡寫備份扇區(qū)成功清空主扇區(qū)卡信息塊NNYYl 讀卡連接發(fā)卡器讀取卡序列號成功解析數(shù)據(jù)結束YN沒有找到IC卡或卡是否損壞讀主扇區(qū)數(shù)據(jù)成功YN讀備份扇區(qū)數(shù)據(jù)成功YNl 充值NY讀卡成功寫主扇區(qū)金額結束YN判斷充值參數(shù)正確NY判斷是否同一張（讀兩次序列號）同一卡NY成功讀主扇區(qū)金額成功且寫=讀寫備份扇區(qū)金額成功讀備份扇區(qū)金額成功且寫=讀執(zhí)行次數(shù) 10YYYYNNNN2 數(shù)據(jù)結構說明

7、2.1消費機器數(shù)據(jù)結構l 消費機中數(shù)據(jù)表說明：1UserInfo：（用戶信息表）字段名說明SysID系統(tǒng)卡號UserID用戶編號PIN用戶工號CardNo卡號Name姓名PassWord差額密碼SegNoUserType用戶類型(1黑名單,0白名單)Privage權限(1管理員,0普通用戶)2Template：(指紋信息)3OpLog：（管理日志）字段名說明OPID操作員IDTIME操作時間OP操作編碼4PosLog：（消費記錄）字段名說明SysID系統(tǒng)卡號CardNo卡號PosTime消費時間PosMoney消費金額Balance余額RecNo機器流水號CardRecID卡流水號State消

8、費類型Mealtype餐別MealDate記餐日期OPID操作員ID5PRESSKEY(鍵值信息表)字段名說明KeyID鍵值編號Price價格6StoreInfo：（商品信息）字段名說明StoreNo商品編號Name商品名稱Bc條碼Price價格agio折扣7Mealtype：（餐別信息）字段名說明Mlid餐別編號Name餐別名稱Start開始時間End結束時間8TimeSeg：（就餐批次時間段信息）字段名說明SegID批次編號（1為固定時段）TsID時段編號Start開始時間End結束時間9FIXED（分段定值表）字段名說明TsID時段編號Start開始時間End結束時間Price價格10P

9、ayDetail：（商品消費明細信息， 商品消費時對應消費記錄的明細信息）字段名說明RecNo機器流水號StoreNo商品編號Price實收價格RecSum單筆消費商品流水號11KEYDETAIL 鍵值消費明細表字段名說明RecNo機器流水號KeyID鍵值編號Price實收價格RecSum單筆消費商品流水號12TmPosLog：（記時消費數(shù)據(jù)）字段名說明SysID卡號StartTme開始時間StartBanlance開始金額EndTime結束時間EndBanlance結束金額（余額）13CARDTYPE（卡類設置表）字段名說明SortID卡類序號Name卡類名稱rebate折扣Timemaxm

10、oney次消費最大金額Daymaxmoney天消費最大金額Mealmaxmoney餐消費最大金額Daymaxtimes天消費最大次數(shù)Mealmaxtimes餐消費最大次數(shù)Lowlimit最小卡余額Maxlimit最大卡余額MealType可用餐別Enable是否可用limit有效天數(shù)BatchNo使用時段UseFinger是否使用指紋（1或0）14FULLVALUE（充值記錄表）字段名說明SysID系統(tǒng)卡號CardNo卡號CardRecNO卡流水號Money充值金額Balance余額LogType充值類型OPID操作員IDRecNo機器流水號15SUBSIDYLOG（補貼流水記錄表）字段名說明

11、SysID系統(tǒng)卡號CardNo卡號Batch補貼批號Money補貼金額allowDate補貼日期16SIDYLOG（已補貼記成功錄表）字段名說明SysID系統(tǒng)卡號CardNo卡號CardRecID卡流水號Batch補貼批號AllowTime補貼時間AllowMoney補貼金額Balance余額state補貼方式 0：清零補貼BaseBatch補貼基次RecNo機器流水號17SubSidy：（待補貼記錄表）字段名說明SysID系統(tǒng)卡號CardNo卡號Batch補貼批號AllowMoney補貼金額BaseBatch補貼基次allowDate補貼日期l 數(shù)據(jù)添加格式向消費機中的表添加數(shù)據(jù)，是將記錄組

12、合成一個字符串發(fā)送到機器中的，字符串格式為：字段名=值（tab鍵）字段名=值記錄與記錄之間以換行符號連接如商品資料的一條記錄為“StoreNo=1 Name=包子Bc=464654646 Price=0.5 agio=80”，注意：字段之間是tab符號從消費機讀取的格式也相同，需要自行解析字符串，得到每條記錄每個字段的數(shù)據(jù)。2.2 卡片數(shù)據(jù)結構l 讀取卡片返回數(shù)據(jù)的組成結構數(shù)據(jù)格式采用“字段名1=值1，字段名2=值2”的形式字段名為上述余額扇區(qū)結構說明中的字段名2.3 狀態(tài)報告l 返回狀態(tài)碼及意義-1:Result := 傳入?yún)?shù)非法; -2: Result := 主、備份扇區(qū)數(shù)據(jù)不一致; 1

13、: Result := 操作失敗; 2: Result := 數(shù)據(jù)丟包; 3: Result := 沒有選擇準確的COM口; 4: Result := 和卡通訊超時; 5, 7: Result := XOR校驗出錯; $A: Result := 輸入的參數(shù)大于最大允許范圍，溢出; $80: Result := 參數(shù)設置成功; $81: Result := 參數(shù)設置失敗; $82: Result := 通訊超時; $83: Result := 卡不存在; $84: Result := 接收卡數(shù)據(jù)出錯; $85: Result := 輸入?yún)?shù)或者輸入命令格式錯誤; $87: Result := 未

14、知的錯誤; $8A: Result := 在塊初始化中出現(xiàn)錯誤; $8B: Result := 在防沖突過程中得到錯誤的序列號; $8C: Result := 密碼認證沒通過; $8F: Result := 讀寫設備接收到了未定義的命令; $90: Result := 卡不支持這個命令; $91: Result := 命令格式有錯誤; $92: Result := 在命令的FLAG參數(shù)中, 不支持OPTION模式; $93: Result := 要操作的BLOCK不存在; $94: Result := 要操作的對象已經(jīng)別鎖定, 不能進行修改; $95: Result := 鎖定操作不成功; $

15、96: Result := 寫操作不成功;l 用途獲得接口函數(shù)執(zhí)行結果狀態(tài)描述內容（適用與卡操作函數(shù)）3SDK開發(fā)函數(shù)說明3.1 消費機器sdk開發(fā)函數(shù)詳細參閱dataapi接口使用指南3.2 卡操作sdk卡發(fā)函數(shù)l 1ZK_PosClearICCard【功能】對卡進行初始化，清除卡片數(shù)據(jù)，將扇區(qū)字節(jié)寫為0X 00【需要參數(shù)說明】commHandle: int：無符號整型，發(fā)卡器端口資源句柄，默認為0key: string：卡密碼。mainsec：整型，115，主扇區(qū)號，每個扇區(qū)的三個塊backsec：整型，115，備份扇區(qū)號，每個扇區(qū)的三個塊【返回值】=0：初始化成功0：其它見l 2ZK_P

16、osIssueICCard【功能】對卡寫數(shù)據(jù)，發(fā)放卡片【需要參數(shù)說明】commHandle：整型，發(fā)卡器設備句柄key：卡密碼overPwd：整型，六位數(shù)字，超額密碼Cardno：整型，1999999999，卡號money：整型，初始金額，1999900，cardtype：整型，199，卡片類別號batchNo：整型，卡片版本號miansec：整型，115，主扇區(qū)號backsec：整型，115，備份扇區(qū)號【返回值】 =0：發(fā)卡成功0：其它見l 3ZK_PosReadICCard【功能】讀取卡片數(shù)據(jù)，數(shù)據(jù)包括卡號，余額等信息【參數(shù)說明】commHandle：整型，發(fā)卡器設備句柄，0key：卡密碼

17、miansec：整型，115，主扇區(qū)號backsec：整型，115，備份扇區(qū)號Data：字符串，返回讀取的數(shù)據(jù)，數(shù)據(jù)格式采用“字段名1=值1，字段名2=值2”的形式 【返回值】返回字符串”字段名1=值,字段名1=值”，可以判斷字符串是否包含或字符串長度，不包含則失敗，其它見l 4ZK_PosWriteICCardMoney【功能】對卡片寫入金額充值，主扇區(qū)和備份扇區(qū)的 第二和第三塊需要寫成相同的數(shù)據(jù)?！緟?shù)說明】commHandle：無符號整型，發(fā)卡器設備句柄key：卡密碼 Money：整型，1999900，寫入金額mainsect：整型。115，存儲數(shù)據(jù)的主扇區(qū)號backsec：整型，115

18、，備份扇區(qū)號【返回值】 =0：充值成功 1：其它見l 5ZK_PosWriteICCardPassWord【功能】修改卡密碼【參數(shù)說明】commHandle：整型，發(fā)卡器設備句柄oldkey：六位數(shù)字字符串，原卡密碼newkey：六位數(shù)字字符串，新密碼mainsect：整型。115，存儲數(shù)據(jù)的主扇區(qū)號backsec：整型，115，備份扇區(qū)號【返回值】 =0：成功 1：其它見l 6ZK_PosUpdateParam【功能】修改卡片參數(shù)，可以修改卡片超額密碼、發(fā)卡日期、卡類【參數(shù)說明】commHandle：無符號整型，發(fā)卡器設備句柄key：卡密碼overPwd: 整型，新超額密碼issueDate:字符串，新發(fā)卡日期，如：2011-10-08cardType：整型，new卡類mainSec: intbackSec: int【返回值】 =0：成功 1：失敗，其它見l 7ZK_PosReadCardSerial【功能】讀取卡片序列號【參數(shù)說明】commHandle：整型，發(fā)卡器設備句柄【返回值】字符串，正常為卡號可以通過判斷字符串長度大于4，其它見4開發(fā)建議l 準備工作合作伙伴必須通過中控科技或是中控科技代理商，取得SDK開發(fā)包和相關文檔，及相關技術支持。 l 開發(fā)建議 獲取