引言
D1 是全志科技首款基于 RISC-V 指令集的 SoC，主核是来自阿里平头哥的 64 位的 玄铁 C906。「哪吒」开发板 是全志在线基于全志科技 D1 芯片定制的 AIoT 开发板，是目前还比较罕见的使用 RISC-V SoC 且可运行 GNU/Linux 操作系统的可量产开发板。
ncnn 是腾讯优图实验室推出的一个为移动端极致优化的高性能神经网络前向计算框架，是目前同样也比较罕见的为 RISC-V 架构做过适配和优化的神经网络框架。
本文 是一份教程，步骤骑着步骤 (step by step) 地展示了如何在一块全新的全志 D1「哪吒」开发板上，跑个 ncnn 神经网络推理框架的 demo。
本文的完成参考了以下材料，非常感谢 nihui、BedRock 等开发者们在互联网上的分享！
[1] D1 哪吒 - 在线文档
[2] nihui: 在全志d1开发板上玩ncnn
[3] 腾讯优图ncnn新版本适配国产CPU，全志D1加持最高速度提升70倍！
目录
- 引言
- 必要的材料
- 上电！
- 重刷固件
- 安装并配置交叉编译工具链
- 编译 ncnn，并准备 demo 程序
- 使用 ADB 传输文件
- 运行 demo
1、必要的材料
- 「哪吒」开发板
- Type-C USB 线
- USB 转 TTL 转换器
- 安装有 GNU/Linux 或较新版本的 Windows 10 / 11 的可联网电脑
（本文以 Windows 10 的电脑为例来展示）
2、上电
取出哪吒和 USB 转 TTL 转换器，先把转换器按下图所示接上 DEBUG 端口，再将转换器插入电脑的 USB 口。如果电脑没有识别到串口，可能是因为没有安装转换器的驱动程序，可以在 这里 下载。
在使用开发板自带的固件时，DEBUG 端口会在开发板上电后通过 115200 波特率的 UART 串口来提供一个 Shell，我们可以使用 PuTTY、MobaXterm 或者其它类似的终端模拟器访问这个串口来在 Shell 中操作开发板。（如果使用 PuTTY，可以参考下图来设置）
启动终端模拟器后，暂时只能看到个黑框，因为开发板还没上电。
找出 Type-C USB 线，将开发板的 OTG 接口与电脑相连即可上电（虽然连 POWER 也可以，但是后边一直需要使用这个 OTG 接口，所以推荐连接它）。上电后可发现，开发板上的灯亮了，而且终端模拟器中开始一条条地冒出各种提示了！大概 10 ~ 20 秒后，根据一行按下回车的提示，在终端模拟器中按下回车，即可进入如下图所示的界面，然后就可以执行各种 GNU/Linux 命令了。
3、重刷固件
新开封的开发板里边自带的固件是基于 Open v1.0 版本的 D1 Tina SDK 编译的，在运行 ncnn 程序时会发生非法指令错误 (参考 这里)，根据全志在线开发者论坛中网友 BedRock 的评论，我们可将固件更新为基于 Open v1.01 版本的 SDK 编译的固件再进行后续的步骤。
如果想自己编译固件或者修改固件，可以参考 D1 文档中的 “Tina SDK版本” 部分 下载 SDK。当然，如果只想先跑个 ncnn 玩玩看的话，我们可以直接在 “固件下载” 选择一款全志原厂为我们准备好的固件，比如我可以选择 D1哪吒HDMI测试固件20210804（开机HDMI就有小企鹅启动logo） (名字有点长) 为例。这个固件估计是为展示 HDMI 输出功能而设计的，我们给开发板用 HDMI 线接上个屏幕就能看到个小企鹅，但是因为它是基于 v1.01 SDK 编译的，所以我们刚好也能用它来跑 ncnn 的 demo。
下载好 .img 固件文件后，参考 D1 文档中 “编译与烧写” 的 “烧写” 部分 ，下载 全志USB驱动，使用管理员权限运行 install.bat 安装驱动，再安装烧写软件进行操作，即可将固件烧写进开发板。比如，在 Windows 电脑中我们要下载 PhoenixSuit 软件来烧写固件。要注意的是，在烧写软件中要选择 “全盘擦除升级”，如下图所示，否则无法成功烧写。
烧写成功后，重新上电即可。
4、安装并配置交叉编译工具链
注意：第 4 节和第 5 节的操作需要在 GNU/Linux 操作系统下进行。如果你的电脑装有 GNU/Linux 操作系统、或者可使用虚拟机，可直接在 GNU/Linux 操作系统中进行操作。如果你的电脑装的是较新版本的 Windows 10 / 11，也可以上网搜索相关教程安装并配置个 WSL (Windows Subsystem Linux)，然后在 WSL 中进行操作。
在平头哥芯片开放社区的 “资源下载” 页面，我们可以在 “工具链-900系列” 中找到 V2.0.1 版本的 riscv64-linux-x86_64-20210512.tar.gz，下载它到电脑里，放到 <自己想放的路径>，解压它
tar -xf riscv64-linux-x86_64-20210512.tar.gz
解压完成后，使用 vim 或者其它文本编辑器，打开 ~/.bashrc，在结尾添加工具链的路径至环境变量，即下列内容
# My PATH
export RISCV_ROOT_PATH=/<自己想放的路径>/riscv64-linux-x86_64-20210512
保存并关闭编辑器，然后使用 source 命令刷新 Shell 环境：
source ~/.bashrc
就安装并配置好交叉编译工具链了。
5、编译 ncnn，并准备 demo 程序
在 GitHub 上下载 2021 年 7 月 20 日 Release 的 ncnn 的源代码（Source code）到电脑里，比如 ncnn-20210720.tar.gz，解压，然后进入 ncnn-20210720 目录，准备并开始编译
mkdir build-c906
cd build-c906
cmake -DCMAKE_TOOLCHAIN_FILE=../toolchains/c906.toolchain.cmake -DCMAKE_BUILD_TYPE=relwithdebinfo -DNCNN_OPENMP=OFF -DNCNN_THREADS=OFF -DNCNN_RUNTIME_CPU=OFF -DNCNN_RVV=ON -DNCNN_SIMPLEOCV=ON -DNCNN_BUILD_EXAMPLES=ON ..
make -j32
编译大概需要几分钟，完成后，可在 build-c906 目录中找到编译好的所有文件。
我们可先尝试两个 demo，分别为：
① 使用 benchncnn 做基准测试
② 使用 NanoDet 模型对一张自己的图片做目标检测（NanoDet 是个可在移动端超快运行的超轻量目标检测模型）
为了方便后续将文件传输进开发板，我们可先在电脑上创建 benchncnn_demo 和 nanodet_demo 两个文件夹，将 ① 和 ② 所需的文件分别都放进去准备好。
对于 ①，我们把 ncnn 目录中的 build-c906/benchmark/benchncnn 和 benchmark/*.param 复制进去即完成准备。
对于 ②，我们需要把 ncnn 目录中的 build-c906/examples/nanodet 复制进去，在 ncnn-assets中下载 nanodet_m.bin 和 nanodet_m.param 两个文件放进去，再放入一张你想检测的图片即可。
即，两个目录的结构分别是类似这样的：
benchncnn_demo/
├ benchncnn
├ alexnet.param
├ blazeface.param
└ <一大堆其它模型的 param>nanodet_demo/
├ nanodet
├ nanodet_m.bin
├ nanodet_m.param
└ <你想检测的图片>
6. 使用 ADB 传输文件
ADB 是 Android Debug Bridge，原本为 Android 设计，全志给 Tina Linux 也做了适配，所以我们可以使用 ADB 来调试 Tina Linux 的设备。参考 D1 文档中的 “研发生产工具” 部分 可以下载，下载完成后，将其路径加入环境变量即可使用。
我们在跑这两个 demo 时，可能暂时只需要用到以下几个命令，如果需要使用其它功能也可上网搜索相关教程。
检查设备与电脑的连接情况，可以使用
adb devices
adb push 可以把电脑上的文件或文件夹传给开发板，使用语法如下
adb push <电脑上的文件路径> <开发板上的目标路径>
adb pull 可以把开发板上的文件或文件夹传给电脑，使用语法如下
adb pull <开发板上的文件路径> <电脑上的目标路径>
要注意的是，开发板上的路径都需要填写绝对路径。
7、运行 demo
把第 5 节所示的类似 benchncnn_demo 和 nanodet_demo 的文件夹通过 adb push 命令传进开发板，在开发板上进入 benchncnn_demo 目录，再输入
./benchncnn 4 1 0 -1 0
可开始做基准测试。如果成功运行即可慢慢看到类似下图这样的提示，展示了当前平台运行 ncnn 使用各种模型推理一帧所需的毫秒耗时。
（如果不想等测试慢慢跑完，也可以按 Ctrl + C 停止运行）
在开发板上进入 nanodet_demo 目录，再输入
./nanodet <你想检测的图片>
即可使用 NanoDet 对这张图片目标检测。运行完成后，可在命令行中看到文字版的检测结果，也可以使用 adb pull 把生成的 image.png 图片文件传给电脑再打开查看，上边会画好边界框、类别和置信度。比如这是它检测出的南京市长 江大桥上边的车车车车。
到了这里，我们就成功在一块运行 GNU/Linux 系统的 RISC-V 开发板上跑了个神经网络框架的 demo，如果想进行后续的实验或研发，可以了解有关 D1 哪吒 和 ncnn 的更多内容。
