「Chiselを始めたい人に読んでほしい本」で使用された全サンプルソースを含んだプロジェクトです。 chisel-templateを使用しているので、sbtを使った基本的なプロジェクトの構成に沿っています。 各サンプルソースについては、本書との対応付けと取りやすくするため"src/{main, test}のディレクトリの下に対応するchapterのパッケージディレクトリを作成して、そのディレクトリの下に格納しています。書籍のリストx-yの表記の部分にソースコードのパスが記載してありますので、そちらを確認していただくのが早いと思います。
本文に記載したように、執筆時点では安定版として次の２つのバージョンが存在しています。
- Chisel 3.2.4
- Chisel 3.3.0
本リポジトリに存在するブランチとChiselのバージョンの対応は次のようになっています。
| ブランチ名 | Chiselのバージョン |
|---|---|
| master | Chisel 3.2.4 |
| for-chisel-3.3.0 | Chisel 3.3.0 |
簡単に動作確認を行うためにRTLGeneratorとSimRunnerというオブジェクトを作成してあります。それぞれ以下のような処理を実行することが可能です。
- RTLGenerator : RTLの生成を行うメイン関数を含むオブジェクト
- クラスパラメーターが存在しないChiselのモジュールなら、全部RTLを生成することが可能（なはず）
- クラスパラメーターが必要なChiselのモジュールは、オブジェクト内で明示されているもののみ生成可能
- SimRunner : Chiselのテスト機構を使って1cycleのみのシミュレーションを実行するオブジェクト
- 主に4章で解説したChiselの型のサンプルソース中の
printf関数の表示を確認するために使用
- 主に4章で解説したChiselの型のサンプルソース中の
使い方は以下のようになります。
runMain RTLGenerator <RTL化したいChiselモジュールのクラスパス>
runMain SimRunner <シミュレーションを実行したいChiselモジュールのクラスパス>ここで<シミュレーションを実行したいChiselモジュールのクラスパス>はパッケージ名を含んだクラスパスとなります。
例えばchapter4のSampleRegのRTLを生成する場合は以下のようになります。
runMain Generator chapter4.SampleReg本書を手に取ってくださった方から頂いたご指摘（誤記など）について記載しました。
確認が足りておらず、ご不便おかけしました。 また、ご指摘いただきありがとうございました！
ここに記載されているもの以外で、なにかお気づきの点があれば、本リポジトリのissueやtwitterでお知らせください。
"リスト3.4:sbtを使ったメイン関数の実行"で実行するコマンドに間違いが有りました。
- 本文中の記載
sbt:scala_chk> runMain main- 正しい記載
sbt:scala_chk> runMain HelloWorld"リスト4.2のLチカ"のソースコードにはScalaのパッケージ宣言部分が掲載されておらず、そのままコードを写した後に"リスト4.14:Chisel のモジュールから RTL を生成"のコマンドを実行すると、クラスパスが間違った状態になりrunMainコマンドが失敗します。
- 本文中の記載
- 次のようにコードの先頭が
importから始まっています
- 次のようにコードの先頭が
import math.pow
import chisel3._- 正しい記載
- ”リスト4.14”記載のコマンドを動作させるためには、
package chapter4が必要になります
- ”リスト4.14”記載のコマンドを動作させるためには、
package chapter4 // package宣言が必要
import math.pow
import chisel3._
import chisel3.util._"リスト4.2のLチカ"のソースコードに間違いがあり、本文中のコードをそのまま写すと次のようなビルドエラーが発生します。
[info] running chapter4.ElaborateHelloChisel
[info] [0.001] Elaborating design...
[error] java.lang.NullPointerExceptionこれはw_msec_updateに接続される論理に、初期化が済んでいないレジスタ用の変数r_count_msecを使っていることが原因です。
そのため、次の訂正後のコードのようにval r_count_msecの宣言をw_msec_udpateの前に移動する必要があります。
- 本文中の記載
// r_count_msecの宣言場所がw_msec_updateの後にある
// msec カウントのパルス
val w_msec_update = Wire(Bool())
w_msec_update := r_count_msec === (msecCounts - 1).U
// msec カウント用のレジスタ
val r_count_msec = RegInit(0.U(log2Ceil(msecCounts).W))
val r_count_interval = RegInit(0.U(log2Ceil(blinkInterval).W))- 正しい記載
// r_count_msecの宣言場所はw_msec_updateより前になければならない
// msec カウントのパルス
val r_count_msec = RegInit(0.U(log2Ceil(msecCounts).W))
val w_msec_update = Wire(Bool())
w_msec_update := r_count_msec === (msecCounts - 1).U
// msec カウント用のレジスタ
val r_count_interval = RegInit(0.U(log2Ceil(blinkInterval).W))修正後の正しいコードについては、本リポジトリの次のコードを参照ください。
このサンプルコードを含んだプロジェクト一式についてはMIT Licenseにしてます。 今回は「Chiselを広めたい！」がモチベーションになっているので、Chiselを他の人に勧める 際に「このサンプル使えるやん！」と思ってもらえるのならぜひ使ってください！
MIT License
Copyright (c) 2019-2020 diningyo
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.