当前位置：首页 > news >正文

RV1126B开发环境搭建全攻略：从Ubuntu配置到固件烧录

news 2026/6/16 3:28:31

1. 项目概述：为什么RV1126B开发环境搭建是个技术活

最近在折腾荣品的RV1126B开发板，这块板子用的是瑞芯微的RV1126芯片，主打AI视觉和边缘计算。很多刚拿到板子的朋友，第一步在搭建开发环境上就卡住了，不是编译报错，就是烧录失败，折腾一两天都进不了正题。这其实很正常，RV1126B的开发环境搭建，远不是装个IDE、配个编译器那么简单，它涉及到一整套基于Linux的交叉编译工具链、特定的SDK源码管理、以及和硬件强相关的烧录工具配置，任何一个环节出岔子，后面都玩不转。

我花了差不多一周时间，从零开始踩遍了几乎所有能踩的坑，才把Ubuntu下的完整开发环境给跑通。这个过程里，你会发现官方文档有些步骤是跳着的，网络上的资料又零零散散，对新手极不友好。所以，我决定把这次搭建环境的全过程、核心原理、还有那些文档里没写的“坑点”都详细记录下来。无论你是想为RV1126B开发AI应用、调试摄像头驱动，还是单纯想学习嵌入式Linux开发，这篇从实战中总结出来的指南，都能帮你省下大量摸索的时间，直接进入开发状态。

2. 环境搭建的整体设计与核心思路

搭建RV1126B的开发环境，本质上是在你的PC（通常是x86_64架构的Ubuntu系统）上，构建一个能为ARM架构的RV1126芯片生成可执行程序的“工厂”。这个工厂的核心部件包括：交叉编译器、SDK源码、内核与文件系统构建工具、以及烧录工具。整个设计思路是“宿主机编译，目标板运行”。

2.1 为什么选择Ubuntu作为宿主机？

几乎所有芯片原厂的SDK和工具链都对Linux，特别是Ubuntu，有最好的支持。在Windows上通过WSL或虚拟机也能跑，但会引入文件系统权限、路径、USB设备映射等一系列额外复杂度，对于编译这种需要稳定环境的重度操作，直接使用物理机或虚拟机安装Ubuntu是风险最低、效率最高的选择。我强烈推荐使用Ubuntu 18.04或20.04 LTS版本，这是经过瑞芯微和众多开发者验证最稳定的基础环境，能最大限度避免因系统版本过新导致的库依赖冲突。

2.2 工具链选型：官方的“金钥匙”

RV1126B使用的是ARM Cortex-A7内核，你需要对应的交叉编译工具链。这里切忌自己从网上下载通用的arm-linux-gnueabihf工具链，因为芯片厂商通常会对GCC进行定制和打补丁，以支持其特有的硬件指令集（如NEON SIMD）和优化。荣品官方SDK包里通常会提供编译好的工具链，或者指引你从瑞芯微的Git仓库获取。使用官方工具链是保证编译出的内核、驱动、应用程序能与板子硬件完美兼容的基石。

2.3 SDK源码管理：认识“Buildroot”与“Yocto”

RV1126B的SDK通常基于Buildroot或Yocto项目来构建完整的Linux系统镜像。Buildroot相对轻量、配置简单，适合快速构建；Yocto则更强大、灵活，适合复杂的产品级定制。荣品的SDK大概率是基于Buildroot的。你需要理解，SDK不是一个简单的“代码文件夹”，它是一个高度自动化的构建系统。你通过配置（如make menuconfig），选择需要的软件包、内核特性、文件系统类型，然后执行一条编译命令，这个系统就能帮你从头到尾生成包括U-Boot（启动引导程序）、Linux内核、根文件系统在内的完整固件。因此，搭建环境的第一步，就是正确获取并初始化这个SDK构建系统。

3. 详细实操步骤：从零搭建完整开发环境

下面我将以在Ubuntu 20.04 LTS物理机上搭建环境为例，分解每一个步骤。请确保你有至少100GB的可用磁盘空间，因为SDK及其编译中间文件会非常庞大。

3.1 宿主机Ubuntu系统基础准备

首先，更新系统并安装一系列必需的开发工具和库。这些是编译任何Linux嵌入式项目的基础依赖。

sudo apt-get update sudo apt-get upgrade -y # 安装基础开发工具 sudo apt-get install -y git-core gitk git-gui gcc-arm-linux-gnueabihf \ device-tree-compiler ncurses-dev lzop libssl-dev build-essential \ gcc g++ make automake autoconf libtool cmake pkg-config \ libc6-dev-i386 u-boot-tools gcc-aarch64-linux-gnu \ bison flex texinfo unzip diffstat chrpath gawk wget cpio \ python3 python3-pip python3-pexpect python3-git python3-jinja2 \ xz-utils debianutils iputils-ping libegl1-mesa libsdl1.2-dev \ xterm sed cvs subversion coreutils texi2html docbook-utils \ help2man desktop-file-utils libgl1-mesa-dev libglu1-mesa-dev \ mercurial automake groff curl lzop libncurses5-dev zlib1g-dev \ libselinux1 genext2fs lib32z1 lib32stdc++6 zlib1g:i386

注意：这是一份比较全面的列表，特别是包含了lib32z1和lib32stdc++6这类32位兼容库，因为一些老的或闭源的编译工具可能是32位的。一次性安装可以避免后续编译过程中因缺少某个库而报错，这种错误信息有时非常隐晦。

安装完成后，建议创建一个专用的工作目录，并确保其路径中没有中文或空格。

mkdir -p ~/rv1126b_sdk cd ~/rv1126b_sdk

3.2 获取官方SDK源码

这是最关键的一步。源码通常来自荣品官方提供的网盘链接或Git仓库。这里以常见的网盘压缩包方式为例。

下载SDK：从荣品文档中心或交流群提供的网盘链接，下载名称为rv1126b_linux_sdk_release_xxx.tar.gz或类似的压缩包。将其放入~/rv1126b_sdk目录。
解压SDK：SDK包通常很大，解压需要时间。
```
tar -xzf rv1126b_linux_sdk_release_xxx.tar.gz
```
解压后会生成一个sdk或rv1126b_sdk目录。进入该目录，你可能会看到buildroot、kernel、u-boot、device等子目录。
初始化Repo（如果SDK使用Repo管理）：瑞芯微的SDK有时会使用Google的Repo工具来管理多个Git仓库。如果是这种情况，你需要先安装Repo。
```
mkdir -p ~/.bin PATH="${HOME}/.bin:${PATH}" curl https://storage.googleapis.com/git-repo-downloads/repo > ~/.bin/repo chmod a+rx ~/.bin/repo
```
然后，在SDK根目录下执行同步（注意，这一步会下载数十GB的数据，耗时很长，务必保证网络稳定）：
```
cd rv1126b_sdk .repo/repo/repo sync -c --no-tags
```
如果官方提供的是完整压缩包，则通常不需要这一步。

3.3 安装与配置交叉编译工具链

在SDK目录中，寻找prebuilts、toolchain或gcc这样的目录。工具链通常位于其中。

# 假设工具链路径在 sdk/prebuilts/gcc/linux-x86/arm/gcc-arm-8.3-2019.03-x86_64-arm-linux-gnueabihf export TOOLCHAIN_DIR=~/rv1126b_sdk/sdk/prebuilts/gcc/linux-x86/arm/gcc-arm-8.3-2019.03-x86_64-arm-linux-gnueabihf # 将工具链的bin目录加入系统PATH echo "export PATH=\$PATH:${TOOLCHAIN_DIR}/bin" >> ~/.bashrc source ~/.bashrc # 验证工具链是否安装成功 arm-linux-gnueabihf-gcc --version

如果成功输出GCC版本信息，表明工具链配置正确。请务必记录下你使用的工具链具体版本，这在后续排查编译问题时非常重要。

3.4 编译完整固件（以Buildroot为例）

进入SDK的Buildroot目录，开始配置和编译。

cd ~/rv1126b_sdk/sdk/buildroot # 加载默认配置文件，荣品通常会为RV1126B提供一个默认配置，如 rv1126b_荣品板型号_defconfig make rv1126b_xxx_defconfig # 启动图形化配置界面（可选，用于定制系统） make menuconfig

在menuconfig中，你可以进行各种定制，比如：

Target packages：添加或删除你需要的软件，如openssh、python3、ffmpeg等。
Filesystem images：选择生成的文件系统镜像格式，如ext4、squashfs等。
Kernel：这里通常只是选择是否从Buildroot内部编译内核，具体内核配置在独立的kernel目录进行。

配置完成后，保存退出。然后开始漫长的编译过程。首次编译会下载所有选中的软件包源码并编译，耗时可能长达数小时。

make -j$(nproc)

-j$(nproc)表示使用你CPU的所有核心进行并行编译，以加快速度。编译成功后，在output/images/目录下，你会找到生成的固件，最重要的通常是：

uboot.img: U-Boot引导镜像。
boot.img: 包含内核和设备树的启动镜像。
rootfs.ext4: 根文件系统镜像。
rv1126b_xxx_sdk.img: 可能是打包好的完整升级镜像。

3.5 安装与配置烧录工具（RKDevTool）

要在开发板上运行你编译的系统，需要用到瑞芯微专用的烧录工具RKDevTool。它通常在Windows下运行，通过USB OTG接口与板子通信。

获取工具：从荣品提供的资料或瑞芯微官网下载RKDevTool。建议使用较新的版本，如v2.96以上。
安装驱动：这是最容易出问题的一步。在Windows上，首先需要安装瑞芯微的USB驱动DriverAssitant_v5.1.1。安装前，务必先关闭所有杀毒软件和Windows Defender的实时保护，并以管理员身份运行安装程序。安装完成后重启电脑。
连接板子进入Loader模式：
- 板子先不要上电。
- 用USB Type-C数据线连接板子的OTG口（注意不是USB Host口）和电脑。
- 按住板子上的**升级键（Recovery或Loader键）**不放，然后给板子上电。
- 保持按住约2-3秒后松开。此时，在Windows设备管理器中应能看到一个名为Rockusb Device或USB Download Gadget的设备。
- 打开RKDevTool，软件下方应显示“发现一个LOADER设备”。
烧录镜像：
- 在RKDevTool界面，切换到“升级固件”选项卡。
- 点击“固件”按钮，选择你编译生成的完整镜像文件（如.img文件），或者分别加载uboot.img、boot.img、rootfs.img到对应的地址（地址信息通常由SDK提供或已在工具中预设）。
- 点击“执行”按钮，工具将开始擦除、下载、校验。烧录完成后，设备会自动重启。

4. 核心环节深度解析与避坑指南

4.1 编译内核与设备树的定制

虽然Buildroot可以编译内核，但更常见的做法是单独配置和编译内核，以便进行更精细的驱动调试和内核参数调整。

cd ~/rv1126b_sdk/sdk/kernel # 生成荣品板对应的默认内核配置文件 make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- rv1126b_xxx_defconfig # 启动内核图形化配置 make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- menuconfig

在内核配置中，你需要特别关注：

Device Drivers：确保你的板载设备驱动被正确启用，如Wi-Fi/BT模块（可能是RTL8723DS）、音频编解码器、摄像头传感器（如OV13850、GC2053）等。荣品的板子可能使用了特定的复位或电源控制GPIO，这些配置有时在设备树（Device Tree）中，而非内核。
设备树（Device Tree）：这是描述硬件拓扑的核心文件。源文件（.dts）通常在arch/arm/boot/dts/目录下。荣品应该会提供一个基础的rv1126b-xxx.dts文件。你可能需要根据实际硬件修改这里，比如调整GPIO引脚、I2C地址、时钟频率等。修改后，需要编译设备树：
```
make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- dtbs
```
生成的.dtb文件会包含在boot.img中。

实操心得：内核编译出错，十有八九是交叉编译环境变量没设置对，或者之前编译的中间文件（.o文件）混乱。在尝试新的配置前，先执行make mrproper或make distclean进行彻底清理，再从defconfig重新开始，能解决很多玄学问题。

4.2 根文件系统的定制与Overlay

Buildroot生成的根文件系统是只读的（如果是squashfs）。为了在开发阶段方便地添加自己的程序或脚本，可以使用Overlay（覆盖）功能。

在Buildroot配置(make menuconfig)中，找到System configuration -> Root filesystem overlay directories。
将其设置为你本地的某个目录，例如$(TOPDIR)/../board/荣品/rv1126b/overlay。
在此Overlay目录中，你可以按照根文件系统的目录结构放置文件。例如，在overlay/usr/bin/下放一个你自己的可执行程序，在overlay/etc/下放一个自定义的配置文件。
重新编译Buildroot (make)，这些文件就会被自动打包进最终的根文件系统镜像。

这是实现板级定制化（如预装应用、修改服务、配置网络）最干净的方式，避免了直接修改Buildroot内部包配置的复杂性。

4.3 应用程序的独立交叉编译

对于你自己的C/C++应用程序，不建议在庞大的SDK目录里编译。更好的做法是建立一个独立的项目目录，使用CMake或Makefile，并指向SDK提供的工具链和库。

创建一个简单的CMakeLists.txt示例：

cmake_minimum_required(VERSION 3.10) project(MyRV1126App) set(CMAKE_SYSTEM_NAME Linux) set(CMAKE_SYSTEM_PROCESSOR arm) # 指定交叉编译器 set(CMAKE_C_COMPILER arm-linux-gnueabihf-gcc) set(CMAKE_CXX_COMPILER arm-linux-gnueabihf-g++) # 指定SDK中sysroot的路径，这里包含目标板的头文件和库 set(CMAKE_SYSROOT ~/rv1126b_sdk/sdk/buildroot/output/host/arm-buildroot-linux-gnueabihf/sysroot) set(CMAKE_FIND_ROOT_PATH ${CMAKE_SYSROOT}) set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER) set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY) set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY) add_executable(my_app main.c) target_link_libraries(my_app pthread m)

然后使用CMake进行跨平台编译：

mkdir build && cd build cmake -DCMAKE_TOOLCHAIN_FILE=../toolchain.cmake .. make

生成的my_app就是可以在RV1126B上运行的ARM可执行文件。

5. 常见问题排查与解决实录

即使按照步骤操作，你也大概率会遇到一些问题。下面是我在搭建过程中遇到并解决的一些典型问题。

5.1 编译错误：缺少头文件或库

现象：编译内核或应用程序时，报错fatal error: xxx.h: No such file or directory或cannot find -lxxx。

排查与解决：

确认依赖包已安装：回顾3.1节的基础包安装列表，确保没有遗漏。特别是libssl-dev、libncurses5-dev这类。
检查交叉编译环境变量：确保CROSS_COMPILE和ARCH变量设置正确且已导出。对于应用程序，检查CMake或Makefile中的CMAKE_SYSROOT路径是否正确指向了SDK的sysroot。
查看SDK的文档：有些SDK需要先执行一个环境设置脚本（如source build/envsetup.sh或. setup.sh），该脚本会设置好所有必要的路径和变量。

5.2 烧录工具无法识别设备

现象：RKDevTool始终显示“没有发现设备”。

排查与解决：

确认USB线和接口：必须使用数据线（而非仅充电线），连接板子的OTG/Download口。很多板子有多个USB口，务必确认。
驱动安装问题：这是最常见的原因。以管理员身份运行驱动安装程序，安装时关闭所有杀毒软件。安装后，在设备管理器中手动检查是否有带感叹号的未知设备，尝试右键更新驱动，手动指向驱动安装目录（通常是DriverAssitant_v5.1.1\drivers）。
进入Loader模式的操作：确保步骤正确：先按住升级键不放，再上电，2-3秒后松开。有些板子可能需要先上电，在极短时间内（如1秒内）按住升级键。具体操作请查阅荣品板子的用户手册。
尝试不同USB口和电脑：更换电脑的USB端口（优先使用后置USB2.0口），甚至换一台电脑测试，以排除电脑USB控制器兼容性问题。

5.3 板子上电后无输出或无法启动

现象：烧录成功，但板子重启后串口无输出，或卡在U-Boot阶段。

排查与解决：

检查串口连接与配置：使用USB转TTL串口线连接板子的调试串口（通常是UART2）。在PC上使用串口工具（如MobaXterm、Putty、minicom），确保波特率设置为1500000（这是瑞芯微平台常见的调试波特率，而非传统的115200）。数据位8，停止位1，无校验。
查看U-Boot启动日志：如果能看到U-Boot日志但随后卡住，可能是内核或设备树问题。在U-Boot倒计时阶段按任意键进入命令行，尝试手动设置启动参数或单独加载内核和设备树进行测试，以定位是内核崩溃还是文件系统加载失败。
核对镜像地址：确认烧录时各个镜像（Uboot, Kernel, Rootfs）的起始地址（Load Address）是否正确。这些地址在U-Boot的源码或SDK文档中有定义，烧录错误地址会导致CPU从错误位置取指令。
检查电源：RV1126B在启动瞬间，特别是带起外围芯片时，电流需求可能较大。使用质量不佳的电源适配器或MicroUSB线可能导致电压跌落，引起启动不稳定。尝试使用额定电流2A以上的电源和较粗的电源线。

5.4 网络连接问题（如SSH无法连接）

现象：系统启动后，能Ping通但SSH连接被拒绝或超时。

排查与解决：

确认SSH服务已安装并启动：在Buildroot配置中，确保选中了openssh包。在板子上使用ps | grep sshd查看服务是否运行。如果没有，可能需要手动创建SSH主机密钥，命令是ssh-keygen -A，然后启动/etc/init.d/S50sshd start。
检查IP地址：使用ifconfig或ip addr确认板子获取到的IP地址。如果是动态获取（DHCP），确保路由器DHCP服务正常。开发阶段更推荐设置静态IP。
防火墙：Buildroot默认的防火墙配置可能阻止了SSH端口（22）。检查/etc/sysctl.conf或iptables规则。为简化，开发初期可以先关闭防火墙。
根文件系统为只读：如果文件系统是squashfs等只读格式，你对/etc目录下配置文件的修改在重启后会丢失。这就是为什么推荐使用Overlay机制来进行持久化配置的原因。

搭建RV1126B的开发环境，就像为一个新工厂铺设所有管道和电路，初期繁琐，但一旦打通，后续的开发、调试、迭代就会顺畅无比。这个过程里最宝贵的不是一次成功的编译，而是遇到问题、分析日志、搜索资料、最终解决的能力积累。每次解决一个编译错误或驱动问题，你对这套系统的理解就会加深一层。我的建议是，准备好充足的耐心，详细记录每一步的操作和结果，善用串口调试信息这个最直接的“黑匣子”，你会发现，这块小小的板子能带来的学习和创造乐趣，远超你的想象。

查看全文

http://www.zskr.cn/news/1532658.html