# RKNPU

本工程主要为Rockchip NPU提供驱动、示例等。



## 适用平台

- RK1808/RK1806

- RV1109/RV1126

    

**注意：**    

- **RK3399Pro用户态的库及驱动不在本工程**，请参考：https://github.com/airockchip/RK3399Pro_npu
- RK3566/RK3568/RK3588/RV1103/RV1106请参考：https://github.com/rockchip-linux/rknpu2



## RKNN Toolkit

​    在使用RKNN API进行部署之前，需要使用RKNN Toolkit将原始的模型转化成rknn模型。

- RK1808/RK1806/RV1109/RV1126/RK3399Pro 使用： https://github.com/rockchip-linux/rknn-toolkit
- RK3566/RK3568/RK3588/RV1103/RV1106使用：https://github.com/rockchip-linux/rknn-toolkit2

​    具体的使用说明请参考相应的网址。



## NPU驱动说明

### NPU驱动目录说明

NPU的驱动在$SDK/external/rknpu/drivers/目录下或者https://github.com/rockchip-linux/rknpu/tree/master/drivers

其中的编译、安装规则参考$SDK/buildroot/package/rockchip/rknpu/rknpu.mk

主要目录包括：

```
drivers/
├── common
├── linux-aarch64
├── linux-aarch64-mini
├── linux-armhf
├── linux-armhf-mini
├── linux-armhf-puma
├── linux-armhf-puma-mini
├── npu_ko
```

- linux-aarch64：RK1808 full driver

- linux-aarch64-mini: RK1808 mini driver

- linux-armhf: RK1806  full driver

- linux-armhf-mini: RK1806 mini driver

- linux-armhf-puma: RV1109/RV1126  full driver

- linux-armhf-puma-mini: RV1109/RV1126 mini driver

- npu_ko：NPU内核驱动KO

    在更新驱动时，需要同时更新用户态驱动及内核驱动，不然会产生类似错误:

    ```
    [ 1] HAL user version 6.4.6.5.351518
    [ 2] HAL kernel version 6.4.6.5.351518
    ```

    另外，npu ko与内核配置强相关，有可能会加载不成功，运行程序时，会产生类似错误：
    
    ```
    [ 1] Failed to open device: No such file or directory, Try again...
    [ 2] Failed to open device: No such file or directory, Try again...
    ```
    
    遇到这种情况需要联系开发团队解决。
    
    

### NPU full driver与mini driver的区别

主要包含以下几点：

- Mini driver只支持预编译的rknn模型，如果跑非预编译模型，会出现 RKNN_ERR_MODEL_INVALID的错误，从1.6.0开始，会返回RKNN_ERR_NON_PRE_COMPILED_MODEL_ON_MINI_DRIVER的错误;

- Full driver支持RKNN Toolkit的联机调试功能，mini driver不支持；

- Mini driver 库大小比full driver小很多，以RV1109/RV1126 1.6.0驱动为例，full driver大小为87MB，mini driver大小为7.1MB，可以有效的节省flash大小。

- Mini driver库运行时占用的内存比full driver小。

    

### 手动更新NPU驱动

有时需要手动更新NPU驱动，只要将相关的驱动拷贝到对应的目录就可以。

- 更新RK1808的驱动：

```
adb push drivers/linux-aarch64/   /
adb push drivers/npu_ko/galcore.ko /lib/modules/galcore.ko
```

- 更新RK1808 mini driver：

```
adb push drivers/linux-aarch64-mini/   /
adb push drivers/npu_ko/galcore.ko /lib/modules/galcore.ko
```
- 更新RV1109/RV1126的驱动：

```
adb push drivers/linux-armhf-puma/   /
adb push drivers/npu_ko/galcore_puma.ko /lib/modules/galcore.ko
```

- 更新RV1109/RV1126 mini driver：

```
adb push drivers/linux-armhf-puma-mini/   /
adb push drivers/npu_ko/galcore_puma.ko /lib/modules/galcore.ko
```

注意：adb不同版本的默认行为不一样，有些是直接push目录的，有些是push目录下的文件。因此替换完后，需要检查一下相关的库是否已经替换成功。比如通过md5sum检查对应文件的md5值是否相同。部分板子不支持adb命令，请通过ssh等其他方式拷贝文件到对应目录即可。

**另外，toybrick可能对文件路径进行了调整，因此最好通过toybrick自带的方式进行更新。**



## librknn_api与librknn_runtime的区别

librknn_api是对librknn_runtime的封装，主要是为了减少对其他so的编译依赖，功能上并没有区别。检查驱动版本时，一般以librknn_runtime.so为准。