干货分享 | 一文了解TSMaster中Seed&key的两种处理方法

在UDS诊断过程中，会涉及到安全访问的问题，也就是常说的Seed&Key。TSMaster中提供了两种 Seed&Key 的处理方法：第一种是直接加载DLL文件；第二种是直接在TSMaster的编译器中直接添加安全算法。

一、加载外部 Seed&Key DLL

TSMaster 诊断模块支持通过 dll 载入 Seed&Key 算法，该算法 dll 跟主流工具的计算接口兼容，接口定义如下图所示：

DLL 加载界面如下图所示：

【1】 加载 DLL

【2】 删除 DLL

【3】 DLL 校验器，通过此按钮，用户可以判断自己加载的 dll 接口是否正确，算法是否符合设计要求。如下图所示：

如上图所示界面，用户选择 Seed 的 Level 过后，输入 Demo Seed 值，点击 GenKey 进行判断。如果该 DLL 接口跟模板定义接口统一，则会输出提示信息：Generate Key Success，然后用户根据 Key 值跟目标值对比，进一步确认DLL 中的算法是否符合设计要求。

【4】 打开 TSMaster 安装目录下 Seed&Key 接口工程所在的路径。用户可以拷贝该工程添加自己的 Seed&Key 算法。

“

默认SeedKey函数接口

目前，要想被 TSMaster 的诊断模块直接加载，该 DLL 必须实现如下三种函数接口中的一种：

【1】 接口 1：

unsigned int GenerateKeyEx(

const unsigned char* ipSeedArray, /* Array for the seed [in] */

unsigned int iSeedArraySize, /* Length of the array for the seed [in] */

const unsigned int iSecurityLevel, /* Security level [in] */

const char* ipVariant, /* Name of the active variant [in] */

unsigned char* iopKeyArray, /* Array for the key [in, out] */

unsigned int iMaxKeyArraySize, /* Maximum length of the array for the key [in] */

unsigned int& oActualKeyArraySize); /* Length of the key [out] */

【2】 接口 2：

unsigned int GenerateKeyExOpt(

const unsigned char* ipSeedArray, /* Array for the seed [in] */

unsigned int iSeedArraySize, /* Length of the array for the seed [in] */

const unsigned int iSecurityLevel, /* Security level [in] */

const char* ipVariant, /* Name of the active variant [in] */

const char* iPara, /* */

unsigned char* iopKeyArray, /* Array for the key [in, out] */

unsigned int iMaxKeyArraySize, /* Maximum length of the array for the key [in] */

unsigned int& oActualKeyArraySize) /* Length of the key [out] */

【3】 接口 3：

bool ASAP1A_CCP_ComputeKeyFromSeed(

const unsigned char* ipSeedArray, /* Array for the seed [in] */

unsigned short iSeedArraySize, /* Length of the array for the seed [in] */

unsigned char* iopKeyArray, /* Array for the key [in, out] */

unsigned short iMaxKeyArraySize, /* Maximum length of the array for the key [in] */

unsigned short* opSizeKey) /* Length of the key [out] */

用户的 DLL 只要实现了上述任意一种函数接口，即可直接加载到 TP 层模块中。如果出现加载失败，主要检查如下情况：

1. 是否用 Release 模式发布，如果是 Debug 模式，常常会有以上失败的情况出现。

2. 是否采用 x86 平台发布，目前 TSMaster 为支持 X86 的版本，用来调试的 DLL 也必须为X86 模式。

“

如何兼容其他函数接口

日常使用中，经常出现用户已经开发好了 dll，如果该 dll的接口不是上述三种中的任何一种，就无法直接加载到 TSMaster 的诊断模块中。对于这种情况，推荐采用如下方案来解决此问题：

下面以一个实际的实例来讲解如何兼容用户现有的 DLL 文件。

1. 用户现有的 DLL，名称为 UserSeedKey.dll。该函数内部的 API 函数有：

➢ Seed 等级为 1 的时候，调用函数 void GetKeyFromSeed01(byte* ASeed, byte* AKey)；

➢ Seed 等级为 3 的时候，调用函数 void GetKeyFromSeed03(byte* ASeed, byte* AKey)；

➢ Seed 等级为 11 的时候，调用函数 void GetKeyFromSeed11(byte* ASeed, byte* AKey)；

该 dll 不支持上述默认加载接口，无法直接加载到 TSMaster 中使用。因此，需要把这些 DLL 再包装一层，才能载入到 TSMaster 的诊断模块中。

2. 选择 TSMaster 安装目录中提供的 GenerateKeyEx 的模板工程，在该工程中调用上述 DLL的函数接口。基本思路是：

➢ 采用 Loadlibrary 动态用户现有的 dll。

➢ 根据传入的 Level 参数，采用 GetProcAddress 函数动态获取实际的用于计算 Key 的函数指针。

➢ 如果获取函数指针成功，则使用该函数指针传输 Seed 值，并计算对应的 Key 值。

详细调用示例函数如下图所示：

3. 该 GenerateKeyEx 工程开发结束后，TSMaster 直接加载 GenerateKeyEx 所在的 dll。需要注意的是，用户需要把现有的UserSeedKey.dll 拷贝到TSMaster 根目录或者GenerateKeyEx.dll 所在的目录。如果不拷贝过去，GenerateKeyEx.dll 执行的时候会出现找不到对应依赖 dll 的情况，解锁失败。

总结： 

在 TSMaster 安装目录中，提供了封装 Seed&Key 算法的模板工程。如 GenerateKeyEx，GenerateKeyExOpt ASAP1A_CCP_ComputeKeyFromSeed，用户基于此模板工程开发即可得到能够直接加载的 dll 函数。

同时，也提供了二次封装的 dll 的工程，比如 GenerateKeyEx_Wrapper_Demo，该工程演示了如何基于已经存在的 SeedKey 算法库进行包装，生成可以直接加载到 TSMaster 诊断模块中的 dll 的过程。

二、采用内置的算法编辑器

基本步骤如下所示：

注意事项：

【1】 算法函数的接口，TSMaster 目前提供了最常用的接口形式，如果用户有自己特殊的接口形式，无法覆盖住，请联系上海同星把此接口增加到选项中。

【2】 所有的接口函数都定义了返回值 s32。增加此约束，主要是增加函数的严谨性。返回值为 0 表示成功，为其他值则有对应的错误码。用户在编辑代码的时候，最后一行一定不要忘了输入返回值，否则系统执行函数过后，会认为算法执行失败，不予往后面执行。如下所示：

【3】 添加算法过后，点击 OK 退出。TSMaster 内置编译器会自动解释该算法，并准备好在执行诊断的过程中使用。