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 が残ります。
インストールとログイン
ダウンロード から Windows アプリをダウンロードし、Windows インストールガイド の説明どおりにインストールします。
Digital Design Studio を起動します。Digital Design Studioにログイン で Altifigenceで続ける を選び、ブラウザーでログインを完了します。
代わりに ログインせずに続ける を選んだ場合も、サンプルを開いて編集し、実行できます。Cloud や AI などのアカウントサービスが必要になったら、後でログインしてください。
カウンターのサンプルを開く
新しいユーザーが PC で初めてアプリを起動すると、ログインするか、ログインせずに続けた後に、カウンターのサンプルが自動的に開きます。アプリはテストベンチ tb/counter_tb.sv と RTL simulation タブを開きます。
この PC で以前に Digital Design Studio を使ったことがある場合 (保存されたログイン、最近のプロジェクトや Academy のプロジェクト、保存されたウィンドウなど)、特定のプロジェクトを開くためにアプリが起動された場合、またはログインした組織にすでに Cloud プロジェクトがある場合、サンプルは自動では開きません。自分で開くには:
ナビゲーションパネルの上部で環境メニューを開き、このPC を選びます。
このPCのプロジェクト で サンプルを開く を選びます。この PC のプロジェクトがすでに開いている場合は、プロジェクト一覧の下にある このPC を選ぶとこのページに戻ります。
先に編集内容を保存し、実行中のタスクが終わるのを待ってください。未保存の作業や実行中のタスクがある間、アプリはプロジェクトを切り替えません。
サンプルはあなた専用のコピーで、アプリのデータフォルダーに一度だけ作成されます。もう一度開いても変更は保持されます。
ファイル | 内容 |
|---|---|
| 非同期のアクティブ Low リセット ( |
| テストベンチ。カウンターをリセットし、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 シミュレーター を選択して インストール を選びます。この PC でのその後の実行では同じインストールを使います。
テストベンチの実行
パネルを確認します。テストベンチ は
counter_tb · tb/counter_tb.sv、シミュレーター は Icarus Verilog、波形形式 は VCD です。その下に「ソースファイル2件 · top counter_tb」と表示されます。実行 を押します。実行すると、まず変更された
.v、.sv、.svh、.vhファイルを保存します。次に、.alti/、.altifigence/、.git/、node_modules/の下にあるファイルを除き、プロジェクト内のすべての.vと.svファイルを、選択したテストベンチをトップモジュールとしてコンパイルします。実行に成功すると、パネルにシミュレーターのバージョンと実行時間とともに 成功 と表示され、その下に波形が開きます。
シミュレーターログ を展開すると、コンパイラーとシミュレーターの出力を確認できます。テストベンチは
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) · … | シミュレーターが 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 上のプロジェクトを開き、テストベンチ ビューでテストベンチを実行します。 |
「テストベンチが見つかりません。…」 | テストベンチは、 |
ダウンロードが失敗する、または止まる | github.com、release-assets.githubusercontent.com、objects.githubusercontent.com への接続、プロキシ、ファイアウォールを確認してから、もう一度 実行 を押します。ダウンロードは止まったところから再開します。 |
ウイルス対策ソフトがファイルをブロックした、または Icarus Verilog が起動しない | セキュリティソフトのメッセージをそのまま控え、公式のダウンロードと期待されるハッシュを確認してください。実行を強行するためだけに保護を無効にしたり、広い除外を追加したりしないでください。再試行する前に、サポートまたは管理者にその検出内容を確認してもらってください。 |
ディスクの空き容量が足りない | メッセージに表示された容量を空けてから、もう一度試してください。 |
Verilator を選択できない | Verilator には、この PC に C++ コンパイラーと make が必要です。たとえば MSYS2 UCRT64 では |
「この実行では波形が書き出されませんでした。…」 | テストベンチに |
波形が 32 MiB を超える |
|
インクルードファイルとマクロ
インクルードする
.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、ストレージ、アカウントの条件については、サポートガイド を参照してください。