liuye / etradeclient · Files

#include "stdafx.h"

#include <windows.h>

#include "etradeclient/hardware/dili_card_device.h"

#include <exception>
#include <sstream>
#include <iomanip> // hex conversion.
#include <intrin.h> // Endian conversion.

#include "etradeclient/utility/string_converter.h"
#include "ETradeClient/hardware/DLCardManager.h"

template <typename T>
std::string DecToHex(T d, bool show_base = false)
{
	std::stringstream ss;
	if (show_base)
		ss << "0x";
	ss << std::setfill('0') << std::setw(sizeof(T) * 2) << std::hex << static_cast<int>(d);
	return ss.str();
}

/*
Note:
All data are stored in the card in binary format.
However, the data will be converted into hexadecimal character format when we read it via the card reader API.
In binary format, one character's length is 1 byte, 
and 1 character can be represented using HEX format which needs 2 characters(thus the length becomes 2).
For example, decimal:255 ---> binary:1111 1111 (length: 1 byte)---> hexadecimal: 0xFF (length: 2 bytes---'F''F').
This is the reason why the length of data read from card are always 2 times of the length of it's inner storage format(binary).
*/

namespace DILICard
{
	// 注意：卡面号数值的后5位即为卡类型标记范围。
	struct CardTypeCfg
	{
		std::string code;
		uint32_t mark_num_min; // 卡类型标记范围最小值
		uint32_t mark_num_max; // 卡类型标记范围最大值
	};

	// 注意：前期制卡过程中将第一批卡的发卡机构编码为8000，以后所有的卡的发卡机构编码均为8888。
	static const std::string CARD_ISSUER_CODE_HAERBIN_HADA_BATCH1 = "8000"; // TODO Config file.
	static const std::string CARD_ISSUER_CODE_HAERBIN_HADA = "8888"; // 哈尔滨哈达市场. TODO Config file.

	// 卡片硬件标识默认值为“FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF”，需要在激活时写入正确值（通过读卡函数“FindCard”获得）。
	// 撤销激活后重置为默认值。
	static const std::string DEFAULT_CARD_DEVICE_ID = "FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF";

	static const uint16_t DEFAULT_DATA_BLOCK_LEN = 512;
	static const uint16_t CARD_DATA_LEN_MAX = 4 * 1024;
	static const uint8_t WRITE_DATA_BLOCK_LEN = 32; // 数据写入单元大小.
	static const uint16_t SERVICE_INFO_DATA_HEADER_LEN = 4; // 业务文件(FID:0015)前4字节确定文件的有效长度
	static const uint16_t SERVICE_INFO_DATA_LEN_MAX = 0xFA; // 业务数据最大长度250bytes.

	// 卡基本信息文件包括：卡面号，卡片硬件标识（卡片内码, 卡序列号SN），卡片类型码，发卡机构编码，校验码。
	/*
	字节			数据元				数据格式		长度（Byte）
	1 - 6			卡面号				HEX				6
	7 - 14			卡类型编码			BCD				8
	15 - 24			发卡机构编码		BCD				10
	25 - 28			安全码编码(3位数)	BCD				4
	29 - 45			卡片内码			BCD				16
	46 - 250		RFU					HEX				206
	*/

	/*Notice: All these length are the reserved maximum length, currently some of the fields' actual length are less than it's
	reserved length. E.g. verify code's actual length is 3 while it's reserved length is 8.
	The spare characters are all filled with character 'F'.*/
	static const uint8_t CARD_CHIP_NUM_LEN = 12; // 卡面号
	static const uint8_t CARD_TYPE_CODE_LEN = 16; // 卡片类型码（卡类型编码）
	static const uint8_t CARD_ISSUER_CODE_LEN = 20; // 发卡机构编码
	static const uint8_t CARD_VERIFY_CODE_LEN = 8; // 校验码（安全码编码(3位数)）
	static const uint8_t CARD_SN_LEN = 32; // 卡片内码, 卡序列号SN

	static const char PADDING_CHAR = 'F';

	static const char* MF_FILE_DIR = "3F00";
	static const char* DF01_DIR = "DF01";

	static const char BASIC_INFO_FILE_ID = 0x5;
	static const char SERVICE_INFO_FILE_ID = 0x15;

	static const char SERVICE_INFO_KEY_ID = 0x1;
	static const char ACTIVATE_KEY_ID = 0x0;


	// 卡片默认密钥
	static const char* K_DCCK_DV = "FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF0";
	static const char* K_F0015_DACK_DV = "FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF6";
	static const char* K_F0015_DEAK_DV = "FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7";
	static const char* K_F0015_DAMK1_DV = "FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF8";

	static const char* K_F0005_DCMK1 = "FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF4";

	static const char* K_DCCK_CMD_HEAD = "18000000003300FF10";
	static const char* K_F0015_DACK_CMD_HEAD = "18000000006600FF10";
	static const char* K_F0015_DEAK_CMD_HEAD = "180D01000066002210";
	static const char* K_F0015_DAMK1_CMD_HEAD = "184801000066002210";

	RWDevice::RWDevice()
	{
	}
	RWDevice::~RWDevice()
	{
		Disconnect();
	}
	bool RWDevice::Connect() const
	{
		bool bResult = true;

		int iResult = DLCConnectDevice();
		if (0 != iResult)
		{
			bResult = false;
			throw std::exception(std::to_string(iResult).c_str());
		}

		return bResult;
	}
	void RWDevice::Disconnect() const
	{
		DLCDisconnectDevice();
	}

	bool RWDevice::FindCard() const
	{
		bool bResult = true;

		int iResult = DLCFindCard();
		if (0 != iResult)
		{
			bResult = false;
			throw std::exception(std::to_string(iResult).c_str());
		}

		return bResult;
	}

	// 卡基本信息文件包括：卡面号，卡片硬件标识（卡片内码, 卡序列号SN），卡片类型码，发卡机构编码，校验码。
	// 正常情况下，所有的卡片在出厂后，其“卡片硬件标识”、“ 卡片类型码”及“发卡机构编码”都应该已经设置好，而不需要在激活过程中再写入。
	// 因此，目前在激活中所做的写入“卡片硬件标识”、“ 卡片类型码”及“发卡机构编码”的操作应该都是为了修正和兼容以前的不规范卡片。
	// ！！！此结论需与卡商确认！！！

	// 目前卡面号，校验码为制卡时写入，后期卡片激活时不需再修改。
	// 其他需要修改的信息为：
	// 1. 卡片硬件标识默认值为“FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF”，需要在激活时写入正确值（通过读卡函数“FindCard”获得）。
	// 2. 卡片类型码默认值为“100001”，需要通过卡面号计算而得并写入。卡面号具备一定的规律性，可用来计算卡片类型码。
	// 3. 发卡机构编码默认值为“00000001”，需要通过卡面号计算而得并写入，卡面号的前4位数字代表发卡机构编码。
	// 注意：由于前期制卡过程中将部分卡片的发卡机构编码搞错，因此在激活过程中需要对发卡机构编码进行校正。
	// 第一批卡面号为8000开头的卡的发卡机构编码应该校正为8888。
	void RWDevice::ActivateCard(const std::string& card_sn, 
								const std::string& key_DCCK, 
								const std::string& key_F0015_DACK, 
								const std::string& key_F0015_DEAK,
								const std::string& key_F0015_DAMK1) const
	{
		// 注意，激活时按照一定数值范围定义卡片类型的做法是有非常大的局限性的，
		// 例如，龙虾卡最多只能制作2500张，我们估计这种做法仅仅是为了兼容前期的一些制作不规范的卡片，
		
		// 黑金.龙虾卡8888 0003 0001 - 8888 0003 2500, 卡类型编码：100001
		static const CardTypeCfg CARD_TYPE_LONGXIA = { "100001", 30001, 40000 }; // 龙虾卡

		// 铂金.蓝莓卡8888 0001 0001-8888 0001 2500, 卡类型编码：100002
		static const CardTypeCfg CARD_TYPE_LANMEI = { "100002", 10001, 12500 }; // 蓝莓卡

		// 黄金.麦穗卡8888 0002 0001-8888 0002 1000（第一批次）, 卡类型编码：100003
		static const CardTypeCfg CARD_TYPE_MAISUI_BATCH1 = { "100003", 20001, 21000 }; // 麦穗卡

		// 黄金.麦穗卡8888 0002 1001-8888 0002 3000（第二批次）, 卡类型编码：100003
		static const CardTypeCfg CARD_TYPE_MAISUI = { "100003", 21001, 29000 }; // 麦穗卡

		// 青绿.豆荚卡8888 0000 0001-8888 0000 2500, 卡类型编码：100004
		static const CardTypeCfg CARD_TYPE_DOUJIA = { "100004", 1, 10000 }; // 豆荚卡

		const char kKeyID = NULL; // No need to do authentication.
		const std::string kKey = "";

		static const uint32_t CARD_SN_DATA_OFFSET = CARD_CHIP_NUM_LEN + CARD_TYPE_CODE_LEN + CARD_ISSUER_CODE_LEN + CARD_VERIFY_CODE_LEN;

		/*
		由于我们目前允许其他园区的卡可以拿到本园区使用，因此暂时取消该限制。
		但仍要注意我们仍会将在本园区撤销激活的卡的序列号重置为默认值“FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF”。

		// 读取卡片内码号，以判断该卡是否处于未激活状态
		std::string card_sn_str = ReadCardFile(MF_FILE_DIR, BASIC_INFO_FILE_ID, CARD_SN_DATA_OFFSET, CARD_SN_LEN, kKeyID, kKey);
		if (card_sn_str.compare(DEFAULT_CARD_DEVICE_ID) != 0)
			throw std::exception("Card already activated!");
		*/

		// 读取卡面号
		static const uint32_t CHIP_NUM_DATA_OFFSET = 0;
		std::string chip_num_str = ReadCardFile(MF_FILE_DIR, BASIC_INFO_FILE_ID, CHIP_NUM_DATA_OFFSET, CARD_CHIP_NUM_LEN, kKeyID, kKey);

		/*注意：目前不确定为某一市场定制的卡是否能够拿到其他市场去使用，因此暂时不做此检查。
		// 检验卡片是否可以在当前市场使用.
		const uint32_t kIssuerCodeLen = CARD_ISSUER_CODE_HAERBIN_HADA.size(); // 卡面号前4位数字即为发卡机构编码.
		std::string issuer_code_of_chip_num = chip_num_str.substr(0, kIssuerCodeLen);
		if (!(issuer_code_of_chip_num.compare(CARD_ISSUER_CODE_HAERBIN_HADA) == 0 ||
			issuer_code_of_chip_num.compare(CARD_ISSUER_ CODE_HAERBIN_HADA_BATCH1) == 0))
			throw std::exception("This card belongs to other market, it cannot be used in this market!");
		*/

		// 设置密码
		//九方元通的卡，damk的秘钥标示为0
		std::string sCardType = chip_num_str.substr(4, 1);
		if (sCardType == "1")
		{
			SetPassword(DF01_DIR, 0, K_F0015_DACK_DV, key_F0015_DAMK1.c_str(), KT_DAMK);
			SetPassword(MF_FILE_DIR, 0, K_DCCK_DV, key_F0015_DAMK1.c_str(), KT_DAMK);
		}
		else
		{
			SetPassword(DF01_DIR, 1, K_F0015_DACK_DV, key_F0015_DAMK1.c_str(), KT_DAMK);
			SetPassword(MF_FILE_DIR, 1, K_DCCK_DV, key_F0015_DAMK1.c_str(), KT_DAMK);
		}
		//
		SetPassword(DF01_DIR, 1, K_F0015_DACK_DV, key_F0015_DEAK.c_str(), KT_DEAK);
		SetPassword(DF01_DIR, 0, K_F0015_DACK_DV, key_F0015_DACK.c_str(), KT_DCCK);
		SetPassword(MF_FILE_DIR, 0, K_DCCK_DV, key_DCCK.c_str(), KT_DCCK);

		// 写卡片硬件标识（卡片内码, 卡序列号SN）
		// 注意这里offset计算不需要进行“/2”转换，因为这个API层面操作的都是HEX字符串格式，在“WriteCardFile”内部会自动进行“/2”转换。
		WriteCardFile(MF_FILE_DIR, BASIC_INFO_FILE_ID, CARD_SN_DATA_OFFSET, ACTIVATE_KEY_ID, key_F0015_DAMK1.c_str(), card_sn);
		
		// 读发卡机构
		uint8_t issuer_code_len = CARD_ISSUER_CODE_HAERBIN_HADA.size();
		// 注意这里offset计算不需要进行“/2”转换，因为这个API层面操作的都是HEX字符串格式，在“WriteCardFile”内部会自动进行“/2”转换。
		static const uint32_t ISSUER_CODE_DATA_OFFSET = CARD_CHIP_NUM_LEN + CARD_TYPE_CODE_LEN;
		std::string issuer_code_by_read = ReadCardFile(MF_FILE_DIR, BASIC_INFO_FILE_ID, ISSUER_CODE_DATA_OFFSET, CARD_ISSUER_CODE_LEN, kKeyID, kKey);
		issuer_code_by_read = issuer_code_by_read.substr(0, issuer_code_len);
		bool is_issuer_code_by_read_valid = issuer_code_by_read.compare(CARD_ISSUER_CODE_HAERBIN_HADA) == 0; // 读到的发卡机构编码前4为"8888".

		std::string issuer_code_of_chip_num = chip_num_str.substr(0, issuer_code_len);
		bool is_issuer_code_of_chip_num_valid = issuer_code_of_chip_num.compare(CARD_ISSUER_CODE_HAERBIN_HADA) == 0 ||
			issuer_code_of_chip_num.compare(CARD_ISSUER_CODE_HAERBIN_HADA_BATCH1) == 0; // 卡面号前4位为"8000"或者"8888"。
		
		if (is_issuer_code_of_chip_num_valid && !is_issuer_code_by_read_valid) //根据需要重写发卡机构编码
		{
			std::string issuer_code = CARD_ISSUER_CODE_HAERBIN_HADA + std::string(CARD_ISSUER_CODE_LEN - CARD_ISSUER_CODE_HAERBIN_HADA.size(), PADDING_CHAR);
			WriteCardFile(MF_FILE_DIR, BASIC_INFO_FILE_ID, ISSUER_CODE_DATA_OFFSET, ACTIVATE_KEY_ID, K_F0005_DCMK1, issuer_code);
		}

		// 写卡片类型码
		// 检查卡面号中前4位数字已确定是否需要重新写入卡类型编码，并根据卡面号中后5位数字确定卡片类型.
		std::string card_type_str(CARD_TYPE_CODE_LEN, PADDING_CHAR);
		static const uint8_t MARK_NUM_LEN = 5;
		uint32_t mark_num = std::atoi(chip_num_str.substr(CARD_CHIP_NUM_LEN - MARK_NUM_LEN, MARK_NUM_LEN).c_str());

		bool need_write_code_type = false;
		if (issuer_code_of_chip_num.compare(CARD_ISSUER_CODE_HAERBIN_HADA_BATCH1) == 0) // 针对卡面号前4位为“8000”的第一批次卡
		{
			if (mark_num >= CARD_TYPE_MAISUI_BATCH1.mark_num_min && mark_num <= CARD_TYPE_MAISUI_BATCH1.mark_num_max)
			{
				card_type_str.replace(0, CARD_TYPE_MAISUI_BATCH1.code.size(), CARD_TYPE_MAISUI_BATCH1.code);
				need_write_code_type = true;
			}
		}
		else if (issuer_code_of_chip_num.compare(CARD_ISSUER_CODE_HAERBIN_HADA) == 0) // 针对以后批次的卡面号前4位为“8888”的卡
		{
			if (mark_num >= CARD_TYPE_LONGXIA.mark_num_min && mark_num <= CARD_TYPE_LONGXIA.mark_num_max)
			{
				card_type_str.replace(0, CARD_TYPE_LONGXIA.code.size(), CARD_TYPE_LONGXIA.code);
				need_write_code_type = true;//只有在这些号段的时候，才需要重写。add by liuye 2017.6.6
			}
			else if (mark_num >= CARD_TYPE_LANMEI.mark_num_min && mark_num <= CARD_TYPE_LANMEI.mark_num_max)
			{
				card_type_str.replace(0, CARD_TYPE_LANMEI.code.size(), CARD_TYPE_LANMEI.code);
				need_write_code_type = true;
			}
			else if (mark_num >= CARD_TYPE_MAISUI.mark_num_min && mark_num <= CARD_TYPE_MAISUI.mark_num_max)
			{
				card_type_str.replace(0, CARD_TYPE_MAISUI.code.size(), CARD_TYPE_MAISUI.code);
				need_write_code_type = true;
			}
			else if (mark_num >= CARD_TYPE_DOUJIA.mark_num_min && mark_num <= CARD_TYPE_DOUJIA.mark_num_max)
			{
				card_type_str.replace(0, CARD_TYPE_DOUJIA.code.size(), CARD_TYPE_DOUJIA.code);
				need_write_code_type = true;
			}
			//新卡不在以上号段中时，卡片类型码会被写空。所以，下面这句话被干掉了。modify by liuye 2017.6.6
			//need_write_code_type = true;
			// 
		}

		//卡类型码纠错仅针对于智信融创的老卡 add by daxiong 2017.10.19
		if (sCardType != "0")
		{
			need_write_code_type = false;
		}
		//
		
		// 注意这里offset计算不需要进行“/2”转换，因为这个API层面操作的都是HEX字符串格式，在“WriteCardFile”内部会自动进行“/2”转换。
		if (need_write_code_type) // 根据需要重新写入卡片类型编码.
		{
			static const uint32_t TYPE_CODE_DATA_OFFSET = CARD_CHIP_NUM_LEN;
			WriteCardFile(MF_FILE_DIR, BASIC_INFO_FILE_ID, TYPE_CODE_DATA_OFFSET, ACTIVATE_KEY_ID, key_F0015_DAMK1, card_type_str);
		}

		//将业务信息文件中的数据长度设置为0.
		WriteCardFile(DF01_DIR, SERVICE_INFO_FILE_ID, 0/*offset*/, ACTIVATE_KEY_ID, key_F0015_DAMK1, DecToHex(0)); // Default length is 0.
	}

	void RWDevice::ResetCard(const std::string& key_DCCK, const std::string& key_F0015_DACK) const
	{
		/*注意：目前不确定为某一市场定制的卡是否能够拿到其他市场去使用，因此暂时不做此检查。
		// 检验卡片是否可以在当前市场使用.
		// 读取卡面号
		const char kKeyID = NULL; // No need to do authentication.
		const std::string kKey = "";
		static const uint32_t CHIP_NUM_DATA_OFFSET = 0;
		std::string chip_num_str = ReadCardFile(MF_FILE_DIR, BASIC_INFO_FILE_ID, CHIP_NUM_DATA_OFFSET, CARD_CHIP_NUM_LEN, kKeyID, kKey);

		const uint32_t kIssuerCodeLen = CARD_ISSUER_CODE_HAERBIN_HADA.size(); // 卡面号前4位数字即为发卡机构编码.
		std::string issuer_code_of_chip_num = chip_num_str.substr(0, kIssuerCodeLen);
		if (!(issuer_code_of_chip_num.compare(CARD_ISSUER_CODE_HAERBIN_HADA) == 0 ||
		issuer_code_of_chip_num.compare(CARD_ISSUER_CODE_HAERBIN_HADA_BATCH1) == 0))
		throw std::exception("This card belongs to other market, it cannot be used in this market!");
		*/


		// 设置密码
		static const uint32_t CHIP_NUM_DATA_OFFSET = 0;
		const char kKeyID = NULL; // No need to do authentication.
		const std::string kKey = "";
		std::string chip_num_str = ReadCardFile(MF_FILE_DIR, BASIC_INFO_FILE_ID, CHIP_NUM_DATA_OFFSET, CARD_CHIP_NUM_LEN, kKeyID, kKey);
		//九方元通的卡，damk的秘钥标示为0
		std::string sCardType = chip_num_str.substr(4, 1);
		if (sCardType == "1")
		{
			SetPassword(DF01_DIR, 0, key_F0015_DACK.c_str(), K_F0015_DAMK1_DV, KT_DAMK);
			SetPassword(MF_FILE_DIR, 0, key_DCCK.c_str(), K_F0005_DCMK1, KT_DAMK);
		}
		else
		{
			SetPassword(DF01_DIR, 1, key_F0015_DACK.c_str(), K_F0015_DAMK1_DV, KT_DAMK);
			SetPassword(MF_FILE_DIR, 1, key_DCCK.c_str(), K_F0005_DCMK1, KT_DAMK);
		}
		//
		SetPassword(DF01_DIR, 1, key_F0015_DACK, K_F0015_DEAK_DV, KT_DEAK);
		SetPassword(DF01_DIR, 0, key_F0015_DACK, K_F0015_DACK_DV, KT_DCCK);
		SetPassword(MF_FILE_DIR, 0, key_DCCK.c_str(), K_DCCK_DV, KT_DCCK);

		// 充值卡片内码
		// 注意这里offset计算不需要进行“/2”转换，因为这个API层面操作的都是HEX字符串格式，在“WriteCardFile”内部会自动进行“/2”转换。
		static const uint32_t CARD_SN_DATA_OFFSET = CARD_CHIP_NUM_LEN + CARD_TYPE_CODE_LEN + CARD_ISSUER_CODE_LEN + CARD_VERIFY_CODE_LEN;
		WriteCardFile(MF_FILE_DIR, BASIC_INFO_FILE_ID, CARD_SN_DATA_OFFSET, ACTIVATE_KEY_ID, K_F0005_DCMK1, DEFAULT_CARD_DEVICE_ID);
		
		//将业务信息文件中的数据长度设置为0.
		WriteCardFile(DF01_DIR, SERVICE_INFO_FILE_ID, 0/*offset*/, ACTIVATE_KEY_ID, K_F0015_DAMK1_DV, DecToHex(0)); // Default length is 0.
	}

	DILICard::BasicInfo RWDevice::ReadCardBasicInfo() const
	{
		const uint32_t kOffset = 0;
		const uint32_t kLength = CARD_CHIP_NUM_LEN + CARD_SN_LEN + CARD_TYPE_CODE_LEN + CARD_ISSUER_CODE_LEN + CARD_VERIFY_CODE_LEN;
		const char kKeyID = NULL; // No need to do authentication.
		const std::string kKey = "";
		std::string basic_info_str = ReadCardFile(MF_FILE_DIR, BASIC_INFO_FILE_ID, kOffset, kLength, kKeyID, kKey);

		DILICard::BasicInfo basic_info;
		
		uint32_t offset = 0;
		basic_info.chip_num = basic_info_str.substr(offset, CARD_CHIP_NUM_LEN);
		offset += CARD_CHIP_NUM_LEN;

		std::string field;
		field = basic_info_str.substr(offset, CARD_TYPE_CODE_LEN);
		basic_info.type_code = field.substr(0, field.find_first_of(PADDING_CHAR));
		offset += CARD_TYPE_CODE_LEN;

		field = basic_info_str.substr(offset, CARD_ISSUER_CODE_LEN);
		basic_info.issuer_code = field.substr(0, field.find_first_of(PADDING_CHAR));
		offset += CARD_ISSUER_CODE_LEN;

		field = basic_info_str.substr(offset, CARD_VERIFY_CODE_LEN);
		basic_info.verify_code = field.substr(0, field.find_first_of(PADDING_CHAR));
		offset += CARD_VERIFY_CODE_LEN;

		basic_info.device_id = basic_info_str.substr(offset, CARD_SN_LEN);

		return basic_info;
	}
	
	std::string RWDevice::ReadCardServiceInfo(const std::string& key_F0015_DEAK) const
	{
		const uint32_t kOffset = 0;
		std::string data_len_hex = ReadCardFile(DF01_DIR, 
			SERVICE_INFO_FILE_ID, kOffset, SERVICE_INFO_DATA_HEADER_LEN * 2, SERVICE_INFO_KEY_ID, key_F0015_DEAK);
		uint32_t data_len = _byteswap_ulong(std::stoul(data_len_hex, 0, 16)); // 大端转小端.
		if (data_len > CARD_DATA_LEN_MAX)
			throw std::exception("Read card service info data length failed！");
		if (0 == data_len)
			return "";
		else
			// 注意这里offset计算不需要进行“/2”转换，因为这个API层面操作的都是HEX字符串格式，在“WriteCardFile”内部会自动进行“/2”转换。
			return ReadCardFile(DF01_DIR, 
				SERVICE_INFO_FILE_ID, data_len_hex.size(), data_len * 2, SERVICE_INFO_KEY_ID, key_F0015_DEAK); // 根据长度读数据.
	}

	void RWDevice::WriteCardServiceInfo(const std::string& key_F0015_DAMK1, const std::string& data) const
	{
		uint32_t data_len = data.size() / 2; // Why "/ 2"? refer to the comment at the front of this file.
		if (data_len > SERVICE_INFO_DATA_LEN_MAX)
			throw std::exception("Data length too long, write card service info data failed！ Max valid length: 250 bytes!)");
		std::string data_len_str = DecToHex(_byteswap_ulong(data_len)); // Convert to big endian first and then to HEX string.
		WriteCardFile(DF01_DIR, SERVICE_INFO_FILE_ID, 0, SERVICE_INFO_KEY_ID, key_F0015_DAMK1, data_len_str + data);
	}

	//------Private Implementations----------------
	std::string RWDevice::ReadCardFile(const std::string&	dir, 
									   char					file_id, 
									   uint32_t				offset, 
									   uint32_t				length, 
									   char					key_id, 
									   const std::string&	key) const
	{
		std::stringstream err_msg;
		unsigned char aucDir[4] = { 0 }, aucKey[32] = { 0 }, aucData[500] = { 0 };
		memcpy(aucDir, dir.c_str(), 4);
		int iResult = 0;
		if (NULL != key_id)
		{
			memcpy(aucKey, key.c_str(), 32);
			iResult = DLCReadCardData(aucDir, file_id, offset, length, aucKey, aucData);
		}
		else
		{
			iResult = DLCReadCardData(aucDir, file_id, offset, length, NULL, aucData);
		}

		
		if (0 != iResult)
		{
			err_msg << "Read DL card data failed, dir:" << dir << ", file:" << file_id << ", ErrorCode:" << iResult;
			throw std::exception(err_msg.str().c_str());
		}

		std::string sData = (char*)aucData;
		return sData;

	}

	void RWDevice::WriteCardFile(const std::string& dir, 
								 char				file_id, 
								 uint32_t			offset, 
								 char				key_id, 
								 const std::string& key, 
								 const std::string& data) const
	{
		std::stringstream err_msg;
		int iResult = 0;
		const int DATA_MAX_LEN = 500;

		unsigned char aucDir[4] = { 0 }, aucKey[32] = { 0 };
		memcpy(aucDir, dir.c_str(), 4);
		memcpy(aucKey, key.c_str(), 32);

		int iDataLength = data.size();
		int iStartIndex = 0, iOffset = offset;
		do 
		{
			while (iDataLength - DATA_MAX_LEN > 0)
			{
				unsigned char aucDataBlock[DATA_MAX_LEN] = { 0 };
				memcpy(aucDataBlock, data.substr(iStartIndex, DATA_MAX_LEN).c_str(), DATA_MAX_LEN);
				iResult = DLCWriteCardData(aucDir, file_id, iOffset, DATA_MAX_LEN, aucDataBlock, aucKey);
				if (0 != iResult)
				{
					err_msg << "Write data to file failed, FILE: " << file_id << ", ErrorCode: " << iResult;
					throw std::exception(err_msg.str().c_str());
					break;
				}
				iStartIndex += DATA_MAX_LEN;
				iDataLength -= DATA_MAX_LEN;
				iOffset += DATA_MAX_LEN;
			}
			if (0 == iResult)
			{
				unsigned char aucData[DATA_MAX_LEN] = { 0 };
				memcpy(aucData, data.substr(iStartIndex, iDataLength).c_str(), iDataLength);
				iResult = DLCWriteCardData(aucDir, file_id, iOffset, iDataLength, aucData, aucKey);
				if (0 != iResult)
				{
					err_msg << "Write data to file failed, FILE: " << file_id << ", ErrorCode: " << iResult;
					throw std::exception(err_msg.str().c_str());
					break;
				}
			}
		} while (0);
	}

	void RWDevice::SetPassword(const std::string&	dir, 
							   char					key_id, 
							   const std::string&	main_key, 
							   const std::string&	install_key, 
							   KeyType				emKeyType) const
	{
		std::stringstream err_msg;
		unsigned char aucDir[4] = { 0 }, aucMainKey[32] = { 0 }, aucNewKey[32] = { 0 };
		memcpy(aucDir, dir.c_str(), 4);
		memcpy(aucMainKey, main_key.c_str(), 32);
		memcpy(aucNewKey, install_key.c_str(), 32);
		int iResult = DLCInstallKey(aucDir, key_id, emKeyType, aucMainKey, aucNewKey);
		if (0 != iResult)
		{
			err_msg << "Update key failed, key to be updated: " << install_key << ", ErrorCode: " << iResult;
			throw std::exception(err_msg.str().c_str());
		}
	}

	bool RWDevice::AuthenticationKey(const std::string sKey) const
	{
		bool bResult = true;
		unsigned char aucKey[32] = { 0 };
		memcpy(aucKey, sKey.c_str(), 32);
		int iResult = DLCAuthenticationKey((const unsigned char*)"3f00", 0, aucKey);
		if (iResult)
		{
			bResult = false;
		}
		else
		{
			bResult = true;
		}

		return bResult;
	}

	int RWDevice::M1FindCard() const 
	{
		return DLCM1FindCard();
	}

	BasicInfo RWDevice::M1ReadBasicInfo() const
	{
		BasicInfo basic_info;
		unsigned char data[33] = { 0 };

		const char* key = "ffffffffffff";
		int error_code = DLCM1AuthenticationKey(1, (unsigned char*)key);
		if (error_code)
		{
			throw std::exception(std::to_string(error_code).c_str());
		}

		error_code = DLCM1ReadCard(4, data);
		if (error_code)
		{
			throw std::exception(std::to_string(error_code).c_str());
		}
		basic_info.chip_num.insert(0, (char*)data, 8);
		basic_info.type_code.insert(0, (char*)&data[16], 6);

		error_code = DLCM1ReadCard(5, data);
		if (error_code)
		{
			throw std::exception(std::to_string(error_code).c_str());
		}
		basic_info.issuer_code.insert(0, (char*)data, 4);
		basic_info.verify_code.insert(0, (char*)&data[16], 3);

		error_code = DLCM1ReadCard(6, data);
		if (error_code)
		{
		throw std::exception(std::to_string(error_code).c_str());
		}
		basic_info.sub_type.insert(0, (char*)data, 2);
		basic_info.maker_version.insert(0, (char*)&data[16], 2);

		basic_info.device_id = basic_info.chip_num;

		return basic_info;
	}

	int RWDevice::M1WriteBasicInfo(std::string card_num, std::string card_type_num, std::string market_id, std::string safe_code, std::string m1_type, std::string card_version) const
	{
		int result = 0;

		do 
		{
			const char* key = "ffffffffffff";
			
			if (DLCM1AuthenticationKey(1, (unsigned char*)key))
			{
				break;
			}

			unsigned char data[32] = { 0 };
			memset(data, '0', 32);
			memcpy(data, card_num.c_str(), 8);
			memcpy(&data[16], card_type_num.c_str(), 6);
			if (DLCM1WriteCard(4, (unsigned char*)data))
			{
				break;
			}

			memset(data, '0', 32);
			memcpy(data, market_id.c_str(), 4);
			memcpy(&data[16], safe_code.c_str(), 3);
			if (DLCM1WriteCard(5, (unsigned char*)data))
			{
				break;
			}

			memset(data, '0', 32);
			memcpy(data, m1_type.c_str(), 2);
			memcpy(&data[16], card_version.c_str(), 2);
			if (DLCM1WriteCard(6, (unsigned char*)data))
			{
				break;
			}
		} while (0);

		return result;
	}
} // DILICard