中科蓝讯加密狗使用说明

目录

1. 加密狗授权方式与环境说明

1.1 授权方式及云授权介绍

1.1.1 授权私钥配置

1.1.2 授权下载限制

1.1.3 授权功能 key

1.1.4 云授权功能

1.2 授权环境

2. 授权私钥配置使用介绍

2.1 授权方式说明

2.2 加密狗授权方案环境准备

2.2.1 软件更新

2.2.2 Downloader 使用加密狗的介绍

2.3 SDK中的配置

2.3.1 app.xm文件中填入识别码

2.3.2 SDK中实现密钥1的接口

2.3.3 SDK中读取soft_key变量

2.4 加密狗授权烧录

2.4.1 导出prd生产文件

2.4.2 授权烧录

3. 授权下载限制使用介绍

3.1 次数限制方案

3.2 加密狗授权方案环境准备

3.2.1 软件更新

3.2.2 Downloader使用加密狗的介绍

3.3 SDK中的配置

3.3.1 app.xm文件中填入私钥

3.4 加密狗授权烧录

3.4.1 导出PRD生产文件

3.4.2 授权烧录

4. 云授权使用说明

4.1 客户端（申请人）操作说明

4.1.1 加密狗申请授权

4.1.2 加密狗获取授权

4.2 算法公司（加密狗信息持有人）端操作说明

4.2.1 授权文件生成

4.2.2 服务器授权文件添加

4.2.3 服务器授权

---

1. 加密狗授权方式与环境说明

1.1 授权方式及云授权介绍

1.1.1 授权私钥配置

在起到次数限制（每颗芯片下载会扣减次数，同一颗芯片多次下载只扣减第一次）的同时，还能将用户自定义的私钥数据下载进芯片，这种授权方式对芯片规格有要求，需要有额外的 flash 安全储存空间，安全性要求较高可以使用。

1.1.2 授权下载限制

可以实现下载次数限制（每次下载都会扣减次数，同一颗芯片反复下载每次都会扣减），对芯片规格无要求，但目前程序设置了下载限制功能后无法导出upd文件和fot文件，后续如果有使用相关文件进行升级需求的客户不可使用此方式。

1.1.3 授权功能 key

可以实现下载次数限制，对芯片添加功能限制，仅由蓝讯内部使用。

1.1.4 云授权功能

可以对加密狗进行云授权。以上多种授权方式都可以在线上服务端进行授权，便于加密狗信息持有者远程给其他人进行授权。

以上功能请自己选择合适的方式进行授权使用，后文会对以上多种授权方式及云授权功能进行详细使用说明

1.2 授权环境

Downloader 版本：v3.0.7 以上(包含 v3.0.7)     支持单授权加密狗

                              v3.3.0 以上(包含 v3.3.0)     支持多授权加密狗

加密狗版本：v0.1.5 以上(包含 v0.1.5) 单授权版本

v0.2.0以上(包含 v0.2.0)是多授权版本，一个加密狗可以存放10个授权信息

注意：v0.2.0、v0.2.1版本是测试版本，存在问题，v0.2.0不可使用、v0.2.1的9号授权位不可使用，否则会导致校验出错。使用前需要跟蓝讯开发人员确认相关的烧录器是否已经支持多授权加密狗功能，并且加密狗版本只能向上升级无法回退版本

1 拖 4 烧录器版本：v260 以上(包含 v260)支持单授权加密狗，是否支持多授权加密狗请与相关负责人员确认

1 拖 8 烧录器版本：v122 以上(包含 v122)支持单授权加密狗，是否支持多授权加密狗请与相关负责人员确认

2. 授权私钥配置使用介绍

2.1 授权方式说明

中科蓝讯加密狗私钥配置授权方案主要用于第三方算法授权，通过的密钥计算大致如下图所示。

​​​​​​图 2.1.1 密钥生成流程

私钥保存在加密狗中，用于授权使用的，请给有授权权限的人员进行保管。

私钥使用SHA-256算法，生成密钥1，密钥1是写在SDK中。

密钥1加上FLASH UUID盐之后，同样通过SHA-256算法，生成密钥2，密钥在授权烧录时写入芯片程序的配置中。

识别码是由私钥经过哈希算法生成的4byte数据，用于快速识别和验证。

以上的私钥、密钥1、密钥2请由对应人员妥善保管，尤其是私钥。若是丢失了私钥或者密钥，原厂也无法找回。

在授权烧录时，Downloader/烧录器首先会检查PRD生产文件和加密狗的识别码是否一致，若两者不一致则无法进行烧录和授权。开始烧录时，烧录器会读取芯片的信息，判断是否已经有授权。若是已经授权的，会判断芯片的识别码与PRD文件的识别码是否一致，若两者一致，则不消耗加密狗的授权次数；若两者不一致，则视为新的程序授权，会消耗加密狗的授权次数。

SDK中，芯片在上电之后，会进行密钥的校验，读取芯片FLASH的UUID和SDK中的密钥1，计算生成密钥2，再和FLASH 配置区中保存的密钥2进行比较，若两者一致则会正常上电，否则就是一直复位。

图 2.1.2加密狗授权烧录流程图

2.2 加密狗授权方案环境准备

2.2.1 软件更新

RV32-Toolchain工具链更新至v1.3.5版本或以上。

downloader更新至v3.0.7版本或以上（说明书所用配图为历史配图，版本号不作为参考）。downloader分为授权版和普通版。授权版downloader请给有授权权限的工程师使用。授权版可以对加密狗进行授权，普通版的只能读取加密狗信息和使用加密狗进行烧录，无法进行授权。

图 2.2.1 Downloader软件版本

2.2.2 Downloader 使用加密狗的介绍

以下介绍中的图片中显示的私钥、密钥1、识别码等信息，以及SDK中默认的识别码和密钥，仅作示例参考的，实际使用中请务必修改。加密狗实物图片如下：

图 2.2.2 加密狗实物

打开加密狗界面：将加密狗插入电脑USB，打开Downloader的USB功能，此时会在上方菜单栏显示“加密狗”。其中，授权版有“信息”、“授权”和“升级”三个功能。

图 2.2.3 Downloader软件加密狗界面

升级加密狗固件：第一次使用加密狗时，建议点击“升级”，将加密狗的固件升级到最新版本。

读取加密狗信息：点击“信息”时，会弹出加密狗的授权信息界面。

图 2.2.5 加密狗授权信息

加密狗授权私钥配置：注意只有授权版的Downloader才会有加密狗授权功能，普通版只有申请授权和获取授权。

点击“授权“，会打开加密狗授权的界面。以下图片中显示的私钥、密钥1、识别码等信息，仅作示例参考的，实际使用中需要自己生成。下面实例中介绍的是授权私钥配置选项

图 2.2.6 加密狗授权私钥配置