rt-thread/bsp/cvitek/cv18xx_aarch64/README.md

136 lines
4.6 KiB
Markdown
Raw Normal View History

# Milkv-Duo256M 板级支持包说明
## 1. 简介
Milk-V Duo 256M 是 Duo 的升级版本,内存提升至 256M满足需要更大内存容量的应用。采用 SG2002 计算系列芯片,计算能力提升至 1.0TOPS@INT8。它可以实现 RISC-V/ARM 架构之间的无缝切换,并支持双系统同时运行。此外,它还包含 SPI、UART 等一系列丰富的 GPIO 接口,适合边缘智能监控领域的各种硬件开发,包括 IP 摄像头、智能猫眼锁、可视门铃等。
该板级支持包主要是针对**ARM架构的大核**实现的一份移植支持RT-Thread标准版和Smart版内核。
## 2. 编译说明
推荐使用ubuntu20的[env环境](https://github.com/RT-Thread/env)当然也可以使用windows上的[env工具](https://www.rt-thread.org/download.html#download-rt-thread-env-tool)进行编译。下面介绍**标准版**和**Smart版本**的编译流程。
### 2.1 RT-Thread编译
**1.menuconfig配置工程**
该BSP默认menuconfig支持的就是RT-Thread标准版无需配置工程。
**2.配置工具链相关环境:**
依次执行下面命令进行环境变量的相关配置:
```shell
export RTT_CC=gcc
export RTT_EXEC_PATH="/opt/tools/gnu_gcc/arm-gnu-toolchain-13.2.Rel1-x86_64-aarch64-none-elf/bin"
export RTT_CC_PREFIX=aarch64-none-elf-
export PATH=$PATH:$RTT_EXEC_PATH
```
**3.编译:**
```shell
scons -j12
```
### 2.2 RT-Smart编译
**1.menuconfig配置工程**
```shell
RT-Thread Kernel --->
[*] Enable RT-Thread Smart (microkernel on kernel/userland)
```
**2.配置工具链相关环境:**
依次执行下面命令进行环境变量的相关配置:
```shell
export RTT_CC=gcc
export RTT_EXEC_PATH="/opt/tools/gnu_gcc/aarch64-linux-musleabi_for_x86_64-pc-linux-gnu/bin"
export RTT_CC_PREFIX=aarch64-linux-musleabi-
export PATH=$PATH:$RTT_EXEC_PATH
```
**3.编译:**
```shell
scons -j12
```
如果编译正确无误,会产生 `rtthread.elf`, `rtthread.bin` 文件。
## 3. 运行
### 3.1 uboot加载rtthread.bin
1. 将 SD 卡分为 2 个分区,第 1 个分区用于存放 bin 文件,第 2 个分区用于作为数据存储分区,分区格式为 `FAT32`
2. 将bsp的boot目录下的 `fip.bin` 和编译生成的 `rtthread.bin` 复制 SD 卡第一个分区中。后续更新固件只需要复制 `rtthread.bin` 文件即可。
配置**串口0**参数: 115200 8N1 ,硬件和软件流控为关。
进入uboot命令行后依次输入以下命令。
```shell
fatload mmc 0:1 0x80200000 rtthread.bin
dcache flush
go 0x80200000
```
> 0x80200000为rtthread.bin加载到内存的位置可在menuconfig中自己修改注意不能与小核固件加载位置重叠。
### 3.2 uboot加载boot.sd
1. 将 SD 卡分为 2 个分区,第 1 个分区用于存放 bin 文件,第 2 个分区用于作为数据存储分区,分区格式为 `FAT32`
2. 将bsp的boot目录下的 `fip.bin` 和编译生成的 `boot.sd` 复制 SD 卡第一个分区中。后续更新固件只需要复制 `boot.sd` 文件即可。
配置**串口0**参数: 115200 8N1 ,硬件和软件流控为关。
直接上电运行uboot会自动调用bootcmd解析boot.sd文件然后加载`rtthread.bin`运行。
### 3.3 如何生成fip.bin
在本bsp的boot/milkv-duo256m目录下存放了所有需要构建出fip.bin的一些依赖文件和相关脚本。用户只需要在boot目录下执行`combine.sh`即可生成fip.bin。
> 如何用户编译了小核c906_little的bsp那么`combine.sh`脚本将会生成带有小核程序的fip.bin。未编译则不会。
完成后可以看到串口的输出信息:
**标准版log信息**
```shell
heap: [0x8028f2b0 - 0x84000000]
\ | /
- RT - Thread Operating System
/ | \ 5.1.0 build Apr 16 2024 00:05:56
2006 - 2024 Copyright by RT-Thread team
hello rt-thread!
msh />
```
**Smart版log信息**
```shell
heap: [0x002f62c0 - 0x04000000]
\ | /
- RT - Thread Smart Operating System
/ | \ 5.1.0 build Apr 16 2024 00:04:47
2006 - 2024 Copyright by RT-Thread team
[E/lwp] lwp_startup: init program not found
Switching to legacy mode...
hello rt-thread!
msh />
```
## 4. 注意事项
目前RISC-V(Smart版本)支持外设物理地址映射到完全相同的虚拟地址而ARM(Smart版本)目前是不支持这样搞的所以在编写驱动的时候应该使用rt_ioremap这样的函数讲物理地址映射到可访问的虚拟地址上去。为了保证ARM的Smart版本内核能够成功运行目前仅对uart和pinctrl的驱动进行了适配。其他驱动可能会因为未进行ioremap导致不可用。
## 5. 联系人信息
维护人:[liYony](https://github.com/liYony)