在 Digital Design Studio 中首次執行 RTL 模擬

Windows 版 Digital Design Studio 中的首次 RTL 模擬。開啟計數器範例,在您的電腦上執行其測試平台並讀取波形。

Windows 版 Digital Design Studio:本教學會使用 OSS CAD Suite 模擬器在您的電腦上執行測試平台;這些模擬器只有在您要求時,應用程式才會下載並安裝。已發布的套件請參閱下載。

概觀

Digital Design Studio 內含一個小型範例專案:4 位元計數器(rtl/counter.sv)及其測試平台(tb/counter_tb.sv)。在本教學中,您會開啟範例、安裝一次模擬器、按下執行,然後查看波形。模擬在您的電腦上執行,不會啟動 Cloud 工作。

您需要:

  • 在 Windows x64 上執行的 Digital Design Studio Windows 應用程式。

  • Altifigence 帳戶並非必要:不登入也能執行模擬器,而且 Windows 應用程式不需要裝置授權。

  • 網際網路連線,用於從 GitHub 一次性下載約 574 MiB。安裝後,電腦上會保留約 226 MiB。

安裝與登入

  1. 從下載取得 Windows 應用程式,並依照Windows 安裝指南的說明安裝。

  2. 啟動 Digital Design Studio。在登入 Digital Design Studio畫面中選擇使用 Altifigence 繼續,然後在瀏覽器中完成登入。

  3. 如果改為選擇不登入並繼續,您仍然可以開啟、編輯並執行範例;之後需要 Cloud 或 AI 等帳戶服務時再登入即可。

開啟計數器範例

新使用者第一次在電腦上啟動應用程式時,在登入或不登入並繼續之後,計數器範例會自動開啟。應用程式會開啟測試平台 tb/counter_tb.sv 與 RTL simulation 分頁。

如果這台電腦以前使用過 Digital Design Studio(例如已儲存的登入、最近的專案或 Academy 專案,或已儲存的視窗)、應用程式是為了開啟特定專案而啟動,或您登入的組織已經有 Cloud 專案,範例就不會自動開啟。若要自行開啟:

  1. 在導覽面板頂端開啟環境選單,然後選擇這台電腦。

  2. 在這台電腦的專案中選擇開啟範例。如果已經開啟這台電腦上的專案,請選擇專案清單下方的這台電腦回到此頁面。

請先儲存編輯內容,並等待執行中的工作完成:有未儲存的內容或執行中的工作時,應用程式不會切換專案。

範例是您自己的副本,只會在應用程式的資料資料夾中建立一次。再次開啟時會保留您的變更。

檔案

內容

rtl/counter.sv

具有非同步低態有效重設(rst_n)的 4 位元計數器。enable 為高電位時會計數。

tb/counter_tb.sv

測試平台。它會重設計數器、啟用計數器 20 個時脈週期、檢查計數是否繞回到 4,並寫出 counter_tb.vcd。

README.md

範例的簡短說明。

.gitignore

讓存放執行結果的 .alti/ 資料夾不納入 Git。

安裝 OSS 模擬器(只需一次)

Digital Design Studio 未隨附模擬器。在您要求時,它會下載官方 YosysHQ OSS CAD Suite 2026-10-09 組建,以固定的 SHA-256 檢查下載內容,並只安裝 Icarus Verilog、Verilator 與 GTKWave 所需的檔案。

  1. 在 RTL simulation 分頁中,保持選取測試平台。在安裝模擬器之前,面板會顯示「尚未安裝 OSS CAD Suite 模擬器擴充功能。執行時會先安裝。」

  2. 按下執行。在要安裝 OSS CAD Suite 模擬器嗎?中選擇下載並安裝。選擇稍後會關閉對話方塊,不會安裝任何東西。

  3. 對話方塊會顯示下載、SHA-256 檢查與安裝的進度。選擇取消即可停止;已下載的部分會保留,下次會接續下載。

  4. 安裝完成後,執行就會開始。

您也可以事先安裝模擬器:開啟外掛程式,選取OSS CAD Suite 模擬器,然後選擇安裝。之後在這台電腦上的執行都會使用同一份安裝。

執行測試平台

  1. 確認面板:測試平台為 counter_tb · tb/counter_tb.sv,模擬器為 Icarus Verilog,波形格式為 VCD。面板會在其下方顯示「2 個原始檔 · top counter_tb」。

  2. 按下執行。執行時會先儲存已變更的 .v、.sv、.svh 與 .vh 檔案,接著以所選測試平台作為頂層模組,編譯專案中所有的 .v 與 .sv 檔案,但 .alti/、.altifigence/、.git/ 與 node_modules/ 底下的檔案除外。

  3. 執行通過時,面板會顯示通過以及模擬器版本與執行時間,並在下方開啟波形。

  4. 展開模擬器記錄即可查看編譯器與模擬器的輸出。測試平台會印出 counter_tb: PASS count=4 at 260 ns。

閱讀結果

時脈週期為 10 ns。測試平台在時脈的下降緣變更輸入,計數器在上升緣計數。波形顯示:

時間

訊號

0–20 ns

rst_n 為低電位。使用 Icarus Verilog 時,count 在 5 ns 的上升緣將其重設為 0 之前都是未知值(x)。

20 ns

rst_n 變為高電位。

30 ns

enable 變為高電位。

35–225 ns

count 在 clk 的每個上升緣加 1,在 185 ns 從 15 繞回 0,並在 225 ns 達到 4。

230 ns

enable 變為低電位;count 維持在 4。

260 ns

測試平台檢查 count,印出 PASS 行並結束模擬。

狀態列會顯示執行如何結束:

狀態

意義

通過 · …

模擬器以結束代碼 0 結束,且測試平台記錄未回報失敗。

失敗(結束代碼 N)· …

模擬器以非零結束代碼結束,例如編譯時發生錯誤。請在模擬器記錄中閱讀編譯器或測試平台的訊息。如果 Digital Design Studio 在模擬前拒絕了輸入,記錄會說明被拒絕的路徑或設定;沒有模擬器結束代碼就表示執行並未完成。

測試平台回報失敗 · …

模擬器以結束代碼 0 結束,但測試平台日誌回報失敗。請在模擬器記錄中查看失敗訊息。

已達時間限制而停止 · …

執行時間超過 2 分鐘,也就是從此面板執行的上限。

已取消

您在執行期間按下了取消。

每次執行都會保存在專案 .alti/sim/ 底下各自的資料夾中,內含波形與 receipt.json。receipt 會記錄模擬器記錄與版本、OSS CAD Suite 版本,以及每個原始檔與被包含檔案的 SHA-256。Digital Design Studio 會保留最新的 20 次執行。如果在執行期間原始檔、被包含的檔案或 Verilog 設定有所變更,該次執行會標示為失敗;請再執行一次。

解決常見錯誤

症狀

處理方式

範例沒有自動開啟

自動開啟只適用於新使用者。請在這台電腦的專案(這台電腦)中選擇開啟範例。

『無法開啟範例專案。若要再試一次,請在「這台電腦」選擇「開啟範例」。』

在這台電腦中選擇開啟範例。範例不存在時,之後啟動應用程式也會再試,總共最多 3 次。

沒有測試平台按鈕

在 Windows 應用程式中開啟這台電腦上的專案,並透過測試平台檢視執行測試平台。

「找不到測試平台。…」

測試平台是沒有連接埠、也沒有被其他模組實例化的模組,例如 module counter_tb;。請儲存檔案並選擇重新尋找。

下載失敗或停滯

檢查連線、Proxy 或防火牆是否允許 github.com、release-assets.githubusercontent.com 與 objects.githubusercontent.com,然後再按一次執行。下載會從中斷處繼續。

防毒軟體封鎖了檔案,或 Icarus Verilog 無法啟動

請保留安全性軟體的完整訊息,並確認官方下載與預期的雜湊值。不要只為了強制執行而停用保護或加入範圍過大的排除項目。重試前,請支援人員或系統管理員檢查這次的偵測。

可用磁碟空間不足

釋出訊息中顯示的空間後再試一次。

無法選取 Verilator

Verilator 需要這台電腦上有 C++ 編譯器與 make,例如在 MSYS2 UCRT64 中執行 pacman -S mingw-w64-ucrt-x86_64-gcc mingw-w64-ucrt-x86_64-make。Icarus Verilog 不需要它們也能運作。

「這次執行沒有寫出波形。…」

在測試平台中加入 $dumpfile("name.vcd") 與 $dumpvars。檔名不要包含資料夾:只會開啟寫在該次執行專屬資料夾中的波形。

波形大於 32 MiB

縮小 $dumpvars 的範圍,或縮短執行時間。

包含檔案與巨集

  • 請將被包含的 .svh 與 .vh 標頭檔放在專案內。RTL 編譯、Icarus Verilog 與 Verilator 會先搜尋專案根目錄,接著依儲存的順序搜尋包含路徑,再依名稱順序搜尋找到的原始碼資料夾。如果包含它的檔案旁邊有另一個內容不同的標頭檔,問題與模擬器記錄會指出兩個路徑以及實際使用的標頭檔。

  • 如果模擬器記錄顯示找不到被包含的檔案,請將其資料夾以相對於專案根目錄的路徑加入專案(Flow Navigator → 專案管理器 → 設定 → 專案 → 包含路徑)中的包含路徑,然後再按一次執行。巨集請在 專案 → 宏定義中輸入,每行一個 NAME 或 NAME=VALUE。

  • 包含專案外部的檔案會使執行在模擬開始前失敗。此時模擬器記錄會顯示「… is outside the project: copy it into the project and include it from there」。

  • 如果包含路徑的項目指向專案外部或包含 ..,或宏定義中有無效的巨集名稱,執行會停止並顯示指出該項目的訊息。請修正或移除它。清單中不存在的資料夾會被略過,並在模擬器記錄中顯示警告。

  • 變更的設定會從下一次執行開始套用。編輯器診斷會在重新開啟專案後使用它們。

後續步驟

  • 修改測試平台,例如啟用的時脈週期數與預期的計數,然後再按一次執行。執行時會先儲存您的編輯。

  • 安裝 C++ 編譯器與 make,在模擬器中選擇 Verilator,並將結果與 Icarus Verilog 比較。

  • 執行您自己的設計:在這台電腦的專案中選擇開啟專案資料夾或建立新專案。加入您的 .v 與 .sv 原始檔,以及使用 $dumpfile 與 $dumpvars 寫出波形的測試平台。接著從 Flow Navigator → 模擬 → 執行模擬 → 開啟模擬設定 開啟 RTL simulation 分頁。如果尚未登入,執行模擬會直接開啟該分頁。

  • 編輯與儲存專案請參閱工作區;Verilog 檔案請參閱 Verilog。

與這項本機模擬分開適用的平台差異,以及公司 AI、儲存空間與帳戶條件,請參閱支援指南。

環境支援