某软件保护加密锁技术开发手册

目录

1.产品介绍 (1)

1.1.新的软件保护方法 (1)

1.2.产品基本组成 (2)

1.2.1.精锐IV开发工具包 (2)

1.2.2.精锐IV硬件设备 (3)

1.2.3.用户运行时环境 (3)

1.3.重要的安全事项 (3)

1.3.1.口令 (3)

1.3.2.文件系统 (4)

1.4.更多的功能 (6)

2.产品安装 (7)

2.1.系统需求 (7)

2.2.SDK安装 (7)

2.2.1.关于设备驱动程序安装的说明 (7)

2.3.SDK卸载 (8)

3.开始使用 (9)

3.1.示例软件 (9)

3.2.代码移植 (10)

3.2.1.创建一个精锐IV工程 (10)

3.2.2.编写精锐IV代码 (10)

3.2.3.编译测试精锐IV代码 (12)

3.2.4.下载代码到精锐IV硬件 (12)

3.2.5.修改PC代码 (13)

3.2.6.测试保护结果 (16)

3.3.程序结构分析 (16)

4.开发精锐IV代码 (18)

4.1.编写精锐IV内部代码 (18)

4.1.1.代码结构 (18)

4.1.2.输入与输出 (19)

4.1.3.内存结构 (20)

4.1.4.使用系统函数库文件 (24)

4.1.5.数据类型 (24)

4.1.6.代码编写建议 (24)

4.2.访问精锐IV设备 (25)

4.2.1.一般性访问 (25)

4.2.2.开发级访问 (28)

4.2.3.用户级访问 (32)

4.3.关于代码测试 (34)

5.1.K EIL C51使用说明 (35)

5.1.1.工程创建与管理 (36)

5.1.2.代码编译与调试配置 (38)

5.1.3.代码调试方法 (39)

5.1.4.仿真器特别说明 (43)

5.2.R AISONANCE R KIT使用说明 (44)

5.2.1.工程创建与管理 (44)

5.2.2.代码编译与调试 (47)

5.3.深思洛克S KIT (47)

5.4.可执行文件格式 (47)

6.工具软件使用说明 (48)

6.1.开发测试工具 (48)

6.1.1.重新连接 (49)

6.1.2.重置设备 (49)

6.1.3.PIN码管理 (51)

6.1.4.下载文件 (51)

6.1.5.清空目录 (52)

6.1.6.执行文件 (53)

6.1.7.授权管理 (54)

6.1.8.PC密钥 (54)

7.网络版使用说明 (56)

7.1.精锐IV网络版简介 (56)

7.1.1.特性 (56)

7.1.2.网络锁口令 (57)

7.1.3.网络锁的模块 (57)

7.2.使用网络版精锐IV (57)

7.2.1.网络锁服务程序的安装和卸载 (57)

7.2.2.网络锁服务管理工具的使用 (57)

7.2.3.网络锁API的使用 (62)

8.系统函数参考 (64)

8.1.流程控制类 (65)

8.1.1._exit (65)

8.2.输入输出类 (66)

8.2.1._set_response (66)

8.3.文件操作类 (67)

8.3.1._open (67)

8.3.2._close (68)

8.3.3._read (69)

8.3.4._write (70)

8.3.5._create (73)

8.3.6._enable_exe (75)

8.4.1._addf (77)

8.4.2._add (78)

8.4.3._subf (79)

8.4.4._sub (80)

8.4.5._multf (81)

8.4.6._mult (82)

8.4.7._divf (83)

8.4.8._div (84)

8.4.9._sinf (85)

8.4.10._sin (86)

8.4.11._cosf (87)

8.4.12._cos (88)

8.4.13._tanf (89)

8.4.14._tan (90)

8.4.15._asinf (91)

8.4.16._asin (92)

8.4.17._acosf (93)

8.4.18._acos (94)

8.4.19._atanf (95)

8.4.20._atan (96)

8.4.21._atan2f (97)

8.4.22._atan2 (98)

8.4.23._sinhf (99)

8.4.24._sinh (100)

8.4.25._coshf (101)

8.4.26._cosh (102)

8.4.27._tanhf (103)

8.4.28._tanh (104)

8.4.29._ceilf (105)

8.4.30._ceil (106)

8.4.31._floorf (107)

8.4.32._floor (108)

8.4.33._absf (109)

8.4.34._abs (110)

8.4.35._fmodf (111)

8.4.36._fmod (112)

8.4.37._expf (113)

8.4.38._exp (114)

8.4.39._logf (115)

8.4.40._log (116)

8.4.41._log10f (117)

8.4.42._log10 (118)

8.4.43._sqrtf (119)

8.4.45._powf (121)

8.4.46._pow (122)

8.4.47._modf (123)

8.4.48._frexp (124)

8.4.49._ldexp (125)

8.4.50._fdcmp (126)

8.4.51._dtof (127)

8.4.52._ftod (128)

8.4.53._dtol (129)

8.4.54._altod (130)

8.4.55._lltod (131)

8.5.密码算法类 (132)

8.5.1._tdes_enc (133)

8.5.2._tdes_dec (134)

8.5.3._des_enc (136)

8.5.4._des_dec (138)

8.5.5._sha1_init (140)

8.5.6._sha1_update (142)

8.5.7._sha1_final (143)

8.5.8._rsa_enc (145)

8.5.9._rsa_dec (148)

8.5.10._rsa_sign (150)

8.5.11._rsa_veri (152)

8.5.12._rand (155)

8.6.内存操作类 (157)

8.6.1._mem_copy (157)

8.6.2._mem_move (158)

8.6.3._mem_set (159)

8.6.4._mempool_init (160)

8.6.5._malloc (161)

8.6.6._calloc (162)

8.6.7._realloc (163)

8.6.8._free (164)

8.6.9._invert (165)

8.6.10._mem_cmp (166)

8.7.时间操作类 (167)

8.7.1._set_timer (167)

8.7.2._start_timer (168)

8.7.3._stop_timer (169)

8.7.4._get_timer (170)

8.7.5._time (172)

8.7.6._mktime (173)

8.7.7._gmtime (174)

8.8.1._swap_u16 (176)

8.8.2._swap_u32 (177)

8.8.3.LE16_TO_CC (178)

8.8.4.LE32_TO_CC (179)

https://www.360docs.net/doc/f87134301.html,_TO_LE16 (180)

https://www.360docs.net/doc/f87134301.html,_TO_LE32 (181)

8.8.7.BE16_TO_CC (182)

8.8.8.BE32_TO_CC (183)

https://www.360docs.net/doc/f87134301.html,_TO_BE16 (184)

https://www.360docs.net/doc/f87134301.html,_TO_BE32 (185)

8.8.11._atod (186)

8.8.12.DEFINE_AT (187)

8.9.设备基本信息类 (188)

8.9.1._get_gbdata (188)

8.10.系统函数错误代码索引 (189)

8.11.双精度浮点数边界条件 (190)

9.API参考 (192)

9.1.API列表 (193)

9.1.1.S4Enum (194)

9.1.2.S4Open (196)

9.1.3.S4OpenEx (198)

9.1.4.S4Close (200)

9.1.5.S4Control (201)

9.1.6.S4CreateDir (206)

9.1.7.S4CreateDirEx (208)

9.1.8.S4ChangeDir (211)

9.1.9.S4EraseDir (212)

9.1.10.S4VerifyPin (213)

9.1.11.S4ChangePin (215)

9.1.12.S4WriteFile (217)

9.1.13.PS4WriteFile (222)

9.1.14.S4Execute (226)

9.1.15.S4ExecuteEx (228)

9.1.16.S4Startup (230)

9.1.17.S4Cleanup (230)

9.2.错误代码索引 (231)

附录A.密码算法使用说明 (233)

A.1.密钥处理函数 (234)

A.1.1X_GenerateRsaKeys (234)

A.1.2R_GenerateRsaKeys (235)

A.1.3X_Pub2Cos (237)

A.1.4X_Pri2Cos (238)

A.1.6X_Cos2Pri (240)

A.2.密码算法函数 (241)

A.2.1RSAPublicEncrypt (241)

A.2.2RSAPrivateDecrypt (242)

A.2.3Sign (243)

A.2.4Verify (244)

A.2.5Digest (245)

A.2.6DES (246)

A.2.7TDES (247)

A.3.错误代码索引 (248)

附录B.硬件参数列表 (249)

附录C.旧版系统函数 (250)

C.1._SHA1_FIRST_BLOCK (250)

C.2._SHA1_MID_BLOCK (251)

C.3._SHA1_FINAL_BLOCK (252)

C.4._SHA1 (253)

C.5._SHA1_FIRST (254)

C.6._SHA1_MID (255)

C.7._SHA1_LAST (256)

C.8._SHA1_ONLY (257)

附录D.系统函数索引 (258)

附录E.设备驱动安装API参考 (260)

E.1.S4DRV_G ET D RIVER I NFO (260)

E.2.S4DRV_I NSTALL (262)

E.3.S4DRV_U NINSTALL (263)

E.4.S4DRV_I S N EED R EBOOT (264)

1.产品介绍

精锐IV是北京深思洛克软件技术股份有限公司开发的新一代软件加密锁，它是目前世界上最安全的软件保护产品。

两种关键技术保证了软件保护真正的安全性：

●程序代码保护

您可以将10,000行左右的高级语言程序代码转移到精锐IV内部去执行，这些被转移的代码不会在计算机中留有任何痕迹，也没有人可以获得这些代码的副本；您的软件将在两个系统上运行：一个是计算机，一个是精锐IV。盗版被精锐IV保护的软件是不可行的，因为精锐IV硬件不可能被复制。

●可靠的硬件基础

不可复制、抵御攻击都是靠硬件的安全性来完成的，为此，精锐IV不仅采用了智能卡技术，而且还选用了最好的智能卡芯片（通过CC EAL5+的安全认证1）。如果您仔细研读了相关的安全标准，您就会发现精锐IV的硬件绝对值得信赖。

精锐IV首次在软件保护领域提出了“不可破解”的安全模型，可以从根本上杜绝盗版从而最大程度保护软件开发者的经济利益。

1.1.新的软件保护方法

如果您曾经使用过其他类型的加密锁，请尽量先忘掉那些加密锁的技术细节，并仔细理解本小节中提供的内容，因为这是一种先进的、全新的思想。如果您之前没有用过任何加密锁的话，那只需要看看下面的图片，您会发现整个过程很容易理解。

请记住已经没有了“数据区”、“算法单元”等概念，这些都是老皇历了。现在您的加密锁拥有一个完整的“操作系统”，在这个系统中一切都是文件：可执行文件、数据文件以及密钥文件；当然也可以有目录。您可以想象这就像是一个MS-DOS操作系统。

下面我们来看看软件保护是怎么完成的（图1-1）。

图1-1 精锐IV软件保护方法

1．专心开发软件并完成测试工作，这时完全不必理会加密锁、软件保护技术；

1这是一个很高的安全认证级别，详细细节您可以参考ISO15408标准的内容。

2．在软件中找出一些相对重要的代码，通过精锐IV兼容的编译器，将这些代码编译并写入到精锐IV内部；

3．在软件中这些被“挖走”的代码的位置，加入对精锐IV的调用；

4．软件运行时，这些被移植的代码将在精锐IV内部运行，并将结果返回给软件；

由于软件的一部分被移植到了精锐IV硬件内部，脱离精锐IV将使软件变得不完整，从而使破解被精锐IV保护的软件成为“无法完成的任务”。

每个被移植的代码部分都可以在精锐IV内部成为一个独立的“可执行文件”，当然也可以将它们组合在一起。精锐IV目前最多可以提供64K字节的安全存储空间，文件的数量几乎没有限制（文件头会占用一部分空间，所以过多的文件会造成存储空间的浪费）。总计可以移植的代码数量在10,000行左右，可以保护任意多个软件。

注意：尽管代码的“移植”是精锐IV最主要的软件保护手段，但是这并不说明您需要完全丢弃原有的技术策略，在多数情况下它们是互为补充的。不过请记住只有代码移植到精锐IV内才可以使您的软件真正安全。

1.2.产品基本组成

精锐IV不是一个简单的加密锁，您需要在它的操作系统2上开发软件中某些部分的“加密锁”版本。这并不是一项艰难的任务，多数情况下只要简单修改代码就能使它们在精锐IV中运行，因为精锐IV支持标准C语言编写的代码。如果软件是通过其它高级语言开发的，例如Delphi，您需要用C语言来改写其中被移植的部分。尽管高级语言之间的“翻译”工作需要一些投入，但是如果“翻译”几百行代码就能够使您的软件彻底远离盗版，这项工作绝对物有所值。在本文的后续部分，我们通常把移植到精锐IV内部的代码称为“精锐IV 应用程序”或者“精锐IV可执行程序”。

精锐IV产品由以下部分组成：

●精锐IV开发工具包

●精锐IV硬件设备

●精锐IV用户运行时环境

1.2.1.精锐IV开发工具包

最重要的部分是精锐IV可执行程序的集成开发环境。精锐IV支持标准C语言开发，任何一款支持MCS 51或者SmartXA 2的编译器都可以用来开发精锐IV可执行程序。我们的SDK中包括了一个全功能的编译环境Skit，如果您更习惯于使用流行的开发工具，我们推荐您购买Keil Software公司的C51编译器或者是Raisonance SA公司的RKit，您可以访问https://www.360docs.net/doc/f87134301.html,和https://www.360docs.net/doc/f87134301.html,获取关于这两种编译软件的信息。

一些工具软件也包含在开发工具包中，包括：

●开发测试工具。协助开发、测试移植到精锐IV内部的代码，并可以简单管理设备；

2精锐IV内部的操作系统符合智能卡操作系统的国际标准，您可以通过查阅ISO7816系列的标准来获取“智能卡操作系统”的相关知识。

●用户测试工具。可以分发给软件最终用户，协助解决可能出现的配置故障；

●批量设置工具。高效率的加密锁批量初始化工具；

您可以在开发工具包中找到很多范例代码，可以作为开发过程中的参考或者是样板。

注意：关于编译器的更详细内容，请参考第五章“编译器使用说明”；关于工具软件的更详细内容，请参考第六章“工具软件使用说明”。

1.2.2.精锐IV硬件设备

硬件设备是精锐IV可执行程序的运行环境和存储介质，完全基于智能卡技术开发，采用16位、16MHz的高性能CPU。精锐IV主要提供USB接口设备类型，作为可选项，也可以按标准智能卡的形式提供。精锐IV是一种高度集成化的产品，其所有器件（包括CPU、RAM、EEPROM以及USB通讯模块）都集成在同一块智能卡芯片上面，这极大提高了产品的安全性和稳定性。

每一个精锐IV设备都具有全球唯一的序列号，该序列号在芯片生产的阶段就已经确定。

1.2.3.用户运行时环境

本文中的“用户”指的是最终的软件用户。

用户运行时环境主要是指精锐IV设备的驱动程序。精锐IV可以运行在两种模式下：一种是通过标准的USB驱动来访问设备，我们称之为标准模式；另一种是无驱动模式，这时它将作为标准的HID设备被Windows操作系统识别。在提供方便性的同时，无驱动模式相比标准模式要牺牲一些高级功能和通用性（例如设备多进程访问），所以我们建议使用标准模式。

1.3.重要的安全事项

在软件保护工作开始之前，请务必确保您已经理解了本小节所提供的内容！

1.3.1.口令

精锐IV共提供了两个级别的口令：开发口令和用户口令（本文中口令有时也称为“PIN 码”），通过不同级别的口令来获得不同的操作权限3。

开发口令共24字节，成功验证开发口令后，可以获得对精锐IV设备的设置权。尽管拥有开发口令并不能直接读出精锐IV硬件内部的数据，但是开发口令泄露仍然会严重威胁精锐IV内部数据的安全。精锐IV在初次使用时，其默认的开发口令为“123456781234567812345678”（0x31 0x32 0x33 0x34 0x35 0x36 0x37 0x38 0x31 0x32 0x33 0x34 0x35 0x36 0x37 0x38 0x31 0x32 0x33 0x34 0x35 0x36 0x37 0x38）。在发行精锐IV 之前，务必将其修改为一个秘密值。

3操作权限有时也称为“安全状态”，如果硬件设备被重置、断电，则操作权限将丢失。例如，当计算机休眠后，尽管重新启动后软件可以继续运行，但由于USB端口有断电过程，所以加密锁的操作权限将丢失，从而导致软件操作加密锁失败。

用户口令共8字节，其默认值为“12345678”

（0x31 0x32 0x33 0x34 0x35 0x36 0x37 0x38）。成功验证用户口令仅能获得对精锐IV设备的“调用权”，即可以调用精锐IV内部的可执行程序，但不能访问其它的文件如数据文件。原则上用户口令没有“安全性”问题，您可以用它来简单检查是否是属于您的加密锁。

下面是一些跟口令相关的重要安全细节：

?无论是开发口令还是用户口令，都是针对精锐IV内部的目录，而不是针对特定的精锐IV设备，每个目录都包含自己的开发口令和用户口令。目录之间的安全

属性是独立的，因此，修改了根目录的口令并不意味着子目录的口令同时得到

修改，获得了根目录的权限也不会自动获得子目录的相应权限。这一特性可以

使多个不相关的软件被同一个加密锁保护并互相不产生干扰和威胁。但是删除

根目录会导致子目录的内容同时被删除。

除非必要，我们不建议使用多级目录以避免产生管理上的混乱。

关于目录的详细介绍，请参考下一节“文件系统”。

?根目录的开发口令连续15次错误重试，会将硬件设备锁定；一旦锁定后将没有任何办法可以恢复。所以需要妥善保管加密锁的开发口令，切记深思洛克并不

能恢复您的口令或者对设备进行解锁，这是为了最大程度保证您的安全性。

子目录开发口令错误重试仅会导致该目录锁定，但仍然可以通过擦除上级目录

的方法将其删除。

?用户口令无论重试多少次都不会导致锁定。

?每次重新初始化文件系统，例如删除并重建根目录、清空子目录时，目录的两级口令都会恢复为默认值，所以重新初始化文件系统后一定要记得将开发口令

修改为一个秘密值。

1.3.

2.文件系统

了解一些文件系统的安全性细节会有助于构造更安全的保护方案。

精锐IV支持“目录-文件”结构。精锐IV内部的存储空间按照目录的方式进行管理，下面是精锐IV目录的一些关键特征：

?有且只有一个根目录，目录下面可以有子目录，但最多不能超过三级；

?建立目录必须指定目录所占用的空间，目录一旦建立后其大小不能更改；根目录占用硬件所有的存储空间；

?根目录可以被删除，删除根目录将同时删除目录中包含的所有内容，例如子目录、文件；

?任何目录的父目录，兄弟目录和子目录的目录ID不能重名。

?子目录只能被清空，而不能被直接删除。清空子目录将删除该目录中所包含的所有内容，例如子目录、文件。子目录清空后，其开发级口令、用户级口令都将恢复为

默认值。如果要彻底删除子目录以释放其占用的空间，必须清空/删除其上级目录；

?网络锁只支持根目录。

在精锐IV内部，通常会使用到三种文件：可执行文件、数据文件、密钥文件，任何一种文件都不可能直接从硬件中被读出，验证开发口令后可以创建和修改文件。

?可执行文件

可执行文件是一种可以在精锐IV内部操作系统上被加载并运行的文件格式，软件加密过程中所移植的代码会被编译成可执行文件。可执行文件分为两种：VM可执行文件（或者称为普通可执行文件）与XA可执行文件，对应于两种不同的运行模式。关于运行模式的详细说明，请参考第四章“开发精锐IV代码”。XA可执行文件只被硬件版本2.3及以上的精锐IV支持，其运行效率比VM可执行文件要高，但是在精锐IV上的通用性要差一些。通过运行产品包中提供的工具软件，您可以获取精锐IV的硬件版本号。

可执行文件通过硬件内部的系统函数可以操作其它的同目录文件，例如读写数据文件。对于操作可执行文件，情况稍微有些复杂：可执行文件并不一定可以被其他可执行文件读写，这取决于它自身的安全属性（参看表1-1）。

?数据文件

数据文件仅用于存放二进制数据。计算机中的程序不能直接从精锐IV中将数据文件读出。要访问精锐IV内部的数据文件，您必须通过精锐IV内部的可执行程序来完成。

?密钥文件

目前只有RSA密钥文件被支持，您可以查阅第八章“系统函数参考”来获取更详细的信息。

我们将精锐IV内部常用文件的安全属性总结如下：

表1-1 精锐IV文件安全属性

开发级

（验证开发口令）

用户级

（验证用户口令）

内部

（内部可执行文件）

可执行文件不可读写W E N 内部可读写W E R/W

数据文件W N R/W

密钥文件W N W

R：Read W：Write E：Execute N：None

对于精锐IV内部操作文件时所涉及的安全属性，有更详细的规定，细节请参看第八章“系统函数参考”中有关文件操作部分。

精锐IV内部的文件通过一个16位（2字节）的无符号整数进行标识，部分标识符被系统保留，这些保留的文件标识符包括：0x0000，0x0015，0x0016，0x0018，0x001e，0x3f00，0x3f01，0x3f02，0x3f03，0x3f04。

1.4.更多的功能

精锐IV内部包含了RSA（1024位）、DES/TDES密码算法的硬件协处理器，并提供了SHA-1算法功能和硬件真随机数发生器。以这些密码学功能为基础，深思洛克提供了远程升级和销售管理的平台，被精锐IV保护的软件可以通过互联网完成软件的收费升级，并借此实现对软件销售渠道的管理。深思洛克开放远程升级的底层技术细节，您可以通过深思洛克提供的底层技术来构造自己的远程升级和销售管理平台。

利用精锐IV的这些密码学算法，您还可以用来登录Windows操作系统、加密解密邮件以及完成各种复杂的网络安全功能。

2.产品安装

本章节将指导您如何安装精锐IV的SDK。

2.1.系统需求

要使用精锐IV的SDK，建议您使用一台运行Windows 98、Windows2000或更高版本操作系统的PC。如果在NT4下安装，您需要先安装Service Pack 4、IE4.0或更高版本。

精锐IV支持Microsoft Windows、Linux及Mac OS X，您可以在上述操作系统上使用精锐IV设备。

2.2.SDK安装

将光盘放入光驱，如果安装程序没有自动启动，请运行精锐IV SDK光盘中的Windows\Setup.exe程序，并根据安装向导的提示完成安装。

安装完成后，目标目录将包含以下内容：

子目录内容

API 精锐IV的API函数。

Doc 产品开发手册以及其它说明文档。

Drivers硬件设备驱动，关于驱动程序安装的细节，请参考第2.2.1节“关于设备驱动程序安装的说明”及附录E“设备驱动程序安装API参考”。

IDE 深思洛克提供的使用其它开发工具（如Keil C51）时所需要的支持库。

精锐IV硬件系统函数库，详细信息请参考第八章“系统函数参考”。

Samples 范例代码，包括基本的操作示范以及应用案例源代码。

Tools 各种工具软件，关于工具软件使用的详细信息，请参考第六章“工具软件使用说明”。Support 各种辅助资源，如密码算法库、系统诊断工具。详细内容请参考附录A“密码算法使用说明”。

2.2.1.关于设备驱动程序安装的说明

安装SDK的过程会自动安装精锐IV的设备驱动程序，在一些情况下您可能需要单独安装驱动程序（例如将整个SDK复制到其它计算机中直接使用、发布您的软件），这时候您需要使用SDK中提供的驱动程序安装工具。

该工具位于%SDK%\Drivers目录下，名称为“InstWiz3.exe”。这是一个WIN32可执行程序，可以接受以下命令行参数：

?/INSTALL安装驱动程序（该选项为默认选项）

?/UNINSTALL卸载驱动程序

?/NOGUI不显示安装界面

这些命令行参数可以组合使用，例如，您可以运行“InstWiz3.exe /uninstall /nogui”来隐式卸载设备驱动。

精锐IV开发手册产品安装

注意：InstWiz3.exe不能单独执行，InstWiz3.exe同目录下必须包含mkSetup.dll、language.dll、win98目录、winlh64目录、winlh86目录、winxp64目录、winxp86目录等全部内容，并保持原有的目录结构。

该工具也可以用来检测当前系统中精锐IV设备驱动程序的安装情况：运行InstWiz3.exe，工具将自动检测并汇报驱动程序的安装情况。

有几种办法可以测试驱动程序是否安装成功：

1.插入精锐IV设备，检查硬件设备列表中是否出现正常的Senselock SenseIV v

2.x

设备（“设备管理器”→“智能卡阅读器”下）；对于Windows98、Window2000或更

高版本，如果设备是第一次插入，系统会自动提示“找到新设备”并完成安装；

2.插入精锐IV设备，运行开发测试工具或者用户工具，看是否能成功访问设备；

如果您对设备驱动程序的安装过程非常熟悉，您也可以选择手工的方式安装精锐IV设备驱动。%SDK%\Drivers\Obj目录下面包含了手工安装驱动程序所需要的文件和说明。

如果您希望通过API自己完成设备驱动程序的安装，请参考附录E“设备驱动程序安装API参考”。

精锐IV设备驱动程序已经通过微软徽标认证（Designed for Windows XP），详细情况请连接https://www.360docs.net/doc/f87134301.html,/，并查询产品SenseIV。

2.3.SDK卸载

在“控制面板”→“添加／删除程序”中可以直接卸载SDK，删除SDK的过程会自动删除精锐IV设备驱动程序。

3.开始使用

本章将通过一个范例将向您展示如何向精锐IV内部移植一部分代码，这个范例可以使您大致了解使用精锐IV保护软件的全过程。

完整的范例可以在%SDK%\samples\Developer Manual\Chap3目录下找到。

3.1.示例软件

为了使过程看起来更易于理解，我们选择了一个简单的示例程序：冒泡排序算法。在移植之前，整个软件代码如下：

#include

#include

#include

/*bubble sort function*/

void bubble_sort(unsigned char *p, int len)

{

int i,j;

unsigned char tmp;

for (i=0;i

{

for (j=0;j

{

if (p[j] < p[j+1])

{

tmp = p[j];

p[j] = p[j+1];

p[j+1] = tmp;

}

}

}

}

/*main procedure*/

void main()

{

unsigned char test[] = {4,3,8,2,9,7,1,5,0,6};

int len = sizeof(test);

int i;

bubble_sort(test, len);

printf("result:\n");

for (i=0;i

{

printf("%d ",test[i]);

}

}

在Microsoft Visual C++ 6中新建一个WIN32控制台程序工程（Win32 Console Application），将上述代码添加到VC6工程中。本例中，我们假定将工程保存为C:\s4demo\Win32\demo1.dsp，上述代码保存为C:\s4demo\Win32\pc_demo1.c，编译并运行上面的代码会得到如下输出结果：

result:

9 8 7 6 5 4 3 2 1 0

我们假定软件中的排序算法是一段需要保护的代码，并把它移植到精锐IV的内部。3.2.代码移植

在代码移植之前，您需要选择一款精锐IV支持的编译器，本范例中选用Keil C514。本章节仅对Keil C51编译器软件的配置进行必要的说明，关于编译器软件使用的更详细信息，请参考第五章“编译器使用说明”。

3.2.1.创建一个精锐IV工程

运行Keil μVision，在菜单中选择“Project”→“New Project…”，将该工程命名为“Demo1.uv2”，并保存在磁盘上，本例中假定工程保存为“C:\s4demo\Demo1.uv2”。

接下来μVision会提示您选择设备类型，在“Data Base”列表中选择“Intel”→“8052AH”。现在一个空白的工程就创建完了。为了使该工程能够被精锐IV支持，还需要作一些额外的配置。

在菜单中选择“Project”→“Options for Target ‘Target1’”，在“Target”选项页中，设置“Memory Model”为“Large: variables in XDATA”；切换到“Output”选项页，选中“Create Hex File”。

3.2.2.编写精锐IV代码

现在我们可以向工程中增加移植代码。新建一个C文件，命名为demo1.c，将pc_demo1.c 中的bubble_sort()函数复制到demo1.c中，并增加精锐IV的main()函数，完整的demo1.c 的内容如下：

#include “ses_v3.h”

4本章的范例代码与编译器无关，可以在任何一款精锐IV支持的C编译器上编译通过。

/*bubble sort function*/

void bubble_sort(unsigned char *p, int len)

{

int i,j;

unsigned char tmp;

for (i=0;i

{

for (j=0;j

{

if (p[j] < p[j+1])

{

tmp = p[j];

p[j] = p[j+1];

p[j+1] = tmp;

}

}

}

}

/*EliteIV main procedure*/

void main()

{

unsigned char *test = pbInBuff;

int len = bInLen;

bubble_sort(test, len);

_set_response(len,test);

_exit();

}

上面的代码经编译后可以在精锐IV内部运行。在开始编译工作之前，我们对代码进行简要的解释。

这段代码的功能是：将从PC端接收的数据以及数据长度（字节数），交给精锐IV内的bubble_sort()函数处理，并将处理结果返回给PC。

pbInBuff和bInLen是两个预定义的宏，前者指向通讯缓冲区，即由PC传递来的数据；后者表示所传递数据的长度。

bubble_sort()函数的代码与pc_demo1.c中完全一样，这是精锐IV一个非常重要的特性：支持标准C代码的移植。

_set_response()和_exit()是两个精锐IV系统函数，前者用于将数据传送到PC，后者的功能是从精锐IV应用程序中返回。关于这两个系统函数的更详细说明，请参考第八章“系统函数参考”。

为了方便起见，将demo1.c保存到C:\s4demo目录下。

3.2.3.编译测试精锐IV代码

在修改PC端代码（pc_demo1.c）之前，您可以先编译并测试刚才编写的精锐IV代码。

在刚才创建的工程中，选择菜单“Project”→“Components, Environment and Books”，在对话框中点击“Add Files”将demo1.c添加到工程中；同时，将精锐IV SDK中提供的“Ses51L.lib”添加到工程中5。

选择菜单“Project”→“Build target”编译代码，如果编译成功，将在C:\s4demo 目录下生成demo1.hex文件，该文件就是代码的编译结果。

现在您可以测试或者调试精锐IV代码，关于测试和调试技术的细节，请参考第四章“开发精锐IV代码”和第五章“编译器使用说明”。

3.2.

4.下载代码到精锐IV硬件

将精锐IV2.3版连接到计算机上，运行SDK中提供的的“开发测试工具”（%SDK%\Tools\Devtest.exe），如果正确安装了设备驱动程序，工具将显示所连接设备的ID号（与全球唯一序列号并不一定相同）。点击“重新连接”可以查看硬件的详细信息，如图3-1所示。

图3-1 精锐IV开发测试工具——硬件信息显示

为了测试方便，我们首先将设备重新初始化，点击“重置设备”重建精锐IV内部的文件系统。我们假设将前面编译的demo1.hex文件下载到根目录下，文件ID为0xd001。点击“下载文件”，并按照图3-2填写文件信息。

5建议将ses51L.lib和ses_v3.h两个文件复制到工作目录下，即本例中的C:\s4demo。

图3-2 下载文件到硬件

软件会自动计算所需创建的文件大小，本例中文件至少需要398字节。您也可以输入一个更大的值，这样当文件扩大时，所创建的文件仍然可以使用。如果要往已经存在的文件中写入数据，则需要选中“覆盖原文件”框。

3.2.5.修改PC代码

由于bubble_sort()函数已经被移植到了精锐IV内部，我们在pc_demo1.c中将其注释掉或者删除；同时，将main()函数中对bubble_sort()的调用部分修改为对精锐IV内部代码的调用。修改后的pc_demo1.c内容如下：

#include

#include

#include

#include “sense4.h”

/*bubble sort function removed. Add EliteIV invoking code.*/

void call_sense4(char *, unsigned char *, int);

/*main procedure*/

void main()

{

unsigned char test[] = {4,3,8,2,9,7,1,5,0,6};

int len = sizeof(test);

int i;

call_sense4(“d001”, test, len);

printf("result:\n");

for (i=0;i

{

printf("%d ",test[i]);

}

}

void call_sense4(char *fid, unsigned char *buff, int len)

{

/* See remarks for details.*/

}

红色加粗、大号的文字表示对原内容进行的修改，共三部分：

?增加对精锐IV硬件设备的访问支持，包括头文件(sense4.h)和相应的API函数库(sense4.lib+sense4.dll或sense4st.lib)

?去掉被移植代码在软件中的副本，增加精锐IV调用函数call_sense4()

?增加对精锐IV内部代码的调用，完成被移植代码的功能

为了阅读方便，上面的代码中省略了call_sense4()函数的实现过程，您可以在下面的备注中找到该函数的细节信息。可以看到，main()函数仅有一处修改。

备注：关于call_sense4()函数

在本例中，call_sense4()函数的功能是：运行精锐IV内部ID为0xd001的可执行程序，将test

和len作为输入数据，并将运算结果保存在test中。call_sense4()并不是SDK中提供的通用

API函数，它是对标准API的一组封装，目的是为了提高范例代码的易读性。

事实上，要执行精锐IV内部的可执行程序，标准的访问过程应该是：列举设备→打开指定设

备→选择目录→验证用户口令→执行…→执行→关闭设备→释放资源。我们不建议您在

正式的软件中使用这个函数进行设备访问，关于设备访问的细节和建议方法，请参考第九章“API

参考”和第四章“开发精锐IV代码”。

call_sense4()函数的源代码：

void call_sense4(char *fid, unsigned char *buff, int len)

{

SENSE4_CONTEXT ctx = {0};

SENSE4_CONTEXT *pctx = NULL;

unsigned long size = 0;

unsigned long ret = 0;

S4Enum(pctx, &size);

if (size == 0)

{