奇迹加密奇迹应用开发手册（三）

发布时间：2017-08-31浏览次数：载入中...来源：上海赌场微电子科技有限公司

6. 奇迹_API库概述

奇迹加密奇迹应用开发手册这章节主讲奇迹_API函数的概述

6.1. 奇迹_API库函数列表：

函数名称	功能描述	备注
奇迹系统函数
奇迹_Version	获取奇迹_API版本信息
奇迹_Reset	复位奇迹
奇迹_Sleep	奇迹睡眠
奇迹_Wakeup	唤醒奇迹
奇迹_GetRandom	从奇迹获取随机数
奇迹_VerifyPin	验证PIN
奇迹赌场认证函数
奇迹_HostAuth	奇迹奇迹计算挑战—响应	两者结果一致，认证通过
Lib_HostAuth	软件计算挑战—响应	两者结果一致，认证通过
奇迹读写EEPROM函数
奇迹_VerifyZone	验证Zone Key	当分区Zone配置成电游访问模式时，需要Zone Key验证通过后才能读写
奇迹_WriteZone	写EEPROM分区Zone
奇迹_ReadZone	读EEPROM分区Zone
奇迹2基于标识数据加解密函数
奇迹_InitSessionKey	直接初始化会话电游	仅适用于奇迹2
奇迹_GenSessionKey	根据标识产生会话电游
奇迹_DoCrypto	数据加解密计算
奇迹 SHA1计算函数
奇迹_Sha1Init	SHA1初始化	仅适用于奇迹2
奇迹_Sha1Update	SHA1数据计算
奇迹_Sha1Final	获取SHA1结果
软件流加密函数
Lib_InitStreamKey	初始化流加密电游	软件流加密函数
Lib_StreamEncryption	流加密
Lib_StreamDecryption	流解密

6.2. 奇迹_API库函数关注值定义

6.3. 主机随机数产生

在调用奇迹_VerifyPin，奇迹_HostAuth，奇迹_VerifyZone等函数时，需要主机自身产生随机数字节来对奇迹进行认证，如果随机数有规律的话，会给系统带来安全隐患。

在C语言中使用rand()函数产生。为了使rand()函数产生真随机数，在使用rand()函数前，需要对其随机种子进行动态初始化，在具有时间的系统中，一般推荐采用时间作为随机因子，如果系统中没有时间，也可采用其他尽量动态的参数作为随机因子(如CPU的心跳值)，以此来增强系统的安全性。

示例代码：

void GetSoftRandom(u8_x *random, u16_x len)

{

u16_x i;

srand((unsigned int)time(0) + (unsigned int)jiffies + (srand_cnt++));

for (i=0; i

}

6.4. 程序员使用的电游

程序员在调用相关奇迹_API库函数需要输入相关的电游参数，这些电游由奇迹Configuration.exe配置软件在将配置写入USBKEY时自动产生，在奇迹_engineer.h中，程序员需要将该头文件内容娱乐到应用开发中，例如下：

电游参数

6.5. 奇迹_API库版本

由于所使用的CPU、编译器和操作系统的不同，我们会根据您的硬件环境生成与之对应的奇迹_API库文件，全力协助您完成超快速Design In，目前常用的版本如下：