RISCBoyは、ゼロから設計されたオープンソースのポータブルゲームコンソールです
RISCBoy is an open-source portable games console, designed from scratch (github.com)
要約
RISCBoyは、RISC-Vアーキテクチャを採用したオープンソースのポータブルゲームコンソールです。2001年のゲームボーイアドバンスを彷彿とさせる設計で、合成可能なVerilog 2005で記述されており、iCE40-HX8k FPGAへの搭載を目指しています。RV32IMC命令セットをサポートし、RISC-Vコンプライアンススイートをパスしています。PCBレイアウトや開発ツールチェーンの構築方法も詳細に説明されています。
全文翻訳
RISCBoy
RISCBoyは、ゼロから設計されたオープンソースのポータブルゲーム機です。これには以下が含まれます。
- RISC-V互換CPU
- ラスタグラフィックスパイプラインおよびディスプレイコントローラー
- その他のチップインフラストラクチャ:バスファブリック、メモリコントローラー、UART、GPIOなど
- KiCadでのPCBレイアウト
これは、2001年にRISC-Vが存在していた並列宇宙のゲームボーイアドバンスです。私の子供時代の携帯ゲーム機へのラブレターであり、それらを動かしていたテクノロジーへの午前3時の酔ったテキストメッセージです。
設計は合成可能なVerilog 2005で記述されており、iCE40-HX8k FPGAに収まるように意図されています。これは7680個の論理要素を持つLUT4ベースのFPGAであり、32ビットゲーム機を収めるには、バールとワセリン、あるいは慎重な設計が必要かもしれません。HX8kはかつてオープンソースのIcestorm FPGAツールチェーンのターゲットとなった最大のFPGAでしたが、そのツールチェーンはその後より大きなものへと進化しました。
より詳細な情報はドキュメントで見つけることができます。
プロセッサはRV32IMC命令セットをサポートしており、これらの命令に対するRISC-Vコンプライアンススイート、riscv-formal検証スイート、および命令フロントエンドの一貫性と基本的なバスコンプライアンスのための私の独自のフォーマルプロパティチェックに合格しています。また、MモードCSR、例外、およびベクター化された外部割り込みのためのシンプルな準拠拡張もサポートしています。
クローニング
このリポジトリはHDLおよびテスト用のサブモジュールを使用しています
git clone --recursive https://github.com/Wren6991/RISCBoy.git riscboy
または
git clone https://github.com/Wren6991/RISCBoy.git riscboy
cd riscboy
git submodule update --init --recursive
プロセッサのスタンドアロンテストを実行するには、再帰的なサブモジュール更新が必要です。これはRISCBoyゲートウェアのビルドには必要ありません。
RV32IMCツールチェーンのビルド
RV32IMCツールチェーンは、ソフトウェアベースのテストのコンパイルに必要です。RISC-V GNU Toolchain GitHubの指示に従ってください。ただし、configure行は異なります。
# Ubuntu 20.04 の前提条件
sudo apt install -y autoconf automake autotools-dev curl python3 libmpc-dev libmpfr-dev libgmp-dev gawk build-essential bison flex texinfo gperf libtool patchutils bc zlib1g-dev libexpat-dev
cd /tmp
git clone --recursive https://github.com/riscv/riscv-gnu-toolchain
cd riscv-gnu-toolchain
# ./configure の引数が最も重要な違いです
./configure --prefix=/opt/riscv --with-arch=rv32imc --with-abi=ilp32 --with-multilib-generator="rv32i-ilp32--;rv32ic-ilp32--;rv32im-ilp32--;rv32imc-ilp32--"
sudo mkdir /opt/riscv
sudo chown $(whoami) /opt/riscv
make -j $(nproc)
iCE40 UP5kのようなより小さなFPGAでは、RISCBoyはより高性能なRV32IMCバージョンではなく、より小さなRV32Iバリアントのプロセッサを使用するように設定される場合があります。コンパイラはRISCBoyで利用可能なISAバリアントのいずれかをサポートしますが、ビルドスクリプトにも--with-multilib引数を介してこれらのバリアントの標準ライブラリを生成するように指示する必要があります。RV32IMC標準ライブラリとリンクされたRV32I実行可能ファイルをRV32I専用プロセッサで実行すると、問題が発生します!
シミュレーション
シミュレーションフローはXilinx ISIM 14.xによって駆動されます。メイクファイルはscripts/フォルダにあります。これはLinux版ISIMでのみテストされています。
これらのテストを実行するには、RISC-Vコンプライアンススイートもチェックアウトする必要があります(-- testは、gitがKiCadディレクトリを検索してライブラリ構造について不平を言うのを停止するために必要です)。
$ git submodule update --init --recursive
これが準備できたら、以下を実行できるはずです。
. sourceme
cd test
./runtests
これにより、すべてのHDLレベルのテストが実行されます。ソフトウェアテストにはRV32ICツールチェーンが必要です。ISIMがデフォルト以外の場所にインストールされている場合は、sourceme内のパスを調整する必要がある場合があります。テストをグラフィカルにデバッグするには、そのメイクファイルを直接実行します。
cd system
make TEST=helloworld gui
PCB
画像はRev A PCBを示しています。これはiTeadの4層5x5cmプロトタイピングサービスと互換性があり、現在10枚で65ドルです。
回路図はこちら(pdf)で表示できます。
Rev Bはかなり異なる外観になります。ゲートウェアとブートローダーが成熟するのを待ってから進めます。私の現在の開発ハードウェアは、私のSnowflake FPGAボードとよく似ています。
合成
iCE40のFPGA合成にはオープンソースツールチェーンが使用されます。既存のメイクファイルを使用してこのプロジェクトをビルドしたい場合は、まず私が使用したツールチェーンをビルドする必要があります。
- 合成用のYosys
- 配置配線用のnextpnr
- ビットストリーム生成用のProject Icestorm
これらはLinuxでのみビルドしたことに注意してください。Windowsでもビルド可能だと聞いていますが、試したことはありません。ただし、Raspberry Piでもビルドできるのは素晴らしいことです。
ツールチェーンが配置されたら、以下を実行します。
. sourceme
cd synth
make -f HX8k-EVN.mk bit
Lattice HX8k評価ボードに適したFPGAイメージを生成します。
ECP5についても非常に実験的なサポート(つまり、私の主な開発プラットフォームではありません)があり、Lattice LEF5UM5G-85F-EVN評価ボード用のボードファイルがあります。
make -f ECP5-EVN.mk BUILD=full bit
このビルドでは、RISCBoy開発ハードウェアの外部512KiB、16ビット幅SRAMを、TrellisがECP5のsysmemブロックから構築する内部256KiB、32ビット幅同期メモリに置き換えます。
ディレクトリ構造
board: メインRISCBoy PCBおよび開発中に使用されるその他の小型ボードのKiCadファイルdoc: ドキュメント用のLaTeXソースと図、および最新のビルド済みPDFhdl: RISCBoyゲートウェアのVerilogソース。busfabric: AHB-liteクロスバーおよびAPBペリフェラルファブリックgraphics: ピクセル処理ユニットのソースhazard5: RISC-Vプロセッサのソース。これは完全に自己完結型です。mem: メモリコントローラー、およびメモリ自体の推論/注入ラッパーとモデルperis: UART、SPI、PWMなどの小型ペリフェラルriscboy_core: RISCBoyを構成するコンポーネントをインスタンス化および接続するための構造モジュールriscboy_fpga: いくつかの異なるFPGAおよびボードのトップレベルラッパー:IOを接続し、クロックとリセットを提供します
reference: RISCBoyで使用される標準のPDF(例:RISC-V命令セット)scripts: 他の場所に配置できないジャンクsoftware: システムレベルテストに使用されるCファイルの緩いコレクション。まだあまり有用なソフトウェアツリーではありません。synth: 全体システム合成を実行するための作業ディレクトリ。トップレベルメイクファイル、ピン制約ファイル。test: 回帰テスト。Verilogテストベンチもあれば、プロセッサまたはフルシステムのシミュレーションで実行されるソフトウェアテストケースもあります。