构建 RTSS 固件 - Qualcomm Dragonwing Documentation

构建 RTSS 固件的前提条件和步骤。

前提条件

注意

在 Ubuntu 22.04 主机上编译 RTSS 源代码。
按照 BSP image build with firmware 中的说明初始化构建环境。

运行 git clone 命令下载 RTSS 固件：

mkdir -p <FIRMWARE_ROOT>
cd <FIRMWARE_ROOT>
git clone -b <firmware release tag> --depth 1 https://qpm-git.qualcomm.com/home2/git/qualcomm/qualcomm-linux-spf-2-0_ap_standard_oem_sail.git

例如：

git clone -b r2.0_00007.2 --depth 1 https://qpm-git.qualcomm.com/home2/git/qualcomm/qualcomm-linux-spf-2-0_ap_standard_oem_sail.git

git clone 命令会将内容克隆到 <FIRMWARE_ROOT>/qualcomm-linux-spf-2-0_ap_standard_oem_sail.git 目录中。有关最新的 <firmware release tag>，请参阅 Release tags。

下载 FreeRTOS 内核。
1. 使用 git clone 命令克隆 FreeRTOS 内核：
  git clone https://github.com/FreeRTOS/FreeRTOS-Kernel.git -b V11.0.1
2. 进入 FreeRTOS 内核目录：
  cd FreeRTOS-Kernel
3. 将 croutine.c、cspell.config.yaml、event_groups.c、include manifest.yml、queue.c、stream_buffer.c、tasks.c、timers.c 和 list.c 文件复制到 <top_directory>/sail_proc/FreeRTOS/kernel/：
  cp -r croutine.c cspell.config.yaml event_groups.c include manifest.yml queue.c stream_buffer.c tasks.c timers.c list.c <top_directory>/sail_proc/FreeRTOS/kernel/

下载 Arm^® GNU Toolchain 编译器：

注意仅在 x86 64 位主机上安装 Arm GNU Toolchain 编译器。

从 Arm GNU Toolchain Downloads 下载 arm-gnu-toolchain-14.3.rel1-x86_64-arm-none-eabi 工具链变体：

wget https://developer.arm.com/-/media/Files/downloads/gnu/14.3.rel1/binrel/arm-gnu-toolchain-14.3.rel1-x86_64-arm-none-eabi.tar.xz

解压下载的 arm-gnu-toolchain-14.3.rel1-x86_64-arm-none-eabi.tar.xz 文件：
tar -xf arm-gnu-toolchain-14.3.rel1-x86_64-arm-none-eabi.tar.xz
进入 sail_proc 目录：
cd sail_proc
在 sail_proc 目录下创建 toolchain 文件夹：
mkdir toolchain

将解压得到的 arm-gnu-toolchain-14.3.rel1-x86_64-arm-none-eabi 文件夹复制到 sail_proc/toolchain 目录中。

cp -r arm-gnu-toolchain-14.3.rel1-x86_64-arm-none-eabi <FIRMWARE_ROOT>/qualcomm-linux-spf-2-0_ap_standard_oem_sail/SAIL.SI.1.2/sail_proc/toolchain

从 <FIRMWARE_ROOT>/ 的顶层目录导出 SECTOOLS 变量：对于 IQ-9075：

export SECTOOLS= <FIRMWARE_ROOT>/qualcomm-linux-spf-2-0_ap_standard_oem_sail/QCS9100.LE.2.0/common/sectoolsv2/ext/Linux/sectools
export SECTOOLS_DIR= <FIRMWARE_ROOT>/qualcomm-linux-spf-2-0_ap_standard_oem_sail/QCS9100.LE.2.0/common/sectoolsv2/ext/Linux

对于 IQ-8275：

export SECTOOLS= <FIRMWARE_ROOT>/qualcomm-linux-spf-2-0_ap_standard_oem_sail/QCS8300.LE.2.0/common/sectoolsv2/ext/Linux/sectools
export SECTOOLS_DIR= <FIRMWARE_ROOT>/qualcomm-linux-spf-2-0_ap_standard_oem_sail/QCS8300.LE.2.0/common/sectoolsv2/ext/Linux

步骤

进入 bash：
bash

进入 RTSS 的主目录：

cd <FIRMWARE_ROOT>/qualcomm-linux-spf-2-0_ap_standard_oem_sail/SAIL.SI.1.2`

在设备上设置构建环境：
source sail_proc/build/ms/setupenv.sh
注意
1. 在运行该命令之前，请确保工具链和 RTOS 代码/二进制文件已复制到构建中，以避免编译问题。
构建镜像：
make TARGET=<target name>
对于 IQ-9075：
make TARGET=lemans
对于 IQ-8275：
make TARGET=monaco
RTSS 构建成功执行后，会在以下位置生成 sailhyp.elf 和 sailsw1.elf：对于 IQ-9075：
qualcomm-linux-spf-2-0_ap_standard_oem_sail/SAIL.SI.1.2/sail_proc/build/ms/bin/SAIL_RTOS/DEBUG/lemans/signed 对于 IQ-8275： qualcomm-linux-spf-2-0_ap_standard_oem_sail/SAIL.SI.1.2/sail_proc/build/ms/bin/SAIL_RTOS/DEBUG/monaco/signed
将生成的 RTSS 文件复制到 <workspace_path>/build-<DISTRO>/tmp-glibc/deploy/images/<MACHINE>/<IMAGE>/sail_nor 文件夹中，以便对 NOR 闪存进行编程。示例：<workspace_path>/build-qcom-wayland/tmp-glibc/deploy/images/qcs9075-iq-9075-evk/qcom-multimedia-image/sail_nor 参数：
- <DISTRO>: qcom-wayland
- <MACHINE>: qcs9075-iq-9075-evk
- <IMAGE>: qcom-multimedia-image
注意有关 <MACHINE> 的信息，请参阅 Software Release Notes。
（可选）要刷新构建，请清理构建：
make clean TARGET=<target name>
对于 IQ-9075：
make clean TARGET=lemans
对于 IQ-8275：
make clean TARGET=monaco
运行 make clean TARGET=<target name> 命令后，执行以下步骤，使用 make TARGET=<target name> 命令重新构建镜像：
1. 进入 RTSS 的主目录：
  cd <FIRMWARE_ROOT>/qualcomm-linux-spf-1-0_ap_standard_oem_sail/SAIL.SI.1.2`
2. 在设备上设置构建环境：
  source sail_proc/build/ms/setupenv.sh
3. 重新构建镜像：
  make TARGET=<target name>
  对于 IQ-9075：
  make TARGET=lemans
  对于 IQ-8275：
  make TARGET=monaco
有关刷写 RTSS 的说明，请参阅 Flash SAIL。

​前提条件

​步骤

​后续步骤

前提条件

步骤

后续步骤