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

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 P ortClose(void)
类型: bool，
返回值:
True--成功,
False--失败;
函数描述：关闭串口，必须在调用函数PortOpen之后才能调用；
参数定义：无；
2.3 S endData (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,则上电指令下:
缓冲区pszReadData[1024]
接收返回数据nReadLen=300
CPUPowerOnOrDown ('h','B', '0' ,pszReadData[0], 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
缓冲区pszReadData[1024]
接收返回数据nReadLen=300
CPUSendAPDU ('h','C', '0' ,pszSendData[0],7,pszReadData[0], 300); 附指令代码:。