Digital Design Studio で最初の RTL シミュレーション

Windows 版 Digital Design Studio で最初の RTL シミュレーション。カウンターのサンプルを開き、PC 上でテストベンチを実行して波形を読み取ります。

Windows 版 Digital Design Studio: このチュートリアルでは、OSS CAD Suite のシミュレーターを使って PC 上でテストベンチを実行します。シミュレーターは、求めたときにだけアプリがダウンロードしてインストールします。公開されているパッケージは ダウンロード を参照してください。

概要

Digital Design Studio には小さなサンプルプロジェクトが含まれています。4 ビットカウンター (rtl/counter.sv) とそのテストベンチ (tb/counter_tb.sv) です。このチュートリアルでは、サンプルを開き、シミュレーターを一度だけインストールし、実行 を押して波形を確認します。シミュレーションは PC 上で実行され、Cloud ジョブは開始しません。

必要なもの:

  • Windows x64 で動く Digital Design Studio Windows アプリ。

  • Altifigence アカウントは任意です。ログインしなくてもシミュレーターを実行でき、Windows アプリにデバイスライセンスは必要ありません。

  • GitHub から約 574 MiB を一度だけダウンロードするためのインターネット接続。インストール後、PC には約 226 MiB が残ります。

インストールとログイン

  1. ダウンロード から Windows アプリをダウンロードし、Windows インストールガイド の説明どおりにインストールします。

  2. Digital Design Studio を起動します。Digital Design Studioにログイン で Altifigenceで続ける を選び、ブラウザーでログインを完了します。

  3. 代わりに ログインせずに続ける を選んだ場合も、サンプルを開いて編集し、実行できます。Cloud や AI などのアカウントサービスが必要になったら、後でログインしてください。

カウンターのサンプルを開く

新しいユーザーが PC で初めてアプリを起動すると、ログインするか、ログインせずに続けた後に、カウンターのサンプルが自動的に開きます。アプリはテストベンチ tb/counter_tb.sv と RTL simulation タブを開きます。

この PC で以前に Digital Design Studio を使ったことがある場合 (保存されたログイン、最近のプロジェクトや Academy のプロジェクト、保存されたウィンドウなど)、特定のプロジェクトを開くためにアプリが起動された場合、またはログインした組織にすでに Cloud プロジェクトがある場合、サンプルは自動では開きません。自分で開くには:

  1. ナビゲーションパネルの上部で環境メニューを開き、このPC を選びます。

  2. このPCのプロジェクト で サンプルを開く を選びます。この PC のプロジェクトがすでに開いている場合は、プロジェクト一覧の下にある このPC を選ぶとこのページに戻ります。

先に編集内容を保存し、実行中のタスクが終わるのを待ってください。未保存の作業や実行中のタスクがある間、アプリはプロジェクトを切り替えません。

サンプルはあなた専用のコピーで、アプリのデータフォルダーに一度だけ作成されます。もう一度開いても変更は保持されます。

ファイル

内容

rtl/counter.sv

非同期のアクティブ Low リセット (rst_n) を持つ 4 ビットカウンター。enable が High の間カウントします。

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 シミュレーター を選択して インストール を選びます。この PC でのその後の実行では同じインストールを使います。

テストベンチの実行

  1. パネルを確認します。テストベンチ は counter_tb · tb/counter_tb.sv、シミュレーター は Icarus Verilog、波形形式 は VCD です。その下に「ソースファイル2件 · top counter_tb」と表示されます。

  2. 実行 を押します。実行すると、まず変更された .v、.sv、.svh、.vh ファイルを保存します。次に、.alti/、.altifigence/、.git/、node_modules/ の下にあるファイルを除き、プロジェクト内のすべての .v と .sv ファイルを、選択したテストベンチをトップモジュールとしてコンパイルします。

  3. 実行に成功すると、パネルにシミュレーターのバージョンと実行時間とともに 成功 と表示され、その下に波形が開きます。

  4. シミュレーターログ を展開すると、コンパイラーとシミュレーターの出力を確認できます。テストベンチは counter_tb: PASS count=4 at 260 ns を出力します。

結果の読み方

クロック周期は 10 ns です。テストベンチはクロックの立ち下がりエッジで入力を変え、カウンターは立ち上がりエッジでカウントします。波形には次の内容が表示されます:

時間

信号

0–20 ns

rst_n は Low です。Icarus Verilog では、5 ns の立ち上がりエッジで 0 にリセットされるまで、count は不定 (x) です。

20 ns

rst_n が High になります。

30 ns

enable が High になります。

35–225 ns

count は clk の立ち上がりエッジごとに 1 ずつ増え、185 ns で 15 から 0 に戻り、225 ns で 4 になります。

230 ns

enable が Low になり、count は 4 のままです。

260 ns

テストベンチは count を確認し、PASS 行を出力してシミュレーションを終了します。

ステータス行には、実行がどう終わったかが表示されます:

ステータス

意味

成功 · …

シミュレーターが終了コード 0 で終了し、テストベンチのログに失敗の報告がありませんでした。

失敗(終了コード N) · …

シミュレーターが 0 以外の終了コードで終了しました。コンパイルエラーなどが原因です。コンパイラーやテストベンチのメッセージは シミュレーターログ で確認します。シミュレーションの前に Digital Design Studio が入力を拒否した場合は、拒否されたパスや設定がログで説明されます。シミュレーターの終了コードがない場合、実行は完了していません。

テストベンチが失敗を報告 · …

シミュレーターは終了コード 0 で終了しましたが、テストベンチのログで失敗が報告されました。シミュレーターログで失敗のメッセージを確認します。

制限時間で停止しました · …

実行が、このパネルからの実行の上限である 2 分を超えました。

キャンセルしました

実行中に キャンセル を押しました。

各実行は、プロジェクトの .alti/sim/ の下にある専用フォルダーに、波形と receipt.json とともに保存されます。receipt には、シミュレーターのログとバージョン、OSS CAD Suite のリリース、すべてのソースファイルとインクルードされたファイルの SHA-256 が記録されます。Digital Design Studio は最新の 20 件の実行を保持します。実行中にソース、インクルードされたファイル、または Verilog の設定が変わった場合、その実行は失敗として記録されます。もう一度実行してください。

よくあるエラーの対処

症状

対処方法

サンプルが自動で開かなかった

自動で開くのは新しいユーザーだけです。このPCのプロジェクト (このPC) で サンプルを開く を選びます。

『サンプルプロジェクトを開けませんでした。もう一度試すには、「このPC」で「サンプルを開く」を選択してください。』

このPC で サンプルを開く を選びます。サンプルが存在しない間は、その後のアプリ起動時にも再試行します (合計で最大 3 回)。

テストベンチ ボタンがない

Windows アプリでこの PC 上のプロジェクトを開き、テストベンチ ビューでテストベンチを実行します。

「テストベンチが見つかりません。…」

テストベンチは、module counter_tb; のようにポートがなく、ほかのモジュールからインスタンス化されないモジュールです。ファイルを保存して 再検索 を選びます。

ダウンロードが失敗する、または止まる

github.com、release-assets.githubusercontent.com、objects.githubusercontent.com への接続、プロキシ、ファイアウォールを確認してから、もう一度 実行 を押します。ダウンロードは止まったところから再開します。

ウイルス対策ソフトがファイルをブロックした、または Icarus Verilog が起動しない

セキュリティソフトのメッセージをそのまま控え、公式のダウンロードと期待されるハッシュを確認してください。実行を強行するためだけに保護を無効にしたり、広い除外を追加したりしないでください。再試行する前に、サポートまたは管理者にその検出内容を確認してもらってください。

ディスクの空き容量が足りない

メッセージに表示された容量を空けてから、もう一度試してください。

Verilator を選択できない

Verilator には、この PC に 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 → プロジェクトマネージャー → 設定 → プロジェクト → インクルードパス) の インクルードパス に追加し、もう一度 実行 を押します。マクロは プロジェクト → マクロ定義 に、1 行に 1 つずつ NAME または NAME=VALUE の形で入力します。

  • プロジェクト外のファイルをインクルードすると、シミュレーションが始まる前に実行が失敗します。このとき シミュレーターログ には「… is outside the project: copy it into the project and include it from there」と表示されます。

  • プロジェクト外を指す、または .. を含む インクルードパス の項目や、マクロ定義 の無効なマクロ名があると、その項目を示すメッセージとともに実行が止まります。修正するか削除してください。一覧にあるフォルダーが存在しない場合は、シミュレーターログ に警告を出してスキップします。

  • 変更した設定は次の実行から適用されます。エディターの診断では、プロジェクトを開き直した後から使われます。

次のステップ

  • テストベンチを変更し (たとえば有効にするクロックサイクル数と期待するカウント)、もう一度 実行 を押します。実行すると、まず編集内容が保存されます。

  • C++ コンパイラーと make をインストールし、シミュレーター で Verilator を選んで、結果を Icarus Verilog と比べます。

  • 自分の設計を実行します。このPCのプロジェクト で プロジェクトフォルダーを開く または 新しいプロジェクトを作成 を選びます。.v と .sv のソースと、$dumpfile と $dumpvars で波形を書き出すテストベンチを追加します。次に、Flow Navigator → シミュレーション → シミュレーション実行 → シミュレーション設定を開く で RTL simulation タブを開きます。ログインしていない場合は、シミュレーション実行 でタブが直接開きます。

  • プロジェクトの編集と保存については ワークスペース を、Verilog ファイルについては Verilog を参照してください。

このローカルシミュレーションとは別に適用される、プラットフォームの違いや会社の AI、ストレージ、アカウントの条件については、サポートガイド を参照してください。

環境サポート