从零上手RK1126：一站式SDK环境搭建与固件烧写实战

1. 开箱即“懵”？别慌，先理清你的“装备清单”

拿到一块全新的RK1126开发板，看着这块小小的绿色板子和一堆配件，是不是感觉既兴奋又有点无从下手？这种感觉我太懂了，几年前我第一次接触嵌入式开发板时也是这个状态。别担心，我们今天的目标非常明确：从零开始，把这块“板砖”变成一台能跑你代码的智能设备。整个过程就像拼装一台乐高电脑，你需要准备好所有零件，然后按照正确的顺序把它们组装起来。我们先来清点一下，要完成这个“大工程”，你手边到底需要哪些东西。

首先，开发板本体是毋庸置疑的。RK1126是一款主打AI推理的边缘计算芯片，性能不错，功耗也控制得很好，非常适合做图像识别、语音处理这类嵌入式AI项目。接着是连接线，这里有两个关键：一根网线和一根双公头的USB线。网线的作用可不仅仅是联网，对于RK1126，它还能用来供电！这就是所谓的PoE（以太网供电）技术。不过这里有个我踩过的坑：不是所有网络设备都能成功供电。我一开始把网线一头插在家用的普通路由器上，另一头插板子，板子死活没反应，我还以为是板子坏了。后来换到公司机房的交换机上，立马就点亮了。所以，如果你的板子接路由器不启动，别急着怀疑人生，试试换一个专业的网络交换机或者PoE供电模块。

那根双公头USB线就更重要了，它是你调试和烧录系统的“生命线”。因为RK1126通常运行无图形界面的嵌入式Linux系统，你没法直接给它接个显示器。所有操作，包括查看系统日志、传输文件、运行命令，都得通过这条USB线，借助ADB（Android Debug Bridge）工具来完成。所以，确保你有一根质量好的USB线，劣质线可能导致连接不稳定，让你在调试时痛不欲生。

最后是你的开发主机。官方文档推荐Ubuntu 16.04或18.04，我用的是Ubuntu 18.04，在整个环境搭建和编译过程中没有遇到系统兼容性问题。如果你用Windows，也不是完全不行，但强烈建议在Windows上安装WSL2（Windows Subsystem for Linux）并选择Ubuntu发行版，或者干脆用虚拟机装一个完整的Ubuntu。因为后续几乎所有工具链和编译脚本都是为Linux环境设计的，在纯Windows下折腾会平添无数障碍。

最最核心的“装备”，是RK1126的SDK开发包。你可以把它理解为这块板子的“灵魂软件工厂”。没有它，你的板子就真的只是一块精致的电子砖头。这个SDK包里包含了交叉编译工具链、内核源码、U-Boot引导程序、根文件系统构建脚本，以及一大堆驱动和库文件。获取方式，可以通过瑞芯微的官方开发者论坛寻找，或者在一些技术社区、淘宝店铺也能找到。拿到手后，它是一个巨大的压缩包，解压出来，你的征程就正式开始了。

2. 搭建“造物主”环境：SDK解压与依赖安装

好了，装备齐全，我们准备“开工”。第一步，在你的Ubuntu电脑上找一个空间足够的目录，把下载好的SDK压缩包解压。我习惯放在~/work/目录下。使用tar命令解压后，你会看到一个内容非常丰富的目录。先别急着运行任何命令，我建议你花十分钟，像看地图一样浏览一下主要文件夹。

通常，你会看到kernel/（Linux内核源码）、u-boot/（引导程序）、buildroot/或debian/（用于构建根文件系统）、device/rockchip/（设备树和板级配置）以及prebuilts/（预编译的工具链）等目录。这里面最重要的一个文件是docs/目录下的开发指南，可能是PDF或HTML格式。请务必先阅读它！虽然文档可能有点晦涩，但它能帮你建立对整体编译流程的宏观认识，知道每一步是在做什么，而不是机械地复制命令。

阅读完文档，我们就要开始安装编译所需的软件依赖了。这是让很多新手头疼的第一步，因为依赖包非常多。但别怕，我们一条命令搞定。打开你的终端，切换到SDK根目录，通常你会找到一个名为build.sh或类似env_setup.sh的脚本，运行它可能会自动安装依赖。如果没有，你就需要手动安装。下面这条命令很长，它涵盖了从编译工具到库文件的所有必需品：

sudo apt-get update sudo apt-get install repo git-core gitk git-gui gcc-arm-linux-gnueabihf \ u-boot-tools device-tree-compiler gcc-aarch64-linux-gnu mtools parted \ libudev-dev libusb-1.0-0-dev python-linaro-image-tools linaro-image-tools \ autoconf autotools-dev libsigsegv2 m4 intltool libdrm-dev curl sed make \ binutils build-essential gcc g++ bash patch gzip gawk bzip2 perl tar cpio \ python unzip rsync file bc wget libncurses5 libqt4-dev libglib2.0-dev \ libgtk2.0-dev libglade2-dev cvs git mercurial rsync openssh-client \ subversion asciidoc w3m dblatex graphviz python-matplotlib libc6:i386 \ libssl-dev expect fakeroot cmake

把上面这一大串命令粘贴到终端执行。这个过程会从Ubuntu的软件源下载并安装几十个包，需要一些时间，也取决于你的网速。这里有个常见坑点：如果你的Ubuntu系统是刚安装的，或者软件源配置有问题，可能会遇到“无法定位软件包”的错误。最常见的是libqt4-dev这个包，在较新的Ubuntu版本中可能已被替换。如果遇到，你可以尝试安装libqt5-dev，或者根据错误提示搜索替代方案。另一个坑点是libc6:i386这个32位兼容库，在64位系统上是必须的，因为一些老的编译工具是32位的。安装时请确保你的系统已启用i386架构支持（通常运行sudo dpkg --add-architecture i386后再sudo apt update）。

依赖安装完成后，建议重启一下终端，或者执行source ~/.bashrc，让新安装的工具路径生效。至此，你的“造物主”工作台——编译环境，就算初步搭建好了。

3. 第一次编译：耐心与报错的较量

环境准备好，激动人心的编译环节来了。在SDK根目录，你通常会看到几个关键的编译脚本，比如build.sh、mkfirmware.sh或./build.sh all这样的命令。对于第一次上手，我推荐使用全自动编译的方式。这通常是一个封装好的脚本，它会按照正确的顺序，依次编译U-Boot、内核、根文件系统，最后打包成完整的固件。你可以在文档里找到具体的命令，很可能就是./build.sh。

在终端执行这个编译命令，然后，泡杯茶，站起来活动一下。第一次完整编译RK1126的SDK，根据你的电脑CPU性能（我的是i7-8700），可能需要1到3个小时。编译过程会在终端输出大量的信息，滚动得非常快。你的任务不是盯着每一行看，而是留意最后是否有明显的ERROR字样，或者编译进程是否在某个地方卡住不动了。

根据我和很多开发者的经验，第一次编译大概率不会一帆风顺。报错是常态，也是学习的过程。常见的错误有几类：一是依赖缺失，虽然我们安装了一大堆，但可能仍有漏网之鱼，错误信息通常会提示缺少某个.h头文件或.so库，这时你需要根据提示的包名，再用apt-get install来安装。二是权限问题，确保你是在普通用户下编译，但拥有对SDK目录的读写权限，尽量不要在root用户下直接编译，以免引起路径混乱。三是工具链路径错误，检查SDK中prebuilts/gcc/之类的目录是否存在，并且编译脚本是否正确引用了它。

我印象比较深的一次报错是关于openssl版本冲突的。系统安装的openssl版本较高，而SDK里某个组件需要较老的API，导致编译失败。解决方案不是降级系统openssl（那会影响其他软件），而是找到SDK里那个组件的配置，修改其Makefile或configure脚本，让它兼容新版本，或者为这个组件单独编译一个老版本的openssl放在本地。听起来复杂，但搜索引擎是你的好朋友，把错误信息的关键词复制粘贴到搜索框，很大概率能找到前人踩坑留下的解决方案。

心态很重要：遇到报错别慌，也别轻易放弃。嵌入式开发就是这样一个不断遇到问题、搜索、尝试、解决问题的过程。每一次解决报错，你对这套系统的理解就会加深一层。当终端最终停止滚动，出现“Build completed successfully”或类似的提示时，那种成就感是无与伦比的。

4. 收获果实：定位与理解生成的固件

经过漫长的等待和可能的“排雷”，编译终于成功了！这时，你需要知道“果实”在哪里。在SDK目录下，会有一个专门的输出文件夹，常见名字是output/、rockdev/或image/。进入这个目录，你会看到一堆生成好的文件，这就是能让你板子“活过来”的固件。

关键的文件通常包括这几个：

• uboot.img：U-Boot引导加载程序镜像。相当于电脑的BIOS，负责最基础的硬件初始化，并加载操作系统。
• boot.img：内核镜像和设备树打包文件。包含了Linux内核以及针对RK1126这块特定板子的硬件配置信息（设备树）。
• rootfs.img：根文件系统镜像。这就是你的“操作系统”本身，包含了从/bin、/lib到/etc的所有命令、库和配置文件。
• MiniLoaderAll.bin或loader.bin：瑞芯微芯片专用的底层加载器，用于初始化DDR内存等最底层的硬件，是烧录过程的第一步。
• 最终，会有一个打包好的完整固件，名字可能是update.img。这个文件就是我们要烧写到板子eMMC存储里的“系统全家桶”。

你可以使用ls -lh命令查看这些文件的大小和生成时间，确认它们都已正常生成。例如，一个完整的rootfs.img可能有好几百MB，而uboot.img则很小。理解每个文件的作用，有助于你在后续开发中，如果只修改了内核驱动，就只需要重新编译和烧写boot.img，而不必每次都打包完整的update.img，能节省大量时间。

5. 临门一脚：使用工具完成固件烧写

编译出固件，就像做好了系统安装盘，最后一步就是把它“安装”到开发板上。RK1126通常使用瑞芯微自家的RKDevTool（Windows下）或upgrade_tool（Linux下）进行烧录。这里我以在Ubuntu开发主机上使用upgrade_tool为例，讲解最常用的Loader模式烧录。

首先，确保你的开发板处于断电状态。然后，用双公头USB线，连接开发板的USB OTG口（注意不是普通的USB口，一般在板子上会有标记）和电脑的USB口。接着，找到开发板上的恢复按键（Recovery Button）或MaskROM按键，通常是一个需要镊子短接的小孔或者一个按钮。按住这个按键不放，然后给开发板上电（插上电源或通过PoE供电）。保持按住约2-3秒后松开，这时开发板就进入了特殊的“Loader”或“MaskROM”模式，等待电脑给它刷机。

在电脑终端上，你需要先进入存放upgrade_tool工具的目录（它通常在SDK的tools/linux/或类似路径下）。然后执行查看设备命令：

sudo ./upgrade_tool ld

如果看到列出了设备（比如DevType=Rockusb），说明电脑已经识别到了处于烧录模式的开发板。

接下来就是执行烧录命令。烧录完整固件update.img的命令类似这样：

sudo ./upgrade_tool uf output/update.img

或者，你也可以分步烧录各个部分，这在调试时很常用：

sudo ./upgrade_tool ul output/MiniLoaderAll.bin sudo ./upgrade_tool di -p output/parameter.txt # 写入分区表 sudo ./upgrade_tool di -uboot output/uboot.img sudo ./upgrade_tool di -boot output/boot.img sudo ./upgrade_tool di -rootfs output/rootfs.img

烧录过程会有进度条显示。这里有个至关重要的注意事项：烧录过程务必保证USB连接稳定，电脑不要休眠，直到烧录工具提示“Download OK”或“Write Success”为止。中途断电或断开USB，极有可能导致板子“变砖”，需要更复杂的方式才能救回。

烧录完成后，先断开USB线，然后给开发板重新上电。如果一切顺利，你应该能通过串口工具（需要USB转TTL串口线连接板子的调试串口）看到U-Boot和内核的启动日志，最后出现Linux登录提示符。或者，如果你烧录的系统包含了ADB服务，你可以用adb devices命令查看是否能找到设备。当终端上出现你的设备序列号时，恭喜你，你的RK1126开发板已经成功“点亮”，从一块砖头变成了一个可编程的智能边缘设备！

整个流程走下来，你会发现从零到一的过程充满了细节。每个步骤都可能遇到小问题，但解决问题的过程正是嵌入式开发的乐趣所在。希望这份详细的实战记录，能帮你少走些弯路，更快地享受在RK1126上创造应用的乐趣。