libs/rt-thread-official
libs
/
rt-thread-official
mirror of https://github.com/RT-Thread/rt-thread.git
4
0
Fork 0
Code Issues Releases Wiki Activity
rt-thread-official/bsp/cvitek/README.md

7.4 KiB
Executable File
Raw Blame History

参考文档

概述

支持开发板以及集成 SoC 芯片信息如下

Duo 家族开发板采用 CV18xx 系列芯片。芯片的工作模式总结如下：

  • CV1800B，支持一种工作模式：
    • 大核（RISC-V C906@1GHz）+ 小核（RISC-V C906@700MHz）。
  • SG2002（原 CV181xC），支持两种工作模式，通过管脚 GPIO_RTX 的外围电路控制进行切换：
    • 大核（RISC-V C906@1GHz）+ 小核（RISC-V C906@700MHz）。
    • 大核（ARM Cortex-A53@1GHz）+ 小核（RISC-V C906@700MHz）。
  • SG2000（原 CV181xH），支持两种工作模式，通过管脚 GPIO_RTX 的外围电路控制进行切换：
    • 大核（RISC-V C906@1GHz）+ 小核（RISC-V C906@700MHz）。
    • 大核（ARM Cortex-A53@1GHz）+ 小核（RISC-V C906@700MHz）。

BSP 支持情况

由于大小核的存在，以及不同 SoC 下不同工作模式的存在，bsp/cvitek 提供了三种不同 BSP/OS，需要单独编译。

BSP 名称 大小核 芯片架构 默认串口控制台 备注
cv18xx_risc-v 大核 RISC-V C906 uart0 支持 MMU，支持 RT-Thread 标准版 和 RT-SMART 模式，默认运行 RT-SMART 版本
c906-little 小核 RISC-V C906 uart1 无 MMU，运行 RT-Thread 标准版
cv18xx_aarch64 大核 ARM Cortex A53 uart0 支持 MMU， 支持 RT-Thread 标准版 和 RT-SMART 版，默认运行 RT-Thread 标准版本

由于开发板默认运行的大核为 "cv18xx_risc-v", 所以本文将主要介绍 "cv18xx_risc-v" 和 "c906-little" 的构建和使用。有关 "cv18xx_aarch64" 的介绍请参考 这里。

注：不同开发板 uart 输出管脚不同，默认配置可能导致串口无法正常显示，请根据开发板 uart 通过 scons --menuconfig 配置对应 uart 的输出管脚。

驱动支持列表

驱动 支持情况 备注
uart 支持 默认波特率115200
gpio 支持
i2c 支持
adc 支持
spi 支持 默认CS引脚，每个数据之间CS会拉高，请根据时序选择GPIO作为CS。若读取数据，tx需持续dummy数据。
pwm 支持
timer 支持
wdt 支持
sdio 支持
eth 支持

编译

Toolchain 下载

注：当前 bsp 只支持 Linux 编译，推荐 ubuntu 22.04

  1. RT-Thread 标准版工具链：riscv64-unknown-elf-gcc 下载地址 https://occ-oss-prod.oss-cn-hangzhou.aliyuncs.com/resource//1705395512373/Xuantie-900-gcc-elf-newlib-x86_64-V2.8.1-20240115.tar.gz

  2. RT-Smart 版工具链： riscv64-unknown-linux-musl-gcc 下载地址 https://github.com/RT-Thread/toolchains-ci/releases/download/v1.7/riscv64-linux-musleabi_for_x86_64-pc-linux-gnu_latest.tar.bz2

正确解压后，在rtconfig.py中将 riscv64-unknown-elf-gcc 或 riscv64-unknown-linux-musl-gcc 工具链的本地路径加入 EXEC_PATH 或通过 RTT_EXEC_PATH 环境变量指定路径。

# RT-Thread 标准版按照以下配置：
$ export RTT_CC_PREFIX=riscv64-unknown-elf-
$ export RTT_EXEC_PATH=/opt/Xuantie-900-gcc-elf-newlib-x86_64-V2.8.1/bin

# RT-Samrt 版按照以下配置：
$ export RTT_CC_PREFIX=riscv64-unknown-linux-musl-
$ export RTT_EXEC_PATH=/opt/riscv64-linux-musleabi_for_x86_64-pc-linux-gnu/bin

依赖安装

$ sudo apt install -y scons libncurses5-dev device-tree-compiler

构建

异构芯片需单独编译每个核的 OS，在大/小核对应的目录下，依次执行:

  1. 开发板选择 Linux平台下，可以先执行：
$ scons --menuconfig

选择当前需要编译的目标开发板类型

Board Type (milkv-duo)  --->
    ( ) milkv-duo
    ( ) milkv-duo-spinor
    (X) milkv-duo256m
    ( ) milkv-duo256m-spinor
    ( ) milkv-duos
  1. 可按照以下方式开启 RT-Smart
RT-Thread Kernel  --->
    [*] Enable RT-Thread Smart (microkernel on kernel/userland)

并配置内核虚拟起始地址 0xFFFFFFC000200000

    RT-Thread Kernel  --->
(0xFFFFFFC000200000) The virtural address of kernel start
    RT-Thread Components  --->
  1. 编译
$ scons

编译成功后，会在 bsp/cvitek/output 对应开发板型号目录下自动生成 fip.bin 和 boot.sd 文件，其中大核运行文件在 boot.sd 中，小核的运行文件在 fip.bin 中。

  • fip.bin：fsbl、opensbi、uboot、小核运行文件打包后的 bin 文件
  • boot.sd：大核打包后的 bin 文件

运行

  1. 将 SD 卡分为 2 个分区，第 1 个分区用于存放 bin 文件，第 2 个分区用于作为数据存储分区，分区格式为 FAT32。

  2. 将根目录下的 fip.bin 和 boot.sd 复制到 SD 卡第一个分区中。两个固件文件可以独立修改更新，譬如后续只需要更新大核，只需要重新编译 "cv18xx_risc-v" 并复制 boot.sd 文件即可。

  3. 更新完固件文件后， 重新上电可以看到串口的输出信息。

FAQ

  1. 如遇到不能正常编译，请先使用 scons --menuconfig 重新生成配置。

  2. 错误：./mkimage: error while loading shared libraries: libssl.so.1.1: cannot open shared object file: No such file or directory

可在 http://security.ubuntu.com/ubuntu/pool/main/o/openssl 下载 libssl1.1_1.1.1f-1ubuntu2_amd64.deb 文件后安装即可解决。 或使用以下命令下载安装:

$ wget http://security.ubuntu.com/ubuntu/pool/main/o/openssl/libssl1.1_1.1.1f-1ubuntu2_amd64.deb
$ sudo dpkg -i libssl1.1_1.1.1f-1ubuntu2_amd64.deb
  1. 如发现切换开发板编译正常，但无法正常打包，请切换至自动下载的 cvi_bootloader 目录，并手工运行 git pull 更新，或删除该目录后重新自动下载。

联系人信息

维护人：flyingcys

更多信息请参考 https://riscv-rtthread-programming-manual.readthedocs.io