编译工程

Copyright © Quectel Wireless Solutions Co., Ltd. 2026. All rights reserved.

---

本文档介绍如何基于UniRTOS进行固件编译，并生成对应的固件包。

工程目录结构

进入工程目录

进入新创建的工程所在目录，如下图所示：

目录结构说明

unirtos_helloworld_demos-1.0.0/
├── CMakeLists.txt                                     // CMake构建脚本
├── env_config.json                                    // unirtos-cli使用的环境配置文件
├── hello_world.c                                      // 应用源代码
├── README.md                                          // 应用说明文档
└── unirtos_helloworld_demos-1.0.0.code-workspace      // VS Code项目工作区文件

SDK目录结构

SDK存放路径

默认路径为 C:\Users<用户名>.unirtos，拉取的SDK位于该路径下的 sdk 目录中，如下图所示（以1.0.1版SDK为例）：

目录结构说明

目录树：
├─cmake                        // CMake相关配置文件
├─qos_applications/            // 存放应用示例与业务代码
│  ├─app_init                  // App层初始化相关文件
│  └─unirtos_std               // AT侧相关功能
├─qos_components/              // 系统组件与中间件
│  ├── components/             // 可裁剪功能组件
│  └── system/                 // 系统服务、驱动、协议栈
├─qos_kernel/                  // 存放各平台内核适配相关工程
│  └── eigen_718/              // 平台适配代码
└─qos_tools                    // 编译及调试工具
│  └── python/                 // 构建/配置/打包Python工具
├─build.sh                     // 一键构建脚本
├─CMakeLists.txt               // UniRTOS编译的主CMake工程文件
├─Kconfig                      // 主配置入口，管理宏控依赖及约束条件
└──...

编译固件

执行命令

当前以编译EG800ZCN_LA固件为例，在工程目录下打开PowerShell终端，输入以下命令。

unirtos-cli build -m EG800ZCN_LA -v EG800ZCNLAR01A01_OCPU_20260625

备注

如果实际使用的并非EG800ZCN_LA模块，需将命令中的模块型号替换为实际使用的型号。

等待编译结束后，日志末尾会提示固件编译结果。编译成功的日志如下图所示：

命令格式与参数说明

unirtos-cli build [-d <project-dir>] [-j <jobs>] [-m <module>] [-v <version>]

• 功能描述
  调用UniRTOS工具链编译当前外部应用。

• 参数说明

参数	默认值	优先级	说明
-d,--project-dir	.（当前命令执行路径）	-	项目目录
-j, --jobs	4	CLI > env_config.build.jobs > 4	并行编译线程数
-m,--module	env_config.build.module	CLI > env_config.build.module	模块名，例如 EG800ZCN_LA
-v,--version	应用根目录名称	CLI > env_config.build.version > 应用根目录名称	固件版本字符串

固件输出路径

固件包输出路径位于项目目录的 qos_build\release 路径下。