# 环境搭建

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

---

本文档介绍如何搭建UniRTOS编译环境，并指导安装相关的工具与驱动。

# USB驱动安装

## 安装程序

1. 解压下载好的 [驱动压缩包](<https://www.quectel.com.cn/download/quectel_windows_usb_drivery_v1-0_cn>)，双击 *setup.exe* 执行安装。

2. 根据提示选择安装目录，完成后点击“**Next**”即可。推荐选择默认路径。

```{image} images/image_GFVUbBmMOondX6xreAHcKM0rnCM.webp
:width: 500px
:height: 381px
:align: center
```

3. 等待安装进度条完成，点击“**Finish**”。

```{image} images/image_TZSZbssRpoVCAWxIepRcapzUnub.webp
:width: 500px
:height: 381px
:align: center
```

## 验证驱动

使用USB数据线连接PC与开发板，长按开发板的电源键开机。在设备管理器中查看是否识别出以“Quectel”开头的端口，若显示该端口，则表示驱动安装成功。如图所示：

```{image} images/image_Oy6SbBVxyoub5WxSo3xcSf1tneh.webp
:width: 781px
:height: 572px
:align: center
```

# unirtos-toolchain编译工具链安装

## 安装程序

1. 解压下载好的 [工具压缩包](<https://www.quectel.com.cn/download/unirtos-%e4%ba%a4%e5%8f%89%e7%bc%96%e8%af%91%e5%b7%a5%e5%85%b7%e9%93%be>)，双击 *unirtos-toolchain.exe* 执行安装程序，若提示申请管理员权限，请点击“**同意**”。

2. 根据提示选择安装目录（默认为 *D:\unirtos-toolchain*），用户可根据需要自定义安装目录。解压后文件约占4.3 GB空间，请确保磁盘空间充足。

```{image} images/image_IhAObAipQoHfCOxv9bLcxC1bndd.webp
:width: 523px
:height: 391px
:align: center
```

3. 安装目录结构如下：

```{image} images/image_FyOJbCzUuoINJvxqnfCc1kK9nnc.webp
:width: 823px
:height: 595px
:align: center
```

## 验证编译环境

新建命令行窗口，输入 **unirtos.exe --version** 检查版本信息。若成功输出版本信息（如下图所示），则表示编译环境安装完成。

```{image} images/image_VSLUbFfrHoIy0zx71jic0sz1nYe.webp
:width: 553px
:height: 152px
:align: center
```

# Python环境安装

## 下载安装包

1. 进入 [Python官网](<https://www.python.org/>)，选择“**Download**”选项下的“**Windows**”版本。

```{image} images/image_AU6sbI5zNots3zxpFCFcXi1Enjh.webp
:width: 1905px
:height: 740px
:align: center
```

2. 根据实际使用的系统下载对应版本。例如：若使用Windows 64位系统，选择“Windows installer (64-bit)”即可。

```{image} images/image_NhQdbWpaYocND6xmorkcyowanod.webp
:width: 1895px
:height: 863px
:align: center
```

## 安装Python程序

1. 双击下载的“.exe”可执行程序开始安装，勾选底部“**Use admin privileges when installing py.exe**”和“**Add python.exe to PATH**”两个选项，点击“**Install Now**”。如需配置特定功能或修改安装目录，可选择“**Customize installation**”。

```{image} images/image_TN2ibzjpAo3Fjax5lCEcCY66nhd.webp
:width: 814px
:height: 502px
:align: center
```

2. 显示此页面即表示Python安装成功。

```{image} images/image_T929bLgJ2oeInUxduz1cI6q9nge.webp
:width: 820px
:height: 506px
:align: center
```

3. 打开PowerShell或cmd窗口，输入“**python --version**”查询。若安装成功，将输出版本号，如下图所示。若未输出版本号或报错“找不到Python命令”，可能是安装过程中未勾选添加环境变量，可手动添加Python执行路径到环境变量中。

```{image} images/image_AkOhbVJ16okGtyx4zXjcnek4nOs.webp
:width: 661px
:height: 283px
:align: center
```

# Git工具安装

## 下载安装包

进入 [Git官网](<https://git-scm.com/install/windows>)，下载系统对应的安装包。

```{image} images/image_L41hb1nAcoiRPHxyYJ4cvd7snyc.webp
:width: 1905px
:height: 919px
:align: center
```

## 安装Git工具

1. 双击下载的“**.exe**”可执行程序开始安装，点击“**Next**”进入下一步。

```{image} images/image_Q3JobDvyIo0QQsxm8L6cE4NTnuf.webp
:width: 798px
:height: 615px
:align: center
```

2. 选择Git工具的安装目录。

```{image} images/image_CpbFbxqW3o87jhxOhUfcH2s9neg.webp
:width: 798px
:height: 615px
:align: center
```

3. 后续功能选项配置根据自身需求选择即可。最后出现此页面时，点击“**Finish**”完成安装。

```{image} images/image_WDc4blH9QoSybmxXqQqcQwjnntK.webp
:width: 798px
:height: 615px
:align: center
```

4. 打开PowerShell或cmd窗口，输入“**git --version**”查询。若安装成功，PowerShell终端将输出版本号，如下图所示。若未输出版本号或报错“找不到git命令”，请确认Git的安装目录已添加到环境变量中。

```{image} images/image_H3gibLf4HoaaN2xf5WQcOaHrnOf.webp
:width: 565px
:height: 273px
:align: center
```

# **unirtos-cli工具安装**

## 安装unirtos-cli工具

1. 按下“**Win + R**”键，输入“**powershell**”，打开Windows的PowerShell窗口。

```{image} images/image_EttGbVSqXo0IwnxQzCmcbi2nnAd.webp
:width: 399px
:height: 230px
:align: center
```

2. 在PowerShell窗口输入命令“**pip install unirtos-cli**”安装unirtos-cli工具，随后输入“**unirtos-cli version**”，若成功输出版本号，则表示工具安装成功，如下图所示。

```{image} images/image_C5j2bkATdonD2kx39MIc2EC2nCg.webp
:width: 530px
:height: 185px
:align: center
```

# QFlash烧录工具安装

QFlash为免安装工具，解压下载好的 [压缩包](<https://www.quectel.com.cn/download/qflash_v7-9_cn>)，打开安装目录，双击其中的.exe可执行程序即可运行。

```{image} images/image_Qh3JbD15CoPhInxjPY5c9mwknL7.webp
:width: 862px
:height: 591px
:align: center
```

# EPAT工具安装

详情参考 [EPAT工具使用教程](<../../开发工具/EPAT工具使用教程/EPAT工具使用教程.md>)。

# QCOM工具安装

详情参考 [QCOM使用教程](<../../开发工具/QCOM使用教程/QCOM使用教程.md>)。