秉承“取之于開源，貢獻于開源”的理念，進迭時空在 Debug 軟件的開發(fā)與維護中，始終堅持 Upstream First 原則，積極將優(yōu)化與修復(fù)反饋至開源上游，與全球開發(fā)者共同推動 RISC-V 生態(tài)的繁榮與發(fā)展。

Debug 相關(guān)軟件項目概覽

RISC-V 調(diào)試所涉及的核心開源軟件主要包括 GDB 和 OpenOCD。

GDB（GNU Debugger）是 GNU 項目下的功能強大的源碼級調(diào)試工具，允許開發(fā)者查看程序在執(zhí)行時的內(nèi)部狀態(tài)，包括設(shè)置斷點、單步執(zhí)行、查看變量和內(nèi)存等。在 RISC-V 生態(tài)中，GDB 繼續(xù)扮演開發(fā)人員重要的調(diào)試交互界面的角色。

OpenOCD（Open On-Chip Debugger）承擔了實現(xiàn) RISC-V 調(diào)試規(guī)范的具體功能。作為一個支持多種架構(gòu)的調(diào)試工具，OpenOCD 的官方代碼托管于https://review.openocd.org.為應(yīng)對 RISC-V 這一新興架構(gòu)的快速迭代與適配需求，社區(qū)為此專門 Fork 了一個支持 RISC-V 的適配版本，該版本托管于https://github.com/riscv-collab/riscv-openocd.

目前，riscv-openocd 已實現(xiàn)對 RISC-V 調(diào)試規(guī)范 v0.11 和 v0.13 的支持，并部分集成 v1.0 特性，能夠滿足日常開發(fā)調(diào)試需求，且仍在持續(xù)演進中。

此外，riscv-test 項目（https://github.com/riscv-software-src/riscv-tests）中提供了一套 Debug Tests 測試套件。由于調(diào)試過程依賴于多個系統(tǒng)組件的協(xié)同工作，該測試套件通過 Python 腳本調(diào)用 OpenOCD 和 GDB，模擬真實調(diào)試流程，執(zhí)行端到端測試，從而有助于發(fā)現(xiàn)從Debug接口到相關(guān)底層組件中可能存在的問題。

始于 K1：一個 PR 的上游之路

在進迭時空首款 RISC-V AI CPU K1 芯片的研發(fā)過程中，OpenOCD 與 riscv-tests 在調(diào)試驗證環(huán)節(jié)發(fā)揮了關(guān)鍵作用。在 K1 研發(fā)階段，OpenOCD 已具備較為完善的基礎(chǔ)調(diào)試功能，然而，由于 K1 的硬件架構(gòu)將 8 個核心分為 2 個 Cluster，每個Cluster對應(yīng)一個調(diào)試模塊（Debug Module, DM），且兩個調(diào)試模塊共同連接至同一個調(diào)試傳輸模塊（Debug Transport Module, DTM），導(dǎo)致當時無論是開源 OpenOCD 還是商用調(diào)試器，均未支持此類“單 DTM 對接多 DM ”的結(jié)構(gòu)。

得益于 OpenOCD 的開源特性，團隊得以對其進行自主修改。通過代碼分析，發(fā)現(xiàn)可借鑒其他架構(gòu)的現(xiàn)有配置，僅需 6 行代碼即可實現(xiàn)對多 DM 調(diào)試結(jié)構(gòu)的支持。完成修改并經(jīng) FPGA 驗證后，進一步補充了調(diào)試日志等輔助內(nèi)容，最終向上游社區(qū)提交了一個總計 27 行改動的初始 PR。

該 PR 獲得了社區(qū)維護者的寶貴意見。經(jīng)過 126 次評審討論，最終完成修改并合入的 PR 代碼行數(shù)擴充至 396 行。除增強檢查機制、更新文檔外，還對 DM 層接口進行了重構(gòu)，使代碼更加清晰、易于維護。

盡管最初未預(yù)料到僅6行的修改最終會演變?yōu)閿?shù)百行的代碼重構(gòu)，但這一過程顯著加深了團隊對代碼的理解，既降低了未來維護成本，同時為開源生態(tài)貢獻了力量，是一次值得的投入。

在與社區(qū)的溝通中，開放、協(xié)作的氛圍和有效的技術(shù)支持堅定了進迭時空將改進貢獻回上游的決心——從最開始就把事情做對，而非在下游維護一個“打補丁”版本，反復(fù)應(yīng)對版本沖突。

從 K1 到 K3：持續(xù)投入迭代

在 K1 調(diào)試支持完成后，相關(guān)配置文件已提交至 OpenOCD 主線?，F(xiàn)在用戶可直接使用上游版本調(diào)試 K1，無需額外補丁。

除了 K1 中發(fā)現(xiàn)和修復(fù)的若干問題，進迭時空在下一代芯片 K3 的研發(fā)過程中也識別出新的需求與挑戰(zhàn)。例如，K3 采用的 X100 核心支持虛擬化擴展，其在調(diào)試虛擬機時暴露出 OpenOCD 地址轉(zhuǎn)換邏輯的潛在問題；同時， Debug v1.0中 External Trigger 等新功能的引入，也催生了新的代碼改進需求。在發(fā)現(xiàn)和解決這些問題后，進迭時空選擇將其都提交至社區(qū)。等到 K3 正式交付，開發(fā)者將能夠像使用K1時一樣， 直接使用上游版本即可支撐調(diào)試需求，獲得良好的調(diào)試體驗。

未來展望

截至目前，進迭時空已累計向 OpenOCD 與 riscv-tests 貢獻并合入40余個Commit，另有數(shù)個補丁仍在評審中。在此特別感謝社區(qū)開發(fā)者，尤其是幾位維護者（@timsifive、@en-sc、@JanMatCodasip）在代碼評審與協(xié)作中給予的支持。

RISC-V 調(diào)試規(guī)范自 2018 年 12 月發(fā)布 v0.13 以來，經(jīng)過社區(qū)共同努力，已于 2025 年 2 月正式批準 v1.0 版本。目前，riscv-openocd 的代碼在持續(xù)完善，上游 OpenOCD 也正在加快合并來自 RISC-V Fork的改動。

隨著 RISC-V 生態(tài)的發(fā)展，CPU 核心、SoC 系統(tǒng)與軟件棧日趨復(fù)雜，高效可靠的調(diào)試手段愈發(fā)重要。RISC-V 本身的開放性與靈活性，也為調(diào)試技術(shù)的探索提供了廣闊空間，例如日漸成熟的 Trace 規(guī)范即將帶來更強大的調(diào)試能力。