TYRM3000动态库接口函数说明文档.doc

TYRM3000动态库接口函数说明文档1. 主要接口函数PortOpen (PBYTE pszPort, PBYTE pszBuildCommDCB);PortClose(void);SendData (char ch1,char ch2, PBYTE pszReadData, int nReadLen);CPUPowerOnOrDown (char ch1,char ch2, char mid ,PBYTE pszReadData, int nReadLen);CPUSendAPDU (char ch1,char ch2, char mid, PBYTE pszSendData ,int nSendLen ,PBYTE pszReadData, int nReadLen);2. 函数说明2.1 PortOpen(PBYTE pszPort, PBYTE pszBuildCommDCB)类 型: bool;返 回 值:True-成功,False-失败;函数描述： 根据参数打开指定串口；参数定义：pszPort 串口号，如”COM1”；pszBuildCommDCB 串口设置参数, 如”COM1:9600,n,8,1”；2.2 PortClose(void) 类 型: bool，返 回 值:True-成功,False-失败;函数描述：关闭串口，必须在调用函数PortOpen之后才能调用； 参数定义：无； 2.3 SendData (char ch1,char ch2, PBYTE pszReadData, int nReadLen)类 型: int;返 回 值： 1-收发正确 2-发送错误 3-接收错误 4-接收数据错误; 函数描述：发送功能指令；参数定义:ch1 - 命令标识1，如41(参照附指令代码) ch2 - 命令标识2, 如52(参照附指令代码) 注：如下发查询指令，功能码为”c”A”,则ch1=99(“c”的ASCII码) Ch2=65(“A”的ASCII码) pszReadData -接收数据缓冲区 nReadLen - 接收数据缓冲区大小.2.4 DLL_EXP int PASCAL CPUPowerOnOrDown (char ch1,char ch2, char mid ,PBYTE pszReadData, int nReadLen);类 型: int;返 回 值： 1-收发正确 2-发送错误 3-接收错误 4-接收数据错误; 函数描述：CPU卡上电和下电发送指令；参数定义:ch1 - 命令标识1，如41(参照附指令代码) ch2 - 命令标识2, 如52(参照附指令代码) 注：如下发查询指令，功能码为”c”A”,则ch1=99(“c”的ASCII码) Ch2=65(“A”的ASCII码) mid -卡机编号,一般默认为0,即mid=0 pszReadData -接收数据缓冲区nReadLen - 接收数据缓冲区大小示例了：根据TYRM-3000协议说明书中可知，CPU卡上电指令为hB，卡机编号为0,则上电指令下:缓冲区pszReadData1024接收返回数据nReadLen=300CPUPowerOnOrDown (h,B, 0 ,pszReadData0, 300);2.5 DLL_EXP int PASCAL CPUSendAPDU (char ch1,char ch2, char mid, PBYTE pszSendData ,int nSendLen ,PBYTE pszReadData, int nReadLen);类 型: int;返 回 值： 1-收发正确 2-发送错误 3-接收错误 4-接收数据错误; 函数描述：发送APDU指令函数；参数定义:ch1 - 命令标识1，如41(参照附指令代码) ch2 - 命令标识2, 如52(参照附指令代码) 注：如下发查询指令，功能码为”c”A”,则ch1=99(“c”的ASCII码) Ch2=65(“A”的ASCII码) mid -卡机编号,一般默认为0,即mid=0 pszSendData -发送的APDU指令缓冲区 nSendLen -发送缓冲区中数据长度 pszReadData -接收数据缓冲区 nReadLen - 接收数据缓冲区大小 示例:根据TYRM-3000协议说明书中可知，CPU卡发送APDU指令为hC，卡机编号为0,pszSendData=A0 A4 00 00 02 2F E2没发送长度nSendLen=7缓冲区pszReadData1024接收返回数据nReadLen=300CPUSendAPDU (h,C, 0 ,pszSendData0,7,pszReadData0, 300);附指令代码: 详细请参考协议说明书，以下只是协议说明书中的一部分(动态库支持部分)命令参数及其意义应答内容及其意义进卡/出卡 0x60Pd= A(0x41) ：读状态；= B (0x42) ：进卡到离开2号光耦,出卡到离开2号光耦(进卡后前退卡)= C (0x43)：进卡到离开2号光耦，出卡到离开2号光耦，再进到离开2号光耦；(进卡后前持卡)=D (0x44)：进卡到2号光耦=E (0x45)：进卡到3号光耦=F (0x46)：进卡到离开门槛=G (0x47)：进卡到4号光耦=H (0x48)：进卡到离开1号光耦=I (0x49)：进卡到5号光耦=J (0x4A)：进卡到离开2号光耦=K (0x4B)：进卡到离开3号光耦=L (0x4C)：进卡到离开4号光耦=M (0x4D)：进卡到离开5号光耦=N (0x4E)：出卡到4号光耦=O (0x4F)：出卡到3号光耦=P (0x50)：出卡到2号光耦=Q (0x51)：出卡到离开5号光耦=R (0x52)：出卡到1号光耦=S (0x53)：出卡到离开4号光耦=T (0x54)：出卡到门槛=U (0x55)：出卡到离开3号光耦=V (0x56)：出卡到离开2号光耦=W (0x57)：出卡到离开2号光耦，再进到2号光耦(前持卡)=X (0x58)：出卡到离开2号光耦，再进到离开2号光耦(往复)=Y (0x59)：出卡到离开3号光耦,再进卡到5号光耦(走位到接触式IC卡位置)P1：电源电压；P2：光耦状态；P3：1磁道状态；P4：2磁道状态；P5：3磁道状态；P6：Mifare1状态；P7：IC卡状态；P8：SAM卡状态；P9：版本号；*光耦状态字：BIT7：IC卡电磁铁状态；BIT6：门头电磁铁状态；BIT5：门头开关状态；BIT4：5号光耦状态；BIT3：4号光耦状态；BIT2：3号光耦状态；BIT1：2号光耦状态；BIT0：1号光耦状态；停卡模式设置.0x2EPs=0：进卡后前退卡；=1：进卡后前持卡；=2：进卡后卡停止；=3：进卡后停在IC卡读卡位置；=4：进卡后后持卡；=5：进卡后后退卡。读写地址a0x61Pb=A：写地址；d0：待写的设备地址号(09)；=B：读“设备地址”、“进卡模式”和“停卡模式”P1：设备地址(09)；P2：进卡模式(AG)；P3：停卡模式(05)；复位b0x62Pr复位卡机，返回卡机的状态信息：=A：机内卡不动作；=B：回收机内卡；=C：退出机内卡；查状态c0x63A查右侧所述各状态P1：电源电压；P2：光耦状态；P3：1磁道状态；P4：2磁道状态；P5：3磁道状态；P6：Mifare1状态；P7：进卡模式；P8：停卡模式；P9：版本号；卡操作d0x64Pc=A：前退卡；=B：前持卡；=C：后退卡；=D：后持卡；=E：取消前一次进卡命令；=F：禁止进卡；设置进卡模式e0x65Pi=A：检测到“门头开关”直接进卡；=B：检测到“门头开关磁信号”直接进卡；=C：接收到命令后，检测到“门头开关”进卡；=D：接收到命令后，检测到“门头开关磁信号”进卡；=E：禁止进卡；=F：检测到“磁信号”直接进卡；=G： 接收到命令后，检测到“磁信号”进卡；磁卡命令f0x66Pm=A：卡进卡到读卡位置；=B：卡进卡到读卡位置，如果读失败，则往复一次重读；=C：往复一次重读；D：清磁道数据；=E：读1、2、3磁道数据； F：读1磁道数据；G：读2磁道数据；H：读3磁道数据；I：读1、2磁道数据；J：读2、3磁道数据；K：读1、3磁道数据；=L：读1、2、3磁道数据，并清除数据；P1：1磁道状态；P2：2磁道状态；P3：3磁道状态；*磁卡的磁道状态： 0：没有错误；1 ：读到正确数据；2 ：前导码错误；3 ：尾随码错误；4 ：LRC错误；5：奇校验错误；6：空磁道错误；CPU卡h0x68Pi=A：IC卡进卡到读卡位置；=B：CPU卡上电(d0：卡座编号)=C：CPU卡下电(d0：卡座编号)；=D：发送命令给CPU卡(d0：卡座编号：d1