ZT598控件接口规范(开发文档).docVIP

ZT598控件接口规范 部门 研发一部 文档用途 ZT598控件开发说明文档 主题词 文档编号 TP_ZT598_01 文档版本号 V1.0 文档日期 2008/05/22 最后更改日期 2008/05/22 文档作者 项目负责人 彭红燕 审核人 彭红燕 项目名称  ZT598控件接口规范 1 1. 控件使用说明 3 1.1 普通键盘工作模式 4 1.2 客户密码录入模式（密码键盘模式） 4 1.3 加密器工作模式 4 1.4 密钥下载模式 4 1.5 设置和取得ZT598的参数 5 1.6 附加功能 5 2. 控件接口规范 5 2.1 控件接口方法说明 5 2.1.1 打开串口 5 2.1.2 关闭串口 5 2.1.3 发送开关键盘和按键声音 6 2.1.4 启动密文输入 7 2.1.5 在关闭密文输入 7 2.1.6 启动明文输入 8 2.1.7 关闭明文输入 8 2.1.8 取键盘中密码密文 8 2.1.9 下装主密钥 9 2.1.10 下装工作密钥 10 2.1.11 激活工作密钥 10 2.1.12 密码键盘复位自检 11 2.1.13 CalcMacData 11 2.1.14 数据加密 12 2.1.15 数据解密 12 2.1.16 取得设备版本信息 13 2.1.17 设置或读取设备终端号 13 2.1.18 设置IC类型 14 2.1.19 读取IC类型 14 2.1.20 IC卡上电 14 2.1.21 IC控制 15 2.1.22 IC下电 15 2.1.23 下装卡号 15 2.2 控件接口事件说明 16 2.2.1 按一次键所取得的键值 16 2.2.2 密码输入完毕后激活此事件 16 3. 返回值表： 17 这份是提供给上层开发的文档 控件使用说明 本金属键盘有四种工作状态：一种是当作普通键盘使用，一种是当作密码键盘使用，还有一种是当作加密器使用，最后一种是密钥的下载和管理。在密码键盘上按键的键值都是以消息形式通知上层程序，方便业务程序的编写。几种工作状态调用步骤如下： 普通键盘工作模式 该模式无需密钥管理。 进入普通键盘模式：ZTEPPEnableKeyPress (); 重复等待事件通知：KeyInputPress (short keycode)，取得按键键值keycode 关闭键盘：ZTEPPDisableKeyPress() 注意：在明文键盘工作模式下，如果需要做其他如下载密钥等操作，则必须先确保ZTEPPDisableKeyPress()成功。 客户密码录入模式（密码键盘模式） 首先，键盘若使用加密键盘模式，是键盘中已经下载了主密钥（和工作密钥），如果是用工作密钥加密必须知道该工作密钥是通过哪一个主密钥（masterkey）保护的。所以，加密模式下需要masterkey和workkey两个参数。 进入密码键盘模式：ZTEPPEnablePinPress (); 重复等待事件通知：KeyInputPress (short keycode)，取得按键键值keycode，此刻的每个密码按键会变成“*”号。 等待PinPadComplete事件：该事件通知上层程序用户已输入完密码，此刻业务程序可以调用ZTEPPOCXPinReadPin（）取得用户输入密码的密文。 激活工作密钥：ZTEPPOCXActiveWorkKey () ZTEPPOCXPinReadPin（）：取得用户输入密码密文。 注意：如果PinPadComplete事件是取消输入和输入超时事件则不能再取密文。另外如果键盘还在密码输入模式下要做其他操作，则需要ZTEPPDisablePinPress ( )来取消输入后再做其他操作。 加密器工作模式 本加密器提供标准DES加密算法，可对数据进行加密。在加密运算前，必须指定用哪一个工作密钥，并且要知道该工作密钥是用哪一个主密钥保护的。 激活工作密钥：ZTEPPOCXActiveWorkKey () 数据加密：ZTEPPOCXPinAdd (); 数据解密：ZTEPPOCXPinUnAdd () 或ZTEPPOCXPinCalMAC（）； 密钥下载模式 本加密器提供16个主密钥，每个主密钥又对应4个工作密钥，具有完善的密钥下载功能。 下载主密钥：ZTEPPOCXLoadMasterKey（）； 下载工作密钥：ZTEPPOCXLoadWorkKey（）； 注意：所有的键盘操作必须要在串口打开的情况下操作应用退出时需关闭串口。 设置和取得ZT598的参数 设置或读取终端号：ZTEPPOCXTerminalNum () 取得设备版本信息：ZTEPPOCXReadVersion () 设置加密参数：ZTEPPOCXSetDesPara () 设置键盘参