myvtm/DevAdapter/include/CardIssuerClass.h

/////////////////////////////////////////////////////////////////////////////////
///	Copyright (c) 2012 China Merchants Bank, all rights reserved	       	  ///
///	  Adapter Interface for Card Issuer.                          	       	  ///
///	                                                             	       	  ///
///	                                                             	       	  ///
/////////////////////////////////////////////////////////////////////////////////
#ifndef __CARD_ISSUER_CLASS_H
#define __CARD_ISSUER_CLASS_H
#pragma once
#include "DeviceBaseClass.h"
#include "CardMix.h"

//retain bin and issue hopper state
struct CardIssuerStatus 
{ 
	CardStatusEnum eMedia;	//state about card
	RtBinStatusEnum eRetainBin;
	DWORD dwRetainCount;	//回收箱容量
	IssHopperStatusEnum eIssuerBin[3];//0,1,2 => hopper 1,2,3 需要对1,2,3三个卡箱进行对应赋值
	DWORD dwIssuerCount[3];	//发卡箱容量，0,1,2 => 1,2,3
};
struct SAMStatus
{
	int isActive;//0:Inactive; 1:acitve
	int chosenOfSAM;//the selected sam number:1,2,...
};
const int MAX_WORKING_KEY_SIZE = 64;
const int MAX_CHECK_CODE_SIZE = 16;
const int MAX_TEMP_DATA_SIZE = 64;

//SCI:SplitCardIssuer
struct SCIKeyInfo
{
	BYTE key[MAX_WORKING_KEY_SIZE];
	DWORD dwSize;
};
struct SCICheckCode
{
	BYTE code[MAX_CHECK_CODE_SIZE];
	DWORD dwSize;
};
struct SCITempData
{
	BYTE data[MAX_TEMP_DATA_SIZE];
	DWORD dwSize;
};
enum SCIParamType
{
	ParamBeep,
	ParamLed,
	ParamLevelTime,
};
enum SCILightType
{
	SCILight_EjectCard,
	SCILight_CMBLogo,
};
enum SCIBluetoothCMD
{
	SCIBluetooth_Open,	//打开蓝牙
	SCIBluetooth_Close,	//关闭蓝牙
	SCIBluetooth_Hide,	//隐藏蓝牙信号
	SCIBluetooth_Show,	//显示蓝牙信号
};

class CardIssuerClass : public DeviceBaseClass
{
public:
	//
	//	本接口几乎废弃不用。连接卡机，请使用DevOpenEx替代本接口
	//	Connect to device and do initialization.
	//	In case of power off or initialization,if the card is held in CardIssuer,move card
	//	to Mag read/write position or doing nothing.
	//	Retract counter will work.
	//	Make preparations for controlling the device.
	//	Arguments:
	//	- dwPort[in]		com port number
	//	- dwBaudRate[in]	Baud rate
	//
	virtual ErrorCodeEnum DevOpen(DWORD dwPort,DWORD dwBaudRate) = 0;
	//
	//	Get card issuer status
	//
	virtual ErrorCodeEnum GetDevStatus(CardIssuerStatus &devStatus) = 0;
	//
	//	Get device serial number.
	//	设备唯一标识，且需贴在设备外壳上
	virtual ErrorCodeEnum GetDeviceSN(char *&pDevSN) = 0;
	//
	//	Move card to specified position.
	//	hopperNo:多卡箱发卡时指定发卡箱号（面对发卡机，从左往右依次是1,2,3，...号卡箱）
	//		卡库：卡片从卡库移动到读卡器，eCardPos为CI_MOVECARD_FROM_HOPPER，hopperNo固定传入99
	//
	virtual ErrorCodeEnum MoveCard(CardPosEnum eCardPos, int hopperNo = 1) = 0;
	//
	//	Set card entry
	//
	virtual ErrorCodeEnum SetCardInType(CardInEnum eCardIn) = 0;

	//
	//	Read data from magnetic track.
	//
	virtual ErrorCodeEnum MagRead(MagTracks &magTracks) = 0;
	//
	//	Write data to magnetic track.
	//
	virtual ErrorCodeEnum MagWrite(MagTracks magTracks,MagWriteModeEnum eWriteMode) = 0;
	//
	//	Set retract counter
	//
	virtual ErrorCodeEnum SetRetractCounter(DWORD dwCount) = 0;
	//
	//	Set issuer counter
	//	hopperNo:多卡箱发卡时指定发卡箱号（面对发卡机，从左往右依次是1,2,3，...号卡箱）
	//
	virtual ErrorCodeEnum SetIssuerCounter(DWORD dwCount,int hopperNo=1) = 0;
	//
	//	Active contact IC card
	//
	virtual ErrorCodeEnum ActiveICCard() = 0;
	//
	//	Move IC card to contact position
	//
	virtual ErrorCodeEnum ContactIC() = 0;
	//
	//	Release IC contact
	//
	virtual ErrorCodeEnum ReleaseIC() = 0;
	//
	//	Warm reset card(IC)
	//
	virtual ErrorCodeEnum WarmReset() = 0;
	//
	//	APDU:Application Protocol Data Unit
	//	CmdSend.lpCmd：Command-APDU
	//	CmdRecv.lpData：Response-APDU
	//
	virtual ErrorCodeEnum ICCommand(CmdInfo sendBuf,CmdInfo &recvBuf) = 0;
	//////////////////SAM 卡操作部分////////////////////
	virtual ErrorCodeEnum SAMActive(BYTE vcc=0x30){ return Error_NotImpl; };
	virtual ErrorCodeEnum SAMDeactivate(){ return Error_NotImpl; };
	virtual ErrorCodeEnum SAMWarmReset(){ return Error_NotImpl; };
	virtual ErrorCodeEnum SAMCommand(CmdInfo sendBuf, CmdInfo &recvBuf){ return Error_NotImpl; };
	virtual ErrorCodeEnum SAMQueryStatus(SAMStatus &samStatus){ return Error_NotImpl; };
	virtual ErrorCodeEnum SAMSelect(const int sn){ return Error_NotImpl; };
	virtual ErrorCodeEnum ActiveICCardATR(CmdInfo &atrBuf){return Error_NotImpl;}
	////////////////卡面打印部分（非即时制卡的卡面印刷，即时制卡的卡面打印接口为PrintCardFaceRightNow），部分机型(例如合肥分行大机)有此功能//////////////////
	virtual ErrorCodeEnum Print(BYTE *&data, const int dataSize,const int side){ return Error_NotImpl; };
	virtual ErrorCodeEnum QueryPrinterStatus(){ return Error_NotImpl;};
	
	////////////////////////////////////////////////////////////////////////////
	////////非接(IC)部分 start，没有此部分，在接口实现中直接返回Error_NotImpl///////////////
	////////////////////////////////////////////////////////////////////////////
	//	Active contactless IC card(Type A,B,Mifare)
	//	The first,second,third activation order decided by fstType,scdType,thdType respectively
	//	fstType,scdType,thdType can be one of 'A','B','M','0'(30H,no type)
	//	outType indicates the type of  activation result
	//
	virtual ErrorCodeEnum ActiveContactlessICCard(char fstType, char scdType, char thdType, char &outType) = 0;
	//
	//	Deactivate contact IC card
	//
	virtual ErrorCodeEnum DeactivateICCard() = 0;
	//
	//	Deactivate contactless IC card
	//
	virtual ErrorCodeEnum DeactContactlessICCard() = 0;
	//
	//	RF Mifare Classic protocol operation
	//	Arguments:
	//	- eFunType:function type as load key,authentication and so on
	//	- sendBuf:[parameter][data]
	//	- recvBuf:[status(1byte)][return data]
	//
	virtual ErrorCodeEnum MifareCommand(MifareFuctionEnum eFunType, CmdInfo sendBuf, CmdInfo &recvBuf) = 0;
	//
	//	RF Type A,B command.
	//	APDU:Application Protocol Data Unit
	//	Arguments:
	// 	- CmdSend.lpCmd:Command-APDU
	// 	- CmdRecv.lpData:Response-APDU
	//
	virtual ErrorCodeEnum RFTypeABCommand(CmdInfo sendBuf, CmdInfo &recvBuf) = 0;
	////////非接(IC)部分 end/////////////////////////////////////////////////////////

	//	发卡机调用打开设备
	//	1. btOpenType:设定通过哪种方式连接设备，由DevOpenType的枚举值组合。usb及蓝牙设备连接可忽略dwPort，dwBaudRate
	//	2.通过pDevSN来指定连接对应设备号的蓝牙发卡机（考虑存在多台发卡机的情况）
	//		例如通过蓝牙或者usb连接设备，则btOpenType = (DEV_OPEN_TYPE_USB|DEV_OPEN_TYPE_BLUETOOTH)
	//	3. btType返回设备实际通过哪种方式相连，返回值参考DevOpenType
	//	4.对于大机（柜式可视柜台）dwPort,dwBaudRate传入端口，波特率，btOpenType为DEV_OPEN_TYPE_COM，pDevSN为""
	//		,btType返回值表示卡槽数量（例如目前存在单卡槽1,双卡槽2，三卡槽3的机型）
	//	
	virtual ErrorCodeEnum DevOpenEx(DWORD dwPort, DWORD dwBaudRate, BYTE btOpenType,const char *pDevSN, BYTE &btType) = 0;

	/////////////////////////////////////////////////////////////////////////
	///以下是便携式卡机特有API，接口实现中其他机型直接返回Error_NotImpl即可//
	/////////////////////////////////////////////////////////////////////////

	//	返回值Error_Succeed表示成功，其他值表示失败
	//	iStatus   0:成功   -1:银行公钥不存在   -2:产生设备密钥故障  -x:其他厂商自定义故障
	//	Cr1：随机数r1的密文； Cr3：随机数r3的密文，dKey：用银行公钥加密的设备公钥密文
	//	r1，r3第16字节为数据完整性校验字节，例如r1为B1B2...B15B16,则B16=B1^B2^...^B15
	virtual ErrorCodeEnum TransferEnInit(int &iStatus, BYTE *&Cr1, int &lenR1, BYTE *&Cr3, int &lenR3, BYTE *&dKey, int &lenKey) = 0;

	//	返回值Error_Succeed表示成功，其他值表示失败
	//	iStatus   0:成功   -x:厂商自定义故障
	//	r2第16字节为数据完整性校验字节，例如r2为B1B2...B15B16,则B16=B1^B2^...^B15
	virtual ErrorCodeEnum SetR2(int &iStatus, BYTE *pCr2, int lenR2) = 0;
	//
	//	设置会话密钥
	//	pWorkingKey:会话密钥，传递16进制的字符形式，例如0x123456FFAB  --> "123456FFAB"
	virtual ErrorCodeEnum SendWorkingKey(const char *pWorkingKey) = 0;

	//安全锁接口部分 begin
	virtual ErrorCodeEnum SLLoadKey(const SCIKeyInfo key) = 0;
	//case ParamBeep: value:0,close beep;value:1,open beep
	//case ParamLed: value:0,close led;value:1,open led
	//case ParamLevelTime: value:the duration of level,100ms per unit
	//		ex.	the value 10 means duration time is 1 second
	virtual ErrorCodeEnum SLSetParam(SCIParamType eType, int value) = 0;
	virtual ErrorCodeEnum SLLock() = 0;
	virtual ErrorCodeEnum SLUnLock(const SCICheckCode checkCode, bool bTemp = true) = 0;
	virtual ErrorCodeEnum SLGetTempData(SCITempData &ksnData, SCITempData &ramData) = 0;
	virtual ErrorCodeEnum SLOpenDoor(const SCITempData data) = 0;
	//安全锁接口部分 end

	//蓝牙控制部分 start
	//蓝牙指令控制，命令参看SCIBluetoothCMD说明
	virtual ErrorCodeEnum BluetoothControl(SCIBluetoothCMD eCmd) = 0;
	//修改配对密码
	virtual ErrorCodeEnum BluetoothModifyKey(unsigned char *key) = 0;
	//修改蓝牙设备名称
	virtual ErrorCodeEnum BluetoothModifyName(unsigned char *name) = 0;
	//获取版本信息
	virtual ErrorCodeEnum BluetoothGetVersion(char *&version) = 0;
	//获取连接设备名称
	virtual ErrorCodeEnum BluetoothGetConnectName(unsigned char *&name) = 0;
	//获取连接设备信号强度
	virtual ErrorCodeEnum BluetoothGetSignalStrength(unsigned char *&signal) = 0;
	//蓝牙控制部分 end
	
	//控制灯光
	//eLight：所控制的灯 ；
	//bOnOff：true 亮灯；fasle 灭灯
	virtual ErrorCodeEnum LightControl(SCILightType eLight, bool bOnOff) = 0;
	//以百分比数值返回剩余电量（1-100），例如剩余51%，则bat赋值为51
	virtual ErrorCodeEnum QueryBatteryPower(int &bat) = 0;
	//oiltest
	//virtual ErrorCodeEnum EncryptData(TempData ramData, TempData bdk, TempData curksn, TempData &encryptedData) = 0;
	//把卡片从读卡器移动到指定卡槽位
	virtual ErrorCodeEnum MoveCardToSlot(int slot){return Error_NotImpl;}
	//把卡片从指定卡槽位移动到读卡器
	virtual ErrorCodeEnum MoveCardFromSlot(int slot){return Error_NotImpl;}
	//读取卡号
	//优先从IC卡解析卡号，如果纯磁条卡，则返回磁道解析的卡号
	virtual ErrorCodeEnum ReadAccount(CardNo &cardNo){return Error_NotImpl;}
	//获取总卡槽数
	virtual ErrorCodeEnum GetSlotSum(int &sum){return Error_NotImpl;}
	//获取卡槽状态
	virtual ErrorCodeEnum QuerySlotsStatus(SlotStatus &slots,const int slot,bool bFull=false){return Error_NotImpl;}
};

#endif //__CARD_ISSUER_CLASS_H