rt-thread/bsp/k210/README.md

129 lines
5.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Kendryte K210板级支持包说明
## 1. 简介
Kendryte K210 是集成机器视觉与机器听觉能力的系统级芯片(SoC)。使用台积电 (TSMC) 超低功耗的 28 纳米先进制程具有双核64位处理器拥有较好的功耗性能稳定性与可靠性。该方案力求零门槛开发可在最短时效部署于用户的产品中赋予产品人工智能。
Kendryte K210 定位于AI与IoT市场的SoC同时是使用非常方便的MCU。
Kendryte中文含义为勘智而勘智取自勘物探智。这颗芯片主要应用领域为物联网领域在物联网领域进行开发因此为勘物这颗芯片主要提供的是人工智能解决方案在人工智能领域探索因此为探智。
* 具备机器视觉能力
* 具备机器听觉能力
* 更好的低功耗视觉处理速度与准确率
* 具备卷积人工神经网络硬件加速器KPU可高性能进行卷积人工神经网络运算
* TSMC 28nm先进制程温度范围-40°C到125°C稳定可靠
* 支持固件加密,难以使用普通方法破解
* 独特的可编程IO阵列使产品设计更加灵活
* 低电压,与相同处理能力的系统相比具有更低功耗
* 3.3V/1.8V双电压支持,无需电平转换,节约成本
芯片规格包括如下:
| 硬件 | 描述 |
| -- | -- |
|芯片型号| K210 |
|CPU| 双核RV64GC |
|主频| 400MHz |
|片内SRAM| 8MB |
| 外设 | 内嵌AES与SHA256算法加速器 |
| | DVP、JTAG、OTP、FPIOA、GPIO、UART、SPI、RTC、I²S、I²C、WDT、Timer与PWM |
## 2. 编译说明
编译 K210需要有 RT-Thread 的代码,因为 K210 的 sdk 是以软件包方式,所以需要在 bsp/k210 下做软件包更新。注意,需要使用 latest 的 RT-Thread 源码和 Latest 的软件包软件包在menuconfig中的配置路径如下:
```
RT-Thread online packages --->
peripheral libraries and drivers --->
Kendryte SDK --->
[*] kendryte K210 SDK
```
最新的 k210 SDK 使用了 C++17 编写了部分代码,因此需要打开 C++ 组件C++组件在menuconfig中的配置路径如下
```
RT-Thread Components ---> C++ features
```
Windows下推荐使用[env工具][1]然后在console下进入bsp/k210目录中运行
cd bsp/k210
menuconfig # 在软件包中选择最新的 k210 SDK
pkgs --update
如果在Linux平台下可以先执行
scons --menuconfig
它会自动下载env相关脚本到~/.env目录然后执行
source ~/.env/env.sh
cd bsp/k210
pkgs --update
下载risc-v的工具链[下载地址](https://github.com/xpack-dev-tools/riscv-none-embed-gcc-xpack/releases)
更新完软件包后,在`rtconfig.py`中将risc-v工具链的本地路径加入文档。
注:
1. 工具链建议使用上方提供的,`kendryte的官方工具链`会报浮点类型不兼容的错误,`risc-v工具链8.2.0之前的版本`会出现头文件不兼容的问题。
2. 网上传需要开启C++ 17,认为k210的神经网络编译器nncase多数语法由C++ 17,故需要开启C++ 17。个人认为没有必要nncase是在PC端独立使用的
作用是将神经网络模型转为kmodel格式此格式文件为已经编译的二进制文件。[shentalon](13212105191@163.com)注)
然后执行scons编译
```
set RTT_EXEC_PATH=C:\Users\xxxx\Downloads\xpack-riscv-none-embed-gcc-10.2.0-1.2\bin
scons
```
来编译这个板级支持包。
或者通过 `scons --exec-path="GCC工具链路径"` 命令,在指定工具链位置的同时直接编译。
如果编译正确无误会产生rtthread.elf、rtthread.bin文件。其中rtthread.bin需要烧写到设备中进行运行。
如果初次使用编译报错可能是使用的SDK过老使用`menuconfig`命令,在→ RT-Thread online packages → peripheral libraries
and drivers → the kendryte-sdk package for rt-thread中将SDK改为latest版本即可。
## 3. 烧写及执行
连接好串口,然后使用[K-Flash](https://kendryte.com/downloads/)工具进行烧写bin文件。
![K-Flash](images/flash.png)
### 3.1 运行结果
如果编译 & 烧写无误当复位设备后会在串口上看到RT-Thread的启动logo信息
![terminal](images/k210.png)
如果是K210-test_v0.2开发板,可以用如下命令来打开串口:
python -m serial.tools.miniterm --rts 0 --dtr 0 COM9 115200
## 4. 驱动支持情况及计划
| 驱动 | 支持情况 | 备注 |
| ------ | ---- | :------: |
| UART | 支持 | 高速UART用于shell |
## 5. 联系人信息
维护人:[bernard](https://github.com/BernardXiong)
## 6. 注意事项
在进行系统menuconfig配置时以下项是必选的
| 配置项 | 强制配置值 |
| ----- | --------- |
| Alignment size for CPU architecture data access | 8 |
| The stack size of idle thread | > 1024 |
| the device name for console | "uarths" |
| Set main thread stack size | 4096 |
## 7. 参考
* 芯片[datasheet][2]
[1]: https://www.rt-thread.org/download.html#download-rt-thread-env-tool
[2]: https://s3.cn-north-1.amazonaws.com.cn/dl.kendryte.com/documents/kendryte_datasheet_20180919020633.pdf