在 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。
安裝與登入
從下載取得 Windows 應用程式,並依照Windows 安裝指南的說明安裝。
啟動 Digital Design Studio。在登入 Digital Design Studio畫面中選擇使用 Altifigence 繼續,然後在瀏覽器中完成登入。
如果改為選擇不登入並繼續,您仍然可以開啟、編輯並執行範例;之後需要 Cloud 或 AI 等帳戶服務時再登入即可。
開啟計數器範例
新使用者第一次在電腦上啟動應用程式時,在登入或不登入並繼續之後,計數器範例會自動開啟。應用程式會開啟測試平台 tb/counter_tb.sv 與 RTL simulation 分頁。
如果這台電腦以前使用過 Digital Design Studio(例如已儲存的登入、最近的專案或 Academy 專案,或已儲存的視窗)、應用程式是為了開啟特定專案而啟動,或您登入的組織已經有 Cloud 專案,範例就不會自動開啟。若要自行開啟:
在導覽面板頂端開啟環境選單,然後選擇這台電腦。
在這台電腦的專案中選擇開啟範例。如果已經開啟這台電腦上的專案,請選擇專案清單下方的這台電腦回到此頁面。
請先儲存編輯內容,並等待執行中的工作完成:有未儲存的內容或執行中的工作時,應用程式不會切換專案。
範例是您自己的副本,只會在應用程式的資料資料夾中建立一次。再次開啟時會保留您的變更。
檔案 | 內容 |
|---|---|
| 具有非同步低態有效重設( |
| 測試平台。它會重設計數器、啟用計數器 20 個時脈週期、檢查計數是否繞回到 4,並寫出 |
| 範例的簡短說明。 |
| 讓存放執行結果的 |
安裝 OSS 模擬器(只需一次)
Digital Design Studio 未隨附模擬器。在您要求時,它會下載官方 YosysHQ OSS CAD Suite 2026-10-09 組建,以固定的 SHA-256 檢查下載內容,並只安裝 Icarus Verilog、Verilator 與 GTKWave 所需的檔案。
在 RTL simulation 分頁中,保持選取測試平台。在安裝模擬器之前,面板會顯示「尚未安裝 OSS CAD Suite 模擬器擴充功能。執行時會先安裝。」
按下執行。在要安裝 OSS CAD Suite 模擬器嗎?中選擇下載並安裝。選擇稍後會關閉對話方塊,不會安裝任何東西。
對話方塊會顯示下載、SHA-256 檢查與安裝的進度。選擇取消即可停止;已下載的部分會保留,下次會接續下載。
安裝完成後,執行就會開始。
您也可以事先安裝模擬器:開啟外掛程式,選取OSS CAD Suite 模擬器,然後選擇安裝。之後在這台電腦上的執行都會使用同一份安裝。
執行測試平台
確認面板:測試平台為
counter_tb · tb/counter_tb.sv,模擬器為 Icarus Verilog,波形格式為 VCD。面板會在其下方顯示「2 個原始檔 · top counter_tb」。按下執行。執行時會先儲存已變更的
.v、.sv、.svh與.vh檔案,接著以所選測試平台作為頂層模組,編譯專案中所有的.v與.sv檔案,但.alti/、.altifigence/、.git/與node_modules/底下的檔案除外。執行通過時,面板會顯示通過以及模擬器版本與執行時間,並在下方開啟波形。
展開模擬器記錄即可查看編譯器與模擬器的輸出。測試平台會印出
counter_tb: PASS count=4 at 260 ns。
閱讀結果
時脈週期為 10 ns。測試平台在時脈的下降緣變更輸入,計數器在上升緣計數。波形顯示:
時間 | 訊號 |
|---|---|
0–20 ns |
|
20 ns |
|
30 ns |
|
35–225 ns |
|
230 ns |
|
260 ns | 測試平台檢查 |
狀態列會顯示執行如何結束:
狀態 | 意義 |
|---|---|
通過 · … | 模擬器以結束代碼 0 結束,且測試平台記錄未回報失敗。 |
失敗(結束代碼 N)· … | 模擬器以非零結束代碼結束,例如編譯時發生錯誤。請在模擬器記錄中閱讀編譯器或測試平台的訊息。如果 Digital Design Studio 在模擬前拒絕了輸入,記錄會說明被拒絕的路徑或設定;沒有模擬器結束代碼就表示執行並未完成。 |
測試平台回報失敗 · … | 模擬器以結束代碼 0 結束,但測試平台日誌回報失敗。請在模擬器記錄中查看失敗訊息。 |
已達時間限制而停止 · … | 執行時間超過 2 分鐘,也就是從此面板執行的上限。 |
已取消 | 您在執行期間按下了取消。 |
每次執行都會保存在專案 .alti/sim/ 底下各自的資料夾中,內含波形與 receipt.json。receipt 會記錄模擬器記錄與版本、OSS CAD Suite 版本,以及每個原始檔與被包含檔案的 SHA-256。Digital Design Studio 會保留最新的 20 次執行。如果在執行期間原始檔、被包含的檔案或 Verilog 設定有所變更,該次執行會標示為失敗;請再執行一次。
解決常見錯誤
症狀 | 處理方式 |
|---|---|
範例沒有自動開啟 | 自動開啟只適用於新使用者。請在這台電腦的專案(這台電腦)中選擇開啟範例。 |
『無法開啟範例專案。若要再試一次,請在「這台電腦」選擇「開啟範例」。』 | 在這台電腦中選擇開啟範例。範例不存在時,之後啟動應用程式也會再試,總共最多 3 次。 |
沒有測試平台按鈕 | 在 Windows 應用程式中開啟這台電腦上的專案,並透過測試平台檢視執行測試平台。 |
「找不到測試平台。…」 | 測試平台是沒有連接埠、也沒有被其他模組實例化的模組,例如 |
下載失敗或停滯 | 檢查連線、Proxy 或防火牆是否允許 github.com、release-assets.githubusercontent.com 與 objects.githubusercontent.com,然後再按一次執行。下載會從中斷處繼續。 |
防毒軟體封鎖了檔案,或 Icarus Verilog 無法啟動 | 請保留安全性軟體的完整訊息,並確認官方下載與預期的雜湊值。不要只為了強制執行而停用保護或加入範圍過大的排除項目。重試前,請支援人員或系統管理員檢查這次的偵測。 |
可用磁碟空間不足 | 釋出訊息中顯示的空間後再試一次。 |
無法選取 Verilator | Verilator 需要這台電腦上有 C++ 編譯器與 make,例如在 MSYS2 UCRT64 中執行 |
「這次執行沒有寫出波形。…」 | 在測試平台中加入 |
波形大於 32 MiB | 縮小 |
包含檔案與巨集
請將被包含的
.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 分頁。如果尚未登入,執行模擬會直接開啟該分頁。
與這項本機模擬分開適用的平台差異,以及公司 AI、儲存空間與帳戶條件,請參閱支援指南。