GS-IMX91QSB: IMX91QSB快速入门
1. 开箱即用
下面描述了启动i.MX 91 QSB的步骤。
开发套件包含：
- i.MX 91 QSB以及搭载恩智浦Wi-Fi 6三频IW610的M.2模块
- 电源：USB-Type C 45W电源输送，支持5V/3A；9V/3A；15V/3A；20V/2.25A
- 线缆：组装，USB 2.0，Type-C公头转Type-A公头
- 软件：在eMMC中烧写的Linux BSP镜像
- 快速入门指南
按照演示视频所示步骤，采用i.MX 91 QSB开始开发应用。如需了解更多信息，请访问i.MX 91应用处理器文档。
1.2 启动选项
i.MX 91 QSB配备一个预构建的恩智浦Linux二进制演示镜像，烧写在eMMC上。无需修改内部的二进制文件，从eMMC启动将提供具有某些功能的默认系统，在Linux上构建其他应用。
如需了解有关恩智浦Embedded Linux®的更多详情，请继续阅读后续章节。
1.3 连接USB调试线缆
将随附的USB-Type C线缆连接至调试UART端口J11，然后将线缆的另一端连接到主机。
主机上将显示四个UART连接。 第三个端口用于A55内核系统调试。如果您不熟悉终端应用，请先查看以下某个教程，再继续下一个章节：Minicom教程、Tera Term教程、PuTTY教程。
如需了解有关恩智浦Embedded Linux®的更多详情，请继续阅读后续章节。1.4 启动开关设置
SW3 [1-4]是启动配置开关。默认情况下，启动设备是eMMC/uSDHC1。
1.5 板启动
- 将电源线插入电源连接器
J13 - 拨动开关
SW5给板上电。
处理器开始执行片上ROM的代码。使用默认启动开关设置，代码读取熔丝，定义可能有可启动镜像的介质。找到可启动镜像后，U-Boot执行应自动开始。
信息在Arm® Cortex®-A55的串行控制台中打印。如果不停止U-boot流程，就会继续启动内核。
板启动。当板启动时，串行端口开始向PC打印日志信息。恭喜，已顺利启动并运行。
2. 获取软件
i.MX Linux板级支持包(BSP)是一系列二进制文件、源代码和支持文件，可用来启动特定i.MX开发平台上的Embedded Linux镜像。
当前Linux二进制演示文件版本请参见Linux下载页面。i.MX软件和开发工具的Linux部分中的i.MX Linux文档包提供其他文档。
2.1 概述
i.MX 91 QSB支持从eMMC和SD卡启动。
本入门指南仅概述了将Linux BSP镜像烧写到SD卡的几种方法。经验丰富的Linux开发人员可根据需要探究其他选项。
2.2 下载恩智浦Linux BSP预构建镜像
i.MX 91 QSB最新的预构建镜像在Linux下载页面提供。
预构建的恩智浦Linux二进制演示镜像提供典型系统和基本的功能集，用于使用和评估处理器。无需修改系统，用户就可以评估硬件接口、测试SoC功能并运行用户空间应用。
2.3 使用Universal Update Utility (UUU)烧写恩智浦Linux BSP镜像
除了“开箱即用”章节的连接外，使用USB线缆将USB1 (J12)连接到主机。
给板断电。参考“1.4 启动开关设置”章节，配置板在串行下载协议(SDP)模式启动。
根据主机中使用的操作系统，将Linux BSP镜像传输到SD卡的方式可能会有所不同。从下面的选项中进行选择，获取详细指导：
Linux®
- 在Linux Distro上安装UUU
- 将恩智浦Linux BSP镜像烧写到板上
如需下载最新的stable文件，请访问UUU GitHub页面 。如果需要有关UUU的进一步帮助，请参阅本详细教程。
在默认情况下，本流程将镜像烧写到SD卡中。查看UUU GitHub页面 ，了解如何将镜像烧写到其他设备。
打开终端应用并将目录更改为uuu及i.MX 91 QSB最新Linux版本所在位置。向uuu文件添加执行权限并执行。uuu等待USB设备连接。
$ chmod a+x uuu
$ sudo ./uuu -b sd_all imx-image-full- imx91qsb.rootfs.wic.zst确认i.MX 91 QSB启动模式已切换至串行下载模式，然后打开板，uuu开始将镜像烧写到SD卡。
完成后，为板和终端断电。如果需要进一步帮助来配置板从SD卡启动，请参阅“1.4 启动开关设置”。
Windows®
- 在Windows Distro上安装UUU
uuu.exe- 串行USB驱动程序（取决于您的板和Windows安装——检查Windows设备管理器）
- 将恩智浦Linux BSP镜像烧写到板上
如需下载最新的stable文件，请访问UUU GitHub页面 。如果需要有关UUU的进一步帮助，请参阅本详细教程。
在默认情况下，本流程将镜像烧写到SD卡中。查看UUU GitHub页面 ，了解如何将镜像烧写到其他设备。
打开命令提示应用，浏览至uuu.exe文件及i.MX 91 QSB最新Linux版本所在位置。
uuu.exe -b sd_all imx-image-full-imx91qsb.rootfs.wic.zst确认i.MX 91 QSB启动模式已切换至串行下载模式，然后打开板，uuu开始将镜像拷贝到板上。
完成后，关闭板和命令提示应用。如需获得关于配置板从SD卡启动的进一步帮助，请参阅“启动开关设置”。
3. 构建、运行
本节简要介绍了如何为i.MX 91 QSB构建Yocto BSP镜像、如何添加Matter支持。
3.1 i.MX 91 QSB Yocto BSP
i.MX 91 QSB BSP基于i.MX SW 2025 Q2版本和Yocto Project 5.2 (Walnascar)。要从源代码构建i.MX 91 QSB BSP镜像，先查阅《i.MX Yocto Project用户指南》 ，熟悉Yocto Project和Yocto Build。然后，按照以下步骤为i.MX 91 QSB构建镜像。
- 下载i.MX SW 2025 Q2 BSP版本：
- Yocto Project设置：
- 烧写SD卡镜像：
- 将启动开关SW1[1:4]更改为“0011”以选择SD卡启动，插入SD卡并启动i.MX 91 QSB
$ repo init -u https://github.com/nxp-imx/imx-manifest -b imx-linux-walnascar -m
imx-6.12.20-2.0.0.xml
$ repo sync$ MACHINE=imx91-9x9-lpddr4-qsb DISTRO=fsl-imx-xwayland source imx-setup-release.sh -b
bld-xwayland-imx91qsb1$ zstdcat imx-image-full-imx91qsb.rootfs.wic.zst | sudo dd of=/dev/sdx bs=1M && sync或使用uuu将镜像烧写到SD卡：
$ uuu -b sd_all imx-image-full-imx91qsb.rootfs.wic.zst3.2 i.MX 91 QSB Matter支持
i.MX 91 QSB支持Matter。要加入Matter支持，请按照以下步骤将Matter层纳入Yocto构建。
- 下载i.MX SW 2025 Q2 BSP版本：
- 下载i.MX Matter Yocto层：
- Yocto Project设置：
- 构建镜像：
$ repo init -u https://github.com/nxp-imx/imx-manifest -b imx-linux-walnascar -m imx-6.12.20-2.0.0.xml
$ repo sync1$ cd ${MY_YOCTO}/sources/meta-nxp-connectivity
$ git remote update
$ git checkout imx_matter_2025_q21$ cd ${MY_YOCTO}
$ MACHINE=imx91qsb-iwxxx-matter DISTRO=fsl-imx-xwayland source sources/meta-nxp-connectivity/tools/imx-matter-setup.sh bld-xwayland-imx91qsb$ bitbake imx-image-multimedia4. Developer Experience (开发人员体验)
为了帮助各种技能水平的用户加速开发，恩智浦提供了丰富的示例应用，以展示该平台的各种功能和性能。
4.1 Application Code Hub (应用代码中心)
工程师可以通过应用代码中心 (ACH)资料库轻松查找由恩智浦专家开发的微控制器和处理器软件示例、代码片段和应用软件包及演示。在代码中心，可轻松快速且集中地查找微控制器和处理器应用。
ACH提供筛选和搜索选项，让您能够快速找到特定的应用。在Git功能的加持下，您可以在用户开发环境中轻松导入并使用应用。
了解应用代码中心(ACH)的详情。
4.2 面向i.MX应用处理器的GoPoint
面向i.MX应用处理器的GoPoint是一款用户友好型应用，可启动Linux BSP预构建的应用，为用户提供卓越的开箱即用体验，并可亲身体验i.MX SoC的功能。GoPoint不仅突出了高级功能，还提供了实用的实现解决方案，并在GitHub 上提供了应用的源代码和构建配方。
调试终端设置
在Linux中调试终端
串行控制台通信的设置
在Linux主机的命令提示符上，运行以下命令，确定端口号：
1$ ls /dev/ttyUSB*第三个端口用于Arm® Cortex®-A55。
Minicom
- 使用以下命令安装和运行Minicom程序：
- 使用先前确定的端口号通过控制台窗口启动Minicom
1$ sudo apt-get install minicom1$ sudo minicom /dev/ttyUSB* -s
在Windows中调试终端
串行控制台通信的设置
i.MX 91 QSB上的FTDI USB串行芯片将枚举4个串行端口。假设端口为COM11、COM12、COM13、COM14。第三个端口(COM13)用于Arm® Cortex®-A55的串行控制台通信。串行转USB驱动程序请参见FTD芯片驱动 。
Tera Term
Tera Term是一款开源终端仿真应用。此程序显示从恩智浦开发平台的虚拟串行端口发送的信息。
- 下载Tera Term。下载完成后，运行安装程序，然后返回到该页面继续操作。
- 启动Tera Term。首次启动时，会显示以下对话。选择串行选项。假设已连接了板，列表中会自动填充一个COM端口
- 配置串行端口设置(使用之前确定的COM端口号)，波特率为115200，数据位为8，无奇偶校验位，停止位为1。要进行此操作，进入Setup→Serial Port (设置→串行端口)并更改设置。
- 确认连接已打开。
PuTTY
PuTTY是一款广受欢迎的终端仿真应用。此程序显示从恩智浦开发平台的虚拟串行端口发送的信息。
- 下载PuTTY。下载完成后，运行安装程序，然后返回到该页面继续操作。
- 启动PuTTY，可双击下载的可执行文件或从“开始”菜单启动，具体取决于您所选的下载类型。
- 配置在启动的窗口中进行。选择Serial单选按钮并输入之前确定的COM端口号。还要输入波特率，在本例中，为115200
- 点击“Open”(打开)，打开串行连接。假设板已连接，并已输入正确的COM端口，此终端窗口会打开。如果配置不正确，PuTTY将会发出提示
支持
故障排除
安全性和完整性
系统安全性与完整性始终是产品开发中最为关键的考虑要素之一。
i.MX 91 QSB支持安全启动和加密启动功能，有效防止设备在启动序列中执行未经授权的软件，并保护引导加载程序数据免遭未授权的访问。
有关安全启动功能的详细说明，请参阅应用笔记《在支持AHAB的设备上实现安全启动》。
有关加密启动功能的详细说明，请参阅应用笔记《在支持AHAB的i.MX设备上实现加密启动》。
快速启动
在某些应用场景下，对设备启动时间有严格要求，即设备必须在限定时间内完成启动过程。
为优化启动时间，i.MX 91 QSB在U-Boot中支持Falcon模式。Falcon模式是U-Boot的一项功能，它允许SPL直接启动Linux内核，从而实现快速启动。它完全跳过了U-Boot的加载和初始化，从而减少在引导加载程序中花费的时间。
关于如何启用Falcon模式以及进一步优化启动时间，请参阅应用笔记《通过Falcon模式及内核优化在i.MX 8M和i.MX 9上实现快速启动》。