136 lines
4.6 KiB
Markdown
136 lines
4.6 KiB
Markdown
# 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)
|