K230 SDK 更新nncase运行时库指南

nncase运行时库版本问题说明

1. kmodel 版本说明

由于 kmodel中没有包含nncase的版本信息，因此无法直接判断 kmodel是由哪个版本的nncase生成。需自行进行版本信息管理，以下两种方式可供参考：

• 保留完整的编译工程(校正集，参数配置)，便于使用任意nncase版本生成 kmodel。

• 通过 kmodel的名字进行版本区分，示例代码如下：

  with open("test.kmodel", "wb") as f:
      f.write(kmodel)
  
  # 将上面代码替换为以下内容
  import _nncase
  with open("test_{}.kmodel".format(_nncase.__version__), "wb") as f:
      f.write(kmodel)
  

2. 版本不兼容问题

由于nncase各版本之间可能存在不兼容的情况，而SDK中的nncase运行时库版本可能与编译 kmodel时使用的nncase版本不一致，从而导致上板推理时出现异常。因此最好在上板推理前，检查两者的版本是否匹配。

有以下两种方式可供确认版本信息是否匹配：

• 通过版本对应关系表查询。

• 通过镜像名字确定两者的版本，例如 k230_canmv_sdcard_v1.4_nncase_v2.8.0.img.gz，其中 v1.4 表示 SDK 版本，v2.8.0 表示 nncase 版本，即SDK-v1.4可以推理nncase-v2.8.0编译生成的 kmodel。 镜像可通过嘉楠开发者社区获取。

3. 版本不兼容解决办法

1. 与SDK版本对齐 在确定好需要的nncase版本后，使用 pip进行安装，具体参考nncase install。

2. 与nncase版本对齐 在nncase release界面下载与编译 kmodel时nncase版本一致的运行时库，例如，”nncase_k230_v2.8.0_runtime.tgz”即为nncase-2.8.0的运行时库。之后按照以下步骤进行SDK中nncase运行时库版本更新：

   #0. 准备工作
   git clone https://github.com/kendryte/k230_sdk.git
   cd k230_sdk
   PATH_TO_K230_SDK=`pwd`
   make prepare_sourcecode
   # 注意检查该命令执行后是否存在以下文件夹
   # src/big/nncase/riscv64/nncase/
   
   #1. 解压nncase_k230_v2.8.0_runtime.tgz
   tar -xf nncase_k230_v2.8.0_runtime.tgz
   
   #2. 替换nncase运行时库
   cp -r nncase_k230_v2.8.0_runtime/* $PATH_TO_K230_SDK/src/big/nncase/riscv64/nncase/
   
   #3. 检查nncase运行时库版本是否正确更新
   cat $PATH_TO_K230_SDK/src/big/nncase/riscv64/nncase/include/nncase/version.h | grep NNCASE_VERSION
   > #define NNCASE_VERSION "2.8.0"
   

至此，SDK中的nncase运行时库版本已更新为nncase-2.8.0。如果需要更换其他版本，下载好对应版本的运行时库，按照上述步骤进行更新即可。