衡山派Luban-Lite SDK构建与开发命令详解：SCons与OneStep实战指南

衡山派Luban-Lite SDK构建与开发命令详解SCons与OneStep实战指南最近在用衡山派ArtInChip的开发板做项目发现他们的Luban-Lite SDK用起来挺顺手的特别是里面那套构建和开发命令把很多繁琐的步骤都简化了。不过刚开始接触时面对一堆命令也容易懵圈不知道从哪下手。今天我就结合自己的使用经验给大家详细拆解一下SDK里最核心的两套命令SCons构建系统命令和OneStep易用性命令集。无论你是刚拿到衡山派开发板还是想更高效地管理多项目配置这篇教程都能帮你快速上手少走弯路。咱们的目标是看完就能照着做把代码编译成能烧录的固件。1. 认识构建系统SCons在嵌入式开发里把一堆源代码、库文件变成最终能运行的二进制固件这个过程就叫“构建”。Luban-Lite SDK用的是SCons这个构建工具。它最大的好处是跨平台也就是说你在Windows电脑上用的命令和在Linux电脑上用的完全一样不用记两套东西。SCons命令是SDK构建的基础所有底层的编译、链接工作都由它来完成。下面咱们来看看最常用的几个SCons命令。1.1 第一步看看有哪些项目可选 (scons --list-def)刚打开SDK目录你可能会问“我该编译哪个” SDK里通常预置了针对不同开发板、不同存储介质比如Nor Flash或NAND Flash、不同软件框架比如裸机Bootloader或RT-Thread系统的多个项目模板。这时候就用scons --list-def命令。它会列出所有内置的项目配置。scons --list-def运行后你会看到类似下面的输出具体项目列表会根据你的SDK版本略有不同scons: Reading SConscript files ... Built-in configs: 0. d12x_demo68-nand_baremetal_bootloader 1. d12x_demo68-nand_rt-thread_helloworld 2. d12x_demo68-nor_baremetal_bootloader 3. d12x_demo68-nor_rt-thread_helloworld 4. d12x_hmi-nor_baremetal_bootloader 5. d12x_hmi-nor_rt-thread_helloworld 6. d13x_demo88-nand_baremetal_bootloader 7. d13x_demo88-nand_rt-thread_helloworld 8. d13x_demo88-nor_baremetal_bootloader 9. d13x_demo88-nor_rt-thread_helloworld 10. d13x_kunlunpi88-nor_baremetal_bootloader 11. d13x_kunlunpi88-nor_rt-thread_helloworld 12. d21x_demo128-nand_baremetal_bootloader 13. d21x_demo128-nand_rt-thread_helloworld 14. g73x_demo100-nor_baremetal_bootloader 15. g73x_demo100-nor_rt-thread_helloworld怎么看懂这个列表呢以d12x_demo68-nor_rt-thread_helloworld为例d12x: 芯片型号比如D12x系列。demo68: 开发板型号。nor: 存储介质是Nor Flash。rt-thread_helloworld: 基于RT-Thread实时操作系统的“Hello World”示例应用。你需要根据自己手里的开发板型号和想跑的程序来选择一个合适的项目。1.2 选定你的项目 (scons --apply-def)知道有哪些项目后就要告诉SCons“我接下来要操作的是这个项目”。这就是scons --apply-def命令的用途。你可以用项目的完整名称来指定scons --apply-defd12x_demo68-nor_rt-thread_helloworld_defconfig或者更简单点直接用前面列表里看到的索引号比如3scons --apply-def3执行成功后会看到类似Load config from target\configs\...的提示说明项目配置已经加载好了。这个操作相当于为后续的配置、编译命令设置好了“工作上下文”。注意每次新打开一个命令行终端进行开发时通常都需要先执行这一步来选定当前要操作的项目。1.3 配置项目 (scons --menuconfig)选好项目模板后你可能还想改点东西比如调整RT-Thread的内核功能、开启或关闭某个外设驱动、修改系统时钟等。这就需要用到配置界面。SCons通过scons --menuconfig命令调出我们熟悉的文本图形化配置菜单就是那个可以用方向键和回车操作的界面。scons --menuconfig这个命令会打开一个配置界面你可以在里面层层点选配置你的系统。配置完成后记得选择保存你的修改会被记录到项目的配置文件中。1.4 开始编译构建 (scons)配置搞定源代码也准备好了最关键的一步就是编译。最简单的编译命令就是scons这个命令会以简洁模式运行只显示主要的编译步骤和进度不会输出一大堆具体的编译器参数界面比较干净。如果你在调试想知道具体的编译命令、包含了哪些头文件路径、链接了哪些库可以加上--verbose参数scons --verbose这样所有编译细节都会打印出来方便你排查“为什么这个文件没编译”或者“链接时找不到某个函数”这类问题。1.5 清理编译产出 (scons --clean)有时候改动了代码但感觉编译结果不对劲或者想从头开始完整编译一次就需要清理之前编译生成的中间文件比如.o目标文件、.a库文件等。SCons提供了清理命令scons --clean或者更简短的写法scons -c执行后output目录下对应项目的编译中间文件会被清除。下次执行scons时所有源文件都会重新编译确保是最新的。2. 效率利器OneStep命令集虽然SCons命令功能完整但每次都要敲scons --apply-defxxx也挺麻烦的。衡山派的工程师们显然也想到了这点所以他们开发了一套叫做OneStep的易用性命令集。OneStep把那些常用的、带参数的SCons命令封装成了更简短的别名并且增加了一些提升开发效率的小工具用起来就像在Linux系统里操作一样顺手。2.1 如何启用OneStep在Windows上最简单。OneStep命令已经集成在SDK提供的win_cmd.bat或win_env.bat批处理脚本里了。你只需要双击运行这个批处理文件它就会打开一个配置好环境包括OneStep命令的命令行窗口。在Linux上需要手动把OneStep脚本“引入”到当前终端环境中。在SDK的根目录下执行source tools/onestep.sh执行后你就可以在当前这个终端窗口里使用所有OneStep命令了。为了方便我通常会把source /path/to/your/sdk/tools/onestep.sh这行命令加到Linux用户的~/.bashrc文件里这样每次打开终端都自动生效。2.2 OneStep命令全家福启用OneStep后输入h或者hmm命令就能看到所有可用的命令及其简要说明。$ h Luban-Lite SDK OneStep commands: hmm|h : Get this help. lunch [keyword] : Start with selected defconfig.e.g. lunch mmc menuconfig|me : Config application with menuconfig bm : Config bootloader with menuconfig km : Config application with menuconfig m|mb : Build bootloader application and generate final image ma : Build application only mu|ms : Build bootloader only c : Clean bootloader and application mc : Clean Rebuild all and generate final image croot|cr : cd to SDK root directory. cout|co : cd to build output directory. cbuild|cb : cd to build root directory. ctarget|ct : cd to target board directory. godir|gd [keyword] : Go/jump to selected directory. list : List all SDK defconfig. list_module : List all enabled modules. i : Get current projects information. buildall : Build all the *defconfig in target/configs rebuildall : Clean and build all the *defconfig in target/configs addboard|ab : Add new board *defconfig in target/configs aicupg : Burn image file to target board命令不少别担心咱们接下来就挑最常用的几个来讲覆盖从选项目到烧录的完整流程。2.3 核心开发流程命令实战假设我们现在要开始一个新的开发任务。1. 列出并选择项目 (listlunch)首先用list命令查看所有项目效果和scons --list-def一样。$ list假设我们想用索引为3的项目d12x_demo68-nor_rt-thread_helloworld。在OneStep里选择项目不用再敲长长的scons --apply-def直接用lunch命令后面跟索引号就行$ lunch 3如果你想用项目名称里的关键词来筛选也可以比如lunch nor它会列出所有包含“nor”的项目让你交互式选择。2. 查看当前项目信息 (i)选好项目后如果不确定当前环境是对应哪个板子、什么系统可以用i命令查看详细信息$ i scons: Reading SConscript files ... Target app: application/rt-thread/helloworld Target chip: d12x Target arch: riscv32 Target board: target/d12x/demo68-nor Target kernel: kernel/rt-thread Defconfig file: target/configs/d12x_demo68-nor_rt-thread_helloworld_defconfig Root directory: xxxxxxxxxxxxxx Out directory: output/d12x_demo68-nor_rt-thread_helloworld Toolchain: toolchain/bin\riscv64-unknown-elf-这个信息非常有用它确认了芯片架构是RISC-Vriscv32当前应用是RT-Thread的Hello World以及编译输出会放到哪个目录。3. 进入配置菜单 (me或menuconfig)要配置RT-Thread内核或应用就用me命令menuconfig的缩写$ me如果要配置Bootloader引导程序则用bm命令$ bm这两个命令分别对应了应用和Bootloader的配置比原始的scons --menuconfig更清晰。4. 一键编译 (m)配置保存好后最爽的时刻来了一键编译。OneStep的m命令或mb会帮你依次编译Bootloader和应用程序并把它们打包生成最终的可烧录镜像文件。$ m编译过程如果没问题最终的固件文件比如.bin或.img就会出现在i命令里显示的Out directory下面。5. 一键清理 (c)想重新编译时先用c命令清理$ c或者想一步到位完成“清理重新编译”可以用mc命令$ mc2.4 提升效率的辅助命令除了核心流程命令OneStep里还有一些能极大提升操作效率的“神器”。快速跳转目录SDK目录层次比较深经常要在根目录、输出目录、板级目录之间切换。croot或cr一秒跳回SDK根目录。cout或co跳转到当前项目的编译输出目录直接查看生成的固件。ctarget或ct跳转到当前目标板子的源码目录。godir或gd模糊搜索并跳转。比如gd rt-thread可以快速跳到RT-Thread相关的源码目录。批量操作buildall编译SDK里target/configs目录下的所有项目配置。适合在发布前做全面构建测试。rebuildall先清理再编译所有项目配置。烧录工具 (aicupg)这个命令会调用衡山派提供的烧录工具将编译好的镜像文件下载到开发板中。具体用法可能需要根据你的烧录器比如串口、DAP-Link等进行一些参数配置可以参考SDK中更详细的烧录文档。刚开始接触衡山派Luban-Lite SDK时你可以先从SCons的基础命令用起理解整个构建过程。等熟悉之后强烈建议切换到OneStep命令集它能让你每天的开发操作行云流水把精力更集中在代码逻辑本身而不是敲命令上。遇到不记得的命令随时h一下看看帮助很快就能上手。