基于龙芯2K0300久久派的OpenCV交叉编译实战：从虚拟机Ubuntu环境搭建到嵌入式视觉应用部署

1. 环境准备虚拟机与Ubuntu的“新家”搭建如果你正准备为龙芯2K0300久久派折腾OpenCV那第一步绝对不是急着敲命令。我见过太多新手朋友一上来就照着教程安装工具链结果卡在奇奇怪怪的环境问题上白白浪费一两天时间。咱们得先把“地基”打好这个地基就是你的开发环境——一个稳定、纯净的Ubuntu虚拟机。为什么非要用虚拟机这可不是多此一举。嵌入式开发尤其是交叉编译经常需要安装特定版本的系统库和工具这些操作很容易把你主机的开发环境搞得一团糟。用虚拟机你可以随时拍快照编译失败了或者配置乱了一键就能回到干净的状态这种“后悔药”在漫长的编译调试过程中简直是救命稻草。我自己就吃过亏曾经在宿主机上直接搞一次错误的make install差点让我重装系统从那以后所有涉及系统级配置的活儿我一律扔进虚拟机。虚拟机软件的选择上VMware Workstation Player个人免费版和VirtualBox都是不错的选择。我个人更习惯用VMware它在性能和与宿主机的文件共享、剪贴板同步上做得更顺手一些。当然如果你手头有正版许可用起来会更方便。VirtualBox作为开源免费方案功能也完全够用看个人喜好。接下来是Ubuntu系统镜像。这里有个关键点强烈建议使用Ubuntu 20.04 LTS版本。你可能想问为什么不用更新的22.04或者24.04原因很简单稳定性和生态兼容性。龙芯官方提供的交叉编译工具链、以及很多成熟的嵌入式开发教程其测试环境大多基于20.04。新版本的系统库比如glibc可能会有细微变动这些变动有时会导致工具链链接库时出现诡异的版本冲突排查起来极其痛苦。用20.04 LTS等于是走在一条被无数人踩平的路上能避开很多潜在的坑。下载好ISO镜像后在虚拟机里新建系统。有几个参数设置我分享一下我的经验CPU核心数可以多给点比如你宿主机是8核可以分4个给虚拟机后续编译OpenCV时make -j4能大幅提速。内存至少分配4GB8GB更佳编译大型项目内存吃紧会很慢。硬盘空间务必留足建议40GB起步因为除了系统本身你还要存放源码、编译中间文件、安装库等空间太小编译到一半报错就尴尬了。安装Ubuntu时记得勾选“安装OpenSSH服务器”这样以后可以通过终端远程连接操作起来更灵活。系统装好后第一件事不是欣赏桌面而是换源。默认的国外源下载速度可能慢如蜗牛。将软件源更新为国内的镜像源比如阿里云、清华大学或中科大的源这是提升后续所有操作效率的第一步。操作也简单在“软件和更新”里选择“其他站点”挑一个速度快的就行。换完源别忘了在终端里执行sudo apt update和sudo apt upgrade更新系统软件包列表并升级现有软件确保起点一致。最后养成一个好习惯在真正开始折腾交叉编译之前给这个刚装好、更新完的纯净Ubuntu系统拍一个虚拟机快照。你可以命名为“Base_Clean_Ubuntu20.04”。这个快照就是你的“黄金还原点”无论后面步骤多混乱你都能瞬间回到这个完美起点心里特别有底。准备工作做到这一步你的“作战指挥部”才算真正搭建完毕可以安心地向龙芯2K0300久久派和OpenCV进发了。2. 交叉编译工具链连接x86与龙芯的“桥梁”环境准备好了现在我们面临嵌入式开发的核心挑战你的开发机x86架构的Ubuntu和你的目标板龙芯2K0300LoongArch架构是两种完全不同的CPU指令集。就像你没法让一个只讲中文的人直接听懂英文指令一样我们需要一个“翻译官”——这就是交叉编译工具链。简单来说交叉编译工具链是一套运行在x86机器上但能生成龙芯LoongArch可执行代码的编译器、链接器和库。它包括了loongarch64-linux-gnu-gccC编译器、loongarch64-linux-gnu-gC编译器、loongarch64-linux-gnu-ld链接器等一系列工具。没有它你在Ubuntu上编译的程序在久久派上根本跑不起来。对于龙芯2K0300久久派我们需要寻找专门针对LoongArch64架构的交叉编译工具链。这里通常有两种获取方式一是从龙芯官方社区或合作伙伴处获取预编译好的工具链包二是从源码开始构建这过程本身又是一次漫长的交叉编译不推荐新手尝试。我们当然选择第一种。根据我手头的资料和实战经验一个可用的工具链版本是loongson-gnu-toolchain-8.3-x86_64-loongarch64-linux-gnu-rc1.3-1。你需要去龙芯的官方开源社区或相关的技术论坛找到这个工具的下载链接。下载下来通常是一个.tar.xz或.tar.gz的压缩包。接下来的安装路径有讲究。很多教程会建议解压到/opt目录下。/opt目录在Linux系统中常用于存放第三方大型软件或工具包结构清晰。我个人的做法也是如此。打开终端使用以下命令进行解压和安装# 假设下载的工具链包在 ~/Downloads 目录下 sudo tar -xvf ~/Downloads/loongson-gnu-toolchain-8.3-x86_64-loongarch64-linux-gnu-rc1.3-1.tar.xz -C /opt解压后在/opt目录下就会生成一个名为loongson-gnu-toolchain-8.3-x86_64-loongarch64-linux-gnu-rc1.3-1的文件夹。这个路径很长但先别急着改名因为后续的CMake配置需要精确指向它。安装好不等于能用。我们需要让系统知道这个工具链的存在。最直接的方法是把工具链的bin目录添加到系统的PATH环境变量中。你可以编辑当前用户的家目录下的.bashrc文件nano ~/.bashrc在文件末尾添加一行export PATH/opt/loongson-gnu-toolchain-8.3-x86_64-loongarch64-linux-gnu-rc1.3-1/bin:$PATH保存退出后执行source ~/.bashrc让配置生效。现在你可以在终端里输入loongarch64-linux-gnu-gcc --version并回车。如果终端打印出了GCC的版本信息比如gcc version 8.3.0并且前缀是loongarch64-linux-gnu-那么恭喜你工具链安装成功了这座连接x86世界与龙芯世界的“桥梁”已经架通。不过这里有个非常重要的细节需要提醒这个工具链是裸工具链它只包含了最基本的编译器和运行时库比如libc。而OpenCV的编译依赖很多第三方库比如libjpeg, libpng, libtiff等。在常规的x86开发中我们用apt安装的-dev包就提供了这些库的头文件和链接库。但在交叉编译时我们需要的是这些库的龙芯版本即同样用LoongArch指令集编译好的库文件。如果缺失OpenCV的CMake配置阶段可能会报错找不到某个库或者即使配置通过编译出来的OpenCV库在板子上运行也会因为链接不到正确的库而崩溃。因此更完整的做法是除了基础工具链还要准备或编译一套针对LoongArch的第三方依赖库。这是一个进阶话题有些工具链包可能会以sysroot的形式提供部分基础库。对于新手如果只是为了编译OpenCV基础功能可以暂时利用OpenCV源码自带的第三方库在opencv/3rdparty目录下以及工具链自带的系统库。但心里要明白如果需要用到更高级的特性如FFmpeg视频编解码可能就需要额外交叉编译这些依赖了。我们接下来的步骤会先基于相对简单的假设进行确保你能走通整个流程。3. OpenCV源码与依赖库备好“建筑材料”工具链这座“桥梁”搭好了接下来我们要准备在“桥”的另一头龙芯平台盖房子所需的“建筑材料”——也就是OpenCV的源代码和它编译时所需的各种依赖库。这一步看似简单就是下载和安装但里面有很多细节直接决定了后续编译的成败。首先是OpenCV版本的选择。开源计算机视觉库OpenCV版本众多有长期支持版如3.4.x, 4.x系列也有持续开发的主干版。对于嵌入式平台尤其是像龙芯2K0300这样资源相对有限的平台我强烈推荐使用OpenCV 3.4.x系列比如原文中提到的3.4.16或者3.4.6。为什么不是最新的OpenCV 4主要原因有三点1.体积与依赖OpenCV 4引入了更多新模块和功能体积更大依赖也可能更复杂对嵌入式存储空间和性能都是考验。2.稳定性OpenCV 3.4是一个非常成熟、稳定的长期支持版本社区资源丰富遇到的绝大多数问题都能找到解决方案。3.兼容性很多为嵌入式平台优化的老教程、代码示例都是基于3.4的跟着做成功率更高。当然如果你的项目必须用到4.x的某些特性那也只能迎难而上但那意味着你可能要面对更多编译和依赖上的挑战。确定版本后去OpenCV的GitHub Release页面https://github.com/opencv/opencv/releases找到对应版本如3.4.16的Source code (zip)包下载。我建议直接在Ubuntu虚拟机里用wget命令下载避免从宿主机拖拽文件可能产生的编码或权限问题。wget https://github.com/opencv/opencv/archive/refs/tags/3.4.16.zip下载完成后创建一个清晰的工作目录。我的习惯是在家目录下创建一个projects/loongson的目录树把相关东西都放里面比如mkdir -p ~/projects/loongson/opencv cd ~/projects/loongson/opencv把下载的zip包移动到这里然后解压unzip 3.4.16.zip解压后会得到一个opencv-3.4.16的源码目录。接下来按照最佳实践我们在其同级目录下创建两个文件夹build和install。build目录用于存放所有编译过程中产生的中间文件保持源码目录的纯净install目录则是我们最终编译好的OpenCV库的安装目的地。命令如下mkdir build install现在源码准备好了但光有砖头OpenCV源码还盖不了房子还需要水泥、沙子依赖库。这就是接下来要做的在Ubuntu主机上安装OpenCV编译所需的原生开发依赖包。注意这里安装的库是x86_64版本的它们的作用是当CMake运行configure阶段时需要调用一些本地的工具如pkg-config和编译一些在主机上运行的小测试程序来探测目标平台龙芯的特性。这些依赖并不会被链接到最终给龙芯用的OpenCV库里但如果没有它们配置阶段就无法正确进行。安装命令是一个长长的apt-get install列表这正是容易出错的地方。务必确保你的虚拟机网络通畅并且已经换好了国内的软件源否则下载会非常慢甚至失败。一条条执行以下命令sudo apt-get update sudo apt-get install build-essential cmake cmake-qt-gui cmake-curses-gui sudo apt-get install libopenblas-dev libatlas-base-dev gfortran sudo apt-get install pkg-config sudo apt-get install libavcodec-dev libavformat-dev libswscale-dev libv4l-dev sudo apt-get install libjpeg-dev libpng-dev libtiff5-dev libdc1394-22-dev sudo apt-get install libxvidcore-dev libx264-dev sudo apt-get install libtbb-dev liblapacke-dev sudo apt-get install python3-dev python3-numpy这里解释几个关键包build-essential提供了基础的编译工具make, gcc等cmake-qt-gui就是我们后面要用到的图形化CMake配置工具libopenblas-dev或libatlas-base-dev是线性代数计算库对OpenCV的性能优化很重要libjpeg-dev,libpng-dev等是图像编解码库libtbb-dev是英特尔线程构建模块用于并行加速。把这些依赖都装齐相当于把编译所需的“本地工具”和“探测环境”都准备好了能最大程度减少后续配置时出现的“找不到XXX”的错误。4. CMake图形化配置给编译“画图纸”所有材料备齐终于到了最核心也最需要耐心的环节——CMake配置。你可以把CMake看作一个高级的建筑图纸生成器。它读取OpenCV源码中的CMakeLists.txt相当于建筑需求书再结合你提供的具体参数比如用什么编译器、装到哪里、要哪些功能生成一套适用于你当前平台的Makefile详细的施工图纸。我们这里要做的就是通过CMake的图形化界面cmake-gui告诉它“请用龙芯的那个交叉编译工具链来生成能在久久派上运行的库的图纸。”首先进入我们之前创建的build空目录然后启动cmake-guicd ~/projects/loongson/opencv/build cmake-gui 一个图形界面窗口会弹出来。界面主要分两部分上半部分用于指定源码路径和构建路径下半部分是一个参数列表。指定源码和构建路径在“Where is the source code:”输入框点击Browse Source...选择到你解压的OpenCV源码目录例如/home/yourname/projects/loongson/opencv/opencv-3.4.16。在“Where to build the binaries:”输入框确保它指向我们当前的build目录例如/home/yourname/projects/loongson/opencv/build。这个路径应该已经被自动填好了。关键的一步指定交叉编译工具链。 点击中间区域的Configure按钮。这时会弹出一个对话框让你“Specify the generator for this project”。保持默认的“Unix Makefiles”即可但下面有一个关键选项“Specify native compilers”。一定要勾选它勾选后点击Next。填写交叉编译器路径 现在会出现三个输入框让我们手动指定C、C编译器和目标系统根目录。C编译器 (C): 点击后面的...浏览到你的交叉工具链的bin目录找到loongarch64-linux-gnu-gcc并选中。完整路径类似/opt/loongson-gnu-toolchain-8.3-x86_64-loongarch64-linux-gnu-rc1.3-1/bin/loongarch64-linux-gnu-gcc。C编译器 (C): 同理选择同目录下的loongarch64-linux-gnu-g。目标系统根目录 (Target Root): 这里要填写工具链的根目录而不是bin目录。即/opt/loongson-gnu-toolchain-8.3-x86_64-loongarch64-linux-gnu-rc1.3-1。CMake会在这个目录下寻找sysroot等信息。填好后点击Finish。CMake会开始第一次配置这个过程会探测你的系统环境和工具链。第一次配置后的参数调整 配置完成后下方参数列表会变成红色表示新修改或未确认的状态。这里我们需要修改几个关键参数CMAKE_BUILD_TYPE: 如果你想生成带调试信息的库可以设为Debug为了性能和减小体积通常设为Release。CMAKE_INSTALL_PREFIX: 这是最终安装路径。把它设置为我们之前创建的install目录的绝对路径例如/home/yourname/projects/loongson/opencv/install。这样make install后所有生成的头文件和库文件都会整齐地放在这里。CMAKE_EXE_LINKER_FLAGS和CMAKE_SHARED_LINKER_FLAGS: 为了确保链接正确我们可能需要添加一些额外的链接器标志。在CMAKE_EXE_LINKER_FLAGS的值后面注意是追加不要覆盖原有内容加上-lpthread -lrt -ldl。这几个库线程、实时、动态加载是Linux系统常用的显式链接可以避免一些未定义引用错误。WITH_FFMPEG: 如果你确定不需要视频编解码功能可以将其取消勾选设为OFF。FFmpeg的交叉编译依赖非常复杂新手建议先关闭降低难度。等基础库编译成功后再考虑。BUILD_TESTS和BUILD_PERF_TESTS:务必取消勾选设为OFF。这些测试用例是需要编译成可执行文件在主机上运行的但我们的编译器是给龙芯用的编译出来的测试程序根本无法在x86主机上执行会导致配置失败。BUILD_opencv_world: 如果你希望将所有OpenCV模块打包成一个单独的巨无霸库libopencv_world.so可以勾选此选项。这会让链接你的应用程序时变得简单但库文件会很大。对于嵌入式平台我通常不勾选只编译我需要的模块以节省空间。处理可能的错误与补丁 点击Configure按钮再次配置。这次配置后红色条目会减少。反复点击Configure直到没有红色条目出现且没有新的错误信息输出在底部的日志窗口。 在这个过程中你可能会遇到一个经典错误提示protobuf相关文件缺少HAVE_PTHREAD定义。这是因为源码里的一处小瑕疵。解决方法如下 用文本编辑器打开OpenCV源码目录下的这个文件opencv-3.4.16/3rdparty/protobuf/src/google/protobuf/stubs/common.cc。 在文件开头#include语句的后面添加一行宏定义#define HAVE_PTHREAD保存文件。然后回到CMake-gui再次点击Configure。这个错误就应该消失了。生成Makefile 当所有配置都完成且没有错误后输出信息最后看到“Configuring done”点击Generate按钮。如果成功你会看到“Generating done”的提示。至此build目录下就生成了完整的、针对龙芯2K0300平台的Makefile“施工图纸”。你可以关掉CMake-gui了接下来的工作将在终端命令行中完成。5. 编译、安装与测试漫长的“施工”与验收图纸Makefile已经生成接下来就是执行make命令启动漫长的编译“施工”过程。这个过程完全在终端中进行耗时很长是对你虚拟机性能和耐心的一次考验。首先确保你还在build目录下。然后输入编译命令make -j$(nproc)这里的-j$(nproc)参数非常有用。nproc命令会获取你虚拟机可用的CPU核心数-j选项则告诉make工具使用多线程并行编译。如果你的虚拟机分配了4个核心这行命令就相当于make -j4可以充分利用所有CPU资源将编译时间缩短到原来的三分之一甚至更多。编译OpenCV 3.4.16在配置合理的虚拟机上这个过程可能需要30分钟到1个多小时。期间终端会疯狂滚动输出编译信息只要不出现红色的error字样导致编译停止就安心等待。编译过程中你可能会看到很多warning警告这在大规模开源项目编译中非常常见通常可以忽略除非是同一类警告大量出现可能预示着潜在的兼容性问题。如果编译真的出错了首先看错误信息的最后几行它通常会指出是哪个文件、哪一行代码出了问题。常见错误原因包括依赖库缺失虽然我们之前装了很多但可能仍有遗漏、工具链路径不对、或者源码补丁没打对。这时需要根据错误关键词去搜索解决方案。当终端最终停止滚动出现类似[100%] Built target opencv_xxx的提示并且命令行光标重新闪烁等待输入时恭喜你编译成功了接下来是安装将编译好的库文件、头文件等复制到我们之前指定的CMAKE_INSTALL_PREFIX目录即install文件夹sudo make install这里使用sudo是因为安装过程可能需要向系统目录写入的权限但因为我们指定的是用户家目录下的install文件夹所以通常不加sudo也可以。安装过程很快几秒钟就完成了。现在进入install目录看看我们的劳动成果cd ../install ls -la你应该能看到类似这样的目录结构bin/ include/ lib/ share/lib文件夹里存放着编译好的动态库.so文件和静态库.a文件例如libopencv_core.so.3.4.16。include文件夹里是所有OpenCV的头文件。bin里可能有一些工具如果编译了的话。share里是OpenCV的一些配置文件。看到这些就证明基于龙芯2K0300交叉编译工具链的OpenCV库已经成功生成并安装好了最后的验收测试真正的测试需要把install目录下的整个lib和include打包拷贝到龙芯2K0300久久派的文件系统中并编写一个简单的OpenCV程序比如读一张图片、显示图片尺寸在板子上编译运行。在久久派上编译测试程序时需要指定交叉编译工具链和OpenCV库的路径# 在久久派上或使用交叉工具链编译测试程序 loongarch64-linux-gnu-g -o test_opencv test.cpp \ -I /path/to/your/install/include/opencv2 \ -I /path/to/your/install/include \ -L /path/to/your/install/lib \ -lopencv_core -lopencv_imgcodecs -lopencv_highgui然后通过SD卡、网络等方式将可执行文件test_opencv和一张测试图片传到久久派上设置好库路径并运行export LD_LIBRARY_PATH/path/to/your/install/lib:$LD_LIBRARY_PATH ./test_opencv test.jpg如果程序能正常运行并输出正确信息那么整个从x86虚拟机到龙芯嵌入式板的OpenCV交叉编译实战才算画上了一个圆满的句号。这个过程虽然步骤繁琐但每一步都踩稳了就能为后续在久久派上开发更复杂的视觉应用打下坚实的基础。记住嵌入式开发就是这样一个在主机和目标板之间反复折腾、调试的过程成功编译出第一个库的那一刻那种成就感会让你觉得所有的等待和排查都是值得的。