「LatticeMico32チュートリアル」の編集履歴（バックアップ）一覧はこちら
「LatticeMico32チュートリアル」(2012/03/08 (木) 20:52:17) の最新版変更点
追加された行は緑色になります。
削除された行は赤色になります。
*LatticeMico32チュートリアル
**LatticeMico32とは
LatticeMico32はLattice Semiconductor社が公開している無償で使える３２ビットソフトコアCPUです。
Lattice社のFPGA向けに最適化されていますがLattice社以外のFPGAでも使用することが可能です。
リソース使用量が多くLatticeXP2に組み込むと2400LUTほど消費しますが、
六段パイプライン構造でクロックあたりの命令実行能力(Clock Per Instruction)が高いのが特徴です。
開発環境はEclipseベースのLatticeMico Systemが提供されおりC/C++言語が使えます。
以下にLatticeMico32のブロックダイアグラムを示します
#image(lm32bus_arch.png)
**このチュートリアルの目標
シミュレーターで動作確認を行い最終的にCQ-FRK-LXP2のLatticeXP2に組み込み、テストプログラム（Lﾁｶ）を走らせることが目標です。
**開発環境
Lattice Diamond1.4がインストールされていることが前提です。なおこのチュートリアルではWindows7 64bitでの解説となります。
**プラットフォームの作成
まずスタートメニューの[プログラム]から [Lattice Diamond1.4]→[Accessories]→[LatticeMico System] を選択しLatticeMico Systemを起動します
初回起動時にWorkspaceをどこにするか聞かれますが、ここでは[C:\lscc\lm32]にしておきます。
#image(msb_new_plat.png)
そして次にメニューから[Files]->[New Platform]を選択します。
#image(msb_plat_wizard.png)
次のようなウィンドウが開きますので、プラットフォーム名、ディレクトリ、組み込むFPGA、動作周波数、パッケージを設定します。
動作周波数はここでは16MHzになってますが各自の環境に合わせてください。LatticeMico32は70MHzぐらいまでなら動作するようです。
**LatticeMico32ハードウェアの生成
#image(msb_lm32.png)
プラットフォームが作成できたら左側の[Available Components]から[LatticeMico32]を選んでダブルクリックします
#image(add_mico32.png)
LatticeMico32の生成オプションを設定するウィンドウが出てきます。ここではFPGAのリソース節約のため全てのチェックボックスとOFFにします。
次にプログラムROMの設定をします。
プログラムROMはWISHBONEバスにOn chip memoryを接続するかinline memoryを使用する方法と二通りありますが、
[[inline memoryを使ったほうがバス効率やアクセス速度の面で有利>http://www.latticesemi.co.jp/corporate/newscenter/newsletters/newsapril2009/mico32.cfm]]です。なので、ここではinline memoryを使う方法を解説します。
#image(inline_memory.png)
次に上のタブからinline memoryの設定画面に移ります。Enabledのチェックボックスを２つともONにし
[Instruction Inline Memory]の[Size of Memory(in bytes)]の項目に[&bold(){0x00000D00}]と入力して[OK]を押します。
**GPIOハードウェアの作成
#image(gpio.png)
次にGPIOのハードウェアを作成します。[Available Components]から[GPIO]を選んでダブルクリックします
#image(add_gpio.png)
設定画面が出てきますので”Data Width”を[8]にして[OK]を押します。
#image(wishbone.png)
次にWishbone Connectionの画面の○をクリックしてGPIOのWISHBONEバスを接続します。
#image(generate.png)
最後に上のメニューのGと書かれたボタンを押してハードウェアを出力します。
**ソフトウェアの作成
#image(new_project.png)
次にソフトウェアプロジェクトを作成します。メニューから[Files]->[New]->[mico Managed Make C Project]を選択します
#image(proj_wiz0.png)
プロジェクト名とファイル保存する場所を設定する画面が出てきます。
[Project Contents]は最初はワークスペースの場所が入力してあるのですが
ワークスペースの下にコンテンツフォルダを作成しようとすると上の画像のように怒られます。
#image(proj_wiz1.png)
そこでワークスペースの外に新たにフォルダを作ってそこをコンテンツフォルダにします。ここでは”lm32c”というフォルダにして[Finish]を押す。
#image(file_add.png)
Cプログラムを追加します。プロジェクト切り替えで[C/C++]を選びます。
プロジェクトが切り替わったら、上の画像のようにアイコンを右クリックしてコンテストメニューからCのソースファイルを追加します。
#highlight(c){{
/* test.c */
#define GPIO *(volatile int *)0x80000000
int main(void)
{
for(;;){
GPIO = 0xffffffff;
GPIO = 0x00000000;
}
}
}}
ソースファイルに次のように入力したら&bold(){Ctrl+B}を押してビルドします。
**メモリファイルの生成
#image(deploy.png)
エラーが出ずにビルドできたら、次にメモリファイルを出力します。メニューから[Tools]->[Software Deployment]を選択します。
#image(onchip_dep.png)
左のメニューから[Mico32 Onchip Memory Deployment]を選択してからメモリファイルの元になる.elfファイルを選択、
ファイル名を設定してメモリファイルを作成します。
#image(msb_lm32p.png)
次にプロジェクトをMSBに切り替えて「LM32」をダブルクリックし設定画面をもう一度出します
#image(memory_set.png)
InlineMemoryのタブで先程生成したメモリファイルを指定します。
このあともう一度Gボタンを押してハードウェアを生成しておきましょう。
**Veritakでシミュレーション
テストベンチファイルを作ります。
#highlight(txt){
/* tb_lm32test.v */
`timescale 10ns/10ps
module t;
reg Clock = 1'b0;
reg Reset = 1'b0;
wire [7:0] gpioPIO_OUT;
lm32test lm32 (
.clk_i(Clock),
.reset_n(~Reset),
.gpioPIO_OUT(gpioPIO_OUT) // [8-1:0]
);
//Global Reset
GSR GSR_INST(.GSR(1'b1));
PUR PUR_INST(.PUR(1'b1));
initial begin
#0.5 Reset = 1'b1;
#0.5 Reset = 1'b0;
fork
forever #0.5 Clock = ~Clock;
do;
join
end
task do; begin
#3000;
$finish;
end endtask
endmodule
}
次にプロジェクトファイルを作ります。
#image(exp.png)
Diamondがインストールされたフォルダにあるシミュレーション用ライブラリがあるフォルダを読み込んでおきます。
#image(veri_proj.png)
Defineで"SIMULATION"を定義しておきましょう。そうしないと論理合成用のブラックボックスモデルが読み込まれてしまいます。
あとLatticeMico32のHDLソースファイルはけっこういい加減な文法なのでVeritakに読み込ませると文法エラーが多発します。
[[gpio.v>http://www36.atwiki.jp/aroe?cmd=upload&act=open&pageid=35&file=gpio.v]]
Veritakでエラーが出ないように修正したHDLソースを容易しましたので上のファイルを &italic(){/componets/gpio/gpio.v} を上書きします
あと&italic(){/components/lm32_top/rtl/verilog/lm32_load_store_unit.v} の200行目
>output irom_store_data_m;
を
>output [`LM32_WORD_RNG] irom_store_data_m;
に修正します。
#image(wave.png)
うまくコンパイルできたら。波形を確認して上のようにGPIOの出力値が交互にFF、00と切り替われば正常に動作しています。
**論理合成用プログラムのビルド
次に実際にFPGAに組み込むための論理合成用プログラムのソースコードを示します
#highlight(c){{
/* lm32syn_test.c */
#define GPIO *(volatile int *)0x80000000
int main(void)
{
unsigned int i;
unsigned int data = 0;
for(;;){
data = ~data;
GPIO = data;
for (i = 0; i < 0x20000; i++); //wait
}
}
}}
これをビルドしたら前のようにメモリファイルをデプロイしましょう。
**Diamondに組み込む
Diamondを起動して新規プロジェクトを作成します。
MicoSystemBuilderで生成したLatticeMico32のCPUコア本体と
次のトップモジュールのVerilog HDLファイルをプロジェクトに追加します。
#highlight(txt){
/* top.v */
module top(
input Clock,
input Reset,
output [1:0] LED
);
wire [7:0] gpio;
assign LED = gpio[1:0];
lm32test lm32 (
.clk_i(Clock),
.reset_n(~Reset),
.gpioPIO_OUT(gpio) // [8-1:0]
);
endmodule
}
上のファイルをストラテジ設定でトップモジュールに設定して論理合成します。
#image(summary.png)
消費リソース一覧
LUTを2278、組み込みRAMを４つ消費しました。
#image(Diamond.png)
スプレッドシートビューで上記のようにピンアサインします。
ビットストリームファイルを出力してFPGAに書きこめば
大体６０MHz以下であれば点滅が確認できるでしょう。
参考にした所
[[ソフトウェア開発を体験する ―― 『ディジタル・デザイン・テクノロジ』（No.1）に付属の基板をマイコン基板として活用する>http://www.kumikomi.net/archives/2010/01/ep02fpga.php?page=2]]
[[とにかく始めるMico32 - shantery.co.jp/dswiki>view-source:http://shantery.co.jp/dswiki/index.php?%A4%C8%A4%CB%A4%AB%A4%AF%BB%CF%A4%E1%A4%EBMico32]]
*LatticeMico32チュートリアル
**LatticeMico32とは
LatticeMico32はLattice Semiconductor社が公開している無償で使える３２ビットソフトコアCPUです。
Lattice社のFPGA向けに最適化されていますがLattice社以外のFPGAでも使用することが可能です。
リソース使用量が多くLatticeXP2に組み込むと2400LUTほど消費しますが、
六段パイプライン構造でクロックあたりの命令実行能力(Clock Per Instruction)が高いのが特徴です。
開発環境はEclipseベースのLatticeMico Systemが提供されおりC/C++言語が使えます。
以下にLatticeMico32のブロックダイアグラムを示します
#image(lm32bus_arch.png)
**このチュートリアルの目標
シミュレーターで動作確認を行い最終的にCQ-FRK-LXP2のLatticeXP2に組み込み、テストプログラム（Lﾁｶ）を走らせることが目標です。
**開発環境
Lattice Diamond1.4がインストールされていることが前提です。なおこのチュートリアルではWindows7 64bitでの解説となります。
**プラットフォームの作成
まずスタートメニューの[プログラム]から [Lattice Diamond1.4]→[Accessories]→[LatticeMico System] を選択しLatticeMico Systemを起動します
初回起動時にWorkspaceをどこにするか聞かれますが、ここでは[C:\lscc\lm32]にしておきます。
#image(msb_new_plat.png)
そして次にメニューから[Files]->[New Platform]を選択します。
#image(msb_plat_wizard.png)
次のようなウィンドウが開きますので、プラットフォーム名、ディレクトリ、組み込むFPGA、動作周波数、パッケージを設定します。
動作周波数はここでは16MHzになってますが各自の環境に合わせてください。LatticeMico32は70MHzぐらいまでなら動作するようです。
**LatticeMico32ハードウェアの生成
#image(msb_lm32.png)
プラットフォームが作成できたら左側の[Available Components]から[LatticeMico32]を選んでダブルクリックします
#image(add_mico32.png)
LatticeMico32の生成オプションを設定するウィンドウが出てきます。ここではFPGAのリソース節約のため全てのチェックボックスとOFFにします。
次にプログラムROMの設定をします。
プログラムROMはWISHBONEバスにOn chip memoryを接続するかinline memoryを使用する方法と二通りありますが、
[[inline memoryを使ったほうがバス効率やアクセス速度の面で有利>http://www.latticesemi.co.jp/corporate/newscenter/newsletters/newsapril2009/mico32.cfm]]です。なので、ここではinline memoryを使う方法を解説します。
#image(inline_memory.png)
次に上のタブからinline memoryの設定画面に移ります。Enabledのチェックボックスを２つともONにし
[Instruction Inline Memory]の[Size of Memory(in bytes)]の項目に[&bold(){0x00000D00}]と入力して[OK]を押します。
**GPIOハードウェアの作成
#image(gpio.png)
次にGPIOのハードウェアを作成します。[Available Components]から[GPIO]を選んでダブルクリックします
#image(add_gpio.png)
設定画面が出てきますので”Data Width”を[8]にして[OK]を押します。
#image(wishbone.png)
次にWishbone Connectionの画面の○をクリックしてGPIOのWISHBONEバスを接続します。
#image(generate.png)
最後に上のメニューのGと書かれたボタンを押してハードウェアを出力します。
**ソフトウェアの作成
#image(new_project.png)
次にソフトウェアプロジェクトを作成します。メニューから[Files]->[New]->[mico Managed Make C Project]を選択します
#image(proj_wiz0.png)
プロジェクト名とファイル保存する場所を設定する画面が出てきます。
[Project Contents]は最初はワークスペースの場所が入力してあるのですが
ワークスペースの下にコンテンツフォルダを作成しようとすると上の画像のように怒られます。
#image(proj_wiz1.png)
そこでワークスペースの外に新たにフォルダを作ってそこをコンテンツフォルダにします。ここでは”lm32c”というフォルダにして[Finish]を押す。
#image(file_add.png)
Cプログラムを追加します。プロジェクト切り替えで[C/C++]を選びます。
プロジェクトが切り替わったら、上の画像のようにアイコンを右クリックしてコンテストメニューからCのソースファイルを追加します。
#highlight(c){{
/* test.c */
#define GPIO *(volatile int *)0x80000000
int main(void)
{
for(;;){
GPIO = 0xffffffff;
GPIO = 0x00000000;
}
}
}}
ソースファイルに次のように入力したら&bold(){Ctrl+B}を押してビルドします。
**メモリファイルの生成
#image(deploy.png)
エラーが出ずにビルドできたら、次にメモリファイルを出力します。メニューから[Tools]->[Software Deployment]を選択します。
#image(onchip_dep.png)
左のメニューから[Mico32 Onchip Memory Deployment]を選択してからメモリファイルの元になる.elfファイルを選択、
ファイル名を設定してメモリファイルを作成します。
#image(msb_lm32p.png)
次にプロジェクトをMSBに切り替えて「LM32」をダブルクリックし設定画面をもう一度出します
#image(memory_set.png)
InlineMemoryのタブで先程生成したメモリファイルを指定します。
このあともう一度Gボタンを押してハードウェアを生成しておきましょう。
**Veritakでシミュレーション
テストベンチファイルを作ります。
#highlight(txt){
/* tb_lm32test.v */
`timescale 10ns/10ps
module t;
reg Clock = 1'b0;
reg Reset = 1'b0;
wire [7:0] gpioPIO_OUT;
lm32test lm32 (
.clk_i(Clock),
.reset_n(~Reset),
.gpioPIO_OUT(gpioPIO_OUT) // [8-1:0]
);
//Global Reset
GSR GSR_INST(.GSR(1'b1));
PUR PUR_INST(.PUR(1'b1));
initial begin
#0.5 Reset = 1'b1;
#0.5 Reset = 1'b0;
fork
forever #0.5 Clock = ~Clock;
do;
join
end
task do; begin
#3000;
$finish;
end endtask
endmodule
}
次にプロジェクトファイルを作ります。
#image(exp.png)
Diamondがインストールされたフォルダにあるシミュレーション用ライブラリがあるフォルダを読み込んでおきます。
#image(veri_proj.png)
Defineで"SIMULATION"を定義しておきましょう。そうしないと論理合成用のブラックボックスモデルが読み込まれてしまいます。
あとLatticeMico32のHDLソースファイルはけっこういい加減な文法なのでVeritakに読み込ませると文法エラーが多発します。
[[gpio.v>http://www36.atwiki.jp/aroe?cmd=upload&act=open&pageid=35&file=gpio.v]]
Veritakでエラーが出ないように修正したHDLソースを容易しましたので上のファイルを &italic(){/componets/gpio/gpio.v} を上書きします
あと&italic(){/components/lm32_top/rtl/verilog/lm32_load_store_unit.v} の200行目
>output irom_store_data_m;
を
>output [`LM32_WORD_RNG] irom_store_data_m;
に修正します。
#image(wave.png)
うまくコンパイルできたら。波形を確認して上のようにGPIOの出力値が交互にFF、00と切り替われば正常に動作しています。
**論理合成用プログラムのビルド
次に実際にFPGAに組み込むための論理合成用プログラムのソースコードを示します
#highlight(c){{
/* lm32syn_test.c */
#define GPIO *(volatile int *)0x80000000
int main(void)
{
unsigned int i;
unsigned int data = 0;
for(;;){
data = ~data;
GPIO = data;
for (i = 0; i < 0x20000; i++); //wait
}
}
}}
これをビルドしたら前のようにメモリファイルをデプロイしましょう。
**Diamondに組み込む
Diamondを起動して新規プロジェクトを作成します。
MicoSystemBuilderで生成したLatticeMico32のCPUコア本体と
次のトップモジュールのVerilog HDLファイルをプロジェクトに追加します。
#highlight(txt){
/* top.v */
module top(
input Clock,
input Reset,
output [1:0] LED
);
wire [7:0] gpio;
assign LED = gpio[1:0];
lm32test lm32 (
.clk_i(Clock),
.reset_n(~Reset),
.gpioPIO_OUT(gpio) // [8-1:0]
);
endmodule
}
上のファイルをストラテジ設定でトップモジュールに設定して論理合成します。
#image(summary.png)
消費リソース一覧
LUTを2278、組み込みRAMを４つ消費しました。
#image(Diamond.png)
スプレッドシートビューで上記のようにピンアサインします。
ビットストリームファイルを出力してFPGAに書きこめば
大体６０MHz以下であれば点滅が確認できるでしょう。
***他に参考になるサイト
-[[ソフトウェア開発を体験する ―― 『ディジタル・デザイン・テクノロジ』（No.1）に付属の基板をマイコン基板として活用する>http://www.kumikomi.net/archives/2010/01/ep02fpga.php?page=2]]
-[[とにかく始めるMico32 - shantery.co.jp/dswiki>view-source:http://shantery.co.jp/dswiki/index.php?%A4%C8%A4%CB%A4%AB%A4%AF%BB%CF%A4%E1%A4%EBMico32]]
-[[HW/WISHBONE - す部屋>http://su.kineya.org/index.php?HW%2FWISHBONE]]
表示オプション
横に並べて表示：
変化行の前後のみ表示：
