# 配置遠端處理器 (remoteproc) 子系統
remoteproc 框架用來將韌體載入至其他子系統，例如 Qualcomm 平台上的音訊數位訊號處理器 (aDSP) 和運算數位訊號處理器 (cDSP)。
remoteproc 框架分成兩部分：
- 核心框架：核心框架包含通用邏輯。它會載入韌體並啟動或停止遠端處理器。
- Remoteproc 驅動程式：驅動程式包含平台操作以管理對應的核心。remoteproc 驅動程式向核心框架登錄 remoteproc 執行個體和操作集合。
非對稱多處理 (ASMP) 配置中的 SoC 上存在多個異質遠端處理器。遠端處理器執行不同的韌體或 OS 執行個體。
欲深入瞭解 Qualcomm Linux 用來管理其他核心的標準框架，請參閱 [Remote Processor Framework](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、數據機周邊子系統 (MPSS) 和無線處理器子系統 (WPSS)。以 QCS6490 為基礎的機板和 Dragonwing™ RB3 Gen 2 開發套件支援的協同處理器包括 aDSP、cDSP 和 WPSS。
備註
支援的遠端處理器子系統清單取決於使用的 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 子裝置為遠端處理器子系統崩潰和復原情境管理通訊脈絡。
實體 (例如通訊脈絡) 必須確定遠端處理器何時啟動或關閉。每個子裝置都有兩個操作：
- 在 `start()` 之後呼叫 `probe()`
- 在 `stop()` 之前呼叫 `remove()`
遠端處理器發生嚴重錯誤時，remoteproc 驅動程式會加以處理並調用 `rproc_report_crash()`，觸發故障遠端處理器的復原。
復原處理常式執行以下操作：
**圖：Remoteproc 崩潰順序**
若要從使用者空間使用復原 `debugfs` 節點啟用和停用復原，請執行以下操作：
mount -t debugfs nodev /sys/kernel/debug
echo disabled > /sys/kernel/debug/remoteproc/remoteprocN/recovery
Copy to clipboard
## 啟用或停用核心傾印
支援遠端處理器核心傾印，以使用 Qualcomm Linux 核心 devcoredump 功能對子系統崩潰問題進行除錯。
發生子系統崩潰時，devcoredump 會在 `/sys/class/devcoredump/devcdN/data` 節點中公開復原 remoteproc 的記憶體快照，並將相關的崩潰 `uevent` 傳送至使用者空間。讀取 sysfs 節點時，sysfs 會在 ELF 容器中提供區段，而寫入操作會釋放資源並銷毀 devcoredump 執行個體。
透過 debugfs 節點，使用者空間可以啟用或停用核心傾印功能。
# 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
備註
為了收集完整的 RAM 傾印以進行崩潰分析，Qualcomm SoC 會在 remoteproc 崩潰 (遠端處理器發生嚴重錯誤) 時觸發核心恐慌。只有在停用核心傾印時，才會啟用核心恐慌模式。
只有在針對子系統啟用核心傾印的情況下，才會在子系統崩潰時建立 devcoredump `/sys/class/devcoredump/devcdN/data` 節點。若要啟用核心傾印，請執行 `echo enabled > /sys/kernel/debug/remoteproc/remoteprocN/coredump` 命令。`devcdN/data` 節點屬於暫時性，逾時後會被移除。若要對問題進行除錯，請使用 `copy` 命令將 `devcdN/data` 節點複製到本機裝置以安全使用。在 `base/devcoredump.c` 中定義刪除逾時。
以下是複製核心傾印的範例命令：
# 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
若要將核心傾印檔案傳輸至主機裝置並對問題進行除錯，請使用 Qualcomm Crash Analysis Portal (QCAP)。
備註
欲深入瞭解 QCAP，請參閱 [使用 QCAP 剖析 RAM 傾印](https://docs.qualcomm.com/bundle/resource/topics/80-70020-12A/debugging_linux_kernel.html#parse_ram_dumps_using_qcap)。
## 在 DT 中配置 remoteproc 節點和韌體載入
使用 DT 繫結在各個裝置樹檔案中配置 remoteproc 裝置。組態包含相容的裝置名稱、記憶體區域、中斷設定和時脈參考，根據 DT 繫結，位於 `Documentation/devicetree/bindings/remoteproc/` 目錄中。
以下範例呈現 `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 裝置樹組態檔。
備註
若要取得所有 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: Jan 01, 2026
[Previous Topic
開發核心](https://docs.qualcomm.com/bundle/publicresource/80-70020-3TC/topics/kernel-development.md) [Next Topic
配置和管理記憶體](https://docs.qualcomm.com/bundle/publicresource/80-70020-3TC/topics/memory.md)