# 配置远程处理器 (remoteproc) 子系统
remoteproc 框架用于将固件加载到 Qualcomm 平台上的其他子系统中，例如音频数字信号处理器 (aDSP) 和计算数字信号处理器 (cDSP)。
Remoteproc 框架分为两部分：
- 核心框架：核心框架包含了共同的逻辑。核心框架用于加载固件并启动或停止远程处理器。
- Remoteproc 驱动程序：驱动程序包含管理相应核心的平台特定操作。Remoteproc 驱动程序向核心框架注册一个 remoteproc 实例和一组操作。
在非对称多处理 (ASMP) 配置中，SoC 上存在多个异构远程处理器。远程处理器运行不同的固件（或操作系统）实例。
有关 Qualcomm Linux 用于管理其他核心的标准框架的更多信息，请参阅[远程处理器框架](https://www.kernel.org/doc/html/next/staging/remoteproc.html)。
## Qualcomm 对 remoteproc 的支持
Qualcomm 已增强 remoteproc 框架，以便使用上游 PAS 驱动程序进行外设固件鉴权。
Qualcomm Linux 中的 remoteproc 驱动程序实现了外设鉴权服务 (PAS) 驱动程序，该驱动程序是一种基于 TrustZone 的外设镜像加载程序，用于 Qualcomm SoC 设备上的远程处理器。
有关详细信息，请参阅 [qcom_q6v5_pas.c](https://github.com/torvalds/linux/blob/master/drivers/remoteproc/qcom_q6v5_pas.c)。
远程处理器用于管理各种协处理器的生命周期，如 aDSP、cDSP、modem 外设子系统 (MPSS) 和无线处理器子系统 (WPSS) 等。基于 QCS6490 的电路板和 Dragonwing™ RB3 Gen 2 开发套件上支持的协处理器包括 aDSP、cDSP 和 WPSS。
Note
支持的远程处理器子系统列表取决于正在使用的 SoC。
**用户界面：** remoteproc 框架可跟踪注册的 remoteproc 设备并提供用于启动和关闭设备的用户接口。用户空间可以使用以下 `sysfs` 接口查询和更改 remoteproc 的当前状态界面：
remoteproc user space interface
# start remoteproc:
echo "start" > /sys/class/remoteproc/remoteprocN/state
# stop remoteproc:
echo "stop" > /sys/class/remoteproc/remoteprocN/state
Copy to clipboard
**图：Remoteproc 支持**
## 配置 Remoteproc 恢复和子系统重启
Remoteproc 子设备负责管理远程处理器子系统崩溃和恢复场景中的通信环境。
通信环境等实体必须确定远程处理器何时启动或关闭。每个子设备都有两个操作：
- `probe()`，在 remoteproc `start()` 之后调用
- `remove()`，在 `stop()` 之前调用
当远程处理器发生致命错误时，remoteproc 驱动程序会处理该错误并调用 `rproc_report_crash()`，从而触发故障远程处理器的恢复。
恢复处理程序会执行以下操作：
**图：Remoteproc 崩溃序列**
要使用用户空间中的恢复 `debugfs` 节点来启用和禁用恢复，请执行以下操作：
mount -t debugfs nodev /sys/kernel/debug
echo disabled > /sys/kernel/debug/remoteproc/remoteprocN/recovery
Copy to clipboard
## 启用或禁用核心 dump
使用 Qualcomm Linux 内核 devcoredump 功能，支持远程处理器核心 dump，以便调试子系统崩溃问题。
当子系统崩溃时，devcoredump 会将正在恢复的 remoteproc 的内存拍照呈现在 `/sys/class/devcoredump/devcdN/data` 节点中，同时将相关的崩溃 `uevent` 发送到用户空间。读取 sysfs 节点时，sysfs 会通过 ELF 容器提供内存段；对该节点进行写入操作时，会释放相关资源并销毁 devcoredump 实例。
公开 debugfs 节点，用于从用户空间启用和禁用核心 dump。
# Disable core dumps:
echo disabled > /sys/kernel/debug/remoteproc/remoteprocN/coredump
# Enable core dumps:
echo enabled > /sys/kernel/debug/remoteproc/remoteprocN/coredump
#
# N represents the index number of the remote processor.
Copy to clipboard
Note
Qualcomm SoC 在 remoteproc 崩溃（远程处理器上的致命错误）时会触发内核 panic，以便收集完整的 RAM dump 文件，用于进行崩溃分析。仅当核心 dump 禁用时，才会启用内核 panic 模式。
仅当为子系统启用了核心 dump 时，才会在子系统崩溃时创建 devcoredump `/sys/class/devcoredump/devcdN/data` 节点。要启用核心 dump，请运行 `echo enabled > /sys/kernel/debug/remoteproc/remoteprocN/coredump` 命令。`devcdN/data` 节点是临时的，超时后会被删除。要调试问题，请使用 `copy` 命令将 `devcdN/data` 节点复制到本地设备以便安全使用。删除超时在 `base/devcoredump.c` 中定义。
以下是复制核心 dump 的示例命令：
# Copy Core dump to a local device
cp /sys/class/devcoredump/devcdN/data > /var/spool/crash/dump_file.elf
#
# N represents the index of core dump. It is incremented each time a new core dump is generated.
Copy to clipboard
要将核心 dump 文件传输到主机设备并调试问题，请使用 Qualcomm Crash Analysis Portal (QCAP)。
Note
有关 QCAP 的更多信息，请参阅 [Parse RAM dumps using QCAP](https://docs.qualcomm.com/bundle/resource/topics/80-70020-12A/debugging_linux_kernel.html#parse_ram_dumps_using_qcap)。
## 在 DT 中配置 remoteproc 节点和固件加载
Remoteproc 设备使用 DT 绑定在相应的设备树文件中进行配置。根据 `Documentation/devicetree/bindings/remoteproc/` 目录中的 DT 绑定，该配置包括兼容的设备名称、内存区域、中断设置和时钟参考。
以下示例显示了 `arch/arm64/boot/dts/qcom/qcs6490.dtsi` 文件中的 QCS6490 aDSP remoteproc 设备树配置：
remoteproc_adsp: remoteproc@3000000 {
compatible = "qcom,sc7280-adsp-pas";
reg = <0x0 0x03000000 0x0 0x100>;
interrupts-extended = <&pdc 6 IRQ_TYPE_EDGE_RISING>,
<&adsp_smp2p_in 0 IRQ_TYPE_EDGE_RISING>,
<&adsp_smp2p_in 1 IRQ_TYPE_EDGE_RISING>,
<&adsp_smp2p_in 2 IRQ_TYPE_EDGE_RISING>,
<&adsp_smp2p_in 3 IRQ_TYPE_EDGE_RISING>,
<&adsp_smp2p_in 7 IRQ_TYPE_EDGE_RISING>;
interrupt-names = "wdog", "fatal", "ready", "handover",
"stop-ack", "shutdown-ack";
clocks = <&rpmhcc RPMH_CXO_CLK>;
clock-names = "xo";
};
Copy to clipboard
检查 `arch/arm64/boot/dts/qcom/sa8775p.dtsi` 路径中的 IQ-9075 设备树配置文件。
Note
要获取所有 Qualcomm SoC 的设备树配置文件，参见相应的平台 DTSI 文件。
所有固件文件都位于 `rootfs` 中的 `/lib/firmware` 目录中并在相应板卡设备树 `arch/arm64/boot/dts/qcom/qcs6490-rb3gen2.dts` 文件中进行相关配置。对于其他 Qualcomm 硬件 SoC，请参阅 `arch/arm64/boot/dts/qcom/-.dts` 文件。
以下示例展示了 remoteproc DT 配置：
&remoteproc_adsp {
firmware-name = "qcom/qcs6490/adsp.mdt";
status = "okay";
};
Copy to clipboard
### Remoteproc 参考日志
在 remoteproc 成功启动后，会显示以下日志：
**
\# remoteproc success**
"remoteproc remoteproc1: remote processor 4080000.remoteproc is now up"
Copy to clipboard
在 remoteproc 固件加载失败后，会显示以下日志：
**
\# remoteproc failure**
Error log: "remoteproc remoteproc0: Direct firmware load for qcom/qcs6490/modem.mdt failed with error -2"
# Caused by: error loading firmware.
# Solution: ensure that the modem firmware is copied to /lib/firmware/qcom/qcs6490 in rootfs.
Copy to clipboard
Last Published: Jul 22, 2025
[Previous Topic
开发内核](https://docs.qualcomm.com/bundle/publicresource/80-70020-3SC/topics/kernel-development.md) [Next Topic
配置和管理内存](https://docs.qualcomm.com/bundle/publicresource/80-70020-3SC/topics/memory.md)